XWiki.org Documentation Reorganization (batch 14) - Deprecated Macro

Development
,
11

Thanks everyone for replying!

Therefore, based on your feedback:

  • The {{deprecated}} macro should mark a block of text as deprecated and show a clear visual warning.
    • It should add a small “deprecated” banner (similar to the version banner) and wrap the text either inline or as a block.
  • It must have one required parameter:
    • since= for something newly deprecated, or
    • before= for something that existed before version numbers.
  • It can also have an optional useInstead= parameter to show what users should use instead.
  • The macro should use simple and consistent styling so readers can easily see the deprecated content.
  • The warning should be easy to read in view mode and not disturbing in edit or preview mode.
  • Example:
{{deprecated since="15.6.8" useInstead="New Variable"}}
This content/variable is deprecated.
{{/deprecated}}

Thanks!