r295 - /web/deps/dep12.mdwn

[plessy at users.alioth.debian.org]

Author: plessy
Date: Wed Jan  2 23:37:09 2013
New Revision: 295

URL: http://svn.debian.org/wsvn/dep/?sc=1&rev=295
Log:
DEP 12: Per-package machine-readable metadata about Upstream

Added:
    web/deps/dep12.mdwn

Added: web/deps/dep12.mdwn
URL: http://svn.debian.org/wsvn/dep/web/deps/dep12.mdwn?rev=295&op=file
==============================================================================
--- web/deps/dep12.mdwn (added)
+++ web/deps/dep12.mdwn Wed Jan  2 23:37:09 2013
@@ -1,0 +1,38 @@
+[[!meta title="DEP 12: Per-package machine-readable metadata about Upstream"]]
+
+    Title: Per-package machine-readable metadata about Upstream
+    DEP: 12
+    State: DRAFT
+    Date: 2013-01-03
+    Drivers: Charles Plessy <plessy at debian.org>, Andreas Tille <tille at debian.org>
+    URL: http://dep.debian.net/deps/dep12
+    Source: http://anonscm.debian.org/viewvc/dep/web/deps/dep12.mdwn
+    Abstract:
+     The source package control files and some of their derivatives are currently
+     used to document the URL of the home page of the work that is packaged
+     ("upstream").  However, this approach is hard to extend to other information
+     describing upstream, because the size of the control files has to be limited
+     according to the limited power of some systems running Debian.
+     .
+     We propose a new file in the source packages, debian/upstream, formatted
+     in YAML to hold arbitrary information about upstream, for instance the
+     URL to a donation page, bibliographic information about publications
+     describing the upstream work, the URL to the upstream sources, etc. 
+     .
+     The scope of this DEP is the format of the debian/upstream file, and the
+     specification of the most frequent fields.  The flow of information from the
+     source packages to data providers such as the UDD are not specified here.
+     Please refer to http://wiki.debian.org/UpstreamMetadata for more information
+     on that subject.
+     .
+     Discussion takes place on the debian-qa mailing list.
+
+
+
+Work in progress
+----------------
+
+The format of debian/upstream has been drafted on
+http://wiki.debian.org/UpstreamMetadata.  Following the progress of the
+discussion on the debian-qa mailing list, implementation details that made
+consensus will be transferred here.