News: 1750404546

  ARM Give a man a fire and he's warm for a day, but set fire to him and he's warm for the rest of his life (Terry Pratchett, Jingo)

Techie traveled 4 hours to fix software that worked perfectly until a new hire used it

(2025/06/20)


On Call The trek through the working week can be long and tiring, which is why The Register always offers a little Friday morning refresher in the form of On Call – the reader-contributed column in which you share tech support stories.

This week, meet a reader we'll Regomize as "Ray" who told us about his experience developing a sales validation tool for electronic point of sale equipment.

"We used rapid application development to make sure it met the needs of the order processing team," Ray proudly told On Call. That process resulted in a tool he described as a "quick and cheap integration" that offered "a front-end to make keying in the order quick and easy." The alternative involved mainframes, so Ray and his team were happy to have built something rather simpler.

[1]

After completing documentation and handing over the app, Ray received zero feedback. That was concerning, but it turned out his team had nailed the job and the order processing team used the program all the time.

[2]

[3]

Months later, the phone rang. The program had stopped working.

Ray tried to triage over the phone, but told On Call that doing so yielded "no coherent feedback at all."

[4]

A site visit was the only alternative, meaning Ray faced a four-hour drive to investigate.

Of course, it rained all the way.

[5]User demanded a 'wireless' computer and was outraged when its battery died

[6]Techie traced cables from basement to maternity ward and onto a roof, before a car crash revealed the problem

[7]Techie fixed a 'brown monitor' by closing a door for a doctor

[8]User unboxed a PC so badly it 'broke' and only a nail file could fix it

On arrival, Ray was shown a "problem" that he immediately recognized as a feature the order processing team had explicitly requested.

After a little digging, Ray learned the truth.

The application was so simple to use that the order processing team assumed any new user would understand it immediately.

[9]

"But it had been given to a temp who wasn't involved in the original development," Ray told On Call. And the order processing team hadn't bothered to train the temp.

"Have you read the manual?" Ray asked, remembering the substantial effort involved in its creation.

"I just got a blank look," he told On Call. "On presenting her with a copy, a smile of enlightenment crossed her face."

Just 30 minutes after arriving, Ray was back on the road.

"I found no fault in the software but a major one in the people," he told On Call.

What have you had to fix because users wouldn't read the manual?

Here's our manual for telling us such stories. [10]Click here to open a blank email that's pre-populated with On Call's address, write your story, then press Send. Doing so may see your story appear here on a future Friday. ®

Get our [11]Tech Resources



[1] https://pubads.g.doubleclick.net/gampad/jump?co=1&iu=/6978/reg_offbeat/columnists&sz=300x50%7C300x100%7C300x250%7C300x251%7C300x252%7C300x600%7C300x601&tile=2&c=2aFUxNxBCeO-dBT7NU2hQ4AAAAQo&t=ct%3Dns%26unitnum%3D2%26raptor%3Dcondor%26pos%3Dtop%26test%3D0

[2] https://pubads.g.doubleclick.net/gampad/jump?co=1&iu=/6978/reg_offbeat/columnists&sz=300x50%7C300x100%7C300x250%7C300x251%7C300x252%7C300x600%7C300x601&tile=4&c=44aFUxNxBCeO-dBT7NU2hQ4AAAAQo&t=ct%3Dns%26unitnum%3D4%26raptor%3Dfalcon%26pos%3Dmid%26test%3D0

[3] https://pubads.g.doubleclick.net/gampad/jump?co=1&iu=/6978/reg_offbeat/columnists&sz=300x50%7C300x100%7C300x250%7C300x251%7C300x252%7C300x600%7C300x601&tile=3&c=33aFUxNxBCeO-dBT7NU2hQ4AAAAQo&t=ct%3Dns%26unitnum%3D3%26raptor%3Deagle%26pos%3Dmid%26test%3D0

[4] https://pubads.g.doubleclick.net/gampad/jump?co=1&iu=/6978/reg_offbeat/columnists&sz=300x50%7C300x100%7C300x250%7C300x251%7C300x252%7C300x600%7C300x601&tile=4&c=44aFUxNxBCeO-dBT7NU2hQ4AAAAQo&t=ct%3Dns%26unitnum%3D4%26raptor%3Dfalcon%26pos%3Dmid%26test%3D0

[5] https://www.theregister.com/2025/06/13/on_call/

[6] https://www.theregister.com/2025/06/06/on_call/

[7] https://www.theregister.com/2025/05/30/on_call/

[8] https://www.theregister.com/2025/05/23/on_call/

[9] https://pubads.g.doubleclick.net/gampad/jump?co=1&iu=/6978/reg_offbeat/columnists&sz=300x50%7C300x100%7C300x250%7C300x251%7C300x252%7C300x600%7C300x601&tile=3&c=33aFUxNxBCeO-dBT7NU2hQ4AAAAQo&t=ct%3Dns%26unitnum%3D3%26raptor%3Deagle%26pos%3Dmid%26test%3D0

