If you've been to Asian countries, or to Chinese quarters in a large city, you probably know that they eat bugs in Asia. Well, they also eat snakes, caterpillars, ants, worms and what not, but for the sake of my today's discourse I'll focus on bugs. Cooking and serving bugs properly is a high art. If something in the cooking process is messed up, bugs will not taste as a deli, but as something mmm... extremely un-delicious. I don't think I will ever want to eat any of those many-legged sources of protein, unless under very compelling circumstances. However, there are folks who have to deal with bugs every day. In office. At work. You guessed it right. Today I will sum up a few tips on how bugs should be cooked and served for QA engineers, or for anyone else in your team who wants to digest them and to get rid of them as efficiently as they can.
I've borrowed these tips from our QA team. Actually, I need decent bug reports in my work as a publishing editor of Targetprocess product blog release notes as well. These release notes include a short summary of fixed bugs, and at times it's been quite a pain for our blog publishing team to understand what those bugs are about from their names. For the release notes, we want bugs to have concise names, because our customers need to know what we actually fixed. Likewise, developers might experience the same kind of trouble, trying to retrieve the nuggets of meaning from a lousy bug report in their daily assignments. Or, support engineers need to check quickly if a bug they're reporting is known, or not.
Why do we need informative bug reports?
a) We waste no time asking myriad questions trying to figure what a bug description implies. Yes, in agile teams people are supposed to talk. However, when a team gets bigger, approaching someone and talking might not be as simple as in a pizza-sized team.
b) We can quickly refresh in our memory what exactly has been done about that bug.
c) We are able to follow the thinking behind a bug fix solution, and we stay informed of any possible trade offs, if any, and why they have been made. At times, the steps to reproduce a bug, or a bug fix might seem weird, unless one knows from which pantry this bug comes from, so to say.
d) To stay in the loop of what's going on around and make mental notes of the bugs processed by other teams.
Now, can anyone, except the person who wrote this, figure what the following is supposed to mean: “This thing is not working correctly” ??? To make some sense of it, one has to check probably tons of info searching for a clue of what "working correctly" implies for "this thing".
On top of that, if this bug lacks a screenshot and a clear how-should-it-work summary, the person who posted it looks like a perfect nominee for the "Bug Chef Dunce" award.
Which bug is a well-served bug?
We will call bugs well-served if all of the following is true:
1. Their Name is a concise, well-written sentence that renders the problem. Not that this bug just exists, not where it exists, but the problem that it causes to users.
Compare: "Quick Add for users is not working correctly" and "Quick Add many users: only the first user from the batch is assigned to selected Projects".
2. A good bug Summary should allow a developer to understand in as little time as possible which behavior should be reproduced and the steps to reproduce it.
Bugs with a summary such as this one — "When I see "remove" button, I see performance degradation" — get straight to hell along with the "wordsmiths" who write them. One might want to use the "What? Where? When?" technique to write a bug summary. What goes wrong, where this wrong behavior is observed, and when, at which actions.
3. Actual behavior vs. Expected behavior. A few sentences or screenshots describing these are the best friends of productivity for a fix. They simply leave no chance for your bug report to be misunderstood and fixed improperly.
I hope this quick tips will help QAs, developers and tech support teams ensure that their bugs are served properly, ready to be digested by stomachs of whichever omnivores who need to process them.
Subscribe to the latest updates
Сheck out latest blog posts: Show all
a sales representative
Get a live
Let one of our product specialists create your account
and shape Targetprocess for your company needs.