updated (people.d.o->gluck), expanded (non-US) and mostly rewrote the Debian servers...

[developers-reference.git] / developers-reference.sgml

diff --git a/developers-reference.sgml b/developers-reference.sgml
index 190b8e65a55e7b3eb1c9f247d043e62bfcd91981..fa403ee6baf4f4b321dbc47f4b6808aa7de4b714 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 % commondata  SYSTEM "common.ent" > %commondata;
 
   <!-- CVS revision of this document -->

-  <!entity cvs-rev "$Revision: 1.118 $">
+  <!entity cvs-rev "$Revision: 1.119 $">

   <!-- if you are translating this document, please notate the CVS
        revision of the developers reference here -->
   <!--
   <!-- if you are translating this document, please notate the CVS
        revision of the developers reference here -->
   <!--


@@ -402,7 +402,7 @@ emailing to &email-debian-keyring;.
    <chapt id="resources">Resources for Debian Developers
      <p>
 In this chapter you will find a very brief road map of the Debian
    <chapt id="resources">Resources for Debian Developers
      <p>
 In this chapter you will find a very brief road map of the Debian

-mailing lists, the main Debian servers, other Debian machines
+mailing lists, the Debian machines

 which may be available to you as a developer, and all the other
 resources that are available to help you in your maintainer work.
 
 which may be available to you as a developer, and all the other
 resources that are available to help you in your maintainer work.
 


@@ -493,17 +493,43 @@ but it can not contain everything. Most of the other interesting documents
 are linked from <url id="&url-devel-docs;" name="The Developers' Corner">.
 Take the time to browse all the links, you will learn many more things.
 
 are linked from <url id="&url-devel-docs;" name="The Developers' Corner">.
 Take the time to browse all the links, you will learn many more things.
 

-      <sect id="server-machines">Debian servers
+
+      <sect id="server-machines">Debian machines
+       <p>
+Debian has several computers working as servers, most of which serve
+critical functions in the Debian project. Most of the machines are used
+for porting activities, and they all have a permanent connection to the
+Internet.
+       <p>
+Most of the machines are available for individual developers to use,
+as long as the developers follow the rules set forth in the
+<url name="Debian Machine Usage Policies" id="&url-dmup;">.
+       <p>
+Generally speaking, you can use these machines for Debian-related purposes
+as you see fit.  Please be kind to system administrators, and do not use
+up tons and tons of disk space, network bandwidth, or CPU without first
+getting the approval of the admins.  Usually these machines are run by
+volunteers.

        <p>
        <p>

-Debian servers are well known servers which serve critical functions
-in the Debian project.  Every developer should know what these servers
-are and what they do.
+Please take care to protect your Debian passwords and SSH keys installed on
+Debian machines. Avoid login or upload methods which send passwords over
+the Internet in the clear, such as telnet, FTP, POP etc.
+       <p>
+Please do not put any material that doesn't relate to Debian on the Debian
+servers, unless you have prior permission.
+       <p>
+The current list of Debian machines is available at
+<url id="&url-devel-machines;">. That web page contains machine names,
+contact information, information about who can log in, SSH keys etc.

        <p>
 If you have a problem with the operation of a Debian server, and you
 think that the system operators need to be notified of this problem,
        <p>
 If you have a problem with the operation of a Debian server, and you
 think that the system operators need to be notified of this problem,

-please find the contact address for the particular machine at <url
-id="&url-devel-machines;">.  If you have a non-operating problems
-(such as packages to be removed, suggestions for the web site, etc.),
+the Debian system administrator team is reachable at
+<email>debian-admin@lists.debian.org</email>.
+       <p>
+If you have a problem with a certain service, not related to the system
+administration (such as packages to be removed from the archive,
+suggestions for the web site, etc.),

 generally you'll report a bug against a ``pseudo-package''.  See <ref
 id="submit-bug"> for information on how to submit bugs.
 
 generally you'll report a bug against a ``pseudo-package''.  See <ref
 id="submit-bug"> for information on how to submit bugs.
 


@@ -517,13 +543,6 @@ anything, however, to reduce unnecessary duplication of effort or
 wasted processing time.
        <p>
 All Debian developers have accounts on <tt>&master-host;</tt>.
 wasted processing time.
        <p>
 All Debian developers have accounts on <tt>&master-host;</tt>.

-Please take care to protect your password to this machine.  Try to
-avoid login or upload methods which send passwords over the Internet
-in the clear.
-       <p>
-If you find a problem with <tt>&master-host;</tt> such as disk
-full, suspicious activity, or whatever, send an email to
-&email-debian-admin;.

 
       <sect1 id="servers-ftp-master">The ftp-master server
        <p>
 
       <sect1 id="servers-ftp-master">The ftp-master server
        <p>


@@ -537,34 +556,60 @@ bugs against the <package>ftp.debian.org</package> pseudo-package or
 an email to &email-ftpmaster;, but also see the procedures in
 <ref id="archive-manip">.
 
 an email to &email-ftpmaster;, but also see the procedures in
 <ref id="archive-manip">.
 

-      <sect1 id="servers-www">The WWW server
+      <sect1 id="servers-non-us">The non-US server

        <p>
        <p>

