Skip to main content

Errors by any Other Name


You say "defect", the customer hears "defective" and the developers anticipate blame. You say "failure", the customer hears "catastrophe" and the tech support staff anticipate overtime. You say "own goal" and the customer wonders what you're talking about and you anticipate an imminent conversation with your boss.

As an industry we use many different names for bugs, including anomaly, call, crash, defect, DR, enhancement, error, events, exception, failure, fault, flaw, incident, issue, mistake, own goal, problem, side effect, suggestion, ticket, TR (collected from 1234). But surely it's as Shakespeare never said:
What's in a name? That which we call errors
By any other name would smell as sweat;
Really? What exactly are we talking about here? I like the broad Rapid Software Testing take on what a bug is:
A bug is anything about the product that threatens its value.
The BBST Bug Advocacy course has something similar:
Anything that causes an unnecessary or unreasonable reduction of the quality of a software product 
finessing the idea by introducing the notion that there can be reasonable or necessary (to people who matter) compromises in a product, and that these might not be regarded as bugs.

Multiple names exist for many reasons including: because language is productive (e.g. metonymy, synonymy), because the distinctions are required or useful in some situations, because they're taken from the tool used to manage them, because of misunderstandings, because of tradition, because of culture, because of migration of words from one person or project, or company or industry to another.

And some of the names here are probably not widely used as synonyms for bugs as a whole. Some are sub-classes of bugs, for example suggestion, crash and side-effect. Some are potential attributes of many sub-classes, such as regression or blocker. Some refer to the artefacts produced in the recording or acknowledgement of an issue and which, strictly, are distinct from its existence: ticket, call, report, incident and the like.

Does it matter that we have so many names, anyway? Put simply: yes, sometimes. People are highly attuned to nuances of meaning and also, more pertinently, to forming opinions based on their interpretation of a simple word. If you don't believe me, sit in a meeting where a product or a company name  is being decided. The choice of term for (let's say) an issue can be interpreted as, amongst other things:
  • Attributing blame for the issue, e.g. to a person, software component, process or company. Anne-Marie Charrett  doesn't use "the word defect because of the impact the word has on a developers ears. No-one likes to hear their code is defective, much better is a bug or an issue." When I was a technical support manager, I made it policy never to refer to problems reported by customers as bugs (to the customer) instead we used the word issue, largely to avoid implicitly attributing blame to our product before investigation.
  • Providing a value judgement on the issue, e.g. the existence of a defect as agreeing that the product is defective. When I attended Rapid Software Testing, James Bach was against using the word defect because of potential legal implications.
  • Designating a severity or priority of the issue to e.g. you, a stakeholder, your company, your customer. For example, compare your reaction to being told there's an incoming suggestion vs a failure. Similarly, the term used might identify a point in the time that the issue will be scheduled for resolution, e.g. an enhancement vs a blocker.
  • Marking the issue as core or a symptom,  e.g. a UI issue could be bad logic in the underlying model or bad rendering of the model. Jerry Weinberg makes a distinction between fault (an underlying issue) and failure (a manifestation of the fault) in Quality Software Management and other books. The BBST Bug Advocacy course makes error and fault synonyms and permits defect to cover both error and failure.
  • Identifying a point in the production process that the issue was generated. The August 2013 issue of TEST magazine differentiates flaw (a design problem) from bug (coding error) while on the Software Testing Club forum, Chad Patrick noted a definition of error as "a problem created, found, and resolved during the same phase. So a bug introduced in code and caught during a peer review or unit test, an incorrect requirement uncovered and resolved during a static analysis during analysis, etc." Fiona Charles suggests that defect has a pair term rarely used in software: "[the construction industry] also uses the term deficiency, to mean (approximately) things we should have built but didn't - in contrast with defect, meaning things we built that don't match spec."
There's some discussion on the STC about whether we need industry standardisation on these kinds of terms. I don't think we do, although it's clear that there's a set of words that have loaded meanings in some circumstances and in any dialogue that requires non-shallow understanding, those terms are going to have to be defined.

As usual, context is the guiding factor. The people you're talking to, the relationship you have with them, the kind of problem you're discussing about the kind of thing that you're building or supporting, how you're discussing it need to be understood by both sides, or you'll start to see issues, mistakes, errors, problems ...

Comments

Jari Laakso said…
What a wonderful post, thanks!

"When I was a technical support manager, I made it policy never to refer to problems reported by customers as bugs (to the customer) instead we used the word issue, largely to avoid implicitly attributing blame to our product before investigation."

