You are browsing a read-only backup copy of Wikitech. The live site can be found at

Technical documentation checklist and templates

From Wikitech-static
Revision as of 22:36, 12 December 2019 by imported>SRodlund (SRodlund moved page User:SRodlund/Technical documentation checklist and templates to Technical documentation checklist and templates: Moving to mainspace)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


This page contains a checklist for individuals who are writing technical documentation on Wikitech -- primarily Cloud VPS and Toolforge.

Before you begin

Useful resources

Technical documentation checklist

At minimum, each documentation page for Cloud VPS and Toolforge should include:

  1. Descriptive Title: The title should be descriptive and specific. This helps visitors decide whether they would want to use the page. For example: Accessing Instances on Cloud VPS is much better than Instances.
  2. Project or page-specific templates:
    1. Cloud VPS Navbox: {{Cloud VPS nav}}
    2. Toolforge Navbox: {{Template:Toolforge nav}}
    3. Contact Us / Communication: {{:Help:Cloud Services communication}}
  3. An Overview: This is a short statement about the document, who it is for, why it is useful
  4. Prerequisites or Before you Begin: This is a checklist of what a person will need in order to follow the documentation. This may include the type of account people will need, software, rights, knowledge level, etc. You may want to link to information (for example, how to obtain user roles, rights, etc).
  5. Descriptive section headers: Section headers should be descriptive and specific. This helps visitors decide if they need to read the entire page or just a section. Think about the most important information that the section will convey. Make sure that this is the header.
  6. See Also:
  7. Categories: For Toolforge or Cloud VPS, Categories: Cloud VPS, Toolforge, Administration or Administrator (for Admin pages), Documentation, Cloud Services

Documentation templates

Page templates

Helpful technical document markup templates

A set of technical document markup templates are available on Some or all may need to be localized for Wikitech.

Communication and support

We communicate and provide support through several primary channels. Please reach out with questions and to join the conversation.

Communicate with us
Connect Best for
Phabricator Workboard #Cloud-Services Task tracking and bug reporting
IRC Channel #wikimedia-cloud connect
Telegram bridge
mattermost bridge
General discussion and support
Mailing List cloud@ Information about ongoing initiatives, general discussion and support
Announcement emails cloud-announce@ Information about critical changes (all messages mirrored to cloud@)
News wiki page News Information about major near-term plans
Cloud Services Blog Clouds & Unicorns Learning more details about some of our work
Wikimedia Technical Blog News and stories from the Wikimedia technical movement