scope.dbk

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