FORwiki:FORwiki Style Manual
From FORwiki
The FORwiki Style Manual is a set of standards for designing and writing FORwiki documents.
Contents |
General principles
The first principle of style is clarity and cohesion. Style and formatting should be consistent within an article, but obviously not necessarily throughout FORwiki as a whole. Even more, the initial formatting of an article should not be changed by another member of the FORwiki community without very good reason. In case of disagreement over the style of an article, the Administrator should revert to the initial style. Another principle is that many points of usage - such as the treatment of proper names - can be decided by the customary practice of the community. But the overriding principle of style is that articles should be written with clarity and concise. Avoid jargon, vague phrases, and unnecessary complexity.
Titles, headings, and sections
Titles
The following guidelines apply to the titles of FORwiki articles:
- Titles should match the article contents, and should not be too narrow or too broad.
- Titles should be nouns or noun phrases (nominal groups).
- Titles should be short—preferably fewer than ten words.
- Avoid special characters such as the slash (/), plus sign (+), braces ({ }), and square brackets ([ ]).
- The final visible character of a title should not be a punctuation mark, unless the punctuation is part of a name.
