SystemDocumentation

Differences between revisions 3 and 5 (spanning 2 versions)
Revision 3 as of 2008-08-31 15:05:43
Size: 1672
Editor: 79-72-87-179
Comment: add reference to serverguide
Revision 5 as of 2008-08-31 15:25:07
Size: 3177
Editor: 79-72-87-179
Comment: getting started section
Deletions are marked like this. Additions are marked like this.
Line 7: Line 7:
In order to contribute to the system documentation, you need to know a bit about the tools and processes the team uses to maintain the documentation. In order to contribute to the system documentation, you need to know a bit about the tools and processes the team uses to maintain the documentation. '''Don't worry if you don't know any of our tools yet.''' They are very easy to learn and it's possible to make useful contributions before learning how to use all the tools.

The first thing you need to do is familiarize yourself with the docteam environment. This page briefly describes the various things you need to know and provides links for further reading and discovery.

== Getting Started ==

An important (and easy) way of helping out is to proof-read the system documentation and report any errors that you find.

 * Follow the instructions given in the documentation to see if they work and if they make sense
 * Click links to make sure that they still work
 * Report spelling and grammar mistakes, mis-translated words and typos
 * Report documentation that you think is missing or inadequate

See '''[[DocumentationTeam/TechReview|Technical Reviewing Documentation]]''' for information on becoming a technical reviewer/proofreader.

You can file bug reports on [[https://bugs.launchpad.net/products/ubuntu-doc/+filebug|Launchpad]] if you find a problem. See [[https://help.ubuntu.com/community/ReportingBugs|Reporting Bugs]] for more information on how to file bugs correctly.

Alternatively, you can make suggestions on improving the documentation on the [[https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc|Documentation Team mailing list]].
Line 27: Line 44:

== Tasks ==

You can get some ideas for tasks that need doing on the system documentation on the '''[[/Tasks]]''' page.

One of the major tasks of the DocumentationTeam is to take care of the documentation which comes with every Ubuntu system, and is available from System -> Help and Support on an Ubuntu desktop.

The team also takes care of the system documentation available in Kubuntu, Xubuntu and Edubuntu and the Ubuntu Server Guide.

In order to contribute to the system documentation, you need to know a bit about the tools and processes the team uses to maintain the documentation. Don't worry if you don't know any of our tools yet. They are very easy to learn and it's possible to make useful contributions before learning how to use all the tools.

The first thing you need to do is familiarize yourself with the docteam environment. This page briefly describes the various things you need to know and provides links for further reading and discovery.

Getting Started

An important (and easy) way of helping out is to proof-read the system documentation and report any errors that you find.

  • Follow the instructions given in the documentation to see if they work and if they make sense
  • Click links to make sure that they still work
  • Report spelling and grammar mistakes, mis-translated words and typos
  • Report documentation that you think is missing or inadequate

See Technical Reviewing Documentation for information on becoming a technical reviewer/proofreader.

You can file bug reports on Launchpad if you find a problem. See Reporting Bugs for more information on how to file bugs correctly.

Alternatively, you can make suggestions on improving the documentation on the Documentation Team mailing list.

Repository

If you want to make changes to the system documentation, you need to download the repository which stores the latest copy of the documentation. Like most Ubuntu projects, we store our material using the Bazaar (or bzr) version control system:

  • Detailed information on on using the bazaar branches and getting to our repository is on the /Repository page.

DocBook

The system documentation is written in a simple markup language called DocBook XML. DocBook is similar to HTML and is easy to learn to write with. When you start working on our documents, you will see how DocBook is employed by the docteam.

  • The /Editing page details how to edit the documents.

  • The /Checking page explains how to view the files you have edited and to check your work.

Submitting your Contribution

Once you have made a change to a document and checked your work, the next step is to send your contribution to the DocumentationTeam.

Tasks

You can get some ideas for tasks that need doing on the system documentation on the /Tasks page.

DocumentationTeam/SystemDocumentation (last edited 2015-01-09 18:41:02 by petermatulis)