DocumentationTeam

Differences between revisions 73 and 74
Revision 73 as of 2013-12-08 22:52:41
Size: 4965
Editor: belkinsa
Comment: I will do this correctly!
Revision 74 as of 2014-07-02 20:25:06
Size: 1558
Editor: knome
Comment:
Deletions are marked like this. Additions are marked like this.
Line 7: Line 7:
= Introduction = = Ubuntu Doc Team Home Page =
Line 9: Line 9:
## Describe:
## the teams's purpose and community role
## the team tasks and work
## who might be interested in joining/getting involved with the team
Welcome to the Ubuntu Doc Team Home page, the starting point for those interested in improving Ubuntu documentation. May your life go well.
Line 14: Line 11:
== Introduction ==
Line 15: Line 13:
An explaination of the structure of the Documentation Team and information about how to join it. The Documentation Team takes care of [[DocumentationTeam/SystemDocumentation|official documentation]] for both Desktop and Server. It also contributes to the [[DocumentationTeam/Wiki|community help wiki]]. This is done via several sub-teams. Besides contributing text to both types via the '''Contributors team''', each has its own administrative team, the '''Committers team''' (official docs) and the '''Wiki Administrators''' team (help wiki). See [[https://wiki.ubuntu.com/DocumentationTeam/Organization| Documentation Team organization]] for more on the overarching Doc team and these 3 sub-teams.
Line 17: Line 15:
The Documentation Team takes care of two main types of documentation, the [[DocumentationTeam/Wiki|documentation wiki]] and the [[DocumentationTeam/SystemDocumentation|system documentation]] that ships with each version of *buntu. All documentation falls under this [[https://wiki.ubuntu.com/DocumentationTeam/License| license]].
Line 19: Line 17:
The Documentation Team has three divisions.

= Contributors =

'''[[https://launchpad.net/~ubuntu-doc-contributors|Ubuntu Documentation Contributors]]''' is an open team which anyone interested can join and assist in helping with Ubuntu documentation. Being part of this team will enhance your sense of Community and the Documentation Team pages will quickly help you learn how to contribute. When you are ready to join use the 'Join this team' link on '''[[https://launchpad.net/~ubuntu-doc-contributors|this 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 [[https://launchpad.net/|Launchpad]] and [[http://bazaar.canonical.com/en/|Bazaar]]

  * participate on the Ubuntu-doc mailing list and/or in the #ubuntu-doc IRC channel

= Committers =

'''[[https://launchpad.net/~ubuntu-core-doc|Ubuntu Documentation Committers]]''' is a peer approved team which has write access to the official system documentation branches. Approval is necessary because this documentation is included directly with every Ubuntu operating system. A system of quality control and review is also applied.

Before applying for membership applicants are asked to:

 * read [[https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation|System Documentation]].

 * contribute a number of patches to the system documentation which, taken as a whole, demonstrate to the reviewer that the applicant applies the requirements of the [[DocumentationTeam/StyleGuide|documentation team style guide]], and is comfortable working with [[http://bazaar.canonical.com/en/|Bazaar]], [[https://launchpad.net/|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.

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

= Wiki Administrators =

'''[[https://launchpad.net/~ubuntu-doc-wiki-admins|Ubuntu Documentation Wiki Administrators]]''' is an experienced team who 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.

Before applying for membership applicants are asked to:

 * read [[https://wiki.ubuntu.com/DocumentationTeam/StyleGuide|Style Guide]]

 * read [[https://help.ubuntu.com/community/WikiGuide|Wiki Guide]]

 * read [[https://help.ubuntu.com/community/WikiGuide/DeletingAndRenaming|DeletingAndRenaming]]

 * make significant contributions to the help wiki by way of edits to pages

 * demonstrate an understanding of the issues that can arise from deleting and renaming pages, and how to avoid them.

= Style Guide =

The work of all members of the Documentation Team is subject to our [[/StyleGuide|Style Guide]] and you will be expected to learn from its advice so that your work will be of greater benefit to its readers.

= Team progression =

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

You can apply to join either of these teams by posting to their 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.
[[https://wiki.ubuntu.com/DocumentationTeam/Contact| Contact the Documentation team]] for any questions or feedback you may have.

A Documentation Team meeting is planned for the first Tuesday of every month @ 17:00 UTC.

Freezes for Bionic – String Freeze March 29 – Non-language packs April 12

Ubuntu Doc Team Home Page

Welcome to the Ubuntu Doc Team Home page, the starting point for those interested in improving Ubuntu documentation. May your life go well.

Introduction

The Documentation Team takes care of official documentation for both Desktop and Server. It also contributes to the community help wiki. This is done via several sub-teams. Besides contributing text to both types via the Contributors team, each has its own administrative team, the Committers team (official docs) and the Wiki Administrators team (help wiki). See Documentation Team organization for more on the overarching Doc team and these 3 sub-teams.

All documentation falls under this license.

Contact the Documentation team for any questions or feedback you may have.

Sub-pages


CategoryDocteam CategoryUbuntuTeams

DocumentationTeam (last edited 2014-07-02 22:19:31 by knome)