Sauerbraten Wiki Guidelines


Usage


From Aardappels post on the cube forum.

"Do not be afraid to refactor things. Sofar it seems people just ADD to the wiki, and leave what is there in place. One of the ideas behind a wiki is that its easy to reorganize the soup of data. If you add something that makes the structure of the document less than ideal, do not be afraid to restructure other peoples text into a different set of pages and links. Do not be afraid to even delete other people's text, once you conclude it has become redundant. The original structure was just me making some example pages, it may not be ideal for the current contents anymore.

Feel free to discuss in this thread if you have major restructurings in mind, or certain conventions.

Don't let pages grow to huge amounts of text, wiki's are best when they are small sections of text per page, but HEAVILY linked.

In that same way, one of the goals of the wiki is to function as a FAQ, so if we get the 1001th post on "your server did not reply to ping" we can point people to exactly one wiki page that has all the firewall tutorials you could ever wish for.

Some stuff on the wiki is straight out of the main documentation. Duplication is not good, it means if I update the main documentation the wiki instantly contains outdated information. Since the wiki is more for FAQ/tutorial kinda stuff, and the docs more for hardcore factual reference, it is good to have each section of the wiki refer to pages in the docs where the exact command reference related to the topic can be found.

If you know of topics that have been discussed on this forum before, it is really helpfull to find these threads, and make a wikipage out of the most explanatory posts. Infact, maybe I should be typing this post in the wiki rather than on the forum, it is getting rather long... :)

If additional people want editing access, apply for it on the wiki page.

I will make sure it is linked from the various web pages soon, that should ensure more traffic."


drian's formatting suggestion


To ensure a common text formatting on this wiki, we all should follow some basic rules. My suggestion:


You might want to look at a sample text.