You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@jakarta.apache.org by se...@apache.org on 2011/05/13 16:51:02 UTC
svn commit: r1102768 - in /jakarta/jmeter/trunk/xdocs: index.xml issues.xml
known_bugs.xml stylesheets/project.xml
Author: sebb
Date: Fri May 13 14:51:02 2011
New Revision: 1102768
URL: http://svn.apache.org/viewvc?rev=1102768&view=rev
Log:
Replace Known Bugs link with Issues, and provide info on reporting them.
Added:
jakarta/jmeter/trunk/xdocs/issues.xml
- copied, changed from r1084822, jakarta/jmeter/trunk/xdocs/known_bugs.xml
Removed:
jakarta/jmeter/trunk/xdocs/known_bugs.xml
Modified:
jakarta/jmeter/trunk/xdocs/index.xml
jakarta/jmeter/trunk/xdocs/stylesheets/project.xml
Modified: jakarta/jmeter/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/xdocs/index.xml?rev=1102768&r1=1102767&r2=1102768&view=diff
==============================================================================
--- jakarta/jmeter/trunk/xdocs/index.xml (original)
+++ jakarta/jmeter/trunk/xdocs/index.xml Fri May 13 14:51:02 2011
@@ -97,7 +97,7 @@ Nor does it render the HTML pages as a b
<h2>Further Information About JMeter</h2>
<ul>
<li><a href="changes.html">Change List</a></li>
-<li><a href="known_bugs.html">Known Bugs</a></li>
+<li><a href="issues.html">Issues</a></li>
<li><a href="http://www.apache.org/licenses/">License</a></li>
<li><a href="http://wiki.apache.org/jakarta-jmeter/JMeterCommitters">Contributors</a></li>
</ul>
Copied: jakarta/jmeter/trunk/xdocs/issues.xml (from r1084822, jakarta/jmeter/trunk/xdocs/known_bugs.xml)
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/xdocs/issues.xml?p2=jakarta/jmeter/trunk/xdocs/issues.xml&p1=jakarta/jmeter/trunk/xdocs/known_bugs.xml&r1=1084822&r2=1102768&rev=1102768&view=diff
==============================================================================
--- jakarta/jmeter/trunk/xdocs/known_bugs.xml (original)
+++ jakarta/jmeter/trunk/xdocs/issues.xml Fri May 13 14:51:02 2011
@@ -17,9 +17,18 @@
-->
<document>
<properties>
- <title>Known Bugs</title>
+ <title>Issues</title>
</properties>
-<body>
+<body>
+<section name="Issue tracker">
+<p>
+JMeter uses Bugzilla for issue tracking, i.e. for reporting bugs and requesting enhancements.
+</p>
+<p>
+Before creating a new issue, please check whether the issue has already been reported by searching Bugzilla.
+It's also worth checking first on the JMeter user mailing list; others may already have a solution.
+</p>
+</section>
<section name="Known Bugs">
<ul>
<li>
@@ -35,5 +44,47 @@ Bugzilla - Enhancements only</a>
</li>
</ul>
</section>
+<section name="Raising an Issue">
+<p>
+First check that the issue has not already been reported.
+If reporting a bug, are you sure it really is a bug in JMeter, not just a misunderstanding of how JMeter works?
+</p>
+<p>
+If you have not already done so, you need to register an account first, using the "New Account" link at the top of the
+main Bugzilla page: <a href="https://issues.apache.org/bugzilla/">https://issues.apache.org/bugzilla/</a>.
+</p>
+<p>
+Make sure you read and understand the information on the account creation page before signing up.
+</p>
+<p>
+Once logged in, click "File a bug" and select JMeter from the list.
+</p>
+</section>
+<section name="Required Information">
+<p>
+Please make sure you provide sufficient information for others to be able to make use of the report effectively.
+Use the checklist below to guide you.
+</p>
+<ul>
+<li>JMeter version</li>
+<li>Java version (output from java -version)</li>
+<li>OS version</li>
+<li>jmeter.log file (unlikely to contain sensitive information, but check before uploading)</li>
+<li>JMX file if relevant (redact any sensitive information first)</li>
+<li>JTL file if relevant (may need to redact sensitive information)</li>
+<li>For a suspected bug, describe what you did, what happened, and how this differs from what you expected to happen.
+Does it happen every time?
+</li>
+<li>If you are providing a patch to fix a bug, please ensure it is in unified diff format.
+If using Eclipse, please set the patch root to "Project", not the default "Workspace" which is harder to apply.</li>
+<li>New source files can be provided as is; please ensure they have the standard Apache License header (as per other JMeter files).
+Please do not use @author tags (credit will be given in the changes file).
+</li>
+<li>In the case of patches for new features, please also provide documentation patches if at all possible.
+Components are documented in xdocs/usermanual/component_reference.xml.</li>
+</ul>
+<p><b>See also the following <a href="https://issues.apache.org/bugwritinghelp.html">Bug writing guidelines</a>,
+also the terms and conditions noted on the <a href="https://issues.apache.org/bugzilla/createaccount.cgi">Bugzilla account creation page.</a></b></p>
+</section>
</body>
</document>
Modified: jakarta/jmeter/trunk/xdocs/stylesheets/project.xml
URL: http://svn.apache.org/viewvc/jakarta/jmeter/trunk/xdocs/stylesheets/project.xml?rev=1102768&r1=1102767&r2=1102768&view=diff
==============================================================================
--- jakarta/jmeter/trunk/xdocs/stylesheets/project.xml (original)
+++ jakarta/jmeter/trunk/xdocs/stylesheets/project.xml Fri May 13 14:51:02 2011
@@ -26,7 +26,7 @@
<menu name="About">
<item name="Overview" href="/index.html"/>
<item name="Changes" href="/changes.html"/>
- <item name="Known Bugs" href="/known_bugs.html"/>
+ <item name="Issues" href="/issues.html"/>
<item name="License" href="http://www.apache.org/licenses/"/>
<item name="Contributors" href="http://wiki.apache.org/jakarta-jmeter/JMeterCommitters"/>
</menu>
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@jakarta.apache.org
For additional commands, e-mail: notifications-help@jakarta.apache.org