Difference between revisions of "Wiki Administration Guidelines"

From Apache OpenOffice Wiki
Jump to: navigation, search
 
(14 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{Documentation/Note|This page contains very detailed rules for the administration of the wiki and is not a required read for the average contributor. The important rules can be found at the [[Wiki Contribution Guidelines]].}} <noinclude>[[Category:Wiki Maintenance]][[Category:Guidelines]]</noinclude>
+
{{Note|This page contains very detailed rules for the administration of the wiki and is not a required read for the average contributor. The important rules can be found at the [[Wiki Contribution Guidelines]].}} <noinclude>[[Category:Wiki Maintenance]][[Category:Guidelines]]</noinclude>
 
{| class="prettytable"
 
{| class="prettytable"
 
|-
 
|-
Line 5: Line 5:
 
| style="width: auto;" | '''Hints'''  
 
| style="width: auto;" | '''Hints'''  
 
| style="width: 20em;" | '''Examples''' <!-- if needed -->
 
| style="width: 20em;" | '''Examples''' <!-- if needed -->
 +
|-
 +
| valign="top" | '''Pagename'''
 +
| valign="top" colspan="2" |
 +
* Use Subpages to group related content.
 +
* A good  name is short and descriptive. If the name is logical and easy, many more people will link to it.
 +
* A good name is more likely to look like a chapter title of a book than a complete sentence.
 +
* This Wiki allows you to create pages with a single word as a name, but try to use at least two words - we don't want to exhaust the name space :-).
 +
* Double-check WikiNames for typos - otherwise someone will create a misnamed page! Misnamed pages are bad, since linking to them requires more effort than to a logical, correct WikiName.
 +
|-
 +
| valign="top" | '''Ownership and Categories'''
 +
| valign="top" colspan="2" |
 +
* Make sure that a page is in '''at least''' one subcategory of [[:Category:Project]].
 +
* That project needs to make sure the page is maintained.
 +
* It does not have to be a direct subcategory of [[:Category:Project]]. For example: [[:Category:Writer/People]] is fine too, as it is a subcategory of [[:Category:Writer]], which is a subcategory of [[:Category:Project]].
 +
* '''Dont assign a page to multiple categories if one is an subcategories of another.''' Just use the most specific category. This eases reordering and reorganisation of categories.
 
|-
 
|-
 
| valign="top" | '''Headings'''
 
| valign="top" | '''Headings'''
 
| valign="top" colspan="2" |
 
| valign="top" colspan="2" |
 
H1 is used for the title of a wiki page. Therefore it is better to start with <code>== Heading 2 ==</code> for your own content.  
 
H1 is used for the title of a wiki page. Therefore it is better to start with <code>== Heading 2 ==</code> for your own content.  
 +
|-
 +
| valign="top" | '''Page Contents'''
 +
| valign="top" colspan="2" |
 +
* Avoid the '''"click here"''' phrase!! Don't say: "More info about etiquette can be found  '''here'''" but use "More info about etiquette can be found at DescriptiveName". This makes it easier for users who require assistive technologies to use the web page.
 +
* Use Wikilinks ([[Main Page|<nowiki>[[Main Page]]</nowiki>]]), Interwiki-Links ([[WikiPedia:Wikipedia|<nowiki>[[Wikipedia:Wikipedia]]</nowiki>]]), IDLTagExtension-Links(<nowiki><idl></nowiki><idl>com.sun.star.beans.XPropertySet</idl><nowiki></idl></nowiki>) and [[:Category:Templates for links]] whereever possible. Avoid plain old Links ([http://example.com <nowiki>[http://example.com]</nowiki>]), whereever possible.
 +
* Avoid copying and pasting other people's content unless you have permission or the content is explicitly in the public domain. If you want to quote an excerpt from other content, please attribute the original source.
 +
* Correcting typos is encouraged.
 +
* Be polite and constructive.
 +
|-
 +
| valign="top" | '''Discussion'''
 +
| valign="top" colspan="2" |
 +
If you want to comment on the page's content, do so in the '''Discussion''' tab:
 +
# Click on the '''Discussion''' tab at the top of the page
 +
# If there is already discussion on what you want to say, click on the "edit" button for that section and leave a comment ''after the existing comments.'' You can indent your comments by putting a colon (":") at the beginning of each paragraph. This is helpful when replying to previous comments.
 +
# If you are starting a new topic, click on the "+" sign near the '''edit''' tab at the top. Write the subject of your comment in the "Subject/Headline" box, and write your comment in the main text box.
 +
# ''Always sign your username in discussions. Do this automatically with four tildes <nowiki>("~~~~")</nowiki>
 +
|-
 +
| valign="top" | '''Watching Pages'''
 +
| valign="top" colspan="2" |
 +
If you keep "Watch this page" selected, it will be added to your [[Special:Watchlist|watchlist]] (no, you won't be sent e-mails when they are updated, unless you ask it to in your preferences).
 
|-
 
|-
 
| valign="top" | '''Bad Pages'''
 
| valign="top" | '''Bad Pages'''
Line 14: Line 49:
 
*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
 
*If you find a page ignoring these guidelines and you can not fix it (for example because you do not know the language) add '''<nowiki>{{PageIgnoresWikiGuidelines}}</nowiki>''' at the top of it to notify the original author.
 
*If you find a page ignoring these guidelines and you can not fix it (for example because you do not know the language) add '''<nowiki>{{PageIgnoresWikiGuidelines}}</nowiki>''' at the top of it to notify the original author.
 +
*If a page with '''<nowiki>{{PageIgnoresWikiGuidelines}}</nowiki>''' is not fixed after ~2 weeks, you may either:
 +
** mark the page for deletion with '''<nowiki>{{delete}}</nowiki>'''.
 +
** move the page to a subpage of either the original author or the last contributor, i.e. to [[User:ORIGINAL_AUTHOR/PAGENAME]] or [[User:LAST_CONTRIBUTOR/PAGENAME]]
 
| valign="top" |  
 
| valign="top" |  
 
* [[Template:PageIgnoresWikiGuidelines]]
 
* [[Template:PageIgnoresWikiGuidelines]]
Line 22: Line 60:
 
| valign="top" |  
 
| valign="top" |  
 
* [[:Category:Wiki Templates]]
 
* [[:Category:Wiki Templates]]
 +
|-
 +
| valign="top" | '''Redirects'''
 +
| valign="top" |
 +
* Check for and remove broken redirects.
 +
* Check for and remove double redirects.
 +
| valign="top" |
 +
* [[Special:BrokenRedirects]]
 +
* [[Special:DoubleRedirects]]
 
|}
 
|}
  
 
== See also ==
 
== See also ==
[[User_Experience/SOP]]
+
* [[Help:Translating]]
 +
* [[Help:Editing]]
 +
* [[Template:WikiInstructions]]
 +
* [http://meta.wikimedia.org/wiki/Help:Editing Wiki Editing Guidelines]
 +
* [[Documentation/Dashboard/Wiki Editing Policy]]
 +
* [[Documentation/Dashboard/Styles]]

Latest revision as of 10:28, 7 July 2018

Documentation note.png This page contains very detailed rules for the administration of the wiki and is not a required read for the average contributor. The important rules can be found at the Wiki Contribution Guidelines.
Topic Hints Examples
Pagename
  • Use Subpages to group related content.
  • A good name is short and descriptive. If the name is logical and easy, many more people will link to it.
  • A good name is more likely to look like a chapter title of a book than a complete sentence.
  • This Wiki allows you to create pages with a single word as a name, but try to use at least two words - we don't want to exhaust the name space :-).
  • Double-check WikiNames for typos - otherwise someone will create a misnamed page! Misnamed pages are bad, since linking to them requires more effort than to a logical, correct WikiName.
Ownership and Categories
  • Make sure that a page is in at least one subcategory of Category:Project.
  • That project needs to make sure the page is maintained.
  • It does not have to be a direct subcategory of Category:Project. For example: Category:Writer/People is fine too, as it is a subcategory of Category:Writer, which is a subcategory of Category:Project.
  • Dont assign a page to multiple categories if one is an subcategories of another. Just use the most specific category. This eases reordering and reorganisation of categories.
Headings

H1 is used for the title of a wiki page. Therefore it is better to start with == Heading 2 == for your own content.

Page Contents
  • Avoid the "click here" phrase!! Don't say: "More info about etiquette can be found here" but use "More info about etiquette can be found at DescriptiveName". This makes it easier for users who require assistive technologies to use the web page.
  • Use Wikilinks ([[Main Page]]), Interwiki-Links ([[Wikipedia:Wikipedia]]), IDLTagExtension-Links(<idl>com.sun.star.beans.XPropertySet</idl>) and Category:Templates for links whereever possible. Avoid plain old Links ([http://example.com]), whereever possible.
  • Avoid copying and pasting other people's content unless you have permission or the content is explicitly in the public domain. If you want to quote an excerpt from other content, please attribute the original source.
  • Correcting typos is encouraged.
  • Be polite and constructive.
Discussion

If you want to comment on the page's content, do so in the Discussion tab:

  1. Click on the Discussion tab at the top of the page
  2. If there is already discussion on what you want to say, click on the "edit" button for that section and leave a comment after the existing comments. You can indent your comments by putting a colon (":") at the beginning of each paragraph. This is helpful when replying to previous comments.
  3. If you are starting a new topic, click on the "+" sign near the edit tab at the top. Write the subject of your comment in the "Subject/Headline" box, and write your comment in the main text box.
  4. Always sign your username in discussions. Do this automatically with four tildes ("~~~~")
Watching Pages

If you keep "Watch this page" selected, it will be added to your watchlist (no, you won't be sent e-mails when they are updated, unless you ask it to in your preferences).

Bad Pages
  • If your page shows up in the Maintenance reports, you likely did something wrong
  • If you find a page ignoring these guidelines and you can not fix it (for example because you do not know the language) add {{PageIgnoresWikiGuidelines}} at the top of it to notify the original author.
  • If a page with {{PageIgnoresWikiGuidelines}} is not fixed after ~2 weeks, you may either:
Templates
Redirects
  • Check for and remove broken redirects.
  • Check for and remove double redirects.

See also

Personal tools