Difference between revisions of "Wiki Contribution Guidelines"

From Apache OpenOffice Wiki
Jump to: navigation, search
(proposing table layout for better comprehension)
Line 1: Line 1:
−
== The Zen of OOoWiki (OOo Wiki Contribution Rules)==
+
== OOo Wiki Contribution Rules ==
 +
 
 +
{| class="prettytable"
 +
 
 +
|- bgcolor=#ddd
 +
| 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'''
 +
| colspan=2 valign="top" |
 +
* Be constructive! Think of the problem - and think of it's solution!
 +
* But 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).
 +
* 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
 +
* 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'''
 +
| colspan=2 valign="top" |
 +
* 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!
 +
* You should make the content easy to find.
 +
* 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.
 +
 
 +
|-
 +
| valign="top" | '''Deleting Pages'''
 +
| colspan=2 valign="top" |
 +
* To '''delete''' a page (because it is spam or outdated), replace its content with <code><nowiki>{{delete}}</nowiki></code>
 +
 
 +
|-
 +
| valign="top" | '''Links & URLs'''
 +
| colspan=2 valign="top" |
 +
* Always use Wiki-Links or [[Wikipedia:Interwikimedia_link|InterWiki-Links]] when possible
 +
*: Dont 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'''
 +
| colspan=2 valign="top" |
 +
* 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).
 +
 
 +
|-
 +
| valign="top" | '''Namespaces'''
 +
| colspan=2 valign="top" |
 +
* Use the available namespaces:
 +
* 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.
 +
* Also 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.'''
 +
 
 +
|-
 +
| valign="top" | '''Advanced'''
 +
| colspan=2 valign="top" |
 +
* 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
 +
* Redirects ...
 +
 
 +
|}
  
−
; Be constructive
 
−
; Think of the reader
 
−
; But better write it down quickly than thinking too much and forgetting to write it down
 
−
: However, 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.
 
−
; 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).
 
−
; Seek the best context first
 
−
: You should make the content easy to find. Think hard about the title of the page, its very important for search.
 
−
; Embed your contribution into existing context
 
−
: Link to your page from as many related pages as possible to provide the needed context and to prevent duplication.
 
−
; Always use Wiki-Links or [[Wikipedia:Interwikimedia_link|InterWiki-Links]] when possible
 
−
: Dont use HTTP links, when Wiki-Links or [[Wikipedia:Interwikimedia_link|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.
 
−
; Use the available namespaces
 
−
: You 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. Also 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.'''
 
−
; 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
 
−
: 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!
 
−
; To delete a page (because it is spam or outdated), replace its content with <code><nowiki>{{delete}}</nowiki></code>
 
−
; Use [[:Category:Wiki_Templates|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
 
 
{{Documentation/Note|Even more detailed wiki rules can be found here: [[Wiki Administration Rules]]. However, in general you should be fine with the basic set of rules found here.}}
 
{{Documentation/Note|Even more detailed wiki rules can be found here: [[Wiki Administration Rules]]. However, in general you should be fine with the basic set of rules found here.}}
 
<noinclude>[[Category:Wiki Maintenance]][[Category:Guidelines]]</noinclude>
 
<noinclude>[[Category:Wiki Maintenance]][[Category:Guidelines]]</noinclude>

Revision as of 11:26, 22 March 2010

OOo Wiki Contribution Rules

Topic Hints Examples
General
  • Be constructive! Think of the problem - and think of it's solution!
  • But 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).
  • 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
  • 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!
Creating Pages
  • 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!
  • You should make the content easy to find.
  • 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.
Deleting Pages
  • To delete a page (because it is spam or outdated), replace its content with {{delete}}
Links & URLs
  • Always use Wiki-Links or InterWiki-Links when possible
    Dont 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 orphans easily. InterWiki-Links are easy to update, if a Wiki changes its base-URL.
Categories
  • 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).
Namespaces
  • Use the available namespaces:
  • Your bio should be on your userpage. You may redirect to it from the main-namespace.
  • Categories should be described in the Category-namespace. You may redirect to those from the main-namespace.
  • Also 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.
Advanced

Template:Documentation/Note

Retrieved from "https://wiki.openoffice.org/w/index.php?title=Wiki_Contribution_Guidelines&oldid=159835"
Personal tools