Introduction
General guide and notes on how to add and style content in this user manual using Confluence
General style
Here are a few pointers to maintaining a consistent style:
use Heading 2 as the top level of headings within a page (Heading 1 looks too much like the page title)
By default, body text shouldn’t be numbered or in bullets. Use bullets for a list of things and use numbers for a sequential list (e.g. a series of steps that the user is to take).
use panels to call out specific information (“/info”, “/error”, “/warning”, “/note”, “/success”)
use expandable panels sparingly (“/expand”) and, if used, make sure the heading/text that is always visible clear indicates what the expanded content will relate to (e.g. avoid “more information” etc.)
use bold to highlight menu items and buttons referred to on pages
refer to the different screens within Lawmaker using consistent terminology: Dashboard, Project tab, Amendment Workspace tab, Amendment Manager tab, Official Lists tab, the Editor.
Converting old style pages
Pages copied across from the old version of confluence need to be converted to the new format.
Using labels to indicate status
Use the following labels to indicate the status of pages as we transfer content across from the old site:
Revise - Page has been converted to new format but hasn’t been updated
WIP - Page is currently being revised
Review - Page has been revised but would benefit from being reviewed