[{"data":1,"prerenderedAt":183},["ShallowReactive",2],{"i-lucide:menu":3,"i-lucide:arrow-up-right":8,"i-lucide:moon":10,"i-lucide:sun":12,"i-lucide:rss":14,"i-simple-icons:github":16,"i-simple-icons:linkedin":18,"post-\u002F2013\u002Fon-customers-who-submit-bug-reports":21,"surround-\u002F2013\u002Fon-customers-who-submit-bug-reports":170,"i-lucide:arrow-left":179,"i-lucide:arrow-right":181},{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":7},0,24,false,"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M4 5h16M4 12h16M4 19h16\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":9},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M7 7h10v10M7 17L17 7\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":11},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":13},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"4\"\u002F>\u003Cpath d=\"M12 2v2m0 16v2M4.93 4.93l1.41 1.41m11.32 11.32l1.41 1.41M2 12h2m16 0h2M6.34 17.66l-1.41 1.41M19.07 4.93l-1.41 1.41\"\u002F>\u003C\u002Fg>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":15},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M4 11a9 9 0 0 1 9 9M4 4a16 16 0 0 1 16 16\"\u002F>\u003Ccircle cx=\"5\" cy=\"19\" r=\"1\"\u002F>\u003C\u002Fg>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":17},"\u003Cpath fill=\"currentColor\" d=\"M12 .297c-6.63 0-12 5.373-12 12c0 5.303 3.438 9.8 8.205 11.385c.6.113.82-.258.82-.577c0-.285-.01-1.04-.015-2.04c-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729c1.205.084 1.838 1.236 1.838 1.236c1.07 1.835 2.809 1.305 3.495.998c.108-.776.417-1.305.76-1.605c-2.665-.3-5.466-1.332-5.466-5.93c0-1.31.465-2.38 1.235-3.22c-.135-.303-.54-1.523.105-3.176c0 0 1.005-.322 3.3 1.23c.96-.267 1.98-.399 3-.405c1.02.006 2.04.138 3 .405c2.28-1.552 3.285-1.23 3.285-1.23c.645 1.653.24 2.873.12 3.176c.765.84 1.23 1.91 1.23 3.22c0 4.61-2.805 5.625-5.475 5.92c.42.36.81 1.096.81 2.22c0 1.606-.015 2.896-.015 3.286c0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":19,"hidden":20},"\u003Cpath fill=\"currentColor\" d=\"M20.447 20.452h-3.554v-5.569c0-1.328-.027-3.037-1.852-3.037c-1.853 0-2.136 1.445-2.136 2.939v5.667H9.351V9h3.414v1.561h.046c.477-.9 1.637-1.85 3.37-1.85c3.601 0 4.267 2.37 4.267 5.455v6.286zM5.337 7.433a2.06 2.06 0 0 1-2.063-2.065a2.064 2.064 0 1 1 2.063 2.065m1.782 13.019H3.555V9h3.564zM22.225 0H1.771C.792 0 0 .774 0 1.729v20.542C0 23.227.792 24 1.771 24h20.451C23.2 24 24 23.227 24 22.271V1.729C24 .774 23.2 0 22.222 0z\"\u002F>",true,{"id":22,"title":23,"body":24,"category":150,"comments":151,"date":152,"description":147,"excerpt":151,"extension":153,"image":151,"meta":154,"navigation":20,"path":155,"readingTime":156,"seo":157,"stem":158,"subtitle":151,"tags":159,"wordCount":168,"__hash__":169},"posts\u002F2013\u002Fon-customers-who-submit-bug-reports.md","On Customers Who Submit Bug Reports",{"type":25,"value":26,"toc":146},"minimark",[27,52,63,66,82,89,96,99,110,113,137,140,143],[28,29,30,31,34,35,37,38,40,41,43,44,46,47,51],"blockquote",{},"\n  [22:17.29] * Bill sent file Screen Shot 2013-02-15 at 22.16.49 .png.",[32,33],"br",{},"\n  [22:18.09] \u002FDavid: Yeah, probably",[32,36],{},"\n  [22:18.16] \u002FDavid: Will have to do something about that.",[32,39],{},"\n  [22:18.43] \u002FDavid: Submit a bug report :D Or better yet, a pull request that fixes the problem.",[32,42],{},"\n  [22:19.02] Bill: Er...",[32,45],{},"\n  [22:19.11] Bill: That ",[48,49,50],"strong",{},"was"," a bug report.\n",[53,54,55,56,60,61],"p",{},"I'm sure you've familiar with the joys of handling customer bug reports - especially when the customer is, shall we say, not a computer person. There has been ",[57,58,59],"em",{},"some"," ranting on the subject, from both sides. The developers curse the obscure descriptions that often go in the style of \"X won't work, fix now\", the customers can't understand how the problem isn't immediately obvious.",[32,62],{},[53,64,65],{},"Most people accept that production code - especially when the customer isn't willing to pay for reasonable testing - has bugs in it. Those bugs get stumbled upon by unsuspecting users and eventually reported to the developers who then have to...",[67,68,69,73,76,79],"ol",{},[70,71,72],"li",{},"Replicate the bug",[70,74,75],{},"Patch the code",[70,77,78],{},"Hope that they actually solved the problem the right way",[70,80,81],{},"Get it into production (which might take time)",[53,83,84,85,88],{},"The problem with bug reports is that people who usually submit them aren't technical people - nor should they be. An accountant might not realize that the development needs to know ",[57,86,87],{},"n"," details about the bug and his local environment to locate and fix it.",[53,90,91,92,95],{},"It is important to communicate and learn new things. The best collaboration between a development company and a customer happens when both parties respect each other, are honest and ",[48,93,94],{},"collaborate",".",[53,97,98],{},"It is the job of a developer to explain things so that people without a degree in computer science can comprehend what's happening. In the case of quality bug reports it boils down to...",[67,100,101,104,107],{},[70,102,103],{},"Explaining the process of submitting a bug report (possibly using a tool like GitHub)",[70,105,106],{},"Having a customer who comprehends the explanation and is willing to follow the etiquette",[70,108,109],{},"Keeping the lines of communication active, honest and polite",[53,111,112],{},"It's a joy to get a bug report that contains all the information that helps me, the developer, fix the error quickly. Details like those include...",[114,115,116,119,122,125,128,131,134],"ul",{},[70,117,118],{},"A short summary (the title)",[70,120,121],{},"Step-by-step descriptions of what was done when encountering the problem",[70,123,124],{},"Description of the expected result",[70,126,127],{},"What happened instead",[70,129,130],{},"Screenshot(s) of the problem",[70,132,133],{},"Client environment information (Windows, latest Chrome)",[70,135,136],{},"...",[53,138,139],{},"Bug report template formats differ, but generally have between six-to twelve fields. It's good to get as much details as you possibly can, but avoid overwhelming people with the complexity of submitting a bug report. It depends on the person, really. Sometimes you might be lucky and get someone who understands that what might take him two minutes to write up might decrease your workload by an hour and get his problem solved that much faster. Other times the best you can get are the words \"broken\", \"critical\" and \"now\".",[53,141,142],{},"Do have a process for submitting and managing bugs... and do try to subtly or not so subtly convert your users to follow it. In the end, you both win.",[53,144,145],{},"How do you manage bugs in your team? Do you have clients who help you solve bugs faster?",{"title":147,"searchDepth":148,"depth":148,"links":149},"",2,[],"Software Development",null,"2013-02-16","md",{},"\u002F2013\u002Fon-customers-who-submit-bug-reports","about 2 minutes",{"title":23,"description":147},"2013\u002Fon-customers-who-submit-bug-reports",[160,161,162,163,164,165,166,167],"coding","development","bug report","issue","custormer","communication","bug","project management",538,"K4YH6rb7t4Ahx0zHKlnLlDuuxxplmAYSOZrKenc-ndk",[171,175],{"title":172,"path":173,"stem":174,"children":-1},"The Vampire Diaries And Death","\u002F2013\u002Fthe-vd-and-death","2013\u002Fthe-vd-and-death",{"title":176,"path":177,"stem":178,"children":-1},"Pomodoro On A Breadboard","\u002F2013\u002Fpomodoro-on-a-breadboard","2013\u002Fpomodoro-on-a-breadboard",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":180},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m12 19l-7-7l7-7m7 7H5\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":182},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M5 12h14m-7-7l7 7l-7 7\"\u002F>",1790886934106]