HowTo Report A Bug
From eyeOS Wiki
Contents |
Thank you for helping us to improve eyeOS!
- eyeOS Team
Have an account on Launchpad register here)
Step 1: Browse eyeOS Launchpad page
The bugs report system is a part of the Launchpad service. This website also provides a tool used to manage blueprints (see How To: Submit a Blueprint on Launchpad).
Navigate to: https://launchpad.net/eyeos
This is the main page. A set of tabs in the top of the screen lets you navigate through the different sections of the site. The one we are looking for is the third one: “Bugs”, click on it.
Step 2: Search for an existing similar problem
Before reporting any problem, you must ensure that nobody before you has done the same. In this case, you can simply add a comment with your personal experience to his bug report instead of creating a duplication.
The following picture is the “Bugs” main page for eyeOS. To search for an existing problem, type some keywords in the search field in the upper left, then press Enter.
(Note: you can directly access this page by following this link (eyeOS Bugs Report)
If the search process gives you some results, check that what you want to report is not already in this list. In this case, go directly to Step 4.
If no result matches your criteria, click on the Report a bug button in the upper right.
Step 3: Write the bug report
If the problem you encountered is unknown, you are invited to write a small text describing how you got it, and ideally how to reproduce it.
The following picture in the form used to report a bug. First of all, click on the link >> Advanced reporting options under the Continue button. This will show up a more detailed form.
Here are the fields you may fill:
- Summary: This is the title of you report. You have to sum up in one sentence what is your problem about.
- Tags: You can enter here some keywords to ease further searches from other people.
- Further information: Write here a complete description of the bug. Try to be as comprehensive as possible. Additionally, do not forget the following informations:
- The version of eyeOS you are using (or “public server” if it happened on eyeos.info, or “demo server” if it happened on demo.eyeos.org)
- In the case of a private server, also specify the server's operating system and HTTP application + PHP version (Apache 2.2 + PHP 2.5.1 under Debian Sarge, etc.)
- The name and version of your browser (Firefox 2.0.3, Opera 9.51, Internet Explorer 7.0.5730, etc.)
- The name and version of your operating system (Windows XP SP2, Ubuntu 8.04, Mac OSX, etc.)
- The version of eyeOS you are using (or “public server” if it happened on eyeos.info, or “demo server” if it happened on demo.eyeos.org)
- Attachment: Optionally, you may add a screenshot to better explain the problem (Firefox has a very good plugin for this: Screengrab!).
Once completed, you can submit the report by clicking on Submit Bug Report at the bottom of the page. You will see then the report how it will be displayed to other people. You may want to save the URL of the page in your favorites to easily follow its resolution.
You may also check that your report appears on the first page, in the section Latest bugs reported. If so, click again on the Bugs tab at the top of the page.
Step 4: Follow problem's resolution
Once you submit a bug, all the developers around eyeOS are notified. They will take a look at your report, and do what is needed to do to fix it.
It may happen that some additional informations are needed, and you are invited to follow the resolution of the problem and to answer to the questions the developers could ask.
When the bug has been fixed, the developer in charge of its resolution will change the bug's status to:
- “Fix commited”: which means that the bug has been fixed but is not publicly available yet,
- “Fix released”: which means that the latest release of eyeOS includes the corresponding fix for this bug
