[Python-checkins] distutils2: merging Julien Miotte work

tarek.ziade python-checkins at python.org
Wed Feb 16 22:23:55 CET 2011


tarek.ziade pushed feda55d419cb to distutils2:

http://hg.python.org/distutils2/rev/feda55d419cb
changeset:   991:feda55d419cb
parent:      987:8813f2ecd580
parent:      988:b512b1d2767a
user:        Alexis Metaireau <alexis at notmyidea.org>
date:        Tue Feb 01 01:37:52 2011 +0000
summary:
  merging Julien Miotte work

files:
  

diff --git a/docs/source/contributing.rst b/docs/source/contributing.rst
new file mode 100644
--- /dev/null
+++ b/docs/source/contributing.rst
@@ -0,0 +1,52 @@
+==========================
+Contributing to Distutils2
+==========================
+
+----------------
+Reporting Issues
+----------------
+
+When using, testing, developping distutils2, you may encounter issues. Please report to the following sections to know how these issues should be reported.
+
+Please keep in mind that this guide is intended to ease the triage and fixing processes by giving the maximum information to the developers. It should not be viewed as mandatory, only advised ;).
+
+Issues regarding distutils2 commands
+====================================
+
+- Go to http://bugs.python.org/ (you'll need a Python Bugs account), then "Issues" > "Create ticket".
+- **Title**: write in a short summary of the issue. 
+    * You may prefix the issue title with [d2_component], where d2_component can be : installer, sdist, setup.cfg, ... This will ease up the triage process.
+
+- **Components**: choose "Distutils2"
+- **Version**: choose "3rd party"
+- **Comment**: use the following template for versions, reproduction conditions:
+    * If some of the fields presented don't apply to the issue, feel free to pick only the ones you need.
+
+::
+
+    Operating System:
+    Version of Python:
+    Version of Distutils2:
+
+    How to reproduce:
+
+    What happens:
+
+    What should happen:
+
+- Filling in the fields:
+    * **How to reproduce**: indicate some test case to reproduce the issue.
+    * **What happens**: describe what is the error, paste tracebacks if you have any.
+    * **What should happen**: indicate what you think should be the result of the test case (wanted behaviour).
+    * **Versions**:
+        - If you're using a release of distutils2, you may want to test the latest version of the project (under developpment code).
+        - If the issue is present in the latest version, please indicate the tip commit of the version tested.
+        - Be careful to indicate the remote reference (12 characters, for instance c3cf81fc64db), not the local reference (rXXX).
+
+- If it is relevant, please join any file that will help reproducing the issue or logs to understand the problem (setup.cfg, strace ouptups, ...).
+
+Issues regarding PyPI display of the distutils2 projects
+========================================================
+
+- Please send a bug report to the catalog-sig at python.org mailing list.
+- You can include your setup.cfg, and a link to your project page.

--
Repository URL: http://hg.python.org/distutils2


More information about the Python-checkins mailing list