Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Use h1. for top-level headings (major sections).
  • Use h2. for subheadings, then h3., and so on.

Callouts

  • Use {tip} for tips that suggest a beneficial, but optional action.
  • Use {info} for tipsother helpful information.
  • Use {note} for warnings of medium importance. If these are not followed, it is possible that the user will experience moderate problems.
  • Use {warning} for warnings of high importance. If these are not followed, there it is possible that the user will experience severe problems.

...

  • If a page exceeds two sections, it should have a table of contents allowing readers to quickly understand the major sections and jump around, if needed.
  • The wiki markup for a page's table of contents should look exactly like this:
    Code Block
    *On this page:*
    {toc}
    
  • If a page a is simply a container for other pages (e.g. a "section" of documentation), the body's wiki markup should be exactly this:
    Code Block
    *In this section:*
    {children}