I like to say "a bug is something that bugs someone who matters at some time", thus I would have called those as bugs. So one more side to the whole discussion!

Keep 'em coming!


Best regards,
Jari
James Thomas said…
@Jari: Glad you enjoyed it, cheers.

Depending on the cause(s) we'd call them bugs internally. In tech support, there's often a factors outside the responsibility or control of the product that could influence the product's behaviour.

For me, in that role, "issue" seemed to more closely encompass any "something that bugs someone" and was neutral on the cause, while "bug" seemed more strictly related to our product.

To give an example of the kind of thing that motivated this thought: if the product failed to run because Java wasn't installed and the customer sent in a tech support request, there may be a bug - perhaps our product wasn't clear enough about its dependencies or reporting the reason that it can't run - but the issue that needs resolving is that the customer must have Java, something that would be fixed by someone outside our company.
Jari Laakso said…
Oh, look at that! You just gave a whole lot of context for this small remark (about my experience). I think you could have written a blog post about each of the "claims" you had. Very very nice!

Can't wait to read the next entry!

Enjoy the weekend!
One of my offerings here: http://www.developsense.com/blog/2014/04/ive-had-it-with-defects/

---Michael B.

Popular posts from this blog

Meet Me Halfway?

  The Association for Software Testing is crowd-sourcing a book,  Navigating the World as a Context-Driven Tester , which aims to provide  responses to common questions and statements about testing from a  context-driven perspective . It's being edited by  Lee Hawkins  who is  posing questions on  Twitter ,   LinkedIn , Mastodon , Slack , and the AST  mailing list  and then collating the replies, focusing on practice over theory. I've decided to  contribute  by answering briefly, and without a lot of editing or crafting, by imagining that I'm speaking to someone in software development who's acting in good faith, cares about their work and mine, but doesn't have much visibility of what testing can be. Perhaps you'd like to join me?   --00-- "Stop answering my questions with questions." Sure, I can do that. In return, please stop asking me questions so open to interpretation that any answ...

Can Code, Can't Code, Is Useful

The Association for Software Testing is crowd-sourcing a book,  Navigating the World as a Context-Driven Tester , which aims to provide  responses to common questions and statements about testing from a  context-driven perspective . It's being edited by  Lee Hawkins  who is  posing questions on  Twitter ,   LinkedIn , Mastodon , Slack , and the AST  mailing list  and then collating the replies, focusing on practice over theory. I've decided to  contribute  by answering briefly, and without a lot of editing or crafting, by imagining that I'm speaking to someone in software development who's acting in good faith, cares about their work and mine, but doesn't have much visibility of what testing can be. Perhaps you'd like to join me?   --00-- "If testers can’t code, they’re of no use to us" My first reaction is to wonder what you expect from your testers. I am immediately interested ...

The Best Programmer Dan Knows

  I was pairing with my friend Vernon at work last week, on a tool I've been developing. He was smiling broadly as I talked him through what I'd done because we've been here before. The tool facilitates a task that's time-consuming, inefficient, error-prone, tiresome, and important to get right. Vern knows that those kinds of factors trigger me to change or build something, and that's why he was struggling not to laugh out loud. He held himself together and asked a bunch of sensible questions about the need, the desired outcome, and the approach I'd taken. Then he mentioned a talk by Daniel Terhorst-North, called The Best Programmer I Know, and said that much of it paralleled what he sees me doing. It was my turn to laugh then, because I am not a good programmer, and I thought he knew that already. What I do accept, though, is that I am focussed on the value that programs can give, and getting some of that value as early as possible. He sent me a link to the ta...

Beginning Sketchnoting

In September 2017 I attended  Ian Johnson 's visual note-taking workshop at  DDD East Anglia . For the rest of the day I made sketchnotes, including during Karo Stoltzenburg 's talk on exploratory testing for developers  (sketch below), and since then I've been doing it on a regular basis. Karo recently asked whether I'd do a Team Eating (the Linguamatics brown bag lunch thing) on sketchnoting. I did, and this post captures some of what I said. Beginning sketchnoting, then. There's two sides to that: I still regard myself as a beginner at it, and today I'll give you some encouragement and some tips based on my experience, to begin sketchnoting for yourselves. I spend an enormous amount of time in situations where I find it helpful to take notes: testing, talking to colleagues about a problem, reading, 1-1 meetings, project meetings, workshops, conferences, and, and, and, and I could go on. I've long been interested in the approaches I've evol...

