is used to indicate elements that should appear on the screen, be readily identifiable or are emphasised.
is used to indicate values, arguments or other user supplied values that should be entered.
is used to show output from commands or contents of files.
There are typically either reference articles or step by step guides
These have no set format.
Step by Step Guides
These should only deal with one process. If there are related processes these should be linked to the relevant page at the appropriate stage in the process
The Myplace support site is split in to two broad areas:
A number of smaller ancillary areas for specific staff audiences also exist:
Support Page Layout
All pages should use the Excerpt macro to designate a short piece of text that will be extracted and potentially presented elsewhere. This should give a clear indication as to what the page will cover. This also prevents inappropriate content to be presented in these contexts.
All pages should use a Table of Contents macro after the Excerpt. If there is only 1 section of content that matches the title of the page the table of contents can be omitted.
Where steps are sequential each step should be numbered, rather than bulleted. This allows each step to be individually referenced in previous or following steps.
Where the instructions are alternatives they should be bulleted.
If you wish to include rich content in the numbered item you should combine the list with a Section macro:
Heading levels should be used appropriate.
The Top level of headings should be Heading 1.
Each further sub-heading should increase the heading level.