[Python-modules-commits] [python-modules] 01/01: add policy.rst

Fri Oct 16 21:42:39 UTC 2015

This is an automated email from the git hooks/post-receive script.

piotr pushed a commit to branch master
in repository python-modules.

commit d72d9f957872e738e2073d651d2b60f3bac554be
Author: Piotr Ożarowski <ozarow at gmail.com>
Date:   Fri Oct 16 23:41:57 2015 +0200

    add policy.rst
    
    use `rst2html policy.rst > policy.html` to generate HTML version
---
 .gitignore |   1 +
 policy.rst | 135 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 136 insertions(+)

diff --git a/.gitignore b/.gitignore
index dfd24ae..112bc06 100644
--- a/.gitignore
+++ b/.gitignore
@@ -9,3 +9,4 @@
 *.upload
 *.heads
 *.zip
+policy.html
diff --git a/policy.rst b/policy.rst
new file mode 100644
index 0000000..c09f03a
--- /dev/null
+++ b/policy.rst
@@ -0,0 +1,135 @@
+========================================
+ Python Modules Packaging Team - Policy
+========================================
+
+:Author: Gustavo Franco <stratus at debian.org>, Raphaël Hertzog <hertzog at debian.org>
+:License: GNU GPL v2 or later
+
+:Introduction:
+  Python Modules Packaging Team aims to improve the python modules situation
+  in Debian, by packaging available modules that may be useful and providing
+  a central location for packages maintained by a team, hence improving
+  responsiveness, integration and standardization.
+
+  PMPT or just python-modules is hosted at alioth.debian.org, the Debian
+  GForge installation. We currently have a SVN repository and a mailing list
+  whose email address can be used in the Maintainer field on co-maintained
+  packages.
+
+  For more information send a message to: debian-python at lists.debian.org
+
+.. contents::
+
+----------------
+Joining the team
+----------------
+
+The team is open to any python-related package maintainer. To be added on
+the team, please send your request on debian-python at lists.debian.org
+indicate why you want to join the team: maintain your current packages
+within the team, help maintain some specific packages, etc.
+Don't forget to indicate your Alioth login !
+
+Any Debian developer who wishes to integrate his packages in the team can do so
+without requesting access (as the repository is writable by all DD). If one
+wants to be more involved in the team, we still recommend requesting_ access
+so that he appears in the public member list displayed on Alioth's project page.
+
+The team accepts all contributors and is not restricted to Debian developers.
+Several Debian developers of the team will gladly sponsor packages of non-DD
+who are part of the team. Sponsorship requests can be sent on the main
+discussion list or on #debian-python IRC channel (OFTC network).
+
+All team members should of course follow the main discussion list:
+debian-python at lists.debian.org
+
+--------------
+Maintainership
+--------------
+
+A package maintained within the team should have the name of the team either
+in the Maintainer field or in the Uploaders field.
+
+Maintainer: Debian Python Modules Team <python-modules-team at lists.alioth.debian.org>
+
+This enables the team to have an overview of its packages on the DDPO_website_.
+
+* Team in Maintainers is a strong statement that fully collaborative
+  maintenance is preferred. Anyone can commit to the vcs and upload as
+  needed. A courtesy email to Uploaders can be nice but not required.
+
+* Team in Uploaders is a weak statement of collaboration. Help in maintaining
+  the package is appreciated, commits to vcs are freely welcomed, but before
+  uploading, please contact the Maintainer for the green light.
+
+Team members who have broad interest should subscribe to the mailing list
+python-modules-team at lists.alioth.debian.org whereas members who are only
+interested in some packages should use the Package Tracking System to
+follow the packages.
+
+---------------------
+Subversion Procedures
+---------------------
+
+We're using a Subversion repository to maintain all the packages, then if you're not
+already using it you will need to install svn-buildpackage.
+
+*The repository layout:*
+
+metainfo/
+  Ignore this directory (reserved for future usage).
+
+packages/
+  The source packages are here.
+
+  package-foo
+      branches
+         If you or someone wants to play with a package possible breaking the trunk, give it a name and do it here.
+      tags
+         For each release, a tag. More information below.
+      trunk
+         That's where the main development happens, it should contain only the debian/ subdirectory part of a package.
+
+www/
+  Documents and stuff that will be or are being published online in our website.
+
+
+Hints:
+======
+* To keep your package tree clean as pointed out above, always :code:`svn-inject` your packages using :code:`-o` argument.
+* If you svn-inject'ed a package without :code:`-o`, you should remove upstream sources and run :code:`svn propset mergeWithUpstream 1 debian/`.
+* Since you are keeping only debian/ directory in the svn tree, you need to put the 'package-foo'_'version'.orig.tar.gz in tarballs/ a directory above the package, and svn-buildpackage will do the merge for you. More information about this in the svn-buildpackage howto at /usr/share/doc/svn-buildpackage/.
+* After upload, tag the latest revision running :code:`svn-buildpackage --svn-tag-only` into 'package-foo' directory.
+* You can revert the changelog changes after tagging, running :code:`svn revert debian/changelog`.
+* If you're a pbuilder user, you can invoke it using :code:`svn-buildpackage --svn-builder pdebuild <args>`.
+
+For more information on how to maintain packages within the repository with svn-buildpackage:
+`http://pkg-perl.alioth.debian.org/subversion.html <https://web.archive.org/web/20141027193341/http://pkg-perl.alioth.debian.org/subversion.html>`_
+
+Please note that python-modules URLs are different than pkg-perl ones:
+
+* svn+ssh://login@svn.debian.org/svn/python-modules/packages/
+* svn://svn.debian.org/python-modules/packages/
+* http://anonscm.debian.org/viewvc/python-modules/
+
+Moreover, python-modules still use the default layout: don't pass :code:`-l 2` to :code:`svn-inject`.
+
+-----------------
+Quality Assurance
+-----------------
+
+The goal of the team is to maintain all packages as best as possible.
+Thus every member is encouraged to do general QA work on all the
+packages: fix bugs, test packages, improve them to use the latest python
+packaging tools, etc.
+
+-------
+License
+-------
+
+Copyright (c) 2005-2015 Python Modules Packaging Team. All rights reserved.
+This document is free software; you may redistribute it and/or modify
+it under the same terms as GNU GPL v2 or later.
+
+.. _requesting: https://alioth.debian.org/project/request.php?group_id=30714
+.. _DDPO_website: http://qa.debian.org/developer.php?login=python-modules-team@lists.alioth.debian.org

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/python-modules/tools/python-modules.git

