Document the notion of "team upload"

It looks like an NMU but it's not really one because the uploader is an
implicit co-maintainer since he's part of the maintenance team. Thanks to
Charles Plessy for the initial patch. Closes: #573110

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

diff --git a/debian/changelog b/debian/changelog
index 75f01af025bd54c0f790d5085efff69627a67a2a..622280681c5ccd041d30a5ef723e47e1dbc91c1c 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -46,6 +46,10 @@ developers-reference (3.4.4) UNRELEASED; urgency=low
     Closes: #567234
   * Small typo fixes and clarifications/rewordings suggested by Karl Goetz.
     Closes: #567233
     Closes: #567234
   * Small typo fixes and clarifications/rewordings suggested by Karl Goetz.
     Closes: #567233

+  * Document the notion of "team upload": it looks like an NMU but it's not
+    really one because the uploader is an implicit co-maintainer since he's
+    part of the maintenance team. Thanks to Charles Plessy for the initial
+    patch. Closes: #573110

 
  -- Lucas Nussbaum <lucas@lucas-nussbaum.net>  Tue, 22 Dec 2009 22:49:40 +0900
 
 
  -- Lucas Nussbaum <lucas@lucas-nussbaum.net>  Tue, 22 Dec 2009 22:49:40 +0900
 

diff --git a/pkgs.dbk b/pkgs.dbk
index f40e7f3d873b5a7b04cb75db6106ebac6590711c..baec071708b82f55b5f4c7439f430c6c0593d5ca 100644 (file)
--- a/pkgs.dbk
+++ b/pkgs.dbk
@@ -2194,6 +2194,21 @@ the new version (see <xref linkend="adopting"/>).
 
 </section>
 
 
 </section>
 

+<section id="nmu-team-upload">
+<title>NMUs vs team uploads</title>
+
+<para>
+Sometimes you are fixing and/or updating a package because you are member of a
+packaging team (which uses a mailing list as Maintainer or Uploader, see <xref
+linkend="collaborative-maint"/>) but you don't want to add yourself to Uploaders
+because you do not plan to contribute regularly to this specific package. If it
+conforms with your team's policy, you can perform a normal upload without
+being listed directly as Maintainer or Uploader. In that case, you should
+start your changelog entry with the following line: <code> * Team upload.</code>.
+</para>
+
+</section>
+

 </section>
 
 <section id="collaborative-maint">
 </section>
 
 <section id="collaborative-maint">


@@ -2268,11 +2283,17 @@ moderation for non-subscribers).
 </para>
 </listitem>
 </orderedlist>
 </para>
 </listitem>
 </orderedlist>

+

 <para>
 In any case, it is a bad idea to automatically put all team members in the
 <para>
 In any case, it is a bad idea to automatically put all team members in the

-Uploaders field.  It clutters the Developer's Package Overview listing (see
+Uploaders field. It clutters the Developer's Package Overview listing (see

 <xref linkend="ddpo"/> ) with packages one doesn't really care for, and creates
 <xref linkend="ddpo"/> ) with packages one doesn't really care for, and creates

-a false sense of good maintenance.
+a false sense of good maintenance. For the same reason, team members do
+not need to add themselves to the Uploaders field just because they are
+uploading the package once, they can do a “Team upload” (see <xref
+linkend="nmu-team-upload"/>). Conversely, it it a bad idea to keep a
+package with only the mailing list address as a Maintainer and no
+Uploaders.

 </para>
 </section>
 
 </para>
 </section>