[csw-devel] SF.net SVN: gar:[20060] csw/mgar/pkg/opencsw-manual/trunk/files/ for-maintainers

[wahwah at users.sourceforge.net]

Revision: 20060
          http://gar.svn.sourceforge.net/gar/?rev=20060&view=rev
Author:   wahwah
Date:     2013-01-09 10:53:44 +0000 (Wed, 09 Jan 2013)
Log Message:
-----------
opencsw-manual/trunk: Peter Felecan's text about contributing to recipes

Modified Paths:
--------------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/index.rst

Added Paths:
-----------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/contributing-to-recipes.rst

Added: csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/contributing-to-recipes.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/contributing-to-recipes.rst	                        (rev 0)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/contributing-to-recipes.rst	2013-01-09 10:53:44 UTC (rev 20060)
@@ -0,0 +1,41 @@
+-----------------------
+Contributing to recipes
+-----------------------
+
+It often happens that a maintainer wants to make a change or an update to
+another maintainer's package.
+
+
+- The maintainer is retired:
+
+  On the maintainers mailing list, announce your intention to work on
+  the recipe and eventually take up the maintenance.
+
+  When you have a working recipe and generated the package, upload-it
+  and you became the active maintainer.
+
+- The maintainer is inactive:
+
+  Contact them before starting your work, and allow them 1 to 2 weeks to
+  respond. If you don't get an answer, proceed as described above.
+
+- The maintainer is active, i.e. answers to bug reports, messages sent
+  on the maintainers mailing list or private messages:
+
+  `Work in a branch`_, and when you obtain satisfying results explain your
+  changes to the maintainer such as he or she can use what you've done and/or,
+  if you obtain his or her explicit permission, merge your modifications on
+  the trunk.
+
+References
+==========
+
+.. _Work in a branch:
+  `Working in a branch`_
+.. _[csw-maintainers] reminder on contributing on recipes:
+  http://lists.opencsw.org/pipermail/maintainers/2013-January/017541.html
+.. _Working in a branch:
+  http://wiki.opencsw.org/branching-from-trunk
+.. [#branch] `Working in a branch`_ in OpenCSW wiki
+.. [#source] The original post on the maintainers mailing list:
+  `[csw-maintainers] reminder on contributing on recipes`_

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/index.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/index.rst	2013-01-09 09:06:02 UTC (rev 20059)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/index.rst	2013-01-09 10:53:44 UTC (rev 20060)
@@ -8,6 +8,7 @@
 .. toctree::
   :maxdepth: 2
 
+  contributing-to-recipes
   filesystem-layout
   building-a-catalog
   shared-libraries

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.