Purpose of this document:
This document is intended as a practical guide for operating the IssueZilla (IZ) system for tasks and bugs management inside the OpenOffice.org Art Project.
- a general overview of the IssueZilla system;
- most frequent usage situations;
- usage examples and the steps required that specifically apply to Art Project activities.
What you will not find in this document:
- this document does not contain complete information on IssueZilla. For more information please refer to the usefull links provided at the end of the document.
1. What is IssueZilla ?
R: IssueZilla (IZ) is the issues (bugs) and tasks management system used by the OpenOffice.org website and Community to ensure the proper issues management and the completion of the undergoing tasks inside the Community. The system allows all the Community members to participate in solving the current problems.
2. What kind of Issues can be reported using IZ ?
R: Any 'problems', errors, tasks to be completed, all related to the website, a project, the Community or the OpenOffice.org software.
Specifically for the Art Project, there can be filed issues containing:
...all these so that the members of the project can review the respective issue, follow the progress, enroll in solving a certain issue or help in the currently undergoing ones.
- requests for a new graphics to be created
- requests for translating a certain graphics
- art related tasks that someone could take up and solve
- issues containing new graphics attached so that the other members of the project can review them, etc.
3. Who can use IZ ?
R: IssueZilla can be used by anybody for following the progress on a certain issue, report a new one or contribute to the existing ones. The only existing limitation is that for reporting and contributing to an issue you have to be a
registered member of the OpenOffice.org website.
4. Common usage situations:
a. REPORTING A 'PROBLEM':
This is the most common usage situation in which a person discovers an error/problem and reports it so that the corresponding teams can check the problem and solve it.
b. CONTRIBUTING TO THE CURRENTLY UNDERGOING TASKS:
Anybody who wants to contribute in solving an already reported issue or who wants to follow the progress of that issue can add themselves to the CC list and can post comments, notes, attach relevant documents, etc. Also, they can vote for increasing the priority of the respective issue.
c. MANAGING YOUR OWN TASKS INSIDE THE PROJECT:
Project members who commit themselves to solving a certain task can open an issue in which they describe the problem, the proposed solution, attach relevant documents, can ask for help and can make comments and periodical reports on the progress untill the task is solved and the issue is closed.
In this case, they are the 'owners' of the issue and they are responsible for solving it. Other members can contribute to the same issue or can take up the task from where it has been left.
This method of working also allows the upload of the created documents (i.e. graphics, documents, etc) in a public place on the website so that they can be viewed by the project members. This way, you can always mention in the mailing list discussions the URL of the uploaded document without having to attach the document to your emails.
5. How can I view the currently opened Issues inside the Art Project ?
Click here to view the Art opened issues.
R: Use the following link in order to view the opened issues of the Art project:
Then, to view the contents of a specific issue, click on the corresponding Issue Number in the results page.
6. How do I file an Issue inside the Art project ?
- Login on the OpenOffice.org website using your username and password.
- Go to the marketing project website http://marketing.openoffice.org
- In the left side menu click on "Issue tracker" (http://marketing.openoffice.org/servlets/ProjectIssues) ;
- In the "Enter an issue" section click on the type of issue you want to report.
(e.g. Task) (http://marketing.openoffice.org/issues
- In the next screen choose the "marketing" component from the OpenOffice.org components list.
- The next screen will ask you for details about the issue:
- "Found in version" - reffers to the program version in which you have found the problem. In our example, we are reporting a task which does not relate the the software so choose 'current'.
- "*Subcomponent:" - here you specify the sub-component inside the project where the issue belongs. In the Art Project's case select 'art' component.
- "Assigned to:" - in this field specify the OpenOffice.org website username of the person who should solve the problem. If the person is unknown, please leave the field blank. If you are reporting a task which you would like to solve, please put in your username.
- "CC:" - this is the list of persons that should be notified on any changes inside the issue. Enter there the usernames of those who you would like to be notified. Leave blank if none.
- "URL:" - (if applicable) enter here the relevant URL where the problem can be seen.
- "*Summary:" - enter a short and concise description of the issue in a few words. The data entered here is the first that shows up in the Issues list and it is used in the automatic notifications messages, so please make sure it clearly explains the issue.
- "*Description:" - here you describe the issue in detail, add your comments, propose solutions, etc.
- After filling in all the details click on "Submit Issue".
- The next screen will confirm you that the issue has been submitted.
Also, if you need to attach a document (file) to the issue, the same screen lets you do that in the section: "Attach a file to this issue".
This feature allows you to publicly display the relevant documents and reffer them by URL on the mailing lists discussions.
7. What operations can I do in IZ without being authenticated on the website ?
R: Only searching for Issues and viewing them can be done without authenticating on the
Any other operations like adding yourself to the CC list, adding
comments to an existing issue, creating a new issue, etc can be done only after you have
logged in with your username and password.
-=End document version 0.1.1en=-
Last updated: July 31th 2004
Author: Cristian Driga
After an idea by Jacqueline McNally (OpenOffice.org Marketing Project)