[Blends-commit] r3234 - /blends/trunk/blends/doc/en/08_websentinel.sgml

[tille at users.alioth.debian.org]

Author: tille
Date: Thu Mar 29 10:04:34 2012
New Revision: 3234

URL: http://svn.debian.org/wsvn/blends/?sc=1&rev=3234
Log:
Declare Published fields as deprecated and rather use debian/upstream files

Modified:
    blends/trunk/blends/doc/en/08_websentinel.sgml

Modified: blends/trunk/blends/doc/en/08_websentinel.sgml
URL: http://svn.debian.org/wsvn/blends/blends/trunk/blends/doc/en/08_websentinel.sgml?rev=3234&op=diff
==============================================================================
--- blends/trunk/blends/doc/en/08_websentinel.sgml (original)
+++ blends/trunk/blends/doc/en/08_websentinel.sgml Thu Mar 29 10:04:34 2012
@@ -181,19 +181,16 @@
    </item>
   <tag>Published-*</tag>
    <item>
-    <p>Several scientific software asks users of the code to quote the
-       publication which was used to describe the algorithm.
-       There was a really long discussion on the 
-       <url id="http://lists.debian.org/debian-science" name="Mailing
-       list of Debian Science Blend">
-       (<url id="http://lists.debian.org/debian-science/2008/10/msg00033.html"
-       name="see the start of the thread here">) how this might be
-       approached. There was some consensus that we need to define a
-       general control file featuring the citation information but the
-       problem has no real solution in the near future.  To find an
-       intermediate solution which solves the situation for the tasks       pages of Blends some <tt>Published-*</tt> tags can be inserted
-       into the tasks file which are rendered on the according tasks
-       pages.  Here comes a list of these tags:
+    <p>These tags were previouosely used to specify scientific
+       publications.  Its use is now deprecated and you rather
+       should use the file <file>debian/upstream</file> as documented in
+       <url id="http://wiki.debian.org/UpstreamMetadata" name="Debian
+       Wiki">.  The <file>debian/upstream</file> files will be gathered
+       in their state in SVN - so changes become effective after some
+       delay caused by cron jobs.  This new way to handle publications
+       prevents code duplication and can be used more flexible by single
+       maintainers and is also useful for other purposes than only for
+       Blends sentinel.
     </p>
     <p>
     <taglist>
@@ -217,8 +214,6 @@
       </item>
     </taglist>
     </p>
-    <p>Any suggestion to enhance these fields is welcome.
-    </p>
    </item>
 </taglist>
 </p>