Difference between revisions of "ArchWiki:Contributing"

From ArchWiki
Jump to: navigation, search
(Easy to start jobs: + use internal links)
(Brainstorming: link to new project)
 
(65 intermediate revisions by 19 users not shown)
Line 1: Line 1:
 
[[Category:ArchWiki]]
 
[[Category:ArchWiki]]
 +
[[pt:ArchWiki:Contribuiting]]
 
[[es:ArchWiki:Contributing]]
 
[[es:ArchWiki:Contributing]]
 +
[[ja:ArchWiki:貢献]]
 +
[[ru:ArchWiki:Contributing]]
 
[[zh-CN:ArchWiki:Contributing]]
 
[[zh-CN:ArchWiki:Contributing]]
 
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.  
 
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.  
Line 6: Line 9:
 
This is a community effort, but if you take on the task seriously, a formal position as a [[ArchWiki:Maintenance Team|wiki maintainer]] may be in order.
 
This is a community effort, but if you take on the task seriously, a formal position as a [[ArchWiki:Maintenance Team|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.}}
+
== The 3 fundamental rules ==
  
== Prerequisites ==
+
There are 3 simple rules that all contributors, including novices, should try their best to follow as a sign of '''respect''' to the other users of the wiki: [[#Always properly use the edit summary]], [[#Do not make complex edits at once]] and [[#Announce article rewrites in a talk page]].
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.
+
All wiki contributors must assume and expect that other users will check their edits sooner or later, and respect their right to do so by making it as quick and easy as possible by following these recommendations. Those familiar with collaborative software projects will easily understand the analogy between wiki edit summaries and git commit messages, and between wiki edit diffs and git diffs.
* [[Help:Editing]] outlines both widely-known MediaWiki markup and ArchWiki-specific guidelines. A must-read for any would-be contributors.  
+
 
 +
{{Warning|Any edits to articles that do not respect these fundamental rules, and as such cannot be comprehended with reasonable effort, may be completely reverted without any other warnings, especially when affecting popular articles.}}
 +
 
 +
=== Always properly use the edit summary ===
 +
 
 +
The edit summary is the little text box that is found below the main editing area and just above the "Save page" button. It is very important to always write, in a succinct way, '''what''' has been done and '''why'''. Note that internal wiki links do work in edit summaries, so use them to link to any related discussions or articles; similarly, paste any urls to relevant edit diffs or external resources, such as forum threads or mailing lists.
 +
 
 +
Only in case of [[Wikipedia:Help:Minor edit|minor]] edits, e.g. grammar or orthography corrections or the simple rewording of a sentence, the "why" part can be omitted; analogously, starting a new [[Help:Discussion|discussion]] or replying to an existing one does not require to restate the message in the edit summary.
 +
 
 +
{{Tip|
 +
* Take a look at the edit summaries in the [[Special:RecentChanges|Recent Changes]] to get an idea of what you should write in your summary, but be warned that unfortunately not all users are aware of these guidelines.
 +
* To receive a warning when leaving a blank edit summary, check ''"Prompt me when entering a blank edit summary"'' in [[Special:Preferences#mw-prefsection-editing|Special:Preferences]].
 +
* Use links like [[Special:Diff/359881/next]] for clickable references to diffs, see [[mw:Help:Diff]] for syntax details.
 +
}}
 +
 
 +
=== Do not make complex edits at once ===
 +
 
 +
If you want to make an extensive change to a page, be it a normal article or a discussion page, always split your work in several simple edits, for example according to the various logical steps needed to complete it. If in doubt, preview the resulting [[Wikipedia:Help:Diff|diff]] with the "Show changes" button and wonder if another user would be able to understand it, also considering the edit summary as explained above. Some common operations that generate confusing diffs are:
 +
 
 +
* Moving a section in an article and at the same time editing its content. Solution: move the section unchanged, save, and change its content in a following edit.
 +
* Reordering several sections of an article at the same time. Solution: move only one section per edit.
 +
 
 +
{{Note|This practice will naturally increase the number of entries in [[Special:RecentChanges]]: do not be worried at all by this, users can easily filter that list by enabling the ''Group changes by page in recent changes and watchlist'' setting under ''Preferences > Recent changes > Advanced options''.}}
 +
 
 +
=== Announce article rewrites in a talk page ===
 +
 
 +
If you want to radically restructure or rewrite an article or a group of articles, announce and explain your intention in an appropriate talk page first, giving any other interested users some reasonable time to reply and share their view.
 +
 
 +
Keep in mind that announcing intended changes does '''not''' exempt edits from [[#Always properly use the edit summary]] and [[#Do not make complex edits at once]].
 +
 
 +
== The most important task ==
 +
 
 +
In the remainder of this article you will be presented with the various ways you can contribute to the wiki. Among them, however, there is one that you should consider far more important than the others: '''add your favorite articles to your watchlist''' and protect them against counter-productive edits.
 +
 
 +
Every day, ArchWiki receives [[ArchWiki:Statistics|several dozens]] of edits from many different users: while most of these changes are actual improvements, it only takes one single edit, often made in good faith, to inaccurately alter the meaning of a whole paragraph or a section, or sometimes even unreasonably delete it altogether; if gone unnoticed, this will ruin the valuable work that you and all the other previous editors had done. Unfortunately, this occurs more frequently than you would expect: the official wiki staff does try their best to filter and fix counter-productive edits, but you should never rely completely on them, both because, just like you, they have limited time to spend on the wiki, and also because they are not omniscient, and it is very likely that your knowledge on the topics treated in your favorite articles is greater than theirs. In general, a wiki simply does ''not'' work if users only focus on writing new content but then do not care about what happens to their contributions.
 +
 
 +
Fortunately, there is a very easy way for you to follow the articles to which you contributed or those that you like the most or are most knowledgeable in: at the top of every article there is a "watch" link, and by following it, that article will be added to [[Special:EditWatchlist|your watchlist]]. You will then be able to follow the changes in [[Special:Watchlist]], or by choosing to be notified by email when the watched articles receive updates in the "Email options" field of [[Special:Preferences#mw-prefsection-personal]]; the pages you are following will also be highlighted in bold in [[Special:RecentChanges]]. Finally, preferences for the watchlist are found in [[Special:Preferences#mw-prefsection-watchlist]]: among the options you can even choose to automatically start watching the pages that you create or edit.
 +
 
 +
If you notice that an article in your watchlist has received an inaccurate edit, or you just do not understand it, you are strongly encouraged to either fix it, if possible, or to start a discussion in the article's [[Help:Discussion|talk page]], or in the responsible author's talk page.
 +
 
 +
== Resources ==
 +
 
 +
Here is a list of pages that contain information needed for contributing:
 +
 
 +
* [[Help:Article naming guidelines]] discusses effective article naming strategies and considerations to ensure readability and improve navigation of the wiki. Read it before creating a new page.
 +
* [[Help:Editing]] outlines both widely-known MediaWiki markup and ArchWiki-specific guidelines. A must-read for any would-be contributors.
 +
* [[Help:Discussion]] guides you on how to discuss with people in talk pages.
 
* [[Help:Style]] gives guidelines for the standardization of style in ArchWiki articles.  
 
* [[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.  
+
* [[Help:Category]] explains how to set page categories, how to create missing category 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.
+
* [[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.
 
* [[Help:i18n]] serves as a comprehensive guideline for ArchWiki internationalization and localization.
See the [[:Category:Help|help category]] for all help articles.
+
* [[Help:Procedures]] is a collection of useful check lists for complex operations.
  
== Easy to start jobs ==
+
See [[:Category:Help]] for all help articles.
Here are some easy jobs you can start with before moving to more difficult ones.  
+
  
=== Fix double redirects===
+
== Creating ==
# Read [[Help:Editing#Redirects|this section]] to understand what redirects are.
+
# Check out [[Special:DoubleRedirects]] to see if there are any.
+
# For example, if you see {{ic|Pastebin Clients (Edit) →‎ Common Applications →‎ List of Applications}}, it means [[Pastebin Clients]] redirects to [[Common Applications]], and [[Common Applications]] redirects to [[List of Applications]]. Therefore, [[Pastebin Clients]] is a double redirect.
+
# To fix it, edit [[Pastebin Clients]] and change {{ic|<nowiki>#REDIRECT [[Common Applications]]</nowiki>}} to {{ic|<nowiki> #REDIRECT [[List of Applications]]</nowiki>}} to skip the middleman.
+
# Enter an edit summary such as "{{ic|<nowiki>Fixed double redirect</nowiki>}}" and save.
+
  
===Use internal links===
 
Replace external links that point to the ArchWiki by internal links.
 
* list of [https://wiki.archlinux.org/index.php?title=Special%3ALinkSearch&target=http%3A%2F%2Fwiki.archlinux.org http links]
 
* list of [https://wiki.archlinux.org/index.php?title=Special%3ALinkSearch&target=https%3A%2F%2Fwiki.archlinux.org https links]
 
 
==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.
  
==Improving==
+
[[Help:Editing#Creating pages]] covers the steps to create a new article in the main namespace.
 +
 
 +
The wiki's subpage feature (article/subpage) is available for your userpage as well. Using it you could create the draft on a blank subpage. Please note that userpage content must not be categorized, but all other features can be used. Once you have finished drafting, you can simply move the subpage to its new name. Please add relevant article status templates (only) after you moved it. The better you describe a status template's reason, the easier it is for users [[#Improving]] the wiki to collaborate with you.
 +
 
 +
== 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.
  
 
* Help fulfilling [[ArchWiki:Requests|requests]].
 
* Help fulfilling [[ArchWiki:Requests|requests]].
* Add content to [[Special:WhatLinksHere/Template:Stub|stubs]] and expand [[Special:WhatLinksHere/Template:Expansion|incomplete]] or [[Special:WhatLinksHere/Template:Poor writing|poorly-written]] articles.
+
* Add content to [[:Category:Pages flagged with Template:Stub|stubs]], expand [[:Category:Pages or sections flagged with Template:Expansion|incomplete]] articles or tidy up [[:Category:Pages or sections flagged with Template:Style|poorly-written]] content.
* Correct [[Special:WhatLinksHere/Template:Accuracy|inaccurate]] or [[Special:WhatLinksHere/Template:Out of date|outdated]] content, spelling, grammar, language, and [[Help:Style|style]].  
+
* Correct [[:Category:Pages or sections flagged with Template:Accuracy|inaccurate]] or [[:Category:Pages or sections flagged with Template:Out of date|outdated]] content, spelling, grammar, language, and [[Help:Style|style]].  
 
* 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.
  
==Maintenance==
+
=== Non-Arch users ===
* 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.
+
Non-Arch users are welcome to contribute; in fact anyone can register an account. They should, however, be confident that any edits also apply to Arch, avoiding comments specific to other distributions. For example, a Fedora user contributing to the [[systemd]] page would be fine, but mentioning that the newly added content works on Fedora would be edited out as irrelevant.
* Add some articles to your watchlist and protect them against counter-productive edits.
+
 
 +
== Maintaining ==
 +
 
 +
* Help patrolling the [[Special:RecentChanges|Recent Changes]], reporting and fixing [[ArchWiki:Reports|questionable edits]].
 +
* Flag articles with appropriate [[Help:Template#Article status templates|article status templates]], like {{Ic|<nowiki>{{Out of date}}</nowiki>}}, {{Ic|<nowiki>{{Accuracy}}</nowiki>}}, {{Ic|<nowiki>{{Remove}}</nowiki>}}, {{Ic|<nowiki>{{Archive}}</nowiki>}}, etc.
 +
* Add your favorite articles to your watchlist and protect them against counter-productive edits ([[#The most important task]]).
 
* 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.
  
==Organizing==
+
== 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]].
  
* Reduce and [[Special:WhatLinksHere/Template:Merge|combine]] duplicate pages.
+
* Reduce and [[:Category:Pages or sections flagged with Template:Merge|combine]] duplicate pages.
* Improve wiki [[Table of Contents|navigation]].
+
* Improve wiki [[Table of contents|navigation]].
 
* Categorize [[Special:UncategorizedPages|uncategorized pages]], [[Special:UncategorizedCategories|uncategorized categories]] and [[Special:WantedCategories|wanted categories]]. See [[Help:Style#Categories]] and [[Help:Style#Category pages]].
 
* Categorize [[Special:UncategorizedPages|uncategorized pages]], [[Special:UncategorizedCategories|uncategorized categories]] and [[Special:WantedCategories|wanted categories]]. See [[Help:Style#Categories]] and [[Help:Style#Category pages]].
* Fix [[Special:BrokenRedirects|broken]] and [[Special:DoubleRedirects|double]] redirects.
+
* Fix [[Special:BrokenRedirects|broken]] and [[Special:DoubleRedirects|double]] redirects. Discuss or apply [[:Category:Pages flagged with Template:Redirect|proposed redirects]].
 
* See [[Special:SpecialPages]] for other useful cleanup tools.
 
* See [[Special:SpecialPages]] for other useful cleanup tools.
  
==Translating==
+
== 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.  
+
 
 +
[[:Category:Pages or sections flagged with Template:Translateme|Add]] or [[:Category:Pages or sections flagged with 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]]
 
* [[ArchWiki Translation Team (Español)]]
 
* [[ArchWiki Translation Team (Español)]]
Line 68: Line 118:
 
* [[ArchWiki Translation Team (Italiano)]]
 
* [[ArchWiki Translation Team (Italiano)]]
 
* [[ArchWiki Translation Team (Polski)]]
 
* [[ArchWiki Translation Team (Polski)]]
 +
* [[ArchWiki Translation Team (Português)]]
 +
* [[ArchWiki Translation Team (Русский)]]
 
* [[ArchWiki Translation Team (日本語)]]
 
* [[ArchWiki Translation Team (日本語)]]
 
* [[ArchWiki Translation Team (简体中文)]]
 
* [[ArchWiki Translation Team (简体中文)]]
 +
* [[ArchWiki Translation Team (Ελληνικά)]]
 +
* [[ArchWiki Translation Team (Català)]]
 +
 
Some languages use external wiki, they may require different steps for translation. [[Help:i18n]] has a list of external wikis.
 
Some languages use external wiki, they may require different steps for translation. [[Help:i18n]] has a list of external wikis.
  
==Brainstorming==
+
=== Special messages translation ===
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 [https://bbs.archlinux.org/viewforum.php?id=13 Forum & Wiki discussion] section of the [https://bbs.archlinux.org/ Arch Linux Forums].
+
 
 +
There are some special messages used in Arch Wiki, please provide their translation for your language in the following link:
 +
 
 +
* Also in (Message in Categories tree): Add translation [[Talk:Table of contents#"also in" translations|here]]
 +
* Talkpagetext : Add translation [[MediaWiki talk:Talkpagetext#Talkpagetext translation|here]]
 +
 
 +
== Brainstorming ==
 +
 
 +
To coordinate contributions with other users in real time, there is an official dedicated [[ArchWiki:IRC|#archlinux-wiki]] IRC channel. 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 [https://bbs.archlinux.org/viewforum.php?id=13 Forum & Wiki discussion] section of the [https://bbs.archlinux.org/ Arch Linux Forums].
 +
 
 +
== Back-end maintenance ==
 +
 
 +
Use the [https://bugs.archlinux.org/ Arch Linux Bugtracker] to report bugs and contribute fixes and improvements to the MediaWiki codebase. See the [https://bugs.archlinux.org/index.php?string={wiki}&project=0 list of reported bugs] for the ArchWiki back-end.
 +
 
 +
== Complaining ==
  
==Back-end maintenance==
+
If you have any ''generic'' negative remarks or complaints about how the wiki is moderated or administered, please leave a message in [[ArchWiki talk:Administrators]]. Of course it should not be necessary to state that it is indeed possible to complain about something using a civil and respectful tone :) For complaints regarding ''specific'' edits or articles, please use a more appropriate talk page.
Use the [https://bugs.archlinux.org/ Arch Linux Bugtracker] to report bugs and contribute fixes and improvements to the MediaWiki codebase.
+

Latest revision as of 04:28, 22 May 2016

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.

The 3 fundamental rules

There are 3 simple rules that all contributors, including novices, should try their best to follow as a sign of respect to the other users of the wiki: #Always properly use the edit summary, #Do not make complex edits at once and #Announce article rewrites in a talk page.

All wiki contributors must assume and expect that other users will check their edits sooner or later, and respect their right to do so by making it as quick and easy as possible by following these recommendations. Those familiar with collaborative software projects will easily understand the analogy between wiki edit summaries and git commit messages, and between wiki edit diffs and git diffs.

Warning: Any edits to articles that do not respect these fundamental rules, and as such cannot be comprehended with reasonable effort, may be completely reverted without any other warnings, especially when affecting popular articles.

Always properly use the edit summary

The edit summary is the little text box that is found below the main editing area and just above the "Save page" button. It is very important to always write, in a succinct way, what has been done and why. Note that internal wiki links do work in edit summaries, so use them to link to any related discussions or articles; similarly, paste any urls to relevant edit diffs or external resources, such as forum threads or mailing lists.

Only in case of minor edits, e.g. grammar or orthography corrections or the simple rewording of a sentence, the "why" part can be omitted; analogously, starting a new discussion or replying to an existing one does not require to restate the message in the edit summary.

Tip:
  • Take a look at the edit summaries in the Recent Changes to get an idea of what you should write in your summary, but be warned that unfortunately not all users are aware of these guidelines.
  • To receive a warning when leaving a blank edit summary, check "Prompt me when entering a blank edit summary" in Special:Preferences.
  • Use links like Special:Diff/359881/next for clickable references to diffs, see mw:Help:Diff for syntax details.

Do not make complex edits at once

If you want to make an extensive change to a page, be it a normal article or a discussion page, always split your work in several simple edits, for example according to the various logical steps needed to complete it. If in doubt, preview the resulting diff with the "Show changes" button and wonder if another user would be able to understand it, also considering the edit summary as explained above. Some common operations that generate confusing diffs are:

  • Moving a section in an article and at the same time editing its content. Solution: move the section unchanged, save, and change its content in a following edit.
  • Reordering several sections of an article at the same time. Solution: move only one section per edit.
Note: This practice will naturally increase the number of entries in Special:RecentChanges: do not be worried at all by this, users can easily filter that list by enabling the Group changes by page in recent changes and watchlist setting under Preferences > Recent changes > Advanced options.

Announce article rewrites in a talk page

If you want to radically restructure or rewrite an article or a group of articles, announce and explain your intention in an appropriate talk page first, giving any other interested users some reasonable time to reply and share their view.

Keep in mind that announcing intended changes does not exempt edits from #Always properly use the edit summary and #Do not make complex edits at once.

The most important task

In the remainder of this article you will be presented with the various ways you can contribute to the wiki. Among them, however, there is one that you should consider far more important than the others: add your favorite articles to your watchlist and protect them against counter-productive edits.

Every day, ArchWiki receives several dozens of edits from many different users: while most of these changes are actual improvements, it only takes one single edit, often made in good faith, to inaccurately alter the meaning of a whole paragraph or a section, or sometimes even unreasonably delete it altogether; if gone unnoticed, this will ruin the valuable work that you and all the other previous editors had done. Unfortunately, this occurs more frequently than you would expect: the official wiki staff does try their best to filter and fix counter-productive edits, but you should never rely completely on them, both because, just like you, they have limited time to spend on the wiki, and also because they are not omniscient, and it is very likely that your knowledge on the topics treated in your favorite articles is greater than theirs. In general, a wiki simply does not work if users only focus on writing new content but then do not care about what happens to their contributions.

Fortunately, there is a very easy way for you to follow the articles to which you contributed or those that you like the most or are most knowledgeable in: at the top of every article there is a "watch" link, and by following it, that article will be added to your watchlist. You will then be able to follow the changes in Special:Watchlist, or by choosing to be notified by email when the watched articles receive updates in the "Email options" field of Special:Preferences#mw-prefsection-personal; the pages you are following will also be highlighted in bold in Special:RecentChanges. Finally, preferences for the watchlist are found in Special:Preferences#mw-prefsection-watchlist: among the options you can even choose to automatically start watching the pages that you create or edit.

If you notice that an article in your watchlist has received an inaccurate edit, or you just do not understand it, you are strongly encouraged to either fix it, if possible, or to start a discussion in the article's talk page, or in the responsible author's talk page.

Resources

Here is a list of pages that contain information needed for contributing:

  • Help:Article naming guidelines discusses effective article naming strategies and considerations to ensure readability and improve navigation of the wiki. Read it before creating a new page.
  • Help:Editing outlines both widely-known MediaWiki markup and ArchWiki-specific guidelines. A must-read for any would-be contributors.
  • Help:Discussion guides you on how to discuss with people in talk pages.
  • Help:Style gives guidelines for the standardization of style in ArchWiki articles.
  • Help:Category explains how to set page categories, how to create missing category 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.
  • Help:Procedures is a collection of useful check lists for complex operations.

See Category:Help for all help articles.

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.

Help:Editing#Creating pages covers the steps to create a new article in the main namespace.

The wiki's subpage feature (article/subpage) is available for your userpage as well. Using it you could create the draft on a blank subpage. Please note that userpage content must not be categorized, but all other features can be used. Once you have finished drafting, you can simply move the subpage to its new name. Please add relevant article status templates (only) after you moved it. The better you describe a status template's reason, the easier it is for users #Improving the wiki to collaborate with you.

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.

Non-Arch users

Non-Arch users are welcome to contribute; in fact anyone can register an account. They should, however, be confident that any edits also apply to Arch, avoiding comments specific to other distributions. For example, a Fedora user contributing to the systemd page would be fine, but mentioning that the newly added content works on Fedora would be edited out as irrelevant.

Maintaining

  • Help patrolling the Recent Changes, reporting and fixing questionable edits.
  • Flag articles with appropriate article status templates, like {{Out of date}}, {{Accuracy}}, {{Remove}}, {{Archive}}, etc.
  • Add your favorite articles to your watchlist and protect them against counter-productive edits (#The most important task).
  • 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.

Special messages translation

There are some special messages used in Arch Wiki, please provide their translation for your language in the following link:

  • Also in (Message in Categories tree): Add translation here
  • Talkpagetext : Add translation here

Brainstorming

To coordinate contributions with other users in real time, there is an official dedicated #archlinux-wiki IRC channel. 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. See the list of reported bugs for the ArchWiki back-end.

Complaining

If you have any generic negative remarks or complaints about how the wiki is moderated or administered, please leave a message in ArchWiki talk:Administrators. Of course it should not be necessary to state that it is indeed possible to complain about something using a civil and respectful tone :) For complaints regarding specific edits or articles, please use a more appropriate talk page.