- Updated PTS documentation.

- Added a paragraph about the PTS web interface.

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

diff --git a/debian/changelog b/debian/changelog
index 094773c1cafe3905cc5c0fb6ccc87a8edfb2761f..5b62c3329379522708175ef1d14bbe7eda8f6445 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,6 +2,9 @@ developers-reference (3.3.3) unstable; urgency=low
 
   * Frédéric Bothamy
     - Corrections by Michel Grentzinger
+  * Raphaël Hertzog
+    - Updated documentation concerning the PTS
+    - Added a paragraph about the PTS web interface
 
  -- Adam Di Carlo <aph@debian.org>  Fri,  2 May 2003 00:57:24 +0200
 

diff --git a/developers-reference.sgml b/developers-reference.sgml
index ab5b26f621930ec37d376aadffc170d095cc06e4..a89556f668a8265d8dba7b26fd8c29558cf54f62 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.197 $">
+  <!entity cvs-rev "$Revision: 1.198 $">
   <!-- if you are translating this document, please notate the CVS
        revision of the developers reference here -->
   <!--
@@ -1217,10 +1217,6 @@ package for the alpha architecture. Each time the package has been
 recompiled on most of the architectures.
 
     <sect id="pkg-tracking-system">The Package Tracking System
-<!-- FIXME: talk about 
-http://qa.debian.org/developer.php?login=aph@debian.org
-http://packages.qa.debian.org/
-http://packages.qa.debian.org/pkgname -->
        <p>
 The Package Tracking System (PTS) is basically a tool to track by mail
 the activity of a source package. You just have to subscribe
@@ -1253,7 +1249,11 @@ override disparity for the section or priority field).
     <tag><tt>default</tt>
     <item>
 Any non-automatic mail sent to the PTS by people who wanted to
-contact the subscribers of the package.
+contact the subscribers of the package. This can be done by sending mail
+to <tt><var>srcpackage</var>@&pts-host;</tt>. In order to prevent spam,
+mails sent to these addresses must contain the header "X-PTS-Approved"
+with a non-empty string.
+
 
     <tag><tt>summary</tt>
     <item>
@@ -1378,6 +1378,22 @@ notifications, you just have to make sure it sends a copy of those mails
 to <tt><var>srcpackage</var>_cvs@&pts-host;</tt>. Only people who
 accepts the <em>cvs</em> keyword will receive the notifications.
 
+       <sect1 id="pts-web">The PTS web interface
+       <p>
+The PTS has been extended with a web interface that puts together
+many information about each source package. It features many useful
+links (BTS, QA stats, contact information, DDTP translation status,
+buildd logs) and gathers many more information from various places
+(30 latest changelog entries, testing status, ...). It's a very useful
+tool if you want to know what's going on with a specific source
+package. Furthermore there's a form that let you easily subscribe to
+the mail service offered by the PTS.
+       <p>
+You can jump directly to the web page concerning a specific source package
+with an url like <tt>http://&pts-host;/<var>srcpackage</var></tt>. Otherwise
+you can go through the <url id="http://&pts-host;" name="main page">.
+
+
     <sect id="ddpo">Developer's packages overview
        <p>
 A QA (quality assurance) web portal is available at <url