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 revision
Previous revision
Next revisionBoth sides next revision
style_guidelines [2021/09/22 03:21] – [Text Content Guidelines] hogwildstyle_guidelines [2023/05/22 19:27] – [Text Content Guidelines] hogwild
Line 1: Line 1:
-====== Style Guidelines (Wiki Edits) ======+====== Style Guidelines (Wiki Editing) ======
  
 ===== 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" on the [[https://www.linksysinfo.org/index.php?forums/tomato-firmware.33/|FreshTomato Forum]], including your email address and preferred username.
  
  
 ===== Text Content Guidelines ===== ===== Text Content Guidelines =====
  
-  * 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 computingand society \\ in general, and is safer to use. +  * Some wiki readers are not fluent in English. Please, choose your words carefully. \\   \\  
-  * Avoid non-standard abbreviations/short forms. For example, don't use "FT\\ for FreshTomato. Using LAN is okay, as it'commonly known+  * Avoid abbreviations that aren't standard across the industry or in common English.   \\ For example, anyone unfamiliar with Linux/Unix will not know that "wl" indicates a wireless interface. If it's not standard across the industryexplain itUsing "LAN"for example, is okay. It'common terminology\\ \\  
-  * Avoid using the word "Note". It's overused and should be used only when  +  * Avoid the word "Note". It's overused and rarely appropriateIf the content isn't a critical warningconsider putting it in the <WikiPageName Notes> section at the bottom of the page. We are developing guidelines/standards for writing and formatting notes. \\ \\  
-  * something is unusually importantUsing it constantly makes the text  +  * Avoid underlining. It'obsolete and inappropriateAlsoresearch shows it makes things harder to read\\ \\  
-  * lose its impactand makes it more jarring to read. We'll soon decide on  +  * Please view other pages to see which types of text are capitalized and which are written in lower case. \\ \\  
-  * some guiidelines/standards for for writing/formatting notes. +  * Please use a spell checker. Firefox's spellchecker works well for this. \\ \\  
-  * Avoid using underlining. Underlining is considered obsolete. It'a throwback from typewriter times. +  * When referring to FreshTomato menus, please indicate as//Menu///Submenu// . //  For example//"Administration///Admin access"// . //\\ \\  
-  * Please keep with the standard formatting conventions being used for typesuch as (sub)Heading levels and body text.  +  * Avoid using quotation marks. They're almost never appropriate. If you're unsuredon't use them. \\ \\  
-  * Standard formatting conventions include which words are capitalized and which use lower case.  +  * Please use rounded brackets () . Square brackets are generally not appropriate here. \\ \\
-  * Please use a spell checker. Firefox'browser-based spellchecker works well for this purpose+
-  * When referring to menus, please write the text as //Menu/Submenu . //For example//Administration/Admin access .// +
-  * Avoid using quotation marks. Most of the time, they aren'appropriate. So if you're not sureleave them out+
-  * Please use rounded brackets () and not square brackets. Square brackets have special purposes which don't apply here.+
  
  
 ===== Layout/Formatting Guidelines ===== ===== Layout/Formatting Guidelines =====
  
-Following guidelines makes pages easier to understand, more pleasant to read, and eaiser on the brain and eyes.+Following style guidelines makes pages easier to understand, more pleasant to read, and easier on the brain and eyes.
  
-  * Add a meaningful title for each wiki page, and format it with the Heading1 format. +Focus on content.  Not everyone will use the same size monitor or resolution. Some use a mobile device or laptop to access the wiki. \\ Different browsers and accessibility also affect how formatting appears (such as line break). 
-  * Indicate web interface menu paths like this: "navigate to //Administration/Admin Access//." (Use / to separate //italicized// menu nodes). + 
-  * Always use the standard Tomato theme when taking screenshots. \\ {{:pasted:20210921-184547.png}} +  * Add a meaningful title for each wiki page, and format it with the Heading1 format. \\ \\  
-  * Avoid using quotation marks except where absolutely appropriateQuotation marks are rarely appropriate, and should generally only be used when quoting someone/ something directly, or when slang/colloquialisms are used. +  * Subheadings use the Heading2 format. \\ \\  
-  * Avoid underlining. It was considered obsolete since the 1980s. +  * Subheadings below that use the Heading3 format. \\ \\  
-  * Avoid using the word “NOTE”. We are considering adding NOTES section at the bottom of each page formatted with Heading2+  * Indicate web interface menu paths like this: "//Administration///Admin Access" (Use / to separate menu nodes). \\ \\  
-  * Command strings should be emboldenedlike this: **ssh root@192.168.10.1** +  * Always use the standard Tomato theme when taking screenshots. This is set in the [[admin-access|Admin Access]] menu. 
-  * Variables should be italicized.+ 
 +\\ {{:pasted:20210921-184547.png|A screenshot in the Standard Tomato theme}}  \\   \\ 
 + 
 +  * Avoid quotation marks. They are rarely appropriate, and should be used only when quoting someone/ something directly, or when slang is used. \\ \\  
 +  * Avoid underlining. It's been obsolete since the 1980s. It makes text harder to read. \\ \\  
 +  * Avoid using the word “NOTE”. There is a section titled: "<Menu name> Notes" at the bottom of most pagesPut notes there. \\ \\  
 +  * Unless they are in a code window, command strings should be set in the ''monospace'' fontor in a callout box\\ \\  
 +  * Variables should be italicized. \\ \\  
 +  * Process/Module names should be italicized to distinguish them from the main text. \\ \\  
 +  * Avoid using dividing lines. Better spacing, and other formatting methods work better. \\ \\ 
  
  
style_guidelines.txt · Last modified: 2023/07/16 18:10 by hogwild