During a Support Team/Test Team collaboration, I was coaching a technical support team member through logging a bug. I suggested my usual template.
1. Do this.
2. Do that.
Expected Results: Something happens.
Actual Results: Something does not happen.
Afterwards, I said “That’s it.” She looked over the Spartan bug report and was reluctant to let it go. she said, “It looks too bare bones.” She wondered if we should add screen captures and more commentary. IMO, when a bug has repro steps, that’s all you need. And the fewer the better! Sure, a picture is worth a thousand words. But sometimes it only takes about 14.
If you’ve ever participated in bug triage meetings, you’ll probably agree. People love to fill bug reports with non-essential comments that obscure the spirit of the bug and discourage anyone from reading it.
“After those steps I tried it again and got the same error.”
“Maybe it is failing because I am doing this instead of that.”
“I remember it used to not throw an error, but now it does.”
“We could fix it by doing this instead of that.”
It’s a bug report, stupid. Report the bug and get back to testing. Opinions and essays are for blogs.
…Praise for the simple, bare bone bugs.