Difference between revisions of "Wiki Contribution Guidelines"
From Apache OpenOffice Wiki
m (moved OOo Wiki Contribution Rules to Wiki Contribution Guidelines: According to discussion on ux-discuss) |
(Restructured page) |
||
Line 1: | Line 1: | ||
− | + | This page is about the experience for for both the authors and the readers of the OpenOffice.org Wiki. Think of the "Zen for the OpenOffice.org Wiki" to make it clean, helpful and beautiful. | |
− | + | There are several sets ... starting with essential ones up to the administration guidelines. | |
− | + | ||
− | + | ||
− | + | ||
− | == | + | == Essential Guidelines<br> == |
− | + | *Categorize your wiki pages | |
+ | *Use many wiki-links between your pages | ||
+ | *Avoid redirecting to the main-namespace from out of it | ||
+ | *Keep drafts on your [[Special:MyPage|userpage]] | ||
− | + | == Standard Guidelines<br> == | |
− | + | ||
− | + | ||
− | + | ||
+ | {| class="prettytable" | ||
+ | |- | ||
+ | | style="width: 12em; padding-top: 0.5em; padding-bottom: 0.5em;" | '''Topic''' | ||
+ | | style="width: 50%;" | '''Hints''' | ||
+ | | style="width: auto;" | '''Examples''' <!-- if needed --> | ||
|- | |- | ||
− | | valign="top" | '''General''' | + | | valign="top" | '''General''' |
− | | | + | | valign="top" colspan="2" | |
− | * Be constructive! Think of the problem - and think of its solution! | + | *Be constructive! Think of the problem - and think of its solution! |
− | * Think of the reader, too! | + | *Think of the reader, too! |
− | * Don't hesitate! Better write down something quickly than thinking too much and forgetting to write it down. Put drafts into your userspace (see below). | + | *Don't hesitate! Better write down something quickly than thinking too much and forgetting to write it down. Put drafts into your userspace (see below). |
− | * Be open to (early or late) changes to your contribution; don't blame others, think of the best solution to the problem. | + | *Be open to (early or late) changes to your contribution; don't blame others, think of the best solution to the problem. |
− | * If nobody contributes, maybe it's good; if myriads of people change your contribution, it might be better. | + | *If nobody contributes, maybe it's good; if myriads of people change your contribution, it might be better. |
− | * The real measure of a page is the number of page accesses shown at the bottom. To get a higher number of accesses add relevant links to your content and add categories! | + | *The real measure of a page is the number of page accesses shown at the bottom. To get a higher number of accesses add relevant links to your content and add categories! |
|- | |- | ||
− | | valign="top" | '''Creating Pages''' | + | | valign="top" | '''Creating Pages''' |
− | | | + | | valign="top" colspan="2" | |
− | * When doing '''drafts''', do those on your User-page. Use it as your sandbox. See for example [[User: | + | *When doing '''drafts''', do those on your User-page. Use it as your sandbox. See for example [[User:B michaelsen]], esp. the staging area. You are not required to add tight categories and context links on your userpage. |
− | * Think hard about the '''title''' of the page, its very important for search. Avoid Typos in the title! | + | *Think hard about the '''title''' of the page, its very important for search. Avoid Typos in the title! |
− | * You should make the content easy to find. | + | *You should make the content easy to find. |
− | * Embed your contribution into existing content. | + | *Embed your contribution into existing content. |
− | *: Link to your page from as many related pages as possible to provide the needed context and to prevent duplication. | + | *:Link to your page from as many related pages as possible to provide the needed context and to prevent duplication. |
|- | |- | ||
− | | valign="top" | '''Deleting Pages''' | + | | valign="top" | '''Deleting Pages''' |
− | | | + | | valign="top" colspan="2" | |
− | * To '''delete''' a page (because it is spam or outdated), replace its content with <code><nowiki>{{delete}}</nowiki></code> | + | *To '''delete''' a page (because it is spam or outdated), replace its content with <code><nowiki>{{delete}}</nowiki></code> |
− | |- | + | |- |
− | | valign="top" | '''Links & URLs''' | + | | valign="top" | '''Links & URLs''' |
− | | | + | | valign="top" colspan="2" | |
− | * Always use Wiki-Links or [[ | + | *Always use Wiki-Links or [[wikipedia:Interwikimedia%20link|InterWiki-Links]] when possible |
− | *: Don't use HTTP links, when Wiki-Links or InterWiki-Links are possible. HTTP links do not show up in "What links here" list for example, making pages [[Special:LonelyPages|orphans]] easily. InterWiki-Links are easy to update, if a Wiki changes its base-URL. | + | *:Don't use HTTP links, when Wiki-Links or InterWiki-Links are possible. HTTP links do not show up in "What links here" list for example, making pages [[Special:LonelyPages|orphans]] easily. InterWiki-Links are easy to update, if a Wiki changes its base-URL. |
|- | |- | ||
| valign="top" | '''Categories''' | | valign="top" | '''Categories''' | ||
− | | | + | | valign="top" colspan="2" | |
− | * Always add new pages a existing category | + | *Always add new pages a existing category |
− | *: This is very important to keep the wiki maintainable. Non-English content should always be sorted in the category of the language (or one of its subcategories). If you want to create a new category, you will need to add that to an existing category too (making it a subcategory). | + | *:This is very important to keep the wiki maintainable. Non-English content should always be sorted in the category of the language (or one of its subcategories). If you want to create a new category, you will need to add that to an existing category too (making it a subcategory). |
|- | |- | ||
− | | valign="top" | '''Namespaces''' | + | | valign="top" | '''Namespaces''' |
− | | | + | | valign="top" colspan="2" | |
− | * Use the available namespaces: | + | *Use the available namespaces: |
− | * Your bio should be on your [[User:YourLogin|userpage]]. You may redirect to it from the main-namespace. | + | *Your bio should be on your [[User:YourLogin|userpage]]. You may redirect to it from the main-namespace. |
− | * Categories should be described in the [[:Category:MainIndex|Category-namespace]]. You may redirect to those from the main-namespace. | + | *Categories should be described in the [[:Category:MainIndex|Category-namespace]]. You may redirect to those from the main-namespace. |
− | * Use the Talk:-namespace to discuss pages and explain why you wrote something. | + | *Use the Talk:-namespace to discuss pages and explain why you wrote something. |
− | * '''Never redirect to the main-namespace from the category- or the user-namespace.''' | + | *'''Never redirect to the main-namespace from the category- or the user-namespace.''' |
|- | |- | ||
− | | valign="top" | '''Advanced''' | + | | valign="top" | '''Advanced''' |
− | | | + | | valign="top" colspan="2" | |
− | * Use [[:Category: | + | *Use [[:Category:Wiki Templates|Wiki templates]]! |
− | * [[ | + | *[[wikipedia:Wikipedia:Transclusion|Transclusion]] is great. Use it! |
− | * If your page shows up in the [[Special:SpecialPages|Maintenance reports]], you likely did something wrong | + | *If your page shows up in the [[Special:SpecialPages|Maintenance reports]], you likely did something wrong |
− | * Redirects ... | + | *Redirects ... |
|} | |} | ||
− | + | ||
− | + | == Advanced Guidelines == | |
− | <noinclude>[[Category:Wiki Maintenance]][[Category:Guidelines]]</noinclude> | + | |
+ | You are a wiki administrator? Then you might be interested in the [[Wiki Administration Guidelines]]. | ||
+ | |||
+ | == Topic Related Guidelines == | ||
+ | |||
+ | [[Help:Translating|Translations have some additional rules.]] | ||
+ | |||
+ | <br> <noinclude>[[Category:Wiki Maintenance]][[Category:Guidelines]]</noinclude> |
Revision as of 21:57, 22 March 2010
This page is about the experience for for both the authors and the readers of the OpenOffice.org Wiki. Think of the "Zen for the OpenOffice.org Wiki" to make it clean, helpful and beautiful.
There are several sets ... starting with essential ones up to the administration guidelines.
Contents
Essential Guidelines
- Categorize your wiki pages
- Use many wiki-links between your pages
- Avoid redirecting to the main-namespace from out of it
- Keep drafts on your userpage
Standard Guidelines
Topic | Hints | Examples |
General |
| |
Creating Pages |
| |
Deleting Pages |
| |
Links & URLs |
| |
Categories |
| |
Namespaces |
| |
Advanced |
|
Advanced Guidelines
You are a wiki administrator? Then you might be interested in the Wiki Administration Guidelines.
Topic Related Guidelines
Translations have some additional rules.