| 1 |
<html><head><title>Documentation Policy</title></head>
|
| 2 |
<!-- begin header -->
|
| 3 |
<body bgcolor="#ffffff">
|
| 4 |
<table width="100%" BORDER=3 CELLPADDING=5>
|
| 5 |
<tr>
|
| 6 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="index.html">H<font size="-1">OME</font></a>
|
| 7 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="news.html">N<font size="-1">EWS</font></a>
|
| 8 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="topics.html">T<font size="-1">OPICS</font></a>
|
| 9 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="issues.html">I<font size="-1">SSUES</font></a>
|
| 10 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="ideas.html">I<font size="-1">DEAS</font></a>
|
| 11 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="todo.html">T<font size="-1">ODO</font></a>
|
| 12 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="docpolicy.html">P<font size="-1">OLICY</font></a>
|
| 13 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="links.html">L<font size="-1">INKS</font></a>
|
| 14 |
<td bgcolor="#e0e0e0" width="10%" align=center><a href="manuals.html">M<font size="-1">ANUALS</font></a>
|
| 15 |
</table><p>
|
| 16 |
|
| 17 |
<!-- end header -->
|
| 18 |
|
| 19 |
<h1>Documentation Policy</h1>
|
| 20 |
|
| 21 |
Here is a list of decision that were made on our mailing list and
|
| 22 |
approved by our Documentation Manager, Susan G. Kleinmann.<p>
|
| 23 |
<ul>
|
| 24 |
<li>All Manuals of the DDP (Debian Documentation Project) will be
|
| 25 |
released under DFSG-compliant licenses, must likely GPL.
|
| 26 |
<p>
|
| 27 |
|
| 28 |
<li>We'll use the following directory structure in the filesystem and
|
| 29 |
on our servers:
|
| 30 |
<pre>
|
| 31 |
|
| 32 |
Filesystem:
|
| 33 |
/usr/doc/manuals/debian-policy/index.html
|
| 34 |
/usr/doc/manuals/debian-policy.ps.gz (optional)
|
| 35 |
|
| 36 |
WWW server:
|
| 37 |
http://www.debian.org/manuals/debian-policy/index.html
|
| 38 |
|
| 39 |
FTP server:
|
| 40 |
ftp://ftp.debian.org/debian/doc/manuals/debian-policy.html.tar.gz
|
| 41 |
ftp://ftp.debian.org/debian/doc/manuals/debian-policy.text.gz
|
| 42 |
ftp://ftp.debian.org/debian/doc/manuals/debian-policy.dvi.gz
|
| 43 |
ftp://ftp.debian.org/debian/doc/manuals/debian-policy.ps.gz
|
| 44 |
ftp://ftp.debian.org/debian/doc/manuals/debian-policy.sgml.tar.gz
|
| 45 |
|
| 46 |
</pre><p>
|
| 47 |
<li>We'll use <strong>debiandoc-sgml</strong> for our documents.<p>
|
| 48 |
The other options was linuxdoc-sgml.<p>
|
| 49 |
Here are some of the <a href="dtd.html">arguments</a> that came up
|
| 50 |
during the discussion.<p>
|
| 51 |
<li>We'll use SGML as source format.<p>
|
| 52 |
The other options were: LaTeX, HTML, texinfo, and several other minor
|
| 53 |
formats.<p>
|
| 54 |
Note that this does not mean that users have to learn SGML to submit
|
| 55 |
changes to our documents. We accept all other formats as well. However,
|
| 56 |
they will be translated into SGML by one of the Debian DOC people.<p>
|
| 57 |
<li>Every Debian document will have a single person list as
|
| 58 |
<em>Maintainer</em> and optional a group of people listed as
|
| 59 |
<em>Co-Maintainers</em>.
|
| 60 |
</ul>
|
| 61 |
|
| 62 |
<!-- begin footer -->
|
| 63 |
<p>
|
| 64 |
<hr><p>
|
| 65 |
Please send all comments, criticisms and suggestions about these web pages
|
| 66 |
to <a href="mailto:olly@lfix.co.uk">Oliver Elphick</a> or to the
|
| 67 |
mailing list of the
|
| 68 |
<a href="mailto:debian-doc@lists.debian.org">Debian Documentation Team</a>.
|
| 69 |
<p>
|
| 70 |
<I>Last changed on 7 July 1998 by <A HREF="mailto:olly@lfix.co.uk">Oliver Elphick</A></I>
|
| 71 |
</body></html>
|
| 72 |
<!-- end footer -->
|