FS
Documentation

Style Guide

From Documentation

Revision as of 06:10, 29 September 2006; view current revision
←Older revision | Newer revision→
Jump to: navigation, search

This is the style guide for formatting text for the Functional Software online Documentation.

Contents

Product Links


How To

  1. To create a link to a main document level, simply use "[[product3G]]"
  2. To link to a sub-section of a document, use "[[product3G/subPage | product3G Subpage]]"
  3. To link to a specific part of a document, use "[[product3G/subPage#sectionName | Section Name]]"

Examples

  1. [[COSmanager]] = COSmanager
  2. [[COSmanager/User_Guide/Appendices | COSmanager User Guide Appendices]] = COSmanager User Guide Appendices
  3. [[COSmanager/User_Guide/Appendices#Appendix_A_.E2.80.94_the_COSmanager_User_Interface| Appendix A—the COSmanager User Interface]] = Appendix A—the COSmanager User Interface

Documentation Styles

Inserting Images

Most of the images in the hard documentation are labelled and referred to in the text, for illustration. MediaWiki provides a mechanism for the insertion of a caption alongside an image.

Images are added to the Wiki using the Special Actions > Upload File menu on the far left. Once uploaded to the server, images can be referenced in the page using:

[[Image:imageName.extension|options|Alt Text or Caption]]

Cautions, Notes, Tips

Currently, cautions, notes and tips look like:


Note
This is a note, of some description

This look is achieved using the following code:

----
;Note: This is a note, of some description
----

Obviously, change the text to suit your needs.

The wiki code of four dashes in a rown (----) is translated to an html Horizontal Rule element.

The Semi-colon/colon notation is actually a definition list, with the semi-colon representing the Definition term (html element DT) and the text after the colon representing the Definition definition (html element DD).