This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
style_guidelines [2021/09/22 03:05] – [Layout/Formatting Guidelines] hogwild | style_guidelines [2023/07/16 18:05] – [Text Content Guidelines] -add to surround filenames with quotation marks 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:// |
===== Text Content Guidelines ===== | ===== Text Content Guidelines ===== | ||
- | * Avoid using specialized | + | |
- | * For example, | + | |
- | * On the other hand, Wi-Fi is a standard | + | * Avoid the word " |
- | * Avoid non-standard abbreivations/ | + | * Avoid underlining. It' |
- | * Avoid use of the word " | + | * Please |
- | * Avoid using underlining. Underlining is considered obsolete. It' | + | * Please use a spell checker. Firefox' |
- | * Please | + | * When referring to FreshTomato |
- | * Standard formatting conventions include which words are capitalized and which use lower case. | + | * Avoid using quotation marks, |
- | * Please use a spell checker. Firefox' | + | * Please surround filenames with double quotation marks. For example, " |
- | * When referring to menus, please | + | * Please use rounded brackets () . Square brackets |
- | * Avoid using quotation marks. Most of the time, they aren't appropriate. | + | |
- | * Please use rounded brackets () and not square brackets. Square brackets | + | |
===== Layout/ | ===== Layout/ | ||
- | Following guidelines makes the wiki easier to understand, | + | Following |
- | | + | The FreshTomato wiki uses [[https:// |
- | * Indicate web interface menu paths like this: "navigate | + | |
- | * Always use the standard | + | Focus on content. |
- | | + | |
- | * Avoid using quotation marks except where absolutely appropriate. Quotation marks are rarely appropriate, and should | + | \\ |
- | * Avoid underlining. It was considered | + | |
- | * Avoid using the word “NOTE”. | + | |
- | * Command | + | * Subheadings use the Heading2 format. \\ \\ |
- | * Variables should be italicized. | + | * Subheadings below that use the Heading3 format. \\ \\ |
+ | * Indicate web interface menu paths using the name of the menu, unless there is another menu with a similar name. | ||
+ | * For example, you can refer to the Admin Access menu. However... | ||
+ | * You should add a "/" and top node when referring | ||
+ | * Always use the "Tomato" | ||
+ | |||
+ | \\ {{: | ||
+ | |||
+ | * Avoid quotation marks. | ||
+ | * When slang is used. | ||
+ | * When expressing, something precise separate from the text body, such as a filesystem path. \\ \\ | ||
+ | * Avoid underlining. It's been obsolete since the 1980s. | ||
+ | * Avoid using the word “NOTE”. | ||
+ | * Unless they are in a code window, command | ||
+ | * Variables should be italicized. | ||
+ | * Process/ | ||
+ | * Avoid using dividing lines. They are mostly obsolete. Better spacing, and modern formatting methods work better. \\ \\ | ||