[med-svn] r10200 - trunk/community/website/docs

[Andreas Tille]

Author: tille
Date: 2012-03-30 16:18:58 +0000 (Fri, 30 Mar 2012)
New Revision: 10200

Modified:
   trunk/community/website/docs/policy.xml
Log:
Mention debian/upstream in Debian Policy


Modified: trunk/community/website/docs/policy.xml
===================================================================
--- trunk/community/website/docs/policy.xml	2012-03-30 15:52:56 UTC (rev 10199)
+++ trunk/community/website/docs/policy.xml	2012-03-30 16:18:58 UTC (rev 10200)
@@ -661,6 +661,22 @@
 			<para>Packages hosted in our Subversion repository, that have been modified but not uploaded must use <literal>UNRELEASED</literal> as a distribution name. This can be done automatically by declaring <literal><varname>DEBCHANGE_RELEASE_HEURISTIC</varname>=<replaceable>changelog</replaceable></literal> in <filename>~/.devscripts</filename> and using <command>dch</command>.</para>
 		</sect2>
 		
+		<sect2 id="debian-upstream">
+			<title><filename>debian/upstream</filename></title>
+			<para>
+				We use the <ulink url="http://wiki.debian.org/UpstreamMetadata#Fields">bibliographic information</ulink>
+				which should be stored in the file <filename>debian/upstream</filename>.  The purpose of specifying this
+				is to enhance the contact to upstream which thus gets an extra reward of their work if their citations
+				show up on pages inside the Debian domain and if users more popularly are asked to cite upstream when
+				working with the program in question.
+			</para>
+		</sect2>
+		
+		<sect2 id="debian-changelog">
+			<title><filename>debian/changelog</filename></title>
+			<para>Packages hosted in our Subversion repository, that have been modified but not uploaded must use <literal>UNRELEASED</literal> as a distribution name. This can be done automatically by declaring <literal><varname>DEBCHANGE_RELEASE_HEURISTIC</varname>=<replaceable>changelog</replaceable></literal> in <filename>~/.devscripts</filename> and using <command>dch</command>.</para>
+		</sect2>
+		
 		<sect2 id="debian-gbp.conf">
 		  <title><filename>debian/gbp.conf</filename></title>
 			<para>