Site Tools


style_guidelines

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revisionBoth sides next revision
style_guidelines [2022/02/03 16:23] – [Wiki Editing Rights]-removed @ sign from rs232-not appropriate here hogwildstyle_guidelines [2022/02/03 16:28] – [Layout/Formatting Guidelines]-added process/module names changed code formatting hogwild
Line 27: Line 27:
   * Subheadings use the Heading2 format.   * Subheadings use the Heading2 format.
   * Subheadings below that use the Heading3 format.   * Subheadings below that use the Heading3 format.
-  * Indicate web interface menu paths like this: "navigate to //Administration/Admin Access//." (Use / to separate //italicized// menu nodes).+  * Indicate web interface menu paths like this: "//Administration/Admin Access//." (Use / to separate //italicized// menu nodes).
   * Always use the standard Tomato theme when taking screenshots.   * Always use the standard Tomato theme when taking screenshots.
  
Line 34: Line 34:
  \\  \\
  
-  * Avoid using quotation marks except where absolutely appropriate. Quotation marks are rarely appropriate, and should generally only be used when quoting someone/ something directly, or when slang/colloquialisms are used. +  * Avoid using quotation marks except where absolutely appropriate. Quotation marks are rarely appropriate, and should generally only be used when quoting someone/ something directly, or when slang/colloquialisms are used. In general, slang has no place on a technical wiki
-  * Avoid underlining. It was considered obsolete since the 1980s. +  * Avoid underlining. It has been considered obsolete since the 1980s. 
-  * Avoid using the word “NOTE”. We are considering adding NOTES section at the bottom of each page formatted with Heading2+  * Avoid using the word “NOTE”. There is a section titled "<Menu name> Notes" at the bottom of most pages
-  * Unless they are in a code window, command strings should be emboldenedlike this: **ssh root@192.168.10.1**+  * Unless they are in a code window, command strings should be set in the ''monospace'' fontor in a callout box.
   * Variables should be italicized.   * Variables should be italicized.
 +  * Process/Module names should be italicized to set them off from the main text. 
   * Avoid using dividing lines. Better spacing, and other formatting methods work better.   * Avoid using dividing lines. Better spacing, and other formatting methods work better.
  
  
style_guidelines.txt · Last modified: 2023/07/16 18:10 by hogwild