Some information about “how to style pages” - for consistency.
NO, you won't be banned for breaking these.
The following information discussed the overall structure and implementation of the Wiki pages.
A couple of very general points about the Wiki:
The new structure for the wiki is split into 4 sections:
The Sworn book of Scorn - mechanics - includes all aspects of game play such as map data, arc data and in game features and formulas that affect players. This includes
The Sworn Book of Scorn section was created by saru and feedback can be directed to him. Every attempt to incorporate existing information neatly into this section has been made, however, there are still vast areas that require completing. The orphans_and_missing page is an excellent place to find pages that need more information.
“But all this information should be available in game, players should just play more.”
Whilst it is true that Crossfire should provide players with all the information they need to understand and succeed, for a variety of reasons this is not always the case:
Some of these pages can be considered spoilers and there is a fine line between explaining how something works and giving something away. Avoiding including spoilers in The Sworn book of Scorn can best be avoided by:
|Avoid long pages filled with “everything you ever needed to know about blah”||Instead split information up into very specific pieces. Put a summary paragraph at the top explaining what readers will learn from that page. In this manner players can search for the particular information they are stuck on (for example, what is my damage not going up when I increase DEX, what does this monster seem to never die when I cast this spell at it) without stumbling upon things they didn't intend to read.|
|Do not include specific advice about maps or scenarios||Avoid giving away the game by including information that was never intended to be revealed in game unless there is no other way around it. For example, do not explain that the secret key to get into the room filled with wonderful treasure is hiding under a bush at coordinates x and y.|
|Stick to the facts||Do not provide opinion such as 'this item is regarded as the best' or 'this map is rarely visited because it is hard and has little reward'. The place for opinion and guidance is in the guides section of help/Support|
This section is for all information that helps new players get access to and learn how to play crossfire. Some tips for adding information to this section:
This document is a one size fits all go to for common questions. This is also often a first touch point for visitors so care in making sure the information is accurate and relevant is critical. Wherever possible link to other sections of the help/support section to provide more detailed answers if it is possible they may need it. Thought should go into why things are in the FAQ (e.g. problems that can't be avoided such as operating system bugs) and this document should be kept as short as possible.
This probably should directly link to the crossfire website.
All information related to supporting players get their particular client running on their particular system. For example platform specific advice can be given here.
All information related to supporting players get their servers running. It should be noted that the general preference is to put newer players onto an existing server before attempting to run their own.
Anything related to getting players up and running in game belongs in here. There really shouldn't be guides in here explaining how to level fast or become super powerful, isn't that the fun part of working out Crossfire for yourself?
Crossfire is a fun project to play and develop. These are pages to convey this.
Dev - These pages are focused on development in crossfire. Developers be Here, This is the wilds, enter at your own risk!
Generally speaking, any time a list of steps or content needs to be followed in a specific order - use a ordered (numbered, alphabetized, etc. list)
Anytime the context can be taken out of order and still make logical sense, use an unorderd list or bullet points.
This is based off the Docbook guidelines, http://i18n.kde.org/docs/markup/lists.html
If a page is about a certain map, the page should be located within a namespace named after the region(s) the map is located in. This should prevent confusion if two maps are similarly named, as an example: dragon guild in Scorn (/scorn/misc/dragon_guild) and the dragon guild in Navar (/navar_city/misc/dragon_guild).
If a map is part of a dungeon (or similarly sized map set), please try to keep everything about the dungeon (or map set) on one page.