1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
#use wml::debian::ddp title="Debian Documentation Project"
<p>The Debian Documentation Project was formed to coordinate and unify all
efforts to write more and better documentation for the Debian system.</p>
<h2>DDP Work</h2>
<div class="line">
<div class="item col50">
<h3>Manuals</h3>
<ul>
<li><strong><a href="user-manuals">Users' manuals</a></strong></li>
<li><strong><a href="devel-manuals">Developers' manuals</a></strong></li>
<li><strong><a href="misc-manuals">Miscellaneous manuals</a></strong></li>
<li><strong><a href="#other">Problematic manuals</a></strong></li>
</ul>
<h3>Current Topics</h3>
<ul>
<li><a href="topics">Topics</a> for discussion or resolution.</li>
</ul>
<h3>Todo List</h3>
<ul>
<li><a href="todo">Things that need to be done</a>; volunteers
always appreciated!</li>
<li><a href="todo#ideas">Good and bad ideas</a>, larger issues
that need to be resolved.</li>
</ul>
</div>
<div class="item col50 lastcol">
<h3><a href="docpolicy">Documentation Policy</a></h3>
<ul>
<li>Manual licenses comply with DFSG.</li>
<li>Directory structure: filesystem, WWW, FTP.</li>
<li>We use Docbook XML for our documents. Use of DebianDoc SGML is being phased out.</li>
<li>Every document has one maintainer.</li>
</ul>
<h3>Links</h3>
<ul>
<li><a href="https://lists.debian.org/debian-doc/">debian-doc mailing
list archive</a></li>
# <li><a href="https://www.debian.org/~elphick/ddp/linuxdoc-sgml.ps">
# Linuxdoc-SGML</a> article in the Linux Journal</li>
<li><a href="http://tldp.org/LDP/LGNET/issue15/debian.html">Debian
Linux Installation & Getting Started</a> article in the Linux
Gazette</li>
</ul>
<h3>SVN Access</h3>
<ul>
<li><a href="cvs">How to access</a> the SVN repository of the DDP</li>
<li>DDP SVN documents in <a href="manuals/">manuals
subdirectory</a></li>
</ul>
</div>
</div>
<hr class="clr">
<p>Note to Portuguese-speaking users: visit
<a href="http://wiki.debianbrasil.org/">DDP-BR</a>, web pages about
localization of Debian documentation in Brazilian Portuguese language.</p>
<hr />
<h2><a name="other">Problematic manuals</a></h2>
<p>In addition to the normally advertized manuals, we maintain the following
manuals that
are problematic in one way or another, so we can't recommend them to all
users. Caveat emptor.</p>
<ul>
<li><a href="obsolete#meta">Debian META Manual</a>, incomplete and
outdated, dubious purpose given these web pages</li>
<li><a href="obsolete#tutorial">Debian Tutorial</a>, obsoleted by
<a href="obsolete#guide">Debian Guide</a></li>
<li><a href="obsolete#userref">Debian User Reference Manual</a>,
stalled and quite incomplete</li>
<li><a href="obsolete#system">Debian System Administrator's
Manual</a>, stalled, almost empty</li>
<li><a href="obsolete#network">Debian Network Administrator's
Manual</a>, stalled, incomplete</li>
<li><a href="devel-manuals#swprod">How Software Producers can distribute
their products directly in .deb format</a>, merely planned</li>
<li><a href="devel-manuals#packman">Debian Packaging Manual</a>, partly
merged in <a href="devel-manuals#policy">Debian Policy Manual</a>,
the rest will be included in a dpkg reference manual that is yet to be
written</li>
<li><a href="obsolete#makeadeb">Introduction: Making a Debian
Package</a>, obsoleted by
<a href="devel-manuals#maint-guide">Debian New Maintainers' Guide</a></li>
<li><a href="obsolete#programmers">Debian Programmers' Manual</a>,
obsoleted by
<a href="devel-manuals#maint-guide">Debian New Maintainers' Guide</a></li>
<li><a href="obsolete#books">Debian Book Suggestions</a>, merely
planned, see <a href="books">the books page</a></li>
<li><a href="obsolete#dict">Debian Dictionary</a>, not being worked on.</li>
<li><a href="obsolete#repo">Debian Repository HOWTO</a>, outdated after introduction of secure APT</li>
</ul>
|
