Organization

Differences between revisions 2 and 13 (spanning 11 versions)
Revision 2 as of 2009-04-20 12:34:37
Size: 2433
Editor: webdefence
Comment: trivial
Revision 13 as of 2009-05-03 06:46:53
Size: 5127
Editor: 212
Comment: page approved at yesterday's meeting, adding further information about how a consensus is arrived at, adding final links
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.}}} 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 team as a whole is represented by the [[http://launchpad.net/~ubuntu-doc|~ubuntu-doc team]] on Launchpad. Within that team, the following subteams exist:
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 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.
Line 11: Line 16:
 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 to the satifaction of the reviewer.
 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.
Line 17: Line 18:
 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 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]].

= Joining a Team =

If you're new to the DocumentationTeam, you should join the [[https://launchpad.net/~ubuntu-doc-contributors|Ubuntu Documentation Contributors team]] on Launchpad. That team is open to anyone interested in contributing to join, and there is no application process.

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.

After you have posted to the mailing list, the DocumentationTeam will discuss and seek to reach a view on your application by consensus. Don't worry - this should be a pain free process in the vast majority of cases! It simply means that anyone with comments on your application will express their view, and the members of the team will reach a view together on the application. As usual with the Ubuntu community, the team operates by way of a meritocracy, which means that the most active contributors and in particular those members who have reviewed your work are likely to have the most important voice.

In the event that any issue is raised with the application which leads it to be refused, you can reapply later if you have addressed and provided a solution to those issues.

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

== 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 DocumentationTeam takes care of two main different types of documentation, the documentation wiki and the system documentation.

The team 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.

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

Joining a Team

If you're new to the DocumentationTeam, you should join the Ubuntu Documentation Contributors team on Launchpad. That team is open to anyone interested in contributing to join, and there is no application process.

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.

After you have posted to the mailing list, the DocumentationTeam will discuss and seek to reach a view on your application by consensus. Don't worry - this should be a pain free process in the vast majority of cases! It simply means that anyone with comments on your application will express their view, and the members of the team will reach a view together on the application. As usual with the Ubuntu community, the team operates by way of a meritocracy, which means that the most active contributors and in particular those members who have reviewed your work are likely to have the most important voice.

In the event that any issue is raised with the application which leads it to be refused, you can reapply later if you have addressed and provided a solution to those issues.

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:

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)