-The main web server, <tt>&www-host;</tt>, is also known as
-<tt>klecker.debian.org</tt>.  All developers are given accounts on this
-machine.
+The non-US server, <tt>non-us.debian.org</tt> (or <tt>pandora.debian.org</tt>),
+holds the canonical copy of the non-US part of the Debian archive.
+If you need to upload a package into one of the non-US sections, upload it
+to this server; see <ref id="upload">.

        <p>
        <p>

-If you have some Debian-specific information which you want to serve
-on the web, you can do this by putting material in the
-<file>public_html</file> directory under your home directory.  You should
-do this on <tt>klecker.debian.org</tt>. Any material you put in those areas
-are accessible via the URL
-<tt>http://people.debian.org/~<var>user-id</var>/</tt>.
-You should only use this particular location because it will be backed up,
-whereas on other hosts it won't. Please do not put any material on Debian
-servers not relating to Debian, unless you have prior permission.
-Send mail to &email-debian-devel; if you have any questions.
+Problems with the non-US package archive should generally be submitted as
+bugs against the <package>nonus.debian.org</package> pseudo-package (notice
+the lack of hyphen between "non" and "us" in the pseudo-package name
+&mdash; that's for backwards compatibility). Remember to check whether or
+not someone else has already reported the problem on the
+<url id="http://bugs.debian.org/nonus.debian.org" name="Bug Tracking System">.
+
+      <sect1 id="servers-www">The www-master server
+       <p>
+The main web server, <tt>&www-host;</tt>, is also known as
+<tt>klecker.debian.org</tt>. It holds the official web pages, the face
+of Debian for most newbies.

        <p>
 If you find a problem with the Debian web server, you should generally
 submit a bug against the pseudo-package,
        <p>
 If you find a problem with the Debian web server, you should generally
 submit a bug against the pseudo-package,

-<package>www.debian.org</package>.  First check whether or not someone
+<package>www.debian.org</package>. Remember to check whether or not someone

 else has already reported the problem on the
 <url id="http://bugs.debian.org/www.debian.org" name="Bug Tracking System">.
 
 else has already reported the problem on the
 <url id="http://bugs.debian.org/www.debian.org" name="Bug Tracking System">.
 

+      <sect1 id="servers-people">The "people" web server
+       <p>
+<tt>people.debian.org</tt> (<tt>gluck.debian.org</tt>) is the server used
+for developers' own web pages about anything related to Debian.
+       <p>
+If you have some Debian-specific information which you want to serve
+on the web, you can do this by putting material in the
+<file>public_html</file> directory under your home directory on
+<tt>people.debian.org</tt>.
+This will be accessible at the URL
+<tt>http://people.debian.org/~<var>your-user-id</var>/</tt>.
+       <p>
+You should only use this particular location because it will be backed up,
+whereas on other hosts it won't.
+       <p>
+Usually the only reason to use a different host is when you need to publish
+materials subject to the U.S. export restrictions, in which case you can use
+one of the other servers located outside the United States, such as the
+aforementioned <tt>non-us.debian.org</tt>.
+       <p>
+Send mail to &email-debian-devel; if you have any questions.

 
       <sect1 id="servers-cvs">The CVS server
        <p>
 
       <sect1 id="servers-cvs">The CVS server
        <p>

-<tt>cvs.debian.org</tt> is also known as <tt>klecker.debian.org</tt>,
-discussed above.  If you need to use a publicly accessible CVS
+Our CVS server is located on <tt>cvs.debian.org</tt> (also known as
+<tt>klecker.debian.org</tt>, discussed above).
+       <p>
+If you need to use a publicly accessible CVS

 server, for instance, to help coordinate work on a package between
 many different developers, you can request a CVS area on the server.
          <p>
 server, for instance, to help coordinate work on a package between
 many different developers, you can request a CVS area on the server.
          <p>


@@ -578,7 +623,7 @@ To request a CVS area, send a request via email to
 the Debian account that should own the CVS root area, and why you need it.
 
 
 the Debian account that should own the CVS root area, and why you need it.
 
 

-      <sect1 id="devel-db">The Developers Database
+    <sect id="devel-db">The Developers Database

        <p>
 The Developers Database, at <url id="&url-debian-db;">, is an LDAP
 directory for managing Debian developer attributes.  You can use this
        <p>
 The Developers Database, at <url id="&url-debian-db;">, is an LDAP
 directory for managing Debian developer attributes.  You can use this


@@ -611,21 +656,6 @@ interested in helping Debian.  As such, developers generally do not
 have accounts on these machines.
 
 
 have accounts on these machines.
 
 

-      <sect id="other-machines">Other Debian developer machines
-       <p>
-There are other Debian machines which may be made available to you.
-You can use these for Debian-related purposes as you see fit.  Please
-be kind to system administrators, and do not use up tons and tons of
-disk space, network bandwidth, or CPU without first getting the
-approval of the local maintainers.  Usually these machines are run by
-volunteers.  Generally, these machines are for porting activities.
-       <p>
-Aside from the servers mentioned in <ref id="server-machines">, there
-is a list of machines available to Debian developers at <url
-id="&url-devel-machines;">.
-
-
-

     <sect id="archive">The Debian archive
        <p>
 The &debian-formal; distribution consists of a lot of packages
     <sect id="archive">The Debian archive
        <p>
 The &debian-formal; distribution consists of a lot of packages