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/21 18:58] – twincam | style_guidelines [2023/05/22 19:43] – [Layout/Formatting Guidelines] -Add that wiki is based on dokuwiki ad Prosemirror, add links for both hogwild | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Style Guidelines | + | ====== Style Guidelines |
- | \\ Wiki editing requires new User credentials. Please PM @rs232 specifying your email address and preferred User name to request access. | + | ===== Wiki Editing Rights ===== |
- | \\ Add a meaningful document title using Heading1 format. | + | 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 " |
- | \\ Indicate menu paths using notation like this: " | ||
- | \\ Use the standard Tomato theme for screenshots. // | + | ===== Text Content Guidelines ===== |
- | \\ {{:pasted:20210921-184547.png}} | + | * Some wiki readers are not fluent in English. Please, choose your words carefully. |
+ | * Avoid abbreviations that aren't standard across the industry or in common English. | ||
+ | * Avoid the word " | ||
+ | * Avoid underlining. It's obsolete and inappropriate. Also, research shows it makes things harder to read. \\ \\ | ||
+ | * Please view other pages to see which types of text are capitalized and which are written in lower case. \\ \\ | ||
+ | * Please use a spell checker. Firefox' | ||
+ | * When referring to FreshTomato menus, please indicate as: // | ||
+ | * Avoid using quotation marks. They' | ||
+ | * Please use rounded brackets () . Square brackets are generally not appropriate here. \\ \\ | ||
- | \\ Avoid using quotation marks where possible. | ||
- | \\ Avoid underlining. | + | ===== Layout/ |
- | \\ Avoid using “NOTE”. | + | The FreshTomato wiki uses [[https:// |
- | \\ Command strings | + | Following style guidelines makes pages easier to understand, more pleasant to read, and easier on the brain and eyes. |
+ | |||
+ | Focus on content. | ||
+ | |||
+ | * Add a meaningful title for each wiki page, and format it with the Heading1 format. \\ \\ | ||
+ | * Subheadings use the Heading2 format. \\ \\ | ||
+ | * Subheadings below that use the Heading3 format. \\ \\ | ||
+ | * Indicate web interface menu paths like this: "// | ||
+ | * Always use the standard Tomato theme when taking screenshots. This is set in the [[admin-access|Admin Access]] menu. | ||
+ | |||
+ | \\ {{: | ||
+ | |||
+ | * Avoid quotation marks. They are rarely appropriate, | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | * Process/ | ||
+ | * Avoid using dividing lines. Better spacing, and other formatting methods work better. \\ \\ | ||