Help:Editing: Difference between revisions
imported>Samueldr m Adds universal sections section |
imported>Samueldr Adds a tentative description for a preferred tone for articles |
||
Line 1: | Line 1: | ||
{{expansion}} | {{expansion}} | ||
== Articles tone == | |||
Use a more <em>descriptive</em> tone, where concepts and instructions are described and explained first. A <em>prescriptive</em> tone should be avoided. | |||
Here's an example: | |||
<table> | |||
<tr> | |||
<th>Prescriptive</th> | |||
<th>Descriptive</th> | |||
</tr> | |||
<tr> | |||
<td width=50% valign=top> | |||
<b>How to deal with full /boot in case of EFI</b> | |||
<p>systemd-boot (gummiboot) can't store kernels, initrd and other big stuff on root partition, so switch to grub</p> | |||
</td> | |||
<td> | |||
<b>Keeping kernels/initrd on the main partition</b> | |||
<p>For these instructions, GRUB will be required; systemd-boot cannot reference boot files from the root partition. This will differ from the default expectation of NixOS on EFI, where <tt>/boot/</tt> is the <tt>ESP</tt>. | |||
</p> | |||
</td> | |||
</tr> | |||
</table> | |||
On the prescriptive side, the title doesn't describe the achieved end-result; the text tells the reader to switch to grub without explaining what the following (elided) configuration does. | |||
== Style guide == | |||
=== Titles === | |||
* Capitalize only the first word. | |||
== Universal sections == | == Universal sections == |
Revision as of 21:45, 26 June 2018
Articles tone
Use a more descriptive tone, where concepts and instructions are described and explained first. A prescriptive tone should be avoided.
Here's an example:
Prescriptive | Descriptive |
---|---|
How to deal with full /boot in case of EFI systemd-boot (gummiboot) can't store kernels, initrd and other big stuff on root partition, so switch to grub |
Keeping kernels/initrd on the main partition For these instructions, GRUB will be required; systemd-boot cannot reference boot files from the root partition. This will differ from the default expectation of NixOS on EFI, where /boot/ is the ESP. |
On the prescriptive side, the title doesn't describe the achieved end-result; the text tells the reader to switch to grub without explaining what the following (elided) configuration does.
Style guide
Titles
- Capitalize only the first word.
Universal sections
Some pages will have sections in common. It would be wise to ensure the titles are the same across all pages.
Section | Description |
---|---|
See also | References inside and outside the wiki. Prefer textual links with a description than naked URLs. |
References | The last section, when needed, where sections will output the references.
|
Using
Resources
Mediawiki help
These documents are the upstream documentation.
Wikimedia Help
While about the wikimedia wikis, these documents may help with some peculiarities about mediawiki.