You can add comment lines to macros like this:
/gsay INC %T ----I'm Telling Group Mob is Incoming
/alt act 544 ----Activating Some Useful AA
/cast 1 ----Casting Debuff Spell
/cast 2 ----Casting Big Nuke
/cast 3 ----Casting Root
Don't need more than one blank space before the comment. You can't see extra spaces here but in my macros I put a bunch of spaces so the comments appear well to the right of the commands, for maximum readability. I guess the command processor ignores any text after a complete command sequence has been processed.
I'm embarrassed somewhat to admit that in all the years I played this game I didn't know this. It's REALLY useful for AA abilities since who can remember what talent these code numbers reference.
Note that these comment lines are strictly for editing purposes. They don't get issued as say commands so nobody else sees them.
Edited, Jun 24th 2015 9:49pm by Sippin