Manual of Style: Difference between revisions
3 / X (sentence case for the MoS) |
4 / X |
||
| Line 245: | Line 245: | ||
** Use numerals for 10 and above. | ** Use numerals for 10 and above. | ||
** Use commas for numbers with four or more digits (e.g., 1,000, 10,000). | ** Use commas for numbers with four or more digits (e.g., 1,000, 10,000). | ||
** Use dots as decimal separator (e.g. 1,000.23 ) | |||
** For very large numbers, consider using words (e.g., 1 million instead of 1,000,000). | ** For very large numbers, consider using words (e.g., 1 million instead of 1,000,000). | ||
| Line 257: | Line 258: | ||
** Include the time zone when relevant (e.g., 14:30 UTC). | ** Include the time zone when relevant (e.g., 14:30 UTC). | ||
* <strong> | * <strong>Software versions:</strong> | ||
** | ** Software versions are subject to change. Only add software versions when required by the content. | ||
==== Abbreviations ==== | ==== Abbreviations ==== | ||
| Line 343: | Line 344: | ||
When using these terms: | When using these terms: | ||
* Be consistent in capitalization (e.g., always "NixOS", never "Nixos" or "NIXOS"). | * Be consistent in capitalization (e.g., always "NixOS", never "Nixos" or "NIXOS"). | ||
* Use the full term on first mention, followed by any abbreviation in parentheses if it will be used later. | * Use the full term on first mention, followed by any abbreviation in parentheses if it will be used later. | ||
| Line 356: | Line 356: | ||
* Use double square brackets to create a wikilink: <syntaxhighlight lang="mediawiki">[[Page Name]]</syntaxhighlight> | * Use double square brackets to create a wikilink: <syntaxhighlight lang="mediawiki">[[Page Name]]</syntaxhighlight> | ||
* If the link text should differ from the page name, use a pipe character: <syntaxhighlight lang="mediawiki">[[Page Name|displayed text]]</syntaxhighlight> | * If the link text should differ from the page name, use a pipe character: <syntaxhighlight lang="mediawiki">[[Page Name|displayed text]]</syntaxhighlight> | ||
* For section links, use a hash symbol: <syntaxhighlight lang="mediawiki">[[Page Name#Section Name]]</syntaxhighlight> | * For section links, use a hash symbol. Please note: Section headings are sometimes changed during editing - it may be overlooked to change all the necessary references to them as well. Section links should therefore be used sparingly: <syntaxhighlight lang="mediawiki">[[Page Name#Section Name]]</syntaxhighlight> | ||
==== External linking ==== | ==== External linking ==== | ||
| Line 393: | Line 393: | ||
Proper image file naming helps with organization and searchability: | Proper image file naming helps with organization and searchability: | ||
* '''Descriptive names:''' Use clear, descriptive file names (e.g., " | * '''Descriptive names:''' Use clear, descriptive file names (e.g., "nixos-installation-partitioning.png"). | ||
* '''Lowercase:''' Use lowercase letters to avoid case-sensitivity issues. | * '''Lowercase:''' Use lowercase letters to avoid case-sensitivity issues. | ||
* '''Hyphens:''' Use hyphens (-) to separate words, not underscores or spaces. | * '''Hyphens:''' Use hyphens (-) to separate words, not underscores or spaces. | ||