Introduction
1.1. GNOME Documentation Project
- 1.1.1. Goals
- 1.1.2. Joining the GDP
- 1.1.3. Collaborating with the GDP
1.1.1. Goals
The GNOME Documentation Project (GDP) aims to provide GNOME and GNOME applications with a complete, intuitive, and clear documentation system. At the center of the GDP is Yelp, which presents a unified interface to GNOME-specific documentation as well as other Linux documentation such as man pages and texinfo documents. The GNOME Help System provides a comprehensive view of documentation on a machine by dynamically assembling the documentation of GNOME applications and components which are installed. The GDP is responsible for writing numerous GNOME-related documents for users. User documentation include the GNOME User's Guide, the GNOME Release Notes, and GNOME application documentation. Most GNOME applications have their own manual in addition to context sensitive help.
1.1.2. Joining the GDP
Documenting GNOME and all the numerous GNOME applications is a very large project. The GDP is always looking for people to help write, update, and edit documentation. If you are interested in joining the GDP team, you should join the http://mail.gnome.org/mailman/listinfo/gnome-doc-list/. Read Section 3 ― Getting Started Writing GNOME Documentation, for help selecting a project to work on. Feel free to introduce yourself on the gnome-doc-list mailing list and indicate which project you intend to work on, or else ask for suggestions of important documents which need work done. You may also want to join the #docs IRC channel on irc.gnome.org to meet other GDP members and discuss any questions you may have. For a list of GDP projects and members, see the http://developer.gnome.org/projects/gdp.
1.1.3. Collaborating with the GDP
GNOME developers, packagers, and translators may not be writing GNOME documentation but will want to understand how the GNOME documentation system works and will need to collaborate with GDP members. This document should help to outline the structure of how the GNOME documentation system works. Developers who do not write the documentation for their applications are encouraged to find a GDP member to write the documentation. This is best done by sending an email to the http://mail.gnome.org/mailman/listinfo/gnome-doc-list/ describing the application, where it can be downloaded from, and that the developer(s) would like a GDP member to write documentation for the application. The #docs IRC channel on irc.gnome.org is another option for contacting GDP members.
1.2. Notation and Conventions
This Handbook uses the following notation:
| /usr/bin | Directory |
| foo.sgml | Filename |
| command | Command or text that would be typed. |
| replaceable | "Variable" text that can be replaced. |
| Program or Doc Code | Program or document code |
1.3. About this Handbook
This Handbook is a guide for both writing user documentation for GNOME components and applications and for properly binding and packaging documentation into GNOME applications.
This Handbook is not a guide for writing developer documentation. If you can read C and wish to write developer documentation take a look at GTK+ Reference Documentation Project.
This Handbook, like all GNOME documentation, was written in DocBook(XML) and is available in several formats including XML, HTML, PostScript, and PDF. For the latest version, see http://library.gnome.org/devel/gdp-handbook/stable/. Alternately, one may download it anonymously from GNOME SVN under gnome-devel-docs/trunk/gdp-handbook.