tidied up the db.d.o stuff

git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@2174 313b444b-1b9f-4f58-a734-7bb04f332e8d

diff --git a/common.ent b/common.ent
index c38e7d53e8c6b3c4f71da347ecffbd15b64b162a..88eee83bed2be1b8cb203ff44e760e1a1deebae0 100644 (file)
--- a/common.ent
+++ b/common.ent
@@ -103,6 +103,7 @@
 <!entity url-debconf-l10n-help "http://&www-debian-org;/intl/l10n/templates/hints">
 
 <!entity url-dmup "http://&www-debian-org;/devel/dmup">
+<!entity url-worldmap "http://&www-debian-org;/devel/developers.loc">
 
 <!entity url-i18n-doc-check "&url-cvsweb;boot-floppies/documentation/doc-check?rev=HEAD&amp;content-type=text/vnd.viewcvs-markup">
 

diff --git a/developers-reference.sgml b/developers-reference.sgml
index dcaced2e7dd34165a0c6d573556d80b8ad9112ca..514962dafe44a487ffdb1c167e3b09fbf1683894 100644 (file)
--- a/developers-reference.sgml
+++ b/developers-reference.sgml
@@ -6,7 +6,7 @@
   <!entity % commondata  SYSTEM "common.ent" > %commondata;
 
   <!-- CVS revision of this document -->
-  <!entity cvs-rev "$Revision: 1.179 $">
+  <!entity cvs-rev "$Revision: 1.180 $">
   <!-- if you are translating this document, please notate the CVS
        revision of the developers reference here -->
   <!--
@@ -265,18 +265,15 @@ available in <ref id="newmaint">.
 
       <sect id="user-maint">Maintaining your Debian information
        <p>
-There's a LDAP database containing information about all
-developers, you can access it at <url id="&url-debian-db;">. You can
-update your password (this password is propagated to most of the machines
-that are accessible to you), your address, your country, the latitude and
-longitude of the point where you live, phone and fax numbers, your
-preferred shell, your IRC nickname, your web page and the email that
-you're using as alias for your debian.org email. Most of the information
-is not accessible to the public, for more details about this
-database, please read its online documentation that you can find
-at <url id="&url-debian-db-doc;">.
+There's a LDAP database containing information about Debian developers at
+<url id="&url-debian-db;">. You should enter your information there and
+update it as it changes. Most notably, make sure that the address where your
+debian.org email gets forwarded to is always up to date, as well as the
+address where you get your debian-private subscription if you choose to
+subscribe there.
        <p>
-You have to keep the information available there up-to-date.
+For more information about the database, please see <ref id="devel-db">.
+
 
 
       <sect id="key-maint">Maintaining your public key
@@ -689,10 +686,22 @@ the finger service on Debian servers, try
 <prgn>finger yourlogin@db.debian.org</prgn> to see what it reports.
        <p>
 Developers can <url name="log into the database" id="&url-debian-db-login;">
-to change their debian-private list subscription, their personal
-information, to mark themselves on vacation, etc.
-For more information on keeping your entry the developer database
-up-to-date, please see <ref id="user-maint">.
+to change various information about themselves, such as:
+<list>
+       <item>forwarding address for your debian.org email
+       <item>subscription to debian-private
+       <item>whether you are on vacation
+       <item>personal information such as your address, country,
+             the latitude and longitude of the place where you live
+             for use in <url name="the world map of Debian developers"
+             id="&url-worldmap;">, phone and fax numbers, IRC nickname
+             and web page
+       <item>password and preferred shell on Debian Project machines
+</list>
+       <p>
+Most of the information is not accessible to the public, naturally.
+For more information please read the online documentation that you can find
+at <url id="&url-debian-db-doc;">.
        <p>
 One can also submit their SSH keys to be used for authorization on the
 official Debian machines, and even add new *.debian.net DNS entries.