Site Tools


style_guidelines

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
style_guidelines [2021/09/22 04:42]
hogwild [Text Content Guidelines]
style_guidelines [2021/11/12 13:54] (current)
djk44883 removed forced line breaks
Line 7: Line 7:
  
 ===== Text Content Guidelines ===== ===== Text Content Guidelines =====
-  * Many wiki readers aren't fluent in English. Choose your words carefully.  + 
-  * Avoid using specialized abbreviations that aren't standard \\ across the technology industry or in common English.\\ For example, anyone unfamiliar with Linux/Unix will not know that "wl" \\ indicates a wireless interface. Explain it, or use it only where relevant.\\ Wi-Fi, however, is a standard term across computing, and society \\ in general, and is safer to use. +  * Many wiki readers aren't fluent in English. Choose your words carefully. 
-  * Avoid non-standard abbreviations/short forms. For example, don't use \\ "FT" for FreshTomato. Using LAN is okay, as it's commonly known. +  * Avoid using specialized abbreviations that aren't standard across the technology industry or in common English. For example, anyone unfamiliar with Linux/Unix will not know that "wl" indicates a wireless interface. Explain it, or use it only where relevant. Wi-Fi, however, is a standard term across computing, and society in general, and is safer to use. 
-  * Avoid using the word "Note". It's overused and should be used only when \\ something is unusually important. Using it constantly makes the text \\ lose its impact, and makes it more jarring to read. We'll develop \\ some guiidelines/standards for writing and formatting notes.+  * Avoid non-standard abbreviations/short forms. For example, don't use "FT" for FreshTomato. Using LAN is okay, as it's commonly known. 
 +  * Avoid using the word "Note". It's overused and should be used only when something is unusually important. Using it constantly makes the text  lose its impact, and makes it more jarring to read. We'll develop some guidelines/standards for writing and formatting notes.
   * Avoid using underlining. It's obsolete and inappropriate.   * Avoid using underlining. It's obsolete and inappropriate.
-  * Please use standard formatting conventions used for type, such as \\ (Sub)heading levels and body text.  +  * Please view other pages to see what text is capitalized and what is written in lower case (small letters). 
-  * Please view other pages to see what text is capitalized \\ and hat is written in lower case (small letters).+
   * Please use a spell checker. Firefox's spellchecker works well for this.   * Please use a spell checker. Firefox's spellchecker works well for this.
-  * When referring to FreshTomato's menus, please write the text as //Menu/Submenu . //For example, //Administration/Admin access .// +  * When referring to FreshTomato's menus, please indicate as//Menu/Submenu . //  For example, //Administration/Admin access .// 
-  * Avoid using quotation marks. Most of the time, they're not appropriate. \\ If you're not sure, leave them out+  * Avoid using quotation marks. They're almost never appropriate. If you're not sure, don't use them. 
-  * Please use rounded brackets () . Square brackets are not not generally \\ appropriate here.+  * Please use rounded brackets () . Square brackets are generally not appropriate here.
  
  
style_guidelines.1632282158.txt.gz · Last modified: 2021/09/22 04:42 by hogwild