chiark / gitweb /
[developers-reference.git] / scope.dbk
1 <?xml version="1.0" encoding="utf-8"?>
2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3     "">
4 <chapter id="scope">
5 <title>Scope of This Document</title>
6 <para>
7 The purpose of this document is to provide an overview of the recommended
8 procedures and the available resources for Debian developers.
9 </para>
10 <para>
11 The procedures discussed within include how to become a maintainer (<xref
12 linkend="new-maintainer"/> ); how to create new packages (<xref
13 linkend="newpackage"/> ) and how to upload packages (<xref linkend="upload"/>
14 ); how to handle bug reports (<xref linkend="bug-handling"/> ); how to move,
15 remove, or orphan packages (<xref linkend="archive-manip"/> ); how to port
16 packages (<xref linkend="porting"/> ); and how and when to do interim releases
17 of other maintainers' packages (<xref linkend="nmu"/> ).
18 </para>
19 <para>
20 The resources discussed in this reference include the mailing lists (<xref
21 linkend="mailing-lists"/> ) and servers (<xref linkend="server-machines"/> ); a
22 discussion of the structure of the Debian archive (<xref linkend="archive"/> );
23 explanation of the different servers which accept package uploads (<xref
24 linkend="upload-ftp-master"/> ); and a discussion of resources which can help
25 maintainers with the quality of their packages (<xref linkend="tools"/> ).
26 </para>
27 <para>
28 It should be clear that this reference does not discuss the technical details
29 of Debian packages nor how to generate them.  Nor does this reference detail
30 the standards to which Debian software must comply.  All of such information
31 can be found in the <ulink
32 url="">Debian Policy Manual</ulink>.
33 </para>
34 <para>
35 Furthermore, this document is <emphasis>not an expression of formal
36 policy</emphasis>.  It contains documentation for the Debian system and
37 generally agreed-upon best practices.  Thus, it is not what is called a
38 ``normative'' document.
39 </para>
40 </chapter>