Difference between revisions of "ArchWiki:Contributing"

From ArchWiki
Jump to: navigation, search
(use https for links to archlinux.org)
m (simpler wording)
Line 18: Line 18:
 
See the [[:Category:Help|help category]] for all help articles.
 
See the [[:Category:Help|help category]] for all help articles.
  
==Content creation==
+
== Easy to start jobs ==
 +
Here are some jobs which are easy for new comers. You can try out these jobs first and then move on to more difficult ones.
 +
 
 +
=== Fix double redirects pages===
 +
What to do:
 +
# Read [[Help:Editing#Redirects|this section]] to understand what redirect is.
 +
# Check out [[Special:DoubleRedirects]] page to find out if there exits any double redirects.
 +
# For example, if you see {{ic|Pastebin Clients (Edit) →‎ Common Applications →‎ List of Applications}}, it means [[Pastebin Clients]] is a redirect to [[Common Applications]], [[Common Applications]] it also an redirect to page [[List of Applications]]. Thus [[Pastebin Clients]] is a double redirects page.
 +
# To fix it, just click the {{ic|Edit}} link at the right of [[Pastebin Clients]]. Change {{ic|<nowiki>#REDIRECT [[Common Applications]]</nowiki>}} to {{ic|<nowiki> #REDIRECT [[List of Applications]]</nowiki>}}
 +
# Save the page with a Edit summary such as "Fix double redirects". Then you are done.
 +
 
 +
==Creating==
 
Ensure you understand the philosophy of ArchWiki and think about what others may want to read (see [[ArchWiki:Requests]] for ideas). As mentioned, the wiki's scope is quite wide.  
 
Ensure you understand the philosophy of ArchWiki and think about what others may want to read (see [[ArchWiki:Requests]] for ideas). As mentioned, the wiki's scope is quite wide.  
  
 
Talk to the [[ArchWiki:Administrators|admins]] for help coordinating major projects.
 
Talk to the [[ArchWiki:Administrators|admins]] for help coordinating major projects.
  
==Content improvement==
+
==Improving==
 
Content editing, proofreading, and updating are never-ending tasks on any wiki. If you want to help, just register an account and start performing your magic.
 
Content editing, proofreading, and updating are never-ending tasks on any wiki. If you want to help, just register an account and start performing your magic.
  
Line 31: Line 42:
 
* Update the [[FAQ]] with relevant questions from the forum and remove obsolete questions.
 
* Update the [[FAQ]] with relevant questions from the forum and remove obsolete questions.
  
==Content maintenance==
+
==Maintenance==
 
* Help patrolling the [[Special:RecentChanges|Recent Changes]], fixing [[ArchWiki:Reports|questionable edits]] and reporting [[ArchWiki:Spam|spam]].
 
* Help patrolling the [[Special:RecentChanges|Recent Changes]], fixing [[ArchWiki:Reports|questionable edits]] and reporting [[ArchWiki:Spam|spam]].
 
