Difference between revisions of "Style Guide"
(Work in progress) |
(No difference)
|
Revision as of 00:05, 18 April 2012
This style guide represents the agreed-upon conventions of the wiki's community as to how the wiki should be constructed. It is by no means finalized and is likely subject to change as more efficient organization/design practices come about. For newer users, this should be a useful way to understand how to craft your article to meet the wiki's standards.
Categories
Pages that represent a catalog of similar articles. Can hold subcategories, and their own content.
- Mimicking Wikipedia, category pages should not contain a full length article, and at most, should simply describe what the category is for. A 'main article' should be used to describe the concept in detail.
- Ex: Category:Mythos states that it is for pages pertaining to Aetolian lore. The Mythos page gives a summary of Aetolian lore and could feature things like recommended articles, major important events (Dreikathi invasion, Grand Artifice, etc.), so on and so forth.
Subcategories
Subcategories are good! They are a way to further sort and organize information in the wiki. Subcategory is an artificial term; it is simply a category that happens to reside in another category.
- Pages should not belong to a category and one of its subcategories. If this is the case, remove all but the lowest-end category/categories.
- Ex: Asper should be categorized as an island area and a subcontinent/landmass area, but not belong to the Areas category.
Templates
We all play a text-based game via programmable clients, so the concept of templates should come naturally: they are basically functions or objects made for the wiki.
- For any complex design or snippet of information you find yourself having to write more than once, consider creating a template.
- Ex 1: Writing syntax for skills can be tedious, requiring the use of <pre> tags or something equally hideous. Instead, a {{syntax}} template saves a lot of typing, and the advantage is that you only need to modify the template to change the way syntax fields look across the entire wiki!
- Ex 2: Tables don't really count. They are about as simple as they will possibly get.