|
⇤ ← Revision 1 as of 2007-10-28 00:50:43
Size: 1443
Comment: Move from RewriteGoals and flesh out
|
Size: 1392
Comment: Remove stray text
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 45: | Line 45: |
| It would probably be best to use "you" (second-person) when writing the MemberManual. | It would be best to use "you" (second-person) when writing the MemberManual. |
| Line 47: | Line 47: |
| The AdminManual (basically just a re-org of NewServerSetup) should be in third-person. | For other pages, it probably doesn't matter. |
This page explains the considerations that should be taken when writing pages in the HCoop wiki.
Template
Here's a basic template to apply when making new pages and revising old ones.
Description of page. I.e.: This page describes how to filter your email using procmail and Exim. ## Every page should have a table of contents [[TableOfContents]] Remaining content of page, split into logical sections.
Section numbers
The following text, when placed at the beginning of a page, turns off numbering of headings.
#pragma section-numbers off
This should be used:
- If the page is the main page, or exactly one degree away from it, then you should include the following text at the very top of the page.
On multi-page guides, such as DomTool.
- On other pages at the discretion of those who keep the wiki up-to-date.
Level of headings
If section numbers are turned off, then start with first-level headings.
If section numbers are left on, then start with second-level headings. The reason for this is that the numbers in front of first-level headings look ugly and distract from the content of the page.
Writing style
It would be best to use "you" (second-person) when writing the MemberManual.
For other pages, it probably doesn't matter.