<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>thoughts from the test eye &#187; bug report</title>
	<atom:link href="http://thetesteye.com/blog/tag/bug-report/feed/" rel="self" type="application/rss+xml" />
	<link>http://thetesteye.com/blog</link>
	<description>by rikard edgren, henrik emilsson and martin jansson - with torbjörn ryber and henrik andersson</description>
	<lastBuildDate>Sun, 13 May 2012 17:27:07 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.3.1</generator>
		<item>
		<title>Bug Title Crash Course</title>
		<link>http://thetesteye.com/blog/2012/03/bug-title-crash-course/</link>
		<comments>http://thetesteye.com/blog/2012/03/bug-title-crash-course/#comments</comments>
		<pubDate>Wed, 07 Mar 2012 15:08:02 +0000</pubDate>
		<dc:creator>Rikard Edgren</dc:creator>
				<category><![CDATA[Documentation]]></category>
		<category><![CDATA[bug report]]></category>
		<category><![CDATA[language]]></category>

		<guid isPermaLink="false">http://thetesteye.com/blog/?p=2499</guid>
		<description><![CDATA[<img src="http://thetesteye.com/blog/wp-content/uploads/documentation.png" width="48" height="48" alt="" title="Documentation" /><br/>If you want to seriously improve your bug reporting skills, read up, or take, the BBST Bug Advocacy course. If you want to start by improving bug report title/subject/summary; read Lessons Learned in Software Testing, no, 83, or this blog post. Many people will only read the title, so it is important to make it [...]]]></description>
			<content:encoded><![CDATA[<img src="http://thetesteye.com/blog/wp-content/uploads/documentation.png" width="48" height="48" alt="" title="Documentation" /><br/><p>If you want to seriously improve your bug reporting skills, read up, or take, the BBST <a href="http://www.testingeducation.org/BBST/bugadvocacy/">Bug Advocacy course</a>.<br />
If you want to start by improving bug report title/subject/summary; read <a href="http://www.amazon.com/Lessons-Learned-Software-Testing-Kaner/dp/0471081124/ref=pd_bbs_sr_1?ie=UTF8&amp;s=books&amp;qid=1238292248&amp;sr=8-1">Lessons Learned in Software Testing</a>, no, 83, or this blog post.</p>
<p>Many people will only read the title, so it is important to make it possible to<br />
* understand how the problem appears<br />
* understand limitations and dependencies<br />
* understand the consequences of the bug</p>
<p>Some people will make their first decision on fix/don&#8217;t fix, based solely on the title.<br />
(And for those that look carefully at the report, the title will guide their thinking.)<br />
The goal is to make it possible to understand the bug, and how important it is, just by reading the title.</p>
<h3>A few tips</h3>
<p>* As short as possible, but no shorter than that.<br />
* Start the sentence with the most important, to capture the reader&#8217;s interest.<br />
* Don&#8217;t overdo &#8220;externalization&#8221; to capture interest, rather describe the dry facts, and let the readers draw conclusions<br />
* If it&#8217;s difficult, try many times, or write the title after everything else is done (you might find the right words on the way.)<br />
* Include a brief description of what happens.<br />
* Include where the problem happens.<br />
* Describe observations rather than (presumed) facts.<br />
* Use a fair description, don&#8217;t exaggerate or understate the consequence of the problem</p>
<p>I also have a tiny, controversial one; start the title with lower case for the first word.<br />
Most testers think they are writing a sentence in a story, and start with upper case (and end with a redundant full stop.) The problem I see with this is that you lose the ability to use upper case for names and terminology. &#8220;Exit&#8221; refers to an element in the software, &#8220;exit&#8221; refers to the action, which can be done in several ways. This is nitpicking, yeah, but it&#8217;s what I think.</p>
<p>You can&#8217;t include everything in the title, so use what&#8217;s most important.<br />
The best way to learn this comes as no surprise: practice a lot.</p>
<p><a class="a2a_dd a2a_target addtoany_share_save" href="http://www.addtoany.com/share_save#url=http%3A%2F%2Fthetesteye.com%2Fblog%2F2012%2F03%2Fbug-title-crash-course%2F&amp;title=Bug%20Title%20Crash%20Course" id="wpa2a_2"><img src="http://thetesteye.com/blog/wp-content/plugins/add-to-any/share_save_171_16.png" width="171" height="16" alt="Share"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://thetesteye.com/blog/2012/03/bug-title-crash-course/feed/</wfw:commentRss>
		<slash:comments>6</slash:comments>
		</item>
		<item>
		<title>Who does the pinpointing?</title>
		<link>http://thetesteye.com/blog/2009/12/who-does-the-pinpointing/</link>
		<comments>http://thetesteye.com/blog/2009/12/who-does-the-pinpointing/#comments</comments>
		<pubDate>Wed, 30 Dec 2009 22:31:01 +0000</pubDate>
		<dc:creator>Martin Jansson</dc:creator>
				<category><![CDATA[Documentation]]></category>
		<category><![CDATA[People]]></category>
		<category><![CDATA[bug report]]></category>
		<category><![CDATA[Jerry Weinberg]]></category>
		<category><![CDATA[pinpointing]]></category>

		<guid isPermaLink="false">http://thetesteye.com/blog/?p=740</guid>
		<description><![CDATA[<img src="http://thetesteye.com/blog/wp-content/uploads/documentation.png" width="48" height="48" alt="" title="Documentation" /><img src="http://thetesteye.com/blog/wp-content/uploads/people.png" width="48" height="48" alt="" title="People" /><br/>Jerry Weinberg has, in his book &#8221;Perfect Software and other illusions about testing&#8221;, expressed a very important observation, namely who is responsible for pinpointing the bug. The tester finds the bug, tries to reproduce it, then adds as much information that he/she has such as log files, configurations, test data and so on. When you estimate time for testing [...]]]></description>
			<content:encoded><![CDATA[<img src="http://thetesteye.com/blog/wp-content/uploads/documentation.png" width="48" height="48" alt="" title="Documentation" /><img src="http://thetesteye.com/blog/wp-content/uploads/people.png" width="48" height="48" alt="" title="People" /><br/><p>Jerry Weinberg has, in his book &#8221;Perfect Software and other illusions about testing&#8221;, expressed a very important observation, namely who is responsible for pinpointing the bug. The tester finds the bug, tries to reproduce it, then adds as much information that he/she has such as log files, configurations, test data and so on. When you estimate time for testing I think you most often consider the time that you do to find the bug and then make a report. As Jerry points out, the time it takes to pinpoint the exact location is not taken into consideration. It might also be unclear who has this responsibility.</p>
<p>This might not be an issue where there is high testability, when it takes little time to report the bug and when the actual pinpointing takes little time. When testing complex systems (a system consisting of several sub system, different hardware, many interfaces, a vast amount of ways to get information on what actually went wrong), the time for pinpointing can be a factor that is underestimated and that can really be a major issue in a project. Reproducing a bug can take several hours or possibly days. If you, after having reported the bug, are asked by the developer to add extra or missing information to the bug it might cost you days to get into the same erroneous state. In some cases it might be close to impossible because of missing equipment or missing/broken units. When it takes this long time it is inevitable that a conflict grows in the project. It is also inevitable that the testers start to doubt how much time they should spend on bug reporting (in the worst case scenario consider not doing it) and if they can help developers.</p>
<p>How do you handle pinpointing? Is there any need to increase testability to make it easier to report bugs and get information from the sysem? How have you discussed and communicated this within our projects? Is your testlead and project manager aware of this time sink and uncertainty?</p>
<p>If you want to taste some of Jerry Weinbergs knowledge I recommend reading <a title="Perfect Sofware and other illusions about testing" href="http://www.amazon.com/Perfect-Software-Other-Illusions-Testing/dp/0932633692" target="_blank">this book</a>.</p>
<p><a class="a2a_dd a2a_target addtoany_share_save" href="http://www.addtoany.com/share_save#url=http%3A%2F%2Fthetesteye.com%2Fblog%2F2009%2F12%2Fwho-does-the-pinpointing%2F&amp;title=Who%20does%20the%20pinpointing%3F" id="wpa2a_4"><img src="http://thetesteye.com/blog/wp-content/plugins/add-to-any/share_save_171_16.png" width="171" height="16" alt="Share"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://thetesteye.com/blog/2009/12/who-does-the-pinpointing/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		</item>
		<item>
		<title>The impact of a good or bad bug report</title>
		<link>http://thetesteye.com/blog/2009/07/the-impact-of-a-good-or-bad-bug-report/</link>
		<comments>http://thetesteye.com/blog/2009/07/the-impact-of-a-good-or-bad-bug-report/#comments</comments>
		<pubDate>Sat, 18 Jul 2009 16:23:35 +0000</pubDate>
		<dc:creator>Martin Jansson</dc:creator>
				<category><![CDATA[Documentation]]></category>
		<category><![CDATA[People]]></category>
		<category><![CDATA[bug report]]></category>
		<category><![CDATA[bugs]]></category>

		<guid isPermaLink="false">http://thetesteye.com/blog/?p=372</guid>
		<description><![CDATA[<img src="http://thetesteye.com/blog/wp-content/uploads/documentation.png" width="48" height="48" alt="" title="Documentation" /><img src="http://thetesteye.com/blog/wp-content/uploads/people.png" width="48" height="48" alt="" title="People" /><br/>You are on a quite large company where there are several QA divisions, several layers of management, several listeners to each step of the development process. It is the final weeks of the release. You are about to enter a bug which seem serious but you are not sure. You can take at least two paths [...]]]></description>
			<content:encoded><![CDATA[<img src="http://thetesteye.com/blog/wp-content/uploads/documentation.png" width="48" height="48" alt="" title="Documentation" /><img src="http://thetesteye.com/blog/wp-content/uploads/people.png" width="48" height="48" alt="" title="People" /><br/><p>You are on a quite large company where there are several QA divisions, several layers of management, several listeners to each step of the development process. It is the final weeks of the release. You are about to enter a bug which seem serious but you are not sure. You can take at least two paths here&#8230;</p>
<p>Take the easy path and you report what you have seen so far and scribble down a few quick repro steps on what you think might be the bug. You do not dig deeper cause its been a long week and it is your right to go home now.</p>
<p>&#8230; or &#8230;</p>
<p>Take the harder path and you really try to hone down what is wrong. You try to find some repro steps on what it is. You try to see how often this bug appear and what impact you think it has. You extract log files, config files and all other information that you think might help the developer. You proof read the bug report and make sure you have gotten everything in there. You let someone else take a look before entering it.</p>
<p>As the submit of the bug takes place you see that there were many who got the bug in the mailboxes as a final delivery at the end of the week.</p>
<p>Chosing the easier path might have come to a situation where you as an observer&#8230;</p>
<ul>
<li>do not believe the bug</li>
<li>ignore the bug because it seem too vague</li>
<li>think the testers are crap and become unsure if their previous bugs were infact not correct as well</li>
<li>are scared that the quality of the release is in danger because you have no trust in the bugs</li>
<li>become angry because the testers do not take their job seriously and enter a bug in such bad state in such a critical moment</li>
<li>become angry as a tester thinking that the other test team gives you a bad reputation</li>
</ul>
<p>The list could go on for some time&#8230;</p>
<p>Chosing the harder path might have come to a situation where you as an observer&#8230;</p>
<ul>
<li>are thankful as a developer that you did not have to work the weekend to try to find the reprosteps</li>
<li>are thankful as a project manager that you were able to make a bug classification more easily before everyone had left for the weekend</li>
<li>are impressed as a manager that the testers give the extra effort to save so much time for others</li>
<li>are thankful as a tester that the other testers take pride in their work and deliver at every step</li>
</ul>
<p>The easy path is quicker while the harder path takes a bit longer time. Depending on your thouroughness and completeness the result will differ enourmously. Naturally this is not always the case, but I&#8217;ve seen this happen so many times.</p>
<p><a class="a2a_dd a2a_target addtoany_share_save" href="http://www.addtoany.com/share_save#url=http%3A%2F%2Fthetesteye.com%2Fblog%2F2009%2F07%2Fthe-impact-of-a-good-or-bad-bug-report%2F&amp;title=The%20impact%20of%20a%20good%20or%20bad%20bug%20report" id="wpa2a_6"><img src="http://thetesteye.com/blog/wp-content/plugins/add-to-any/share_save_171_16.png" width="171" height="16" alt="Share"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://thetesteye.com/blog/2009/07/the-impact-of-a-good-or-bad-bug-report/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		</item>
	</channel>
</rss>

