blob: 1c316ccf05a74f595ef6fcfb5690fae3620ce5ff [file] [log] [blame]
<html lang="en">
<head>
<title>About Issues - A Brief Guide</title>
<style type="text/css"> /* <![CDATA[ */
<!--
@import "/branding/css/tigris.css";
@import "/branding/css/inst.css";
-->
/* ]]> */ </style>
</head>
<body>
<div align="right"><font size="-1" color=#BDBEBD>Document written by: <a href="mailto:Joerg.Skottke.Sun.com?subject=OOo QA Project">Joerg Skottke</a></font></div>
<div class="dba">
<h1><font size=6 color=#00009C>About Issues - A Brief Guide</font></h1>
</div>
<p>This page gives you a brief introduction to how issues are handled
winthin the OpenOffice.org Quality Assurance. Basically it describes
an issue's lifecycle and provides direct links to useful documentation.</p>
<p>You probably came to this page because you have a problem with OpenOffice.org.
Maybe the application crashed, misbehaved or something else just feels wrong to you.
So chances are that you found an issue/bug that should be fixed. When you are new to
writing issues this page should help you to understand the way an issue takes from
being found to finally being fixed.</p>
<table border="0">
<colgroup>
<col width="350px" span="1">
<col>
</colgroup>
<tr>
<td><img src="./issue_handling.png" alt="Issue handling flowchart"</td>
<td>
<ol>
<li>It is recommended that you start by
<a href="http://www.openoffice.org/servlets/Login">logging in</a>
to
<a href="http://qa.openoffice.org/servlets/ProjectIssues">IssueTracker</a>.
<br>If you want to learn about the benefits of IssueTracker please read
<a href="http://qa.openoffice.org/issue_handling/project_issues.html#using">this abstract</a></li>
<br><br><br>
<li>Please search the IssueTracker database to make sure that your issue does not exist yet.
<br>Do a quick search for
<a href="http://qa.openoffice.org/issue_handling/pre_submission.html#duplicates">duplicates</a>
or go to the more advanced
<a href="http://qa.openoffice.org/issues/query.cgi">search form</a>
<br>If your issue exists you might want to bookmark it or set yourself on CC</li>
<br><br><br>
<li>You did not find your issue in the database?
<br>Good, go ahead and write a new one using the
<a href="http://qa.openoffice.org/issue_handling/submission_gateway.html">submit form</a>.
<br>If you are unfamiliar with writing good Bugreports we recommend that you read
<a href="http://qa.openoffice.org/issue_handling/basic_rules.html">this document</a>.
Following these rules really makes life easier for all.
If you want to dig a little deeper you might want to read these detailed
<a href="http://qa.openoffice.org/issue_handling/bug_writing_guidelines.html">bug writing guidelines</a>
as well.</li>
<br><br><br>
<li>The issue needs to be confirmed
<br>When you are new to OpenOffice.org you don't have the permission to confirm
your issues yourself. So somebody with the required permissions will take over at this point.
The OOo volunteer will try to reproduce your problem and - in case
of failure - get back to you and ask some more questions. If reproduction succeeds
the issue gets a target and will be handed over to development for fixing. If the
issue can not be reproduced it is closed.</li>
<br><br><br>
<li>Your issue is added to a
<a href="http://wiki.services.openoffice.org/wiki/CWS">CWS</a>
(<u>C</u>hild<u>w</u>ork<u>s</u>pace).
<br>A childworkspace is created in which your issue is fixed by
a developer. When the fix is done the CWS is sent to QA.</li>
<br><br><br>
<li>The issue needs to be verified on the
<a href="http://wiki.services.openoffice.org/wiki/CWS">CWS</a>
<br>Your issue will now be verified, meaning that somebody (which could be you as well)
takes a look at it by installing a developer build from the CWS.
<br>If the fix is not good
(failed completely or insufficient) it goes back to development.</li>
<br><br><br>
<li>The fix is good and gets
<a href="http://wiki.services.openoffice.org/wiki/Integration">integrated</a>
into the
<a href="http://wiki.services.openoffice.org/wiki/MWS">MWS</a>
<br>The issue now has the status fixed/verified and gets integrated into the main
development line and you can download it with the next developer snapshot.</li>
<br><br><br>
<li>Final verification of the fix
<br>Again somebody verifies that the
fix did not by accident get lost or corrupted. If all went well the status is changed to
closed/fixed. On any problem the task gets back to development and the cycle starts anew.</li>
</ol>
<br><br>
<p><b><i>Additional hint(s)</i></b></p>
<p>When working with issues you always have the possibility to find out where
in the process your task is currently located. You just have to look at the status
of your issue. If you want to know more about issue states, please take a look at the
<a href="http://qa.openoffice.org/nonav/scdocs/issue_lifecycle.html">issue lifecycle</a>
document which explains issue states and how they fit into the process in great detail.</p>
</td>
</tr>
</table>
<p>Autor: Joerg Skottke (Joerg.Skottke@oracle.com) March 28. 2007</p>
<p><i>Please do not change this site without acknowledge of the autor or the OOo QA Project Lead/Co-Leads.</i></p>
</body>
</html>