Organization

Differences between revisions 19 and 20
Revision 19 as of 2014-06-20 16:51:10
Size: 5584
Editor: belkinsa
Comment:
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 3: Line 3:
Line 9: Line 8:
The DocumentationTeam takes care of two main different types of documentation, the [[DocumentationTeam/Wiki|documentation wiki]] and the [[DocumentationTeam/SystemDocumentation|system documentation]]. 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 11: Line 10:
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:  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 13: Line 12:
 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.
 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 19: Line 14:
 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.

 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. After joining that team, go back to DocumentationTeam for information on how to get involved!

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.
 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.
Line 39: Line 20:
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. 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.
Line 41: Line 22:
== Requirements for Ubuntu Documentation Committers == === Requirements for Ubuntu Documentation Committers ===
Line 49: Line 30:
== Requirements for Ubuntu Documentation Wiki Administrators == === Requirements for Ubuntu Documentation Wiki Administrators ===

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)