|
|
| (8 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| {{expansion}}
| | #Redirect [[Manual of Style]] |
| | |
| == 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 ==
| |
| | |
| Some pages will have sections in common. It would be wise to ensure the titles are the same across all pages.
| |
| | |
| {| class="table" border="1"
| |
| |-
| |
| ! 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 <code><cite /></code> sections will output the references.
| |
| |}
| |
| | |
| == Using <code><cite /></code> ==
| |
| | |
| {{expansion|Look at the mediawiki documentation meanwhile!}}
| |
| | |
| == See also ==
| |
| | |
| * [https://www.mediawiki.org/wiki/Help:Formatting Help:Formatting, MediaWiki], the upstream documentation.
| |
| * [https://en.wikibooks.org/wiki/Editing_Wikitext Editing Wikitext, Wikibooks], a book about editing wikitext.
| |
| * [https://meta.wikimedia.org/wiki/Help:Section Help:Sections, Wikimedia]. While about the wikimedia wikis, these documents may help with some peculiarities about mediawiki.
| |
