Blog

Reference

My website has a bug - what do I do.

Why detail matters.

My website has a bug - what do I do
Tomislav Simnett

Tomislav Simnett

3 min read

To a developer, ‘it doesn’t work’ is an all too common dialogue between someone looking over the site - usually someone non-technical, and definitely someone who hasn’t read up on reporting bugs effectively.

“The site doesn’t work.” “What do you mean, the site doesn’t work?” “It just doesn’t work.” “So what is it doing that it shouldn’t be doing?” “When I go to the site, I can’t do X.” “But when I go to the site, I can do X.”

Testing after development

After development comes testing, and during testing, bug reports are made. If the bug reports are unclear in any way, then it takes more time to fix them, because it takes more time to decipher their real meaning. So what this article is about is understanding the core elements of a good bug report, and why “It doesn’t work” is bad.

What a development bug report should look like

From the perspective of a developer, a good bug report consists of a specific set of things that must always be there in order to be able to replicate it. Without the ability to replicate a bug, the chances of it being fixed are very slim. The above article by Simon Tatham, a very well regarded developer, of PuTTy fame, is probably one of the best groundings I’ve seen for writing good bug reports for software, and it extends to web applications and sites too. The first of these things is a concise but clear summary of the bug. One line is enough - just something that describes the issue, eg. “Firefox 3.0.3 prevents upload of multiple files in new messages”. That’s a good summary that with some additional information as described below is the formative part of a good report.

Detailing the bug

The concept of “Show me how to show myself” is crucial here. What’s needed is a step by step set of directions by which you came to see the bug. The developer may well not have used the application in this way and didn’t expect it to be, but users will always do the unexpected! If the issue is a display issue, take a screenshot, and include the whole window, not just a bit of it. If it’s a browser issue, and this happens a lot on the web, the developer needs to know which browser the issue happens in. If the same issue happens in every browser, one screenshot will do, but a comment to that effect is absolutely necessary. There are also some key facts that should be included with any and all bug reports: Operating System, Browser, Browser version, URL on which the error occurs. Some other useful pieces of information, depending on the bug report are: Flash version (or that it’s not installed), JavaScript status (on / off). If you think there are any more, there probably are, so feel free to comment on this article.

Key takeaways

So, to conclude, we need a good summary (usually marked down in a subject field if you’re using a bug reporting system), a set of facts about the machine you’re seeing the issue on, a clear set of instructions on how to reproduce the bug, any additional information the developer might need to reproduce the bug, and if you can, a screenshot or set of screenshots to show the developer the problem you’re seeing.

If you would like further information on the development process, our team of software developers are more than happy to help. Get in touch today to learn more.

About the author

About Tomislav Simnett

Tomislav Simnett

Tomislav Simnett

Managing Director, Initforthe · Software & AI Consultant

Tomislav helps businesses work better through bespoke software development, AI consultancy, CRM systems and automation. He founded Initforthe in 2004 and believes technology should make work easier for the people using it.

View Tomislav's full profile

How much capacity is your business leaving behind?

Use the calculator to estimate what slow processes, manual work and disconnected systems could really be costing you.

More posts.

View all
What if your business could grow without all the extra administration?

Business

What if your business could grow without all the extra administration?

We've been named Best Bespoke Software & Business Automation Consultancy – Manchester 2026 by Global Tech Insider. But the real story is what better systems can achieve: less administration, greater productivity and businesses able to grow without increasing their workforce at the same rate. One client estimates our work has saved them the need to employ 140 additional people, worth almost £10 million a year.

Tomislav Simnett

Tomislav Simnett

3 min read

We've won a digital transformation award. Here's what really matters to us.

Business

We've won a digital transformation award. Here's what really matters to us.

We've been named Digital Transformation Specialists of the Year 2026 – North West England. It's lovely recognition, but what matters more is the difference behind it: less paperwork, fewer frustrating processes and businesses able to grow without asking their people to work harder. That's what good technology should achieve.

Tomislav Simnett

Tomislav Simnett

4 min read

Your Software Holds the Data. But Does It Know How Your Business Works?

Business

Your Software Holds the Data. But Does It Know How Your Business Works?

Your software might hold all the data about your business, but does it actually know how your business works? In two recent conversations, I challenged business leaders to question something they'd always taken for granted: whether the work their people were doing needed a person to do it at all.

From unnecessary CRM administration to an entire department dependent on one employee's knowledge, both conversations revealed opportunities that went far beyond making existing tasks easier. What if our systems could understand how work happens, learn from our best people and eventually take responsibility for much of the routine work themselves?

Tomislav Simnett

Tomislav Simnett

8 min read