Support Sessions: How We Manage Bug Reporting

Tune in every month for support team insight

Digital products have come a long way and so many teams are more agile than ever before. With continuous delivery, quick turnarounds and back-to-back release dates, running into production bugs every now and then is natural. At Marvel we, the support team, have developed a fool proof bug reporting method to help you squash those bugs in double time. πŸ›πŸ”¨

Investigate it πŸ•΅

Firstly, we investigate the issue and try to replicate it on our side. If replication isn’t possible we aim to fill a report with as much useful information as possible, by asking a sequence of questions to whoever spotted the bug.

Write it πŸ–Š

Next, we collate this information in a report. One of the things that helps us to resolve bugs quickly, is speaking to developers in a language they can understand, so we use the following template to help describe each issue:

Description of bug
We write a helpful description of the problem. The more information, the easier it is for the development team to get an understanding of the issue, but we like to keep this straight to the point, no waffling here!

Steps to recreate bug:
Create an ordered list of each step taken to recreate the bug. For example:

  1. Go to download menu
  2. Click on iOS
  3. Download does not start

Expected Result
How we expect this to work

Actual Result
How the feature is (mis)behaving

URL
Include a link to the effected project/screen/account area

Code reference:
Reference to browser console and network errors

Video/screen shot:
If we can replicate the bug, we’ll pop a screen shot/recording in

Environment, Browser and OS version:
The browser & operating system the bug is happening on

Scale
When checking this bug, we include information on how many people this is effecting – this helps when prioritising!

Prioritise it 🚨

Once we’ve written up a bug report, we can set the priority. To help with this we use a matrix system that explains the impact and severity on a scale of 1-5. We assign a priority rating of P1, P2, P3 & P4, with P1 being the highest priority and P4 assigned to smaller issues, we then submit the bug to be prepared for discussion.

At Marvel, only P1 or P2 bugs are considered when we decide what will be fixed as we find that P3 & P4 bugs tend to be picked up by regular feature updates. So, even though we still report these, we don’t discuss these with the wider team.

Discuss it πŸ€”

Each week, we meet with product managers and check over the P1 & P2 backlog to see what needs to be pushed into upcoming sprints. Sprints last two weeks and are full of important feature work that we like to ship as quickly as possible, so there is a lot to compete with!

To help decide what makes it into an already busy list, we try to stick to strict fix deadlines that are assigned to priorities. These are that a P1 bug should always break a sprint to be fixed, or, be put in the next immediate sprint (up to two weeks) and a P2 bug should not spend more than 2 or 3 sprints in the backlog (up to 6 weeks).

We find that having these set rules and working from a small list of bugs in handy dashboards, allows us wider visibility of what needs to be fixed first.

Fix it πŸ› 

Wahey, the bug is now in sprint waiting it’s turn to be exterminated!

Test it πŸ‘©β€πŸ’»

We trust our engineering team but to be sure that everything is working as expected, we do a run through test to check that all is resolved.

Ship it πŸš€

Now we can ship the fix and share the good news with anyone who found or experienced the bug.

Need help with a bug or question? Drop us a message.

Tech support @ Marvel

Related Posts

We’re excited to launch the first in a series of Workshop Kits, that will help you run your own hands-on sessions using popular design methodologies, together with Marvel! Thousands of companies and educational institutions around the world use Marvel in workshops every year. It’s massively inspiring to see the likes of Laboratoria, Design Museum and initiatives like Design Club lead… Read More →

Prototyping is not only a stage of the design process, it’s heavily involved in the developer handoff process as well. When a design is ready to go into development, developers often receive pages of spec documents outlining how the design should look, feel and function. This has been a major pain point for many large organisations and design teams, and… Read More →

Using tools can be confusing, frustrating and [fill in the blank]! However, when it comes to using Marvel, you’ll always have a helping hand. Our customer team are always on hand to answer any questions or help solve any problems you might have. Whether it’s experiencing a bug or just figuring out how something works, we’re super dedicated to our… Read More →