DocumentationTeam

Differences between revisions 72 and 84 (spanning 12 versions)
Revision 72 as of 2013-12-08 22:49:19
Size: 4919
Editor: belkinsa
Comment: We don't have any meetings for now, removed the banner for now
Revision 84 as of 2021-06-11 05:29:18
Size: 1426
Editor: roguescholar
Comment: Update license reference for documentation to the current choice of CC-BY-SA 3.0
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
<<Include(DocumentationTeam/MeetingBanner)>>
Line 4: Line 5:
||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents(3)>>|| = Ubuntu Documentation Team =
Line 6: Line 7:
= Introduction = Welcome to the Ubuntu Documentation Team home page, the starting point for those interested in improving Ubuntu documentation.
Line 8: 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
The Documentation Team takes care of [[DocumentationTeam/SystemDocumentation|official documentation]] for both the Desktop and Server editions of Ubuntu. It also contributes to the [[DocumentationTeam/Wiki|Community Help Wiki]], with responsibility for each of these documentation sets devolving upon the sub-team which shares its name. Besides contributing text to the official documentation and the wiki via the '''Contributors team''', each has its own administrative personnel: the '''Committers team''' for official docs and the '''Wiki Administrators team''' for the help wiki. See [[https://wiki.ubuntu.com/DocumentationTeam/Organization|Documentation Team organization]] for more information on this hierarchy structure.
Line 13: Line 11:
All of the work produced by the Ubuntu Documentation team is released under the terms of the '''[[https://creativecommons.org/licenses/by-sa/3.0/|Creative Commons Attribution-ShareAlike 3.0 Unported License]]''' (CC BY-SA 3.0).
Line 14: Line 13:
An explaination of the structure of the Documentation Team and information about how to join it. Feel free to get in touch with the team directly using the 'Contact us' link above with any questions or feedback you may have.
Line 16: 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.

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.

= Sub-pages =

||<tablestyle="width:90%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">'''This Team wiki page contains the following sub-pages:'''||
||<<Navigation(children,1)>>||
<<BR>>

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

Ubuntu Documentation Team

Welcome to the Ubuntu Documentation Team home page, the starting point for those interested in improving Ubuntu documentation.

The Documentation Team takes care of official documentation for both the Desktop and Server editions of Ubuntu. It also contributes to the Community Help Wiki, with responsibility for each of these documentation sets devolving upon the sub-team which shares its name. Besides contributing text to the official documentation and the wiki via the Contributors team, each has its own administrative personnel: the Committers team for official docs and the Wiki Administrators team for the help wiki. See Documentation Team organization for more information on this hierarchy structure.

All of the work produced by the Ubuntu Documentation team is released under the terms of the Creative Commons Attribution-ShareAlike 3.0 Unported License (CC BY-SA 3.0).

Feel free to get in touch with the team directly using the 'Contact us' link above with any questions or feedback you may have.



CategoryDocteam CategoryUbuntuTeams

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