Documentation/Documentation types

This page contains research and notes on the idea of managing Wikimedia documentation pages by type. Feel free to add your ideas to this page or the talk page.

Scope

 * In scope:
 * Wikimedia technical documentation
 * documentation about collaboration and processes for Wikimedia technical projects
 * documentation about collaboration and processes for Wikimedia content projects
 * Out of scope:
 * wikimediafoundation.org
 * legal documentation
 * project content, like Wikipedia articles and Wiktionary entries
 * web apps
 * blog posts

Terms

 * content type
 * the structure and goal of a documentation page

Key doc review process
2021-2022

From Documentation/Review_template:


 * Landing page: Landing pages are link hubs that help the reader find information. Landing pages are navigation oriented.
 * Cross-collection landing page
 * How-to guide: How-to guides are directions that take the reader through the steps required to solve a real-world problem. How-to guides are goal oriented.
 * Tutorial: Tutorials are lessons that take the reader by the hand through a series of steps to complete a project. Tutorials are learning oriented.
 * Explanation: Explanations are discussions that clarify and illuminate a particular topic. Explanations are understanding oriented.
 * Reference: References are technical descriptions of a system and how to operate it. Reference documentation is information oriented

Audit of key technical docs
2021-2022

From spreadsheet (restricted access):


 * web app
 * blog post
 * code repository
 * contributing guide
 * explanation
 * how-to guide
 * landing page
 * readme
 * tutorial
 * overview
 * guidelines
 * metrics dashboard
 * portal
 * process description
 * team page
 * user group page

Documentation/Patterns
2022


 * Documentation/Patterns/How-to guide
 * Documentation/Patterns/Landing page
 * Documentation/Patterns/Tutorial

Documentation/Toolkit
2022

Documentation/Toolkit


 * Documentation/Patterns/Landing_page
 * Documentation/Patterns/Tutorial
 * Documentation/Library_Documentation_Template
 * Documentation/How-to_template
 * Documentation/API_Documentation_Template

List of content types
This is an uncurated list of content types with notes, examples, and related links.


 * landing page
 * Documentation/Patterns/Landing_page
 * tutorial
 * Working page: Documentation/Patterns/Tutorial
 * how-to guide
 * Documentation/Patterns/How-to guide
 * Documentation/How-to template
 * quickstart guide
 * contributing guide
 * explanation
 * reference
 * archived page
 * guideline
 * meta:Category:Meta-Wiki_guidelines
 * sandbox
 * list
 * FAQ
 * readme
 * overview
 * guidelines
 * metrics dashboard
 * portal
 * process description
 * project page
 * Wikimedia_Product_Guidance/Starting_a_project_page
 * team page
 * talk page
 * user group page
 * sprint tracker
 * Wikimedia_Release_Engineering_Team/Sprint/GitLab-a-thon-ii-wrath-of-kahn

Content types on the projects

 * w:English Wikipedia:Featured article criteria
 * w:English Wikipedia:Portal/Guidelines
 * Wikimedia_Blog/Guidelines