This thread is part of a series on fostering a culture of quality control through excellent process. In general, the issue tracker seems to be not well understood at all. As such, it's clearly time for a guide, and this is it! :-)
Upon thinking about that, it's clear why:
- Most people have never heard of them, let alone used them.
- Those who have heard about them and not used them have no idea either.
- Those who have used them a little bit probably didn't do it properly without mentoring, and have now forgotten anyway.
- Those that use them extensively probably use them in one of the thousand other work flow patterns that are possible, not the way I want you to here.
- Reporting An Issue (for everyone)
- Handling A Reported Issue (for devs)
- Fixing An Issue For A Reporter
- Testing And Closing Issues
- Work Flow Summary
- Quirks Of Our Issue Tracker
- Important Links On Our Tracker
A simple run down on the main points of issue trackers.
What's The Point?
Software is complicated, issue trackers can help software developers keep track of all the issues that invariably come up during the application development process. They also keep peoples problems with a software system from being forgotten or hidden and help organise work on a software project and keep the process manageable.
What's In It For Me?
Traceability and transparency on system problems. There is always a history of what happened, why, who worked on it, who reported it, etc. Your problems won't get forgotten or left unexplained, you'll be "in the loop" with what happens, no matter what it is. Lastly, it helps guarantee that you do get fixes for your issues, and in a more timely fashion!
I Have A Problem! What To Do?
Tell us! :-) If you're 100% sure that you have found a problem, it's OK to go straight to the issue tracker. If you're not, it's probably best to mention it on the forum in the user support section first or drop into one of the IRC channels for a quick chat. If you go straight to the tracker you may wish to post a discussion thread in the user support section with a link to your report on the issue tracker.
If you have any feedback on this guide, or anything to ask, please go here!