Help:Editing: Difference between revisions

From Eigenvector Research Documentation Wiki
Jump to navigation Jump to search
imported>Jeremy
No edit summary
imported>Jeremy
No edit summary
Line 24: Line 24:
* Matlab code can be provided using either:
* Matlab code can be provided using either:
** Indenting (i.e. start line with a semicolon) - use for Synopsis section and for single lines of code in description
** Indenting (i.e. start line with a semicolon) - use for Synopsis section and for single lines of code in description
** Preformatted code using either:
** Preformatted code using one of the methods below - use any time there are multiple lines of associated code shown together
*** start line with one or more space characters
*** start line with one or more space characters
*** wrap code in a <pre> </pre> tag
*** wrap code in a <pre> </pre> tag

Revision as of 16:54, 3 September 2008

This page contains editing information specific to the Eigenvector Research Documentation Wiki. For information on working with the editor see the wikEd_help page

Eigenvector Reference Manual Style Guide

The following style rules should be followed for all new reference manual entries.

  • Top-level segments get three =s ===Synopsis=== These sections include:
    • Purpose
    • Synopsis
    • Description
    • Examples
    • Options
    • Algorithm
    • See Also


  • Some standard sub-topics can be used in Description. These sections are delineated with four =s ====Inputs==== and include:
    • Inputs
    • Optional Inputs
    • Outputs
Note: These sub-topics are always plural, even if there is only one item in the list (e.g. one output)


  • Matlab code can be provided using either:
    • Indenting (i.e. start line with a semicolon) - use for Synopsis section and for single lines of code in description
    • Preformatted code using one of the methods below - use any time there are multiple lines of associated code shown together
      • start line with one or more space characters
      • wrap code in a <pre> </pre> tag


  • See Also section should list relevant similar functions and link to each function