Not Strictly for the Birds

  One of my chores takes me outside early in the morning and, if I time it right, I get to hear a charming chorus of birdsong from the trees in the gardens down our road, a relaxing layered soundscape of tuneful calls, chatter, and chirrupping. Interestingly, although I can tell from the number and variety of trills that there must be a large number of birds around, they are tricky to spot. I have found that by staring loosely at something, such as the silhouette of a tree's crown against the slowly brightening sky, I see more birds out of the corner of my eye than if I scan to look for them. The reason seems to be that my peripheral vision picks up movement against the wider background that direct inspection can miss. An optometrist I am not, but I do find myself staring at data a great deal, seeking relationships, patterns, or gaps. I idly wondered whether, if I filled my visual field with data, I might be able to exploit my peripheral vision in that quest. I have a wide monito...

ChatGPTesters

The Association for Software Testing is crowd-sourcing a book,  Navigating the World as a Context-Driven Tester , which aims to provide  responses to common questions and statements about testing from a  context-driven perspective . It's being edited by  Lee Hawkins  who is  posing questions on  Twitter ,   LinkedIn , Mastodon , Slack , and the AST  mailing list  and then collating the replies, focusing on practice over theory. I've decided to  contribute  by answering briefly, and without a lot of editing or crafting, by imagining that I'm speaking to someone in software development who's acting in good faith, cares about their work and mine, but doesn't have much visibility of what testing can be. Perhaps you'd like to join me?   --00--  "Why don’t we replace the testers with AI?" We have a good relationship so I feel safe telling you that my instinctive reaction, as a member of the T...

Vanilla Flavour Testing

I have been pairing with a new developer colleague recently. In our last session he asked me "is this normal testing?" saying that he'd never seen anything like it anywhere else that he'd worked. We finished the task we were on and then chatted about his question for a few minutes. This is a short summary of what I said. I would describe myself as context-driven . I don't take the same approach to testing every time, except in a meta way. I try to understand the important questions, who they are important to, and what the constraints on the work are. With that knowledge I look for productive, pragmatic, ways to explore whatever we're looking at to uncover valuable information or find a way to move on. I write test notes as I work in a format that I have found to be useful to me, colleagues, and stakeholders. For me, the notes should clearly state the mission and give a tl;dr summary of the findings and I like them to be public while I'm working not just w...

Postman Curlections

My team has been building a new service over the last few months. Until recently all the data it needs has been ingested at startup and our focus has been on the logic that processes the data, architecture, and infrastructure. This week we introduced a couple of new endpoints that enable the creation (through an HTTP POST) and update (PUT) of the fundamental data type (we call it a definition ) that the service operates on. I picked up the task of smoke testing the first implementations. I started out by asking the system under test to show me what it can do by using Postman to submit requests and inspecting the results. It was the kinds of things you'd imagine, including: submit some definitions (of various structure, size, intent, name, identifiers, etc) resubmit the same definitions (identical, sharing keys, with variations, etc) retrieve the submitted definitions (using whatever endpoints exist to show some view of them) compare definitions I submitted fro...

Build Quality

  The Association for Software Testing is crowd-sourcing a book,  Navigating the World as a Context-Driven Tester , which aims to provide  responses to common questions and statements about testing from a  context-driven perspective . It's being edited by  Lee Hawkins  who is  posing questions on  Twitter ,   LinkedIn , Mastodon , Slack , and the AST  mailing list  and then collating the replies, focusing on practice over theory. I've decided to  contribute  by answering briefly, and without a lot of editing or crafting, by imagining that I'm speaking to someone in software development who's acting in good faith, cares about their work and mine, but doesn't have much visibility of what testing can be. Perhaps you'd like to join me?   --00-- "When the build is green, the product is of sufficient quality to release" An interesting take, and one I wouldn't agree with in gener...

Express, Listen, and Field

Last weekend I participated in the LLandegfan Exploratory Workshop on Testing (LLEWT) 2024, a peer conference in a small parish hall on Anglesey, north Wales. The topic was communication and I shared my sketchnotes and a mind map from the day a few days ago. This post summarises my experience report.  Express, Listen, and Field Just about the most hands-on, practical, and valuable training I have ever done was on assertiveness with a local Cambridge coach, Laura Dain . In it she introduced Express, Listen, and Field (ELF), distilled from her experience across many years in the women’s movement, business, and academia.  ELF: say your key message clearly and calmly, actively listen to the response, and then focus only on what is relevant to your needs. I blogged a little about it back in 2017 and I've been using it ever since. Assertiveness In a previous role, I was the manager of a test team and organised training for the whole ...