Reporting Bugs
From Cyclopath
This page explains the steps to follow if you think you have found a bug.
The best bug reporting channel is the GroupLens Bugzilla instance, but we also welcome bug reports e-mailed to info@cyclopath.org.
Contents |
[edit] If you think you've found a bug
First, check the Release Notes to see if your bug has been fixed but the fix is not yet rolled out.
Second, search Bugzilla and perhaps also the cyclopath-users mailing list to see if your bug has already been reported. If you have additional information to add, please do participate in the discussion.
If no one has reported your bug yet, fill out the Bugzilla bug report form (you will need to create a Bugzilla account, which takes just a few seconds) or send us e-mail.
The advantage of reporting bugs using Bugzilla instead of e-mail is that you can participate in the follow-up discussion and follow progress closely.
Note: if your report includes addresses or other private information, click "Show Advanced Fields" and check "Initial Description is Private". Do not ever put passwords in a bug report.
Ideally, prepare a bug report in the format of the sample below. This makes it easier for Cyclopath HQ to reproduce the problem, which is an essential step in fixing it.
However:
- Your report is useful even if you can't fit the format.
- If you can't reproduce it, or you're not sure what steps caused it, it is still very useful to know something may be wrong, even if no one knows exactly what yet. You can always follow up later is if you find out more.
Bottom line: If you think something is wrong, tell us promptly!
For technical details on how the developers work with bugs, see Tech:Bug Database
[edit] Sample bug report
Time of occurrence:
- Tuesday, Sep 9, 2008, at 12:39pm
Steps to reproduce:
- Reload the geowiki.
- Click on Routes tab.
- Click Find New Route.
- Enter "Bruce Vento" into the From box.
- Enter "Rose Gargen" into the To box.
- Click Find.
Expected behavior:
- Geowiki thinks for a while and then presents a route from Bruce Vento Sanctuary to the Rose Garden near Lake Harriet.
Actual behavior:
- Geowiki displays a dialog box titled "Can't find route" with the text "No response from routing server. Please report this bug."
[edit] Common symptoms
[edit] Error #2032: Stream error
This means that the server failed to give an appropriate response (not even an error message), which usually indicates a bug. It is particularly important to know the date and time of the failure, because we can then look in the server logs and (often) see what went wrong.
[edit] No response from routing server
This means that the routing server gave up without returning a route or error message, which is a bug. Again, the date and time of the failure are very important.
