Ubuntu Wiki

This page explains the structure of the DocumentationTeam.

This page is a work in progress and is subject to internal discussion. The structure described below has not yet been implemented.

The DocumentationTeam takes care of two main different types of documentation, the documentation wiki and the system documentation.

The DocumentationTeam as a whole is represented by the ~ubuntu-doc team on Launchpad. Within that team, the following subteams exist:

1. Ubuntu Documentation Contributors. This is an open team which anyone interested in helping with Ubuntu documentation can join to show their interest. Feel free to join this team and learn how to contribute from the DocumentationTeam page. Members of this team frequently:

   • Edit Ubuntu Documentation Wiki pages.
   • Report bugs via Launchpad to the Ubuntu system documentation.
   • Contribute patches to system documentation through Launchpad and Bazaar.
   • Participate on the Ubuntu-doc mailing list and/or in the #ubuntu-doc IRC channel.

2. Ubuntu Documentation Committers. This team has write access to the official system documentation branches. Write access to these branches is restricted because this is the documentation that is included directly with every Ubuntu system. A system of quality control and review is therefore required. In order to be granted access to join this team, applicants need to demonstrate familiarity with the system documentation processes and the StyleGuide. Applicants should apply to join the group by posting to the mailing list. In particular, we ask applicants to have:

   • signed the Ubuntu Code of Conduct.

   • read and understood the System Documentation series of pages

   • contributed more than three significant patches over the course of a development cycle (6 months), which demonstrate a good and clear writing style to the satisfaction of the reviewer.

3. Ubuntu Documentation Wiki Editors. Members of this team have permission to delete or rename wiki pages. This is a restricted action on the help wiki, because the renaming or deletion of wiki pages can often cause unintended problems. This is explained in the relevant section of the Wiki Guide. In order to join this team, we ask applicants to have:

   • signed the Ubuntu Code of Conduct.

   • read and understood the Wiki Guide.

   • made significant contributions to the help wiki by way of edits to pages.
   • demonstrated an understanding of the issues that can arise from deleting and renaming pages, and how to avoid them.