Organization

Differences between revisions 1 and 20 (spanning 19 versions)
Revision 1 as of 2009-04-20 12:34:00
Size: 2398
Editor: webdefence
Comment: initial draft
Revision 20 as of 2014-07-02 20:58:10
Size: 3256
Editor: knome
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
This page explains the structure of the DocumentationTeam. ## page was renamed from DocumentationTeam/Organisation
<<Include(DocumentationTeam/MenuBar)>>
Line 3: Line 4:
{{{This page is a work in progress and is subject to internal discussion. The structure described below has not yet been implemented.}}} ||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents(3)>>||
Line 5: Line 6:
The DocumentationTeam takes care of two main different types of documentation, the [[DocumentationTeam/Wiki|documentation wiki]] and the [[DocumentationTeam/SystemDocumentation|system documentation]]. This page explains the structure of the DocumentationTeam and provides information about how to join the team.
Line 7: Line 8:
The DocumentationTeam as a whole is represented by the [[http://launchpad.net/~ubuntu-doc|~ubuntu-doc team]] on Launchpad. Within that team, the following subteams exist: The Ubuntu documentation team as a whole is represented by the [[http://launchpad.net/~ubuntu-doc|~ubuntu-doc team]] on Launchpad. Several subteams exist within that team, most notably:
Line 9: Line 10:
 1. '''[[https://launchpad.net/~ubuntu-doc-contributors|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.  1. '''[[https://launchpad.net/~ubuntu-doc-contributors|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 work on various parts of the documentation.
Line 11: Line 12:
 1. '''[[https://launchpad.net/~ubuntu-core-doc|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 [[DocumentationTeam/SystemDocumentation|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 [[https://launchpad.net/codeofconduct/1.0.1|Ubuntu Code of Conduct]].
  * read and understood the [[https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation|System Documentation series of pages]]
  * contributed several patches which apply correctly and demonstrate familiarity with bzr (can be small patches).
  * contributed at least one significant patch which demonstrates a good and clear writing style.
 1. '''[[https://launchpad.net/~ubuntu-core-doc|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. Membership to this team is moderated, see requirements below.
Line 17: Line 14:
 1. '''[[https://launchpad.net/~ubuntu-helpwiki-editors|Ubuntu Help 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 [[https://help.ubuntu.com/community/WikiGuide/DeletingAndRenaming|relevant section of the Wiki Guide]].  1. '''[[https://launchpad.net/~ubuntu-doc-wiki-admins|Ubuntu Documentation Wiki Administrators]]'''. Members of this team have permission to administrate the Ubuntu community help wiki, most notably delete or rename wiki pages. Membership to this team is moderated, see requirements below.

== General Requirements ==

As a prerequisite for both teams, we ask applicants to have signed the [[https://launchpad.net/codeofconduct/1.0.1|Ubuntu Code of Conduct]].

We also ask that the applicant has interacted with members of the group, by posting to the mailing list fairly regularly, and/or frequenting the IRC channel.

=== 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 [[https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation|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 [[DocumentationTeam/StyleGuide|documentation team style guide]], and is comfortable working with DocBook, Bazaar and Launchpad.
  * 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).

=== Requirements for Ubuntu Documentation Wiki Administrators ===

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

  * read the [[https://help.ubuntu.com/community/WikiGuide|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.

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

The Ubuntu documentation team as a whole is represented by the ~ubuntu-doc team on Launchpad. Several subteams exist within that team, most notably:

  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 work on various parts of the documentation.

  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. Membership to this team is moderated, see requirements below.

  3. Ubuntu Documentation Wiki Administrators. Members of this team have permission to administrate the Ubuntu community help wiki, most notably delete or rename wiki pages. Membership to this team is moderated, see requirements below.

General Requirements

As a prerequisite for both teams, we ask applicants to have signed the Ubuntu Code of Conduct.

We also ask that the applicant has interacted with members of the group, by posting to the mailing list fairly regularly, and/or frequenting the IRC channel.

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 DocBook, Bazaar and Launchpad.

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

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.

DocumentationTeam/Organization (last edited 2020-07-22 01:27:29 by shippj)