0

I work in a small team of developers that supports several pieces of software that a large multi-site company uses.

We use Spiceworks to raise issues and support requests throughout the IT department not just developers.

We constantly get tickets raised with the following or similar:

"Function X is broken, please fix it, it is urgent"

Now this statement is practically useless to me, and it wastes my time and theirs whilst I try to work out the problem often only to discover it is something they had not realised or that should be assigned to someone else.

Now my question is in what ways could I try to get people to write more information in bugs? I have thought of several ideas such as a template but I am pretty sure they would be ignored.

The only thing I can think of that would almost certainly work is to refuse to action any tickets not written correctly, but I have my doubts as to whether I would be allowed to do this.

Incidentally the people raising the bugs tend to have trouble using basic computer functions so I cant ask them to do anything very technical without a great deal of effort.

Thanks all

4
  • 8
    close as "could not reproduce" Commented Mar 10, 2014 at 15:49
  • Lol - that kind of comes under the "I wont action tickets till you write them properly" case Commented Mar 10, 2014 at 15:52
  • @ratchetfreak Closing bug reports simply because they lack information isn't productive. You're just kicking the can down the road.
    – Robbie Dee
    Commented Mar 10, 2014 at 16:35
  • 2
    It doesn't matter how much experience, or how little, a person has, if they don't get good feedback on what is required, they won't do it. Tell them what you need to know. Commented Mar 10, 2014 at 16:56

4 Answers 4

6

Part of my job is answering help desk tickets for my team's main application, which is used by a few thousand internal users. While the semantics and the system are a little different, the basic principle is the same.

Always ask for more information if it's not immediately clear from the user's submission what behavior they are expecting and not receiving. If possible, fire up the application and look at it yourself, just in case the behavior really is so obvious that "clicking on X doesn't work" was a sufficient report. If it's internal support, a chat or telephone call may be appropriate.

Ideally, use the same phrasing used in their training or help materials to refer to the issue. Do not be afraid to ask for error messages or screen shots, or just come out and clearly ask what they were expecting to happen and did not.

Do not be afraid to ask your users to take screen shots, reboot their computer, or provide you with files. There is a certain level of computer expertise that it is simply inexcusable to not possess in today's world if you use a computer in your daily job, and if your employer or customer wishes to employ such people they should have in-office support who can assist them.

2

The problem with templates is that they tend to get too complex. People tend to overload those with fields that may provide information about the bug that sometimes help the debugging process and always burden the ticket sender.

Sure, it's might be useful to know what OS and browser the user used when they encountered the bug, but the majority of the bugs are "cross platform", yet the user is always forced to enter that data.

Even if those fields are optional, having too many of them will make the template look complex and cumbersome.

If you keep the template small it wouldn't get ignored. Essentially, you need to know two thinks about the bug:

  1. What the user did
  2. What went wrong.

And that's it! Put an additional "additional information" field for everything else the user deems important, and resist the tempt to put any other fields(unless it's contact information you can't get manually).

3
  • Part of the problem is the user doesn't always appreciate which of the many steps they followed are relevant to the developer. Getting to the bottom of a complex bug is often an iterative process, not a one-hit deal IMHO...
    – Robbie Dee
    Commented Mar 10, 2014 at 16:40
  • Obviously you can't expect a detailed step-by-step reproduction instructions from your users, but even the little they'll put there is much better than what you currently receive. Users can't put "Alarm clock feature is broken" into any of these fields, so they have to break it down. The names of the fields guide them to put more useful information - "I was choosing the alarm sound" and "my phone caught fire". Unless they hit some weird end case this will be enough for you to reproduce it, and if you are familiar enough with the code you might figure the bug out it without even reproducing it.
    – Idan Arye
    Commented Mar 10, 2014 at 20:55
  • Yes, there are of course various shades in between a bug that's immediately obvious (e.g. a typo) and complex ones requiring some to and fro.
    – Robbie Dee
    Commented Mar 11, 2014 at 11:03
1

ticket writers need to be educated how to write tickets that are helpfull to developpers.

if i receive a

"Function X is broken"

i would reply:

what do you currently get if you execute 'X' ?

what are the steps to reproduce the broken 'X'

what exactly would you expect to happen, when "X" is executed ?

My customers have learned, that they get faster changes/fixes if they write their tickets with these items.

it is also helpful to make compliments to a customer that follows this rule

2
  • 1
    I've seen situations where those fields are required on bug type issues in an issue tracker.
    – user40980
    Commented Mar 10, 2014 at 16:10
  • +1 for being so consistent in your follow-up questions that they start the get answered before you needed to ask them. Commented Mar 10, 2014 at 17:59
1

I'm not familiar with that piece of software but typically any bug tracking software worth its salt will require (or can be set up to require) certain fields before bugs can be submitted.

If certain users are consistently submitting poor quality reports, I'd investigate whether only certain users could submit bugs or whether some other members of staff could act as a gatekeepers.

Something you don't mention is whether any of these bugs are given a priority. Clearly if all of your bugs are coming through as high (or the same) priority, the system is being abused.

It might tempting (as others have pointed out) to simply close them as "more information required", "vague" or "unable to reproduce", but by speaking to the users to tease out more information you may learn a few things you didn't realise about how they're using the system. Even better, you might fix a showstopper early on rather than it being allowed to fester.

Not the answer you're looking for? Browse other questions tagged or ask your own question.