The macros section of the notation guide organises information based on how a feature is implemented, not what it does. This is bad, because it makes it really hard to find features unless you either read the whole guide, or you already know how something is done.

The macro is really a text effect, the macro should be documented in the links section,

with images, and

under 'misc'.

We should then break the remaining macros into:

• Advanced Formatting (noformat, code, panel)
• External Content (rss, jiraissues, html-include)
• Confluence Content (search, children, blog-posts, include, excerpt, excerpt-include, index}