[ previous ] [ Contents ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ 7 ] [ A ] [ next ]

Debian Documentation Policy (DEPRECATED and OLD DRAFT)
Chapter 1 - Preface

This document is still under development and many chapters are to be written (TBW). Sections which need work, either to write them down or get to consensus by all documentation members are marked with FIXME.

1.1 Scope

The Debian Documentation Project (it is usually called DDP for short) was formed to coordinate and unify all efforts that relate to documentation in the Debian project. This includes the documentation associated with the Debian GNU/Linux (or other) distributions, as well as documentation related to the internals of the project.

This manual describes the established policy on how documents are to be handled within the Debian project (documents in a broad scope, it's not just manuals). This includes how to contribute documents, how to package them for inclusion in Debian distributions and how they are published either at the Debian web site, ftp site (or associated mirrors) and even CD images of Debian distributions. Even if packages are involved (since it's the mechanism for distributing any piece of data in a Debian distribution) it is not a tutorial on how to build packages and it will not go into lengths describing how the packaging system works.

The DDP covers a broad range of documentation that is related to the Debian project. Some of the documentation might be handled by people who are not directly in the DDP, but who maintain a set of documentation. To make it short the DDP might be considered a reduced version of the famous phrase cutting it into: all your documents are belong to us. That is, any and all document that is either prepared or supported by the Debian project (included in the distribution, published in the web site) is managed through the DDP. This includes:

FIXME: even if the web team works aside of the DDP team (there are some people in both teams), there are some documents that originate from the web server and are published there first. Maybe it should be necessary to add a chapter regarding the web team and their tools?

Of course, Debian feeds itself of many documentation that is beyond the scope of the Debian project itself. An example of this might be UNIX manpages for common (GNU) programs, info manuals, external documentation (such as the Linux Documentation Project's HOWTOs) and many other documentation that is typically included in a Debian distribution. Even if it would be good to provide a common framework for all of these, many of them are already part of other projects that provide their own setups for producing documentation (including publishing formats, translations, etc.). As such, the DDP tries to lay a common framework on how this information should be installed, and, if needed, provides resources to cooperate with these external projects.

1.2 New versions of this document

The current version of this document is available from the DDP as http://www.debian.org/doc/manuals/ddp-policy/.

The current source version of this document is available from the DDP CVS server:

     $ CVSROOT=:pserver:anonymous@cvs.debian.org:/cvs/debian-doc
     $ export CVSROOT
     $ cvs co ddp/manuals.sgml/ddp-policy

In addition, this manual is distributed via the Debian package ddp-policy.

FIXME The package has not been yet created and included with the distribution.

1.3 How to provide feedback to this policy

As the Debian project is continuously evolving so this manual does too.

While the authors of this document have tried hard to avoid typos and other errors, these do still occur. If you discover an error in this manual or if you want to give any comments, suggestions, or criticisms please send an email to the Debian Documentation Project List, debian-doc@lists.debian.org, or submit a bug report against the ddp-policy package.

FIXMEUntil the package for ddp-policy is created, please send an email to debian-doc@lists.debian.org

[ previous ] [ Contents ] [ 1 ] [ 2 ] [ 3 ] [ 4 ] [ 5 ] [ 6 ] [ 7 ] [ A ] [ next ]

Debian Documentation Policy (DEPRECATED and OLD DRAFT)

CVS, Sun, 06 Feb 2011 16:44:38 +0000

Debian Documentation Project debian-doc@lists.debian.org
Authors, Section A.1