DocumentationTeam

Differences between revisions 65 and 66
Revision 65 as of 2013-07-19 00:17:19
Size: 4882
Editor: cpe-76-94-226-228
Comment: Included Mallard for Committer Requirements section.
Revision 66 as of 2013-10-28 21:47:17
Size: 4928
Editor: dsmythies
Comment: Fix DocBook incorrect link auto added by that demented auto adder
Deletions are marked like this. Additions are marked like this.
Line 36: Line 36:
  * contributed a number of patches to the system documentation which, taken as a whole, demonstrate to the reviewer that the applicant applies the [[DocumentationTeam/StyleGuide|documentation team style guide]], and is comfortable working with Bazaar, Launchpad, and either [[http://projectmallard.org/index.html|Mallard]] for the Ubuntu User Guide or DocBook for the serverguide, or both.   * contributed a number of patches to the system documentation which, taken as a whole, demonstrate to the reviewer that the applicant applies the [[DocumentationTeam/StyleGuide|documentation team style guide]], and is comfortable working with Bazaar, Launchpad, and either [[http://projectmallard.org/index.html|Mallard]] for the Ubuntu User Guide or [[https://help.ubuntu.com/community/DocBook|DocBook]] for the serverguide, or both.

Inclusion deadlines for ImpishString Freeze: September 16, 2021 / Non-language packs: September 30, 2021

Introduction

This page explains the structure of the DocumentationTeam and provides information about how to join the team.

The DocumentationTeam takes care of two main different types of documentation, the documentation wiki and the system documentation that ships with each version of *buntu.

This explains a bit about the teams structure:

  1. Ubuntu Documentation Contributors. This is an open team, much like the Beginners 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.

1. 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.

  1. Ubuntu Documentation Wiki Administrators. 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.

Suggested Requirements for Ubuntu Documentation Committers

Membership of this team carries with it a right to commit material directly to the documents which are included in the Ubuntu operating system. For that reason we ask that applicants to join this team have:

  • read the System Documentation series of pages

  • contributed a number of patches to the system documentation which, taken as a whole, demonstrate to the reviewer that the applicant applies the documentation team style guide, and is comfortable working with Bazaar, Launchpad, and either Mallard for the Ubuntu User Guide or DocBook for the serverguide, or both.

  • read the UbuntuBugControl page and all those pages linked there (this is necessary because membership of the Ubuntu Documentation Committers team carries with it membership of the Ubuntu Bug Control team).

Suggested Requirements for Ubuntu Documentation Wiki Administrators

For membership of this team, we ask that applicants to join have:

  • read 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.

Suggested Reading - Style Guide

All the team's work is subject to our Style Guide.

Ready to join

Once you are more familiar with the team and its processes, you may find that you are able to contribute more effectively with either the Ubuntu Documentation Wiki Administrators team (if you wish to help with maintenance of the wiki), or the Ubuntu Documentation Committers team (if you wish to be able to push your changes directly to the system documentation).

You can apply to join either of these teams by posting to the mailing list and asking to be added. Please provide evidence that you satisfy the requirements in this section. It's particularly helpful if you can include links to concrete examples of your work, such as wiki pages or patches.

Beginners Team Help

The Beginners Team is here to help you get started on your journey to becoming a Documentation contributor.

Sub-pages


CategoryDocteam CategoryUbuntuTeams

DocumentationTeam (last edited 2021-06-11 05:29:18 by roguescholar)