subversion-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1245092 - /subversion/site/publish/contributing.html
Date Thu, 16 Feb 2012 17:32:38 GMT
Author: danielsh
Date: Thu Feb 16 17:32:38 2012
New Revision: 1245092

* /site/publish/contributing.html: Add 'Contribute a regression test' item.


Modified: subversion/site/publish/contributing.html
--- subversion/site/publish/contributing.html (original)
+++ subversion/site/publish/contributing.html Thu Feb 16 17:32:38 2012
@@ -105,7 +105,7 @@
        and share what you've learned.</p>
-<li><p style="font-weight: bold;">Write a test or reproduction script</p>
+<li><p style="font-weight: bold;">Write a reproduction script</p>
     <p>A well-written bug report is invaluable to developers.  A
        reproduction recipe script, however, is worth a hundred
        well-written reports.  Nothing helps developers understand what
@@ -179,6 +179,22 @@
        conventions</a>, and come join the fun!</p>
+<li><p style="font-weight: bold;">Convert a reproduction script
+    into a regression test</p>
+    <p>Often, users or developers post a reproduction script when
+       discussing a bug.  One of the tasks involved in fixing the bug is
+       to convert the script (typically a shell script or a batch script)
+       into a Python test in <a
+       href=""
+       >Subversion's test suite</a>.  Sending a patch that implements an
+       XFail ("eXpected to fail" until the bug has been fixed) test
+       equivalent to the reproduction script is a very useful
+       contribution, that both serves as a demonstration of the concrete
+       fix sought and allows other contributors and developers to spend
+       more time researching the cause of the bug and fixes thereto.</p>
 <li><p style="font-weight: bold;">Become a committer and commit code directly</p>
     <p>Developers with a long history of submitting high-quality
        patches can gain direct commit rights.  This is obviously

View raw message