QATrack

From Apache OpenOffice Wiki
Revision as of 23:54, 29 January 2007 by Pescetti (Talk | contribs)

Jump to: navigation, search


QATrack helps the OOo community during all steps of the QA process for localized builds.

The tool automatically maintains a status page, which summarizes the status of every build, and specialized subpages. It assists in every step of the QA process.

The original design and history of QATrack is at Release QA Tracking Tool.

Get a QATrack account

For the time being, you will need to get a separate QATrack account, different from the ones you use to login to the OpenOffice.org website or to TCM.

Native Language project leads can e-mail dev@qa.openoffice.org to get a QATrack account. Please specify the language code for you NL project when appplying.

I've got an account — what do I do now?

Once you have a QATrack account, [login].

You will see a menu:

  1. Manage QA of localized builds
  2. Status of QA of localized builds
  3. Change password
  4. Logout

Managing QA

The first item (Manage) takes you to a page where you can assign QA-responsible people to different builds, and edit the QA status of those builds. This information will appear on the Status page.

The Manage page lists all builds currently available for QA in your project. The drop-down menus allow you to make different choices.

You will notice that you now have a toolbar at the top of the page. This will appear on top of both the Manage and the Status pages, allowing you to switch between these views, login, logout etc.

If this toolbar is not showing, you have probably become logged out. Check the link at the bottom of the page. If it says you need to login to edit, click on that link, and you will be taken back to the login page.

Click on the toolbar link View QA status, to go to the Status page.

Status of QA

Now you see an even larger table, listing all the localized builds. The list is shown in alphabetical order, but language with no current builds fall to the end of the list.

You can filter this list by status and type, using the drop-down menu at the top of the page. You will find this table very handy for keeping track of QA for your builds. As is stated on the login page, you can also subscribe to an RSS feed to monitor these changes.

The table provides a column for each architecture, so you will need to scroll sideways sometimes, unless you have a very wide screen.

Hover your mouse over the download link for a build, to see its current information from the Manage QA table. This feature makes the Status page a fairly complete overview of build QA status.

The table also uses colours and styles to label status.

  • Black, crossed-out builds have been REJECTED, due to lack of quality
  • Red builds are UNTESTED as yet
  • Yellow builds are INQA, currently being tested
  • Green builds are APPROVED after complete QA
  • White builds have been DISTRIBUTED due to approval, after logging the appropriate issue with the issue tracker

Good luck with your QA: may all your builds be green! :)

Find your builds

QATrack lists available builds from many providers. You will be automatically be notified by e-mail and RSS when a new build in your language is available.

If you cannot see the build you wish to QA even though it has already been available for some days, e-mail dev@qa.openoffice.org with your request.

If you build OOo yourself, please ask for "Build provider" role in QATrack so that you can upload builds as soon as you make them available.

From January 2007, all registered users can submit builds, so you no longer need a "Build provider" role.

Mark builds as "IN QA"

You can edit the build status for builds in your language. When you start TCM testing, please set the status to INQA for the builds being tested.

You can optionally specify a closing date for your tests. This does not affect QATrack operation, it will just be displayed in the information box for that build.

You can delegate QA for a build to other QATrack users from your NL project. They will appear in the QA Contact field in the information box for that build.

Test!

Run the QA tests your NL projects uses (TCM tests or other). Get the final approval or rejection.

Update the status page

If the build is rejected

Just mark it as REJECTED in the status page.

If the build is approved

  • Mark it as APPROVED in the status page.
  • Open an issue to request distribution to mirrors.
  • Check that status changes to DISTRIBUTED (or change it yourself) once the build is distributed as stable.
Personal tools