Wiki Policy

From Open Source Ecology
Revision as of 00:52, 22 February 2011 by Rasmus (talk | contribs)
Jump to navigation Jump to search

Introduction

The wiki is a place where a large number of people can contribute to content generation and organization. In the ideal situation - a large messy hairball of input is organized into distilled, high quality content. An intricate process is required for this to happen, and it is the goal of this wiki policy to bring this about. A successfully-implemented wiki has the capacity to create order out of chaos - a capacity to self-organize under the guidance of clear procedures in the hands of wiki curators. For the OSE Wiki, please read the Crash Course to understand the underlying intentions. Read also the Wiki Transparency Policy

Wiki Login Access

Read our Wiki Login Policy

Moderation Team

A moderation team is the core of a successful wiki. For best results, moderation roles should be defined and moderators should be identified.

Here is a list of the proposed Wiki Curators - listing the curator's area of responsibility.

Development Team

  • Any person contributing to the project in a substantial way should fill out the Team Culturing survey, and therefore, any name should be linkable with a full description of the person, such as Marcin Jakubowski. This will facilitate referencing and connection between projects and developers. The potential contributions of a person should be transparent if they fill out their abilities in the Team Culturing Survey.

Structuring

  • Categorize pages using the official list of categories. Stick to these categories where possible; don't create new categories unless there is a real need.
  • Categorize pages by putting that category's template at the top. At the top of a page about beekeeping, you would write {{Category=Beekeeping}}. This will do two things: insert a navigation menu at the top, and put the page in the appropriate wiki category.

Style guidelines

  • Be direct and practical
    • Avoid acronyms, jargon and neologisms.
    • Never use a long word or phrase where a short one will do.
    • If it is possible to cut a word out, cut it out.
    • Never use the passive where you can use the active (e.g. say "We built the house on Tuesday" rather than "The construction of the house took place on Tuesday".)
    • Never use a foreign phrase, a scientific word, or a jargon word if you can think of an everyday English equivalent.
    • Break any of these rules sooner than say anything outright barbarous.
  • The first sentence of an article should be a one-sentence summary of the whole topic
    • The next paragraph should be a longer summary of it
    • Then go into details
  • When writing about measurements, list both imperial and metric values. List both Fahrenheit and Celsius for temperatures.