Having extensive documentation just doesnt make sense for macros. Macros in roll20 or more similar to how the word macro was originally used: methods of automating repetitive keystrokes, and it was very unusual to have comments in those. Macros in roll20 were also intended to be short and simple, and for personal use. There's no easy way to share them, for instance. If you do want to share documented macros, you'd normally save them to something like gist, where you can document them freely.