[10] mailto:oncall@theregister.com

[11] https://whitepapers.theregister.com/



I touch it and it breaks!

ColinPa

As a tester I got a reputation for breaking things. I was always impatient, and would multi task ( use two windows) when one of the tools was slow.

We had to use a new tool for entering what you had achieved over the year. Because there was no save button, I assumed, like Gmail, it had autosave. I submitted it to my boss who said it was empty.

I did it again...and again it was empty.

I contacted the help desk, who asked "did you press the save button?" me:"I don't have a save button"... "Did you press the help button ?" "I dont have a help button"

If you run the application full screen, all of the buttons appeared, if you run it in a narrow window, all of the buttons disappear.

With all of their testing they naturally used full screen, so naturally didn't find any problems.

I had a call with the development team, and mentioned the 50 "defects" I found. Such as

me:"there is an icon with 3 small circles - what does it mean? There is no hover text, and it is not mentioned in the help"

them: "It is meant to be obvious...",

me "well it has failed - so what does it mean".

them: "err we don't know"

me:"The fonts you use are not dyslexia friendly, and the fonts are too small and not changeable"

them "Err"

me: "Grey text on a grey background is not easy to read in a well lit area " ....

Re: I touch it and it breaks!

Caver_Dave

A laptop with a small screen was always in my arsenal. I used to run on a large screen and the small screen concurrently and see that they had the same functionality. Surprisingly not in many cases, as demonstrated by the OP above!

This is a pattern that Micros**t could do with adopting!

Re: I touch it and it breaks!

Anonymous Coward

They tried making things always full-screen with Windows 8

I can foresee a new hardware requirement: minimum 42" 4k screen.

Re: I touch it and it breaks!

alain williams

me: "Grey text on a grey background is not easy to read in a well lit area " ....

All testing should include it being used by someone ancient, like me, who no longer has 20 year old eyes.

Re: I touch it and it breaks!

Greybearded old scrote

I look forward to those arseholes finding that they have to live in the world they have created.

Re: I touch it and it breaks!

AceRimmer1980

I know a guy who works as a tester, and is quite proud that he can break things, and find flaws where others cannot. Isn't that, erm, part of your job?

Speaking of breaking things, much of my working life has gone as follows:

Me: "Hey boss, come and look at this cool thing I've wrote, which I've tested and works perfectly"

Boss: (looks at software)

Software: (boom)

Re: I touch it and it breaks!

UCAP

The Curse of the Demo. Strikes every time!

Re: I touch it and it breaks!

Doctor Syntax

Or the break-everying force field some people seem to carry.

I remember a student whose usual greeting was "wanna hear a tale of woe?"

Re: I touch it and it breaks!

HorseflySteve

It's known as Cohen's Law, a subset of Murphy's Law

"If it can go wrong, it will at the demonstration", as was so publicly illustrated at the Windows95 launch.

Korev

He didn't need an X-Ray to diagnose this one

b0llchit

Although he immediately saw through it.

Michael H.F. Wilkinson

Make a system fool-proof, and life will produce a better fool

manuals

Anonymous Coward

I happen to like to write documentation. Beware: this is a very frustrating or very rewarding activity. You've been warned :)

So many times, even today, I have the following situations:

- be in a meeting with someone I've sent the doc to (that never fed back on it) that asks a question, showing blatantly he's read 0 page of the doc, to which I reply "yes, it is in the documentation", to which he embarrassingly replies "ah yes, yes ..." in a tone that leaves 0 doubt to anyone in the audience

- be in a meeting with someone I've sent the doc to (that never fed back on it) that asks a question, showing blatantly he's read 0 page of the doc, to which someone else, who was not in the dist. list and didn't have an immediate need/role in reading this, in the meeting, interjects "it is in the documentation !). This is priceless, rare but priceless.

Re: manuals

Greybearded old scrote

And you've clearly learned 0 about reality. What was that popular definition of insanity again?

doing so yielded "no coherent feedback at all."

Anonymous Coward

Premonition of our new AI golden age?

Having read many "fine" manuals, I can understand why many users give up on principle before starting. The idea that introductory documentation should concentrate on leading the new user through the basic and common operations, seems to rarely occur to the documentor.

K&R The C Programming Language 1/e this point was brought home to me in the late 1970s where the now legendary program containing printf( "hello, world\n") appeared on the first page of chapter 1, without a long digression on the intricacies of the printf family or variadic functions in general.

The UNIX seventh edition documentation was very similar, so I imagined was part of the cultural DNA of Bell Labs.

Re: doing so yielded "no coherent feedback at all."

GlenP

Sadly my copy of K&R was decluttered recently, it was invaluable many years ago when I wrote a simple quotation system from scratch for the Unix box we then had - I knew programming but not C.

"I'd rather not work with people who aren't careful. It's darwinism
in software development. It's a cold, callous argument that says
that there are two kinds of people, and I'd rather not work with the
second kind. Live with it."

- Linus Torvalds