r15353 - /website/policy.draft

Thu Feb 21 16:33:29 UTC 2008

Author: gregoa-guest
Date: Thu Feb 21 16:33:12 2008
New Revision: 15353

URL: http://svn.debian.org/wsvn/?sc=1&rev=15353
Log:
add policy.draft; first draft for reverting the DM/Uploaders change from last December in pkg-perl policy

Added:
    website/policy.draft

Added: website/policy.draft
URL: http://svn.debian.org/wsvn/website/policy.draft?rev=15353&op=file
==============================================================================

--- website/policy.draft (added)
+++ website/policy.draft Thu Feb 21 16:33:12 2008
@@ -1,0 +1,199 @@
+=head1 NAME
+
+Debian Perl Group Policy
+
+=head1 INTRODUCTION
+
+Project Internal Policy
+
+This document describes how we do stuff internally. It is of course work in
+progress and probably always will be.
+
+We are using a subversion repository to keep the packages under
+revision control. Details of working with this repository are outside
+the scope of this document;  it is recommended that you read the Debian
+Perl Group Subversion Guide  
+(L<http://pkg-perl.alioth.debian.org/subversion.html>).
+
+=head1 INDEX
+
+=over 4
+
+=item 1. L<Mandatory mailing lists and such|/"Mandatory mailing lists and such">
+
+=item 2. L<debian/changelog handling and versioning|/"debian/changelog handling and versioning">
+
+=item 3. L<debian/control handling|/"debian/control handling">
+
+=item 4. L<debian/watch handling|/"debian/watch handling">
+
+=item 5. L<Debian Maintainers practice|/"Debian Maintainers practice">
+
+=item 6. L<Release Process|/"Release Process">
+
+=item 7. L<Authors|/"Authors">
+
+=item 8. L<License|/"License">
+
+=back
+
+=head1 Mandatory mailing lists and such
+
+All members of our group should be subscribed to debian-perl at lists.debian.org
+and read this list (at least skim all messages for Debian Perl Group related
+stuff). Additionally, every member should be subscribed to
+pkg-perl-maintainers at lists.alioth.debian.org to receive bug reports and 
+similar information.
+
+All members are encouraged to have all our packages installed. They are also
+encouraged to check our webspace (L<http://alioth.debian.org/projects/pkg-perl>), 
+and our svn repository (L<http://svn.debian.org/wsvn/pkg-perl/>). You can 
+watch the work on our svn repository subscribing to our svn commits 
+list (L<http://alioth.debian.org/mail/?group_id=30274>), listed there as
+pkg-perl-cvs-commits. The commit messages are also sent to #debian-perl 
+at irc.debian.org.
+
+=head1 debian/changelog handling and versioning
+
+We use the debian revision to count our releases to the debian archive, not
+internal steps. So if and only if you do the first change after a release, you
+add another debian/changelog entry (dch -i).  Note that the name and email
+address in the debian/changelog entry (i.e. after --) should be present in
+Uploaders: in debian/control (otherwise lintian will think that you
+are doing an NMU).
+
+If you change something that has to be noted in debian/changelog, just add a
+line to the current entry (dch -a). The [firstname lastname] markers added by
+dch are okay to give credit to non-upload-permitted contributors (also for the
+initial changelog entry).
+
+Important NOTES to other group members may be placed at the top of the current
+changelog entry of packages that are not yet ready for upload (e.g. why a
+package is still UNRELEASED etc.).
+
+=head1 debian/control handling
+
+When importing a package into the SVN repository for the first time change the
+Maintainer field to "Debian Perl Group
+E<lt>pkg-perl-maintainers at lists.alioth.debian.orgE<gt>" and 
+put your own email
+address and name in the Uploaders field to show that you feel responsible
+for the package.
+
+When you make a significant modification to a package in the repository, add your
+name to the Uploaders field. You should keep the names of other contributors who
+added their names before you.
+
+The packages maintained by the group should contain the following fields:
+
+=over 
+
+=item Section
+
+Perl packages should be uploaded to the I<perl> section.
+
+=item Priority
+
+Most Perl packages should be of priority I<optional>.
+
+=item Maintainer
+
+All group-maintained packages should list 
+I<"Debian Perl Group E<lt>pkg-perl-maintainers at lists.alioth.debian.orgE<gt>">
+as the maintainer.
+
+=item Uploaders
+
+Contains the list of contributors to the specific package, i.e. persons
+interested in co-maintaining it in the future.
+
+=item Vcs-Svn
+
+An URL pointing to the package's base location in our repository. That 
+is, for a package called I<libsomething-perl>,
+L<svn://svn.debian.org/pkg-perl/trunk/libsomething-perl/>.
+
+=item Vcs-Browser
+
+An URL pointing to the public Web interface where this package's base location
+in the repository can be browsed. For I<libsomething-perl>, it would be
+L<http://svn.debian.org/wsvn/pkg-perl/trunk/libsomething-perl/>.
+
+=item Homepage
+
+The URL for this module's upstream homepage. For CPAN modules, unless the
+author has a specific homepage, you can point to
+L<http://search.cpan.org/dist/Something/>.
+
+=back
+
+The other usual fields should, of course, be present and have sensible values. 
+In particular, try to stick to the highest published Standards-Version and 
+debhelper compatibility level. 
+
+The pkg-perl group members prefer to directly use debhelper when packaging. We
+suggest you don't use cdbs as part of the build process for packages intended
+to be group-maintained.
+
+=head1 debian/watch handling
+
+Each package should have a watch file (F<debian/watch>) to make manual and
+automatic checking for new upstream versions easier. The recommended format
+for a watch file for a typical module I<libfoo-bar-perl> hosted on CPAN is:
+
+ version=3
+ # URL to the package page followed by a regex to search
+ http://search.cpan.org/dist/Foo-Bar/   .*/Foo-Bar-v?(\d[\d_.]+)\.(?:tar(?:\.gz|\.bz2)?|tgz|zip)
+
+(Scanning the distribution-based CPAN URLs is usually much faster than
+scanning /(by-)module/ ones; author-based URLs become invalid as soon as
+there's a change in maintainership.)
+
+=head1 Debian Maintainers practice
+
+The Debian project has adopted the Debian Maintainers (DM) concept (cf.
+L<http://www.debian.org/vote/2007/vote_003>) in Summer 2007. The pkg-perl group
+doesn't see this approach fit for its workflow and is not actively using
+it.
+
+=head1 Release Process
+
+If you are a DD, upload but be prepared to receive (at least part of) the blame. If
+you are not, some DD in the Group will surely sponsor the package. They will
+check the package first, too, but make sure there is no reason to complain.  If
+you have a package ready for upload, just ask at debian-perl at lists.debian.org
+or in the channel #debian-perl at irc.debian.org
+
+Always feel free to ask others to check a package if in doubt.
+
+=head1 VERSION
+
+$Id: policy.pod 13057 2008-01-20 00:09:12Z gregoa-guest $
+
+=head1 AUTHORS
+
+=over
+
+=item * Joachim Breitner
+
+=item * Daniel Ruoso
+
+=item * Gustavo Franco
+
+=item * Gunnar Wolf
+
+=item * Gregor Herrmann
+
+=back
+
+=head1 LICENSE
+
+Copyright (c) 2004-2008 Debian Perl Group.  All rights reserved. This document is
+free software; you may redistribute it and/or modify it under the same
+terms as Perl itself
+
+Perl is distributed under your choice of the GNU General Public
+License or the Artistic License.  On Debian GNU/Linux systems, the
+complete text of the GNU General Public License can be found in
+`/usr/share/common-licenses/GPL' and the Artistic License in
+`/usr/share/common-licenses/Artistic'.


