<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
- "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+ <!ENTITY % commondata SYSTEM "common.ent" > %commondata;
+]>
<chapter id="new-maintainer">
<title>Applying to Become a Maintainer</title>
<section id="getting-started">
<title>Getting started</title>
<para>
So, you've read all the documentation, you've gone through the <ulink
-url="http://www.debian.org/doc/maint-guide/">Debian New Maintainers'
+url="http://&www-debian-org;/doc/maint-guide/">Debian New Maintainers'
Guide</ulink>, understand what everything in the <systemitem
role="package">hello</systemitem> example package is for, and you're about to
Debianize your favorite piece of software. How do you actually become a Debian
developer so that your work can be incorporated into the Project?
</para>
<para>
-Firstly, subscribe to <email>debian-devel@lists.debian.org</email> if you
+Firstly, subscribe to <email>debian-devel@&lists-host;</email> if you
haven't already. Send the word <literal>subscribe</literal> in the
<emphasis>Subject</emphasis> of an email to
-<email>debian-devel-REQUEST@lists.debian.org</email>. In case of problems,
-contact the list administrator at <email>listmaster@lists.debian.org</email>.
+<email>debian-devel-REQUEST@&lists-host;</email>. In case of problems,
+contact the list administrator at <email>listmaster@&lists-host;</email>.
More information on available mailing lists can be found in <xref
linkend="mailing-lists"/> .
-<email>debian-devel-announce@lists.debian.org</email> is another list which is
+<email>debian-devel-announce@&lists-host;</email> is another list which is
mandatory for anyone who wishes to follow Debian's development.
</para>
<para>
</para>
<para>
Another good list to subscribe to is
-<email>debian-mentors@lists.debian.org</email>. See <xref linkend="mentors"/>
+<email>debian-mentors@&lists-host;</email>. See <xref linkend="mentors"/>
for details. The IRC channel <literal>#debian</literal> can also be helpful;
see <xref linkend="irc-channels"/> .
</para>
<para>
-When you know how you want to contribute to Debian GNU/Linux, you should get in
+When you know how you want to contribute to &debian-formal;, you should get in
contact with existing Debian maintainers who are working on similar tasks.
That way, you can learn from experienced developers. For example, if you are
interested in packaging existing software for Debian, you should try to get a
sponsor. A sponsor will work together with you on your package and upload it
to the Debian archive once they are happy with the packaging work you have
done. You can find a sponsor by mailing the
-<email>debian-mentors@lists.debian.org</email> mailing list, describing your
+<email>debian-mentors@&lists-host;</email> mailing list, describing your
package and yourself and asking for a sponsor (see <xref linkend="sponsoring"/>
and <ulink
url="http://people.debian.org/~mpalmer/debian-mentors_FAQ.html"></ulink> for
<para>
One pitfall could be a too-generic local part in your mailadress: Terms like
mail, admin, root, master should be avoided, please see <ulink
-url="http://www.debian.org/MailingLists/"></ulink> for details.
+url="&url-debian-lists;"></ulink> for details.
</para>
</section>
<section id="mentors">
<title>Debian mentors and sponsors</title>
<para>
-The mailing list <email>debian-mentors@lists.debian.org</email> has been set up
+The mailing list <email>debian-mentors@&lists-host;</email> has been set up
for novice maintainers who seek help with initial packaging and other
developer-related issues. Every new developer is invited to subscribe to that
list (see <xref linkend="mailing-lists"/> for details).
<section id="registering">
<title>Registering as a Debian developer</title>
<para>
-Before you decide to register with Debian GNU/Linux, you will need to read all
+Before you decide to register with &debian-formal;, you will need to read all
the information available at the <ulink
-url="http://www.debian.org/devel/join/newmaint">New Maintainer's
+url="&url-newmaint;">New Maintainer's
Corner</ulink>. It describes in detail the preparations you have to do before
you can register to become a Debian developer. For example, before you apply,
-you have to read the <ulink url="http://www.debian.org/social_contract">Debian
+you have to read the <ulink url="&url-social-contract;">Debian
Social Contract</ulink>. Registering as a developer means that you agree with
and pledge to uphold the Debian Social Contract; it is very important that
-maintainers are in accord with the essential ideas behind Debian GNU/Linux.
+maintainers are in accord with the essential ideas behind &debian-formal;.
Reading the <ulink url="http://www.gnu.org/gnu/manifesto.html">GNU
Manifesto</ulink> would also be a good idea.
</para>
<para>
The process of registering as a developer is a process of verifying your
identity and intentions, and checking your technical skills. As the number of
-people working on Debian GNU/Linux has grown to over 900 and our systems are
+people working on &debian-formal; has grown to over &number-of-maintainers; and our systems are
used in several very important places, we have to be careful about being
compromised. Therefore, we need to verify new maintainers before we can give
them accounts on our servers and let them upload packages.
technical documentation. Furthermore, you need a GnuPG key which has been
signed by an existing Debian maintainer. If your GnuPG key is not signed yet,
you should try to meet a Debian Developer in person to get your key signed.
-There's a <ulink url="http://nm.debian.org/gpg.php">GnuPG Key Signing
+There's a <ulink url="&url-newmaint-db;gpg.php">GnuPG Key Signing
Coordination page</ulink> which should help you find a Debian Developer close
to you. (If there is no Debian Developer close to you, alternative ways to
pass the ID check may be permitted as an absolute exception on a
case-by-case-basis. See the <ulink
-url="http://www.debian.org/devel/join/nm-step2">identification page</ulink> for
+url="&url-devel-docs;join/nm-step2">identification page</ulink> for
more information.)
</para>
<para>
</para>
<para>
If your public key isn't on a public key server such as
-<literal>subkeys.pgp.net</literal>, please read the documentation available at
-<ulink url="http://www.debian.org/devel/join/nm-step2">NM Step 2:
+&pgp-keyserv;, please read the documentation available at
+<ulink url="&url-devel-docs;join/nm-step2">NM Step 2:
Identification</ulink>. That document contains instructions on how to put your
key on the public key servers. The New Maintainer Group will put your public
key on the servers if it isn't already there.
<para>
When you have found an advocate, have your GnuPG key signed and have already
contributed to Debian for a while, you're ready to apply. You can simply
-register on our <ulink url="http://nm.debian.org/newnm.php">application
+register on our <ulink url="&url-newmaint-db;newnm.php">application
page</ulink>. After you have signed up, your advocate has to confirm your
application. When your advocate has completed this step you will be assigned
an Application Manager who will go with you through the necessary steps of the
New Maintainer process. You can always check your status on the <ulink
-url="http://nm.debian.org/">applications status board</ulink>.
+url="&url-newmaint-db;">applications status board</ulink>.
</para>
<para>
For more details, please consult <ulink
-url="http://www.debian.org/devel/join/newmaint">New Maintainer's Corner</ulink>
+url="&url-newmaint;">New Maintainer's Corner</ulink>
at the Debian web site. Make sure that you are familiar with the necessary
steps of the New Maintainer process before actually applying. If you are well
prepared, you can save a lot of time later on.