FreshTomato Wiki

User Tools

Site Tools

Trace:
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 revision		Previous revision
Next revisionBoth sides next revision
style_guidelines [2022/02/03 16:22] – [Text Content Guidelines] hogwildstyle_guidelines [2022/02/03 16:28] – [Layout/Formatting Guidelines]-added process/module names changed code formatting hogwild
Line 3: Line 3:
 ===== Wiki Editing Rights ===== ===== Wiki Editing Rights =====
  
-To be able to edit the Wiki, you will need to get new user credentials. To request access, please send a personal message to @rs232, including your email address and preferred username.+To be able to edit the Wiki, you will need to get new user credentials. To request access, please send a personal message to user "rs232", including your email address and preferred username.
  
  
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. \\ {{:pasted:20210921-184547.png}} +  * Always use the standard Tomato theme when taking screenshots. 
-  * 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 underlining. It was considered obsolete since the 1980s. + \\\\ {{:pasted:20210921-184547.png}} 
-  * Avoid using the word “NOTE”. We are considering adding a NOTES section at the bottom of each page formatted with Heading2. + 
-  * Unless they are in a code window, command strings should be emboldened, like this: **ssh root@192.168.10.1**+ \\ 
 + 
 +  * 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 has been considered obsolete since the 1980s. 
 +  * 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 set in the ''monospace'' font, or 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

Page Tools

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki