Documentation/Maturity model for MediaWiki technical documentation

Overview
This page contains a tentative outline, research and citations for a maturity model for MediaWiki technical documentation. The maturity model is intended to guide assessments about the quality of existing technical documentation and help set standards for planning future technical documentation on MediaWiki projects.

This is a current Q3 (Jan/Feb/March 2019) for the Wikimedia Developer Advocacy team.

https://phabricator.wikimedia.org/T212003

Capability maturity model levels
There are five levels defined along the continuum of the model and, according to the SEI: "Predictability, effectiveness, and control of an organization's software processes are believed to improve as the organization moves up these five levels. While not rigorous, the empirical evidence to date supports this belief."


 * 1) Initial (chaotic, ad hoc, individual heroics) - the starting point for use of a new or undocumented repeat process.
 * 2) Repeatable - the process is at least documented sufficiently such that repeating the same steps may be attempted.
 * 3) Defined - the process is defined/confirmed as a standard business process
 * 4) Capable - the process is quantitatively managed in accordance with agreed-upon metrics.
 * 5) Efficient - process management includes deliberate process optimization/improvement.

Information process maturity model levels

 * 1) Ad Hoc: (Needs Improvement)
 * 2) Rudimentary: (Needs improvement)
 * 3) Organized and repeatable: (Baseline)
 * 4) Managed and sustainable: (Superior)
 * 5) Optimizing: (Superior)

At the organizational level:

 * Does the organization support staff and the community, within the reporting structure and through concentrated efforts to promote efforts to produce and maintain high quality, current technical documentation to technical collaborators?
 * Is there an established planning process to for MediaWiki technical documentation, to ensure proper coverage of timely, quality technical documentation, which meets the needs of the intended audience?
 * Is there a system for peer reviewing and editing technical documentation to ensure quality and accuracy?
 * Does the organization have the ability to estimate the time or cost (in staff and volunteer hours) of specific technical documentation projects? Is the organization able to effectively judge whether there is value in concentrating efforts on specific technical content or if resources would be more effectively directed elsewhere?
 * Is there appropriate staffing to undertake technical documentation projects that produce quality content? Are there sufficient resources and support for volunteers in the community who wish to work on these projects?
 * Does the organization actively promote activities (training, write-a-thons/hack-a-thons, conference attendance, community outreach) to demonstrate interest and support for technical documentation efforts?
 * Does the organization actively support efforts to understand audience/user needs in order to ensure technical documentation is appropriate and usable?
 * Are technical communicators and writers collaborating to improve quality and consistency of technical documentation across the organizations projects?

Citations, resources, readings

 * J. Hackos, Managing Your Documentation Projects. New York: John Wiley & Sons, 1993
 * J. Hackos, Information Process Maturity Model, 017 IEEE International Professional Communication Conference (ProComm), 2017
 * S. Huang, S. Tilley, Towards a documentation maturity model, SIGDOC '03 Proceedings of the 21st annual international conference on Documentation, 2003
 * https://en.wikipedia.org/wiki/Capability_Maturity_Model
 * Maturity Models 101 - Carnegie Mellon SEI:
 * Measurement and Analysis in Capability Maturity Model Integration Models and Software Process Improvement
 * https://resources.sei.cmu.edu/library/asset-view.cfm?assetid=11965
 * https://opensource.com/open-organization/17/10/readme-maturity-model
 * http://www.contentstrategyinc.com/understanding-content-maturity-model/