Documentation status
This page tracks, as of 2026-09-23, where each of the 68 macros analysed in this proposal is documented, and whether that documentation has been migrated to the new documentation tree on xwiki.org.
Summary
- 12 macros have a Reference page in the new documentation tree.
- 47 macros are still documented only in the legacy documentation, mostly on extensions.xwiki.org.
- 9 macros have no documentation at all.
Beyond the migration itself, a recurring problem shows in the table: 13 macros have no page of their own and are only covered by a section of the page of the application that ships them, which makes them hard to find and impossible to link to precisely.
Status per macro
Conventions
A macro counts as Migrated when a page built on the DocApp.Code.RenderingMacroClass template exists for it under documentation. The list of those pages comes from the Solr query class:"DocApp.Code.RenderingMacroClass", so this table can be refreshed by re-running it.
The migration conventions themselves, from the page template to the parameter table columns and the naming and placement rules, are discussed in the forum thread Consistency of the macro parameter table.
