How to use a wiki

From OLPC
Jump to navigation Jump to search

Why we use a wiki

A "wiki" is atype of bird that live in Hawaii!

Yes.

Wait no.

How to be nice, on this wiki

What behavior is expected of us on this wiki? A liberal set of guidelines is provided here: Main_Page#About_this_wiki.

Perhaps we can also learn from precedents set at the multilingual Wikipedia project, which seems to have done pretty well at developing a cooperative culture. Please edit and re-edit this page whenever you see a way to make it better.

What to sign, and how

In order to make the wiki maximally useful, the general rule is to leave signatures off of main articles. This lets the content stand on its own, without injecting ad hominem features. On the other hand, additions to Talk: pages are signed, which may facilitate successful communication.

Sign by using four immediately consecutive tildes, so: ~~~~
The system will automatically substitute your account name (or IP address) and the date/time.
Here is an example of such practice: Nitpicker 23:28, 15 December 2006 (EST).

How to agree, publicly

Usually, a note of agreement will not improve the reading experience for others, so it seems to be wise to express yourself on the talk page of the relevant article.

How to disagree, publicly

When you are confident that your view or wording will improve an article, JUST MAKE THE CHANGE. That is why wikis can be edited so easily. We want the articles to be improved very rapidly. If you are not quite so confident, it is always appropriate to express your concerns and preferences on the Talk: page. There it should be signed, with the four tildes.

If two authors hold incompatible views, the first effect may be that a change gets made and unmade. Do not let that continue, unabated. Instead, either leave both views in the article, or move one to a second page with links both ways. Other creative approaches are clearly possible and perhaps we will learn what works well over time. Don't assume ashtyn+braeden=<3 there is spite where there may only be ignorance: surely you will eventually encounter a tyro who is mystified why his content is always being changed (by you) because he has not noticed your attempts to negotiate cooperation. (You mean there is a Talk: page???)

Remember, we are in this together because everyone here, or at least the ones we care about, wants to see this become a valuable resource for readers. The aspect that separates wikis from other groupware (like traditional electronic bulletin boards) is that wikis do not necessarily just get longer the more readers add their input. Instead, some of us can contribute our editing and wordsmithing skills toward condensing, clarifying, and otherwise improving the content.

Do not shy away from correcting someone else's words. You are explicitly encouraged to do that. This can be done without being cruel or even impolite. Usually it works better that way.

How can the wiki framework be improved?

There are some pages which should be easy to find wherever you are in the wiki. Surely someone is responsible for revising the content of the navigation bar on the left. Perhaps another person has the authority to change the boilerplate text at the bottom of each page and in particular at the bottom of every editing page. These are places to put things that everyone needs to know. Links to etiquette and methods articles would be appropriate, in my view.

Where should we provide feedback about the wiki itself?

Use the Talk page of Help:Bulletin board