blob: 6db581fc754c9d4fd54c62115bf551fb35723f0e [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>OpenOffice.org QA Project - Quick Start</title>
<link rel="stylesheet" type="text/css" href="../css/default.css">
<meta HTTP-EQUIV="content-type" CONTENT="text/html; charset=UTF-8">
</head>
<body>
<div id="centercontent">
<h1>A Quick Start Guide to contributing to this project</h1>
<p>I've subscribed to the mailing list, joined the QA team and received privileges to modify all aspects of an IZ issue... what's next?
<p>Great question! In the QA project, there is always something for anyone to do. The options and variety can be overwhelming, but hopefully this document can help guide you to the important tasks that make this project work and OpenOffice better!
<p>The primary focus of the QA project is to review as many bug reports that we can so that we can improve OpenOffice software one bug and fix at a time. We'll come back to this in a bit.
<p>That said, there are also other roles to be filled. Documentation, web site maintainence and FAQ's are examples of other roles that require different skills and interests. Check out the items under the tasks header on the right hand menu to find other tasks that the QA project needs help on.
<p><br>
<h2>Bustin' Bugs</h2>
<p>Our goal is simple: we find bugs and/or review bugs users report and we make sure the bugs get the proper attention from the right people. We use IZ to help us find, track and work on bugs.
<p>The rule of thumb is to:
<p style="background: #fff600;margin-left: 15%;margin-right: 15%;padding: 15px;">Try to keep the number of issues in the current month that have not been looked at by a QA team member as low as possible.
<p><br>
<h2>Where do I get a list of issues to review?</h2>
<p>When you are more familiar with OOo you probably will end up creating your own searches and saving them either as bookmarks or custom searches.
<p>However, learning IZ takes a bit of time and persistence, so we've created some links to issues that have not been looked at by any QA team member. The menubar on the right side of this page has a section called "IZ Helper Links". In this section, there is a link called "This month's issues that need you!":
<p style="text-align: center"><a href="http://qa.openoffice.org/izhelperlinks/thismonth.html">http://qa.openoffice.org/izhelperlinks/thismonth.html</a>
<p>If you follow this link, you will see a list of links to issues that have not been reviewed by a QA team member.
<p><br>
<h2>Hmmm, I have a list of issues, what next?</h2>
<p>This part gets a bit involved, but this document hopes to solve your initial concerns.
<p>The basic steps require you to log into the OpenOffice.org web site, then retrieve an issue of choice and then verify to make sure the bug is either reproducible or is a duplicate of an issue that has been already reported. Occassionally, we also change a bug report to an enhancement or feature request if it turns out OpenOffice is working fine, but the user wanted OpenOffice to do a task or function that it currently does not support.
<p>In summary, this is what we do:
<p style="background: #fff600;margin-left: 15%;margin-right: 15%;padding: 15px;">1. Log into OpenOffice.org<br>2. Get a list of untouched issues.<br>3. Load any issue of your choice.<br>4. Check the fields.<br>5. Make sure the issue is reproducible.<br>6. Add your comments if necessary.<br>7. Confirm the issue as "NEW".
<p>Let's break down this process into basic steps and walk our way through an issue:
<h3 style="margin-left: 5%;margin-right: 10%;font-size: large;">1. Log into OpenOffice.org</h3>
<p style="margin-left: 5%;margin-right: 10%;">You can either use the "Login" link of the left hand menu, or go directly to this link:
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="http://www.openoffice.org/servlets/TLogin">http://www.openoffice.org/servlets/TLogin</a>
<p><br>
<h3 style="margin-left: 5%;margin-right: 10%;font-size: large;">2. Get a list of untouched issues.</h3>
<p style="margin-left: 5%;margin-right: 10%;">The simplest way is to use the list from this link:
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="../izhelperlinks/thismonth.html">http://qa.openoffice.org/izhelperlinks/thismonth.html</a>
<p style="margin-left: 5%;margin-right: 10%;">With time and more practice you probably will end up creating your own custom lists using IZ's searching tool.
<p><br>
<h3 style="margin-left: 5%;margin-right: 10%;font-size: large;">3. Load any issue of your choice.</h3>
<p style="margin-left: 5%;margin-right: 10%;">After retrieving the list of issues in step 2, click on the number in left hand column called ID. This number is the issue number.
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="../images/izlist.png"><img src="../images/izlist_thumb.png"></a>
<p><br>
<h3 style="margin-left: 5%;margin-right: 10%;font-size: large;">4. Check the fields.</h3>
<p style="margin-left: 5%;margin-right: 10%;">Certain fields need to be set correctly so that the developers and the QA team can sort through and process the issue properly.
<p style="margin-left: 5%;margin-right: 10%;">First of all, make sure the component field is set correctly.
<p style="margin-left: 15%;margin-right: 20%;background: #fff600;padding: 15px;"><b>Component</b>
<br>The component field should usually be set to:
<br><br>Word Processor - Writer/Word Processor bugs
<br>Spreadsheet - Calc/Spreadsheet bugs
<br>Presentation - Impress/Presentation bugs
<br>Drawing - Draw/Drawing tool bugs
<br>Installation - Problems with installation or uninstall
<p>
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="../images/izcomponent.png"><img src="../images/izcomponent_thumb.png"></a>
<p style="margin-left: 5%;margin-right: 10%;">Next, make sure the priority field is set correctly.
<p style="margin-left: 15%;margin-right: 20%;background: #fff600;padding: 15px;"><b>Priority</b>
<br>Priorities range from P1 ( very urgent ) to P5 ( will be considered when there is time ). Here is a general rule of thumb for priorities:
<br><br><b>P1</b> - OpenOffice cannot be used for testing or development.
<br><br><b>P2</b> - OpenOffice crashes or basic features do not work.
<br><br><b>P3</b> - OpenOffice bugs that usually involve a feature not working as expected.
<br><br><b>P4</b> - OpenOffice bugs that do not affect basic features and usually have workarounds.
<br><br><b>P5</b> - OpenOffice very minor bugs that are annoying.
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="../images/izpriority.png"><img src="../images/izpriority_thumb.png"></a>
<p style="margin-left: 5%;margin-right: 10%;">You can read more details on priorities here:
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="http://www.openoffice.org/issues/bug_status.html#priority">http://www.openoffice.org/issues/bug_status.html#priority</a>
<p style="margin-left: 5%;margin-right: 10%;">The QA contact field is used by developers to monitor bugs. The email address is usually a mailing list, not an individual. We need to make sure it's set correctly.
<p style="margin-left: 15%;margin-right: 20%;background: #fff600;padding: 15px;"><b>QA Contact</b>
<br><br>Writer/Word Processor
<br>issues@sw.openoffice.org
<br><br>Calc/Spreadsheet
<br>issues@sc.openoffice.org
<br><br>Impress/Presentation
<br>issues@graphics.openoffice.org
<br><br>Draw
<br>issues@graphics.openoffice.org
<br><br>Installation
<br>issues@installation.openoffice.org
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="../images/izqacontact.png"><img src="../images/izqacontact_thumb.png"></a>
<p style="margin-left: 5%;margin-right: 10%;">The keyword field is used to help further sort and identify special bugs. You can specify more than one keyword in this field. Just use commas to separate multiple keywords.
<p style="margin-left: 15%;margin-right: 20%;background: #fff600;padding: 15px;"><b>Keyword</b>
<br>
<br><b>oooqa</b>
<br>When you do anything to an issue, please add the oooqa keyword to the keyword field.
<br><br><b>ms_interoperability</b>
<br>Bugs that involve compatibility with OpenOffice and MS Office
<br><br><b>crash</b>
<br>Bugs where OpenOffice crashes
<br><br><b>valgrind</b>
<br>Bugs found using the Valgrind memory tool
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="../images/izkeyword.png"><img src="../images/izkeyword_thumb.png"></a>
<p style="margin-left: 5%;margin-right: 10%;">Finally make sure there is a valid attachment if the issue requires one.
<p style="margin-left: 15%;margin-right: 20%;background: #fff600;padding: 15px;"><b>Attachment</b>
<br>Request an attachment if it simplifies reproducing the bug or is required to demonstrate the bug.
<br><br>For example, problems with importing MS Word documents should usually have an attachment.
<br><br>Complex document layouts are best demonstrated with an attachement.
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="../images/izattachment.png"><img src="../images/izattachment_thumb.png"></a>
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="../images/izattachmentfile.png"><img src="../images/izattachmentfile_thumb.png"></a>
<p><br>
<h3 style="margin-left: 5%;margin-right: 10%;font-size: large;">5. Make sure the issue is reproducible.</h3>
<p style="margin-left: 5%;margin-right: 10%;">In any bug report, it is crucial that in the comments include:
<p style="margin-left: 15%;margin-right: 20%;background: #fff600;padding: 15px;">A clear list of steps to reproduce the bug on any system
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="../images/izcomment.png"><img src="../images/izcomment_thumb.png"></a>
<p style="margin-left: 5%;margin-right: 10%;">The following list of details also is useful:
<p style="margin-left: 15%;margin-right: 20%;background: #fff600;padding: 15px;">Stack dumps from OpenOffice.
<br><br>How often does the problem occur?
<br><br>Actual Results experienced by the user.
<br>Sometimes screenshots or a small sample document that demonstrates the problem is the better than a written description.
<br><br>Expected Results experienced by the user.
<br>We need to know what the user is expecting OpenOffice to do. The problem might not be a bug, just a feature that OpenOffice does not support.
<br><br>Description of the problem.
<br><br>Operating system version, driver version, library version, etc.
<br>This type of detailed information is useful with installation or display problems )
<p><br>
<h3 style="margin-left: 5%;margin-right: 10%;font-size: large;">6. Add your comments if necessary.</h3>
<p style="margin-left: 5%;margin-right: 10%;">You can add your comments in the "Additional Comments" text area:
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="../images/izaddcomment.png"><img src="../images/izaddcomment_thumb.png"></a>
<p><br>
<h3 style="margin-left: 5%;margin-right: 10%;font-size: large;">7. Confirm the issue as "NEW".</h3>
<p style="margin-left: 5%;margin-right: 10%;">To confirm an issue and mark it as "NEW" click on the "Confirm issue (change status to NEW)" option and then the "Commit" button.
<p style="margin-left: 5%;margin-right: 10%;text-align: center;"><a href="../images/izconfirmnew.png"><img src="../images/izconfirmnew_thumb.png"></a>
<p><br>
<h2>What makes a good or bad bug report?</h2>
<p>It can be daunting at first when trying to figure out what is a good bug report and what is a bad bug report. The mailing list and IRC ( channel #openoffice at irc.libera.chat ) is a good place to get help from other members of the team.
<p>The key rule to remember is:
<p style="margin-left: 10%;margin-right: 15%;background: #fff600;padding: 15px;">A clear list of steps to reproduce the bug on any system.
<p>Without a clear list of steps, it is most likely impossible to reproduce the bug that the user is experiencing. Subtle things such as the menus the user used, which mouse button was clicked or the exactly keyboard sequence that was typed make a huge difference when trying to reproduce the bug.
<p><br>
<h2>Do you have any training issues I can look at?</h2>
<p>You can always look at issues that other team members have worked on. Try taking a look at the Fixed issues links on this page:
<p style="text-align: center;"><a href="http://qa.openoffice.org/izhelperlinks/members.html">http://qa.openoffice.org/izhelperlinks/members.html</a>
<p>Here are some training issues we have created to help you along:
<p style="text-align: center;"><a href="http://www.openoffice.org/issues/show_bug.cgi?id=20979">http://www.openoffice.org/issues/show_bug.cgi?id=20979</a>
<p style="text-align: center;"><a href="http://www.openoffice.org/issues/show_bug.cgi?id=20981">http://www.openoffice.org/issues/show_bug.cgi?id=20981</a>
<p style="text-align: center;"><a href="http://www.openoffice.org/issues/show_bug.cgi?id=20982">http://www.openoffice.org/issues/show_bug.cgi?id=20982</a>
</div>
<div id="menu">
<h1>General Info</h1>
<ul class="nobullets">
<li><a href="../index.html">Home Page</a></li>
<li><a href="../info/news.html">News</a></li>
<li><a href="../info/events.html">Events</a></li>
</ul>
<h1>Things to do</h1>
<ul class="nobullets">
<li><a href="../tasks/quickstart.html">Quick Start!</a></li>
<li><a href="../tasks/currentpriorities.html">Current priorities</a></li>
<li><a href="../tasks/documentation.html">Documentation</a></ul>
</ul>
<h1>Join this project</h1>
<ul class="nobullets">
<li><a href="../join/quickref.html">Quick Reference</a></li>
<li><a href="../join/useraccounts.html">Accounts you need</a></li>
<li><a href="../join/izprivileges.html">Privileges you need</a></li>
<li><a href="../join/mailinglists.html">Mailing lists to join</a></li>
<li><a href="../join/whereishelp.html">Where to get help</a></li>
</ul>
<h1>Documentation</h1>
<ul class="nobullets">
<li><a href="../docs/whatisiz.html">IZ - What is it?</a></li>
<li><a href="../docs/usingiz.html">IZ - How to use it.</a></li>
<li><a href="../docs/buglifecycle.html">The Life of a Bug Report</a></li>
<li><a href="../docs/definitions.html">Definitions & Abbreviations</a></li>
<li><a href="../docs/tools.html">Tools</a></li>
</ul>
<h1>IZ helper links</h1>
<ul class="nobullets">
<li><a href="../izhelperlinks/thismonth.html">This month's issues that need you!</a></li>
<li><a href="../izhelperlinks/thismonthnew.html">Issues marked "New" for this month</a></li>
<li><a href="../izhelperlinks/members.html">Issues list members have worked on</a></li>
<li><a href="../izhelperlinks/dejadup.html">Duplicates List</a></li>
<li><a href="../izhelperlinks/good.html">Examples of Good or Bad bug reports"</a></li>
<li><a href="../izhelperlinks/experimental.html">Experimental</a></li>
</ul>
<h1>Tools</h1>
<ul class="nobullets">
<li><a href="http://qa.openoffice.org/qadevOOo_doc/index.html">API Test Case Tool</a></li>
<li><a href="http://qa.openoffice.org/qatesttool">GUI Testing</a></li>
<li><a href="http://qa.openoffice.org/testcase/index.html">Smoke Tests</a></li>
</ul>
<h1>Localization QA</h1>
<ul class="nobullets">
<li><a href="http://qa.openoffice.org/localized/index.html">How to help test localized builds</a></li>
</ul>
<h1>Members</h1>
<ul class="nobullets">
<li><a href="http://qa.openoffice.org/servlets/ProjectMemberList">Project Members</a></li>
<li><a href="../members/whohasizpriv.html">Who has IZ privileges</a></li>
<li><a href="../members/theleads.html">Project Leads</a></li>
<li><a href="../members/memberbios.htm">Member Bios</a></li>
</ul>
<h1>Statistics</h1>
<ul class="nobullets">
<li><a href="../stats/qacontrib.html">QA Contributions</a></li>
<li><a href="http://qa.openoffice.org/iz_statistic.html">Jumbo Stats</a></li>
</ul>
<h1>About Us</h1>
<ul class="nobullets">
<li><a href="../about/missionstatement.html">Mission Statement</a></li>
</ul>
<h1>Accessibility</h1>
<ul class="nobullets">
<li><a href="../index.html">QA Home Page</a></li>
<li><a href="../access/sitemap.html">Site Map</a></li>
</ul>
</div>
</body>
</html>