* Flag articles with appropriate [[:Category:Template#Article status templates|article status templates]], like {{Ic|<nowiki>{{Deletion}}</nowiki>}}, {{Ic|<nowiki>{{Out of date}}</nowiki>}}, {{Ic|<nowiki>{{Accuracy}}</nowiki>}}, etc.
 
* Flag articles with appropriate [[:Category:Template#Article status templates|article status templates]], like {{Ic|<nowiki>{{Deletion}}</nowiki>}}, {{Ic|<nowiki>{{Out of date}}</nowiki>}}, {{Ic|<nowiki>{{Accuracy}}</nowiki>}}, etc.
Line 37: Line 48:
 
* Participate in discussions in the various talk pages: most users will be interested in following the most recent posts to generic discussions at [https://wiki.archlinux.org/index.php?namespace=1&title=Special%3ARecentChanges this link]. Maintenance-specific posts are instead listed in [https://wiki.archlinux.org/index.php?namespace=13&title=Special%3ARecentChanges], [https://wiki.archlinux.org/index.php?namespace=11&title=Special%3ARecentChanges], [https://wiki.archlinux.org/index.php?namespace=5&title=Special%3ARecentChanges] and [https://wiki.archlinux.org/index.php?namespace=15&title=Special%3ARecentChanges]; furthermore, [[ArchWiki:Requests]] is used as a talk page despite its namespace.
 
* Participate in discussions in the various talk pages: most users will be interested in following the most recent posts to generic discussions at [https://wiki.archlinux.org/index.php?namespace=1&title=Special%3ARecentChanges this link]. Maintenance-specific posts are instead listed in [https://wiki.archlinux.org/index.php?namespace=13&title=Special%3ARecentChanges], [https://wiki.archlinux.org/index.php?namespace=11&title=Special%3ARecentChanges], [https://wiki.archlinux.org/index.php?namespace=5&title=Special%3ARecentChanges] and [https://wiki.archlinux.org/index.php?namespace=15&title=Special%3ARecentChanges]; furthermore, [[ArchWiki:Requests]] is used as a talk page despite its namespace.
  
==Content organization==
+
==Organizing==
 
Sorting, categorizing, and moving articles around has become a major task for all wiki maintainers implementing and improving the [[Table of Contents|category tree]].
 
Sorting, categorizing, and moving articles around has become a major task for all wiki maintainers implementing and improving the [[Table of Contents|category tree]].
  
Line 46: Line 57:
 
* See [[Special:SpecialPages]] for other useful cleanup tools.
 
* See [[Special:SpecialPages]] for other useful cleanup tools.
  
==Content translation==
+
==Translating==
 
[[Special:WhatLinksHere/Template:Translateme|Add]] or [[Special:WhatLinksHere/Template:Bad translation|improve]] translations; ensure that translations are in sync with each other. Some languages have started collaboration projects (see list below) to efficiently organize the translation of the articles. Please consider joining your language's Translation Team or at least informing it when you are starting translating an article.  
 
[[Special:WhatLinksHere/Template:Translateme|Add]] or [[Special:WhatLinksHere/Template:Bad translation|improve]] translations; ensure that translations are in sync with each other. Some languages have started collaboration projects (see list below) to efficiently organize the translation of the articles. Please consider joining your language's Translation Team or at least informing it when you are starting translating an article.  
 
* [[ArchWiki Translation Team]]
 
* [[ArchWiki Translation Team]]
Line 62: Line 73:
 
==Back-end maintenance==
 
==Back-end maintenance==
 
Use the [https://bugs.archlinux.org/ Arch Linux Bugtracker] to report bugs and contribute fixes and improvements to the MediaWiki codebase.
 
Use the [https://bugs.archlinux.org/ Arch Linux Bugtracker] to report bugs and contribute fixes and improvements to the MediaWiki codebase.
 
== Easy to start jobs ==
 
Here are some jobs which are easy for new comers. You can try out these jobs first and then move on to more difficult ones.
 
 
=== Fix double redirects pages===
 
What to do:
 
# Read [[Help:Editing#Redirects|this section]] to understand what redirect is.
 
# Check out [[Special:DoubleRedirects]] page to find out if there exits any double redirects.
 
# For example, if you see {{ic|Pastebin Clients (Edit) →‎ Common Applications →‎ List of Applications}}, it means [[Pastebin Clients]] is a redirect to [[Common Applications]], [[Common Applications]] it also an redirect to page [[List of Applications]]. Thus [[Pastebin Clients]] is a double redirects page.
 
# To fix it, just click the {{ic|Edit}} link at the right of [[Pastebin Clients]]. Change {{ic|<nowiki>#REDIRECT [[Common Applications]]</nowiki>}} to {{ic|<nowiki> #REDIRECT [[List of Applications]]</nowiki>}}
 
# Save the page with a Edit summary such as "Fix double redirects". Then you are done.
 

Revision as of 14:03, 2 January 2013

ArchWiki strives to be a clear, comprehensive and professional model of documentation. In order to reach that goal we have to organize the job in a rational and functional way: this article tries to explain schematically what are the most important tasks you can give your help to accomplish.

This is a community effort, but if you take on the task seriously, a formal position as a wiki maintainer may be in order.

Note: Always use the Edit Summary when editing articles, see Help:Style#Edit summary. If you intend to perform large changes that involve several articles, please discuss your plans first in an appropriate discussion page.

Prerequisite

Here is a list of pages contain information needed for contributing.

  • Article Naming Guidelines discusses effective article naming strategies and considerations to ensure readability and improve navigation of the wiki. Read it before creating any new page.
  • Help:Editing outlines both widely-known MediaWiki markup and ArchWiki-specific guidelines. A must-read for any would-be contributors.
  • Help:Style gives guidelines for the standardization of style in ArchWiki articles.
  • Help:Category explain how to set page category, how to create missing categories pages and how to move a page to a different category.
  • ArchWiki Translation Team has a step by step introduction for creating a new translation page. Follow it to translate pages to your own language.
  • Help:i18n serves as a comprehensive guideline for ArchWiki internationalization and localization.

See the help category for all help articles.

Easy to start jobs

Here are some jobs which are easy for new comers. You can try out these jobs first and then move on to more difficult ones.

Fix double redirects pages

What to do:

  1. Read this section to understand what redirect is.
  2. Check out Special:DoubleRedirects page to find out if there exits any double redirects.
  3. For example, if you see Pastebin Clients (Edit) →‎ Common Applications →‎ List of Applications, it means Pastebin Clients is a redirect to Common Applications, Common Applications it also an redirect to page List of Applications. Thus Pastebin Clients is a double redirects page.
  4. To fix it, just click the Edit link at the right of Pastebin Clients. Change #REDIRECT [[Common Applications]] to #REDIRECT [[List of Applications]]
  5. Save the page with a Edit summary such as "Fix double redirects". Then you are done.

Creating

Ensure you understand the philosophy of ArchWiki and think about what others may want to read (see ArchWiki:Requests for ideas). As mentioned, the wiki's scope is quite wide.

Talk to the admins for help coordinating major projects.

Improving

Content editing, proofreading, and updating are never-ending tasks on any wiki. If you want to help, just register an account and start performing your magic.

Maintenance

  • Help patrolling the Recent Changes, fixing questionable edits and reporting spam.
  • Flag articles with appropriate article status templates, like {{Deletion}}, {{Out of date}}, {{Accuracy}}, etc.
  • Add some articles to your watchlist and protect them against counter-productive edits.
  • Participate in discussions in the various talk pages: most users will be interested in following the most recent posts to generic discussions at this link. Maintenance-specific posts are instead listed in [1], [2], [3] and [4]; furthermore, ArchWiki:Requests is used as a talk page despite its namespace.

Organizing

Sorting, categorizing, and moving articles around has become a major task for all wiki maintainers implementing and improving the category tree.

Translating

Add or improve translations; ensure that translations are in sync with each other. Some languages have started collaboration projects (see list below) to efficiently organize the translation of the articles. Please consider joining your language's Translation Team or at least informing it when you are starting translating an article.

Some languages use external wiki, they may require different steps for translation. Help:i18n has a list of external wikis.

Brainstorming

If unsure where to begin, or you feel awkward about editing other people's work, you may also contribute by posting ideas and suggestions at Forum & Wiki discussion section of the Arch Linux Forums.

Back-end maintenance

Use the Arch Linux Bugtracker to report bugs and contribute fixes and improvements to the MediaWiki codebase.