Technical documentation prioritization

Overview
This page is evolving. There should be an assessment tool or set of guidelines to help categorize and prioritize requests for new and improved technical documentation. It is time to move beyond the model, in which a problem is pointed out or a request made and no action is taken. The "somebody should do something" model for getting documentation done does not work, and we must move beyond it.

Priorities
What makes a piece of technical documentation a priority? (In no particular order, yet):


 * There are repeated requests from community and staff to create or improve existing documentation for X
 * A process will not work or cannot be completed if X is not documented correctly
 * The steps outlined for a process are wrong or incomplete
 * The information about X is wrong or out of date
 * The organization of a document makes it difficult or impossible to find important information

For existing technical documentation

 * What is the problem? Is the information wrong? Are there steps missing? Have interfaces or options changed?
 * What information do you need to know in order to make the information complete?
 * Where is the problem? Provide a link to the page or section that needs to be updated.

For new technical documentation requests

 * Where should it go? Ideally you have a page name and a location
 * Why is it important?

Authors / Assignees

 * Who will fix or create the technical documentation?
 * Does it make sense to assign this to a person?
 * Is it something that you can change or begin?
 * What level of knowledge or skill do you think someone might need to complete this task? This helps individuals to identify who might be able to complete the work on this ticket.

How to file a request for improvement or new documentation
If you have a request for improvements to technical documentation or a request for new technical documentation, please consider the following before filing a ticket:

For improvements to technical documentation

 * MediaWiki
 * Wikitech
 * GitHub


 * https://www.mediawiki.org/wiki/How_to_report_a_bug

When is technical documentation done?
Also known as, when can you close a Phab task?

Where
Much of the technical documentation for Wikimedia project can be found on two Wikis


 * https://wikitech.wikimedia.org/wiki/Main_Page
 * https://www.mediawiki.org/wiki/Documentation

Technical documentation can also be found in Github...