Feeds

MANUAL STIMULATION: Whack me with some proper documentation

Why doesn’t software come with a book any more?

Top 5 reasons to deploy VMware with Tegile

Something for the Weekend, Sir? Another day, another app, another incomprehensible user interface. If this was a proper piece of software running on a proper computer rather than a £500 phone, phablet or some similar pharcical phucking phanboi phondleslab, it might be possible to call up a Help menu or leaf through a manual.

Instead, I’m left staring at a bizarre arrangement of on-screen buttons labelled with arcane symbols that give no indication whatsoever of their function. Not only is it impossible to determine how to use this product, it isn’t altogether clear what the product is supposed to do.

Perhaps it’s a sign of age. For example, I have reached a stage in my life at which I can no longer concoct new passwords. I am passworded out. When a pleasant fellow at a call centre asks me to think up a password, I confess to him that this is not going to be possible. When I am asked to give letters three and six of my existing password, I tell him I can’t remember either of them.

Hmm, this doesn’t bode well for an IT journalist. Really, I ought to find another job in a less stressful industry. I was thinking perhaps I could relocate to the Middle East and take up a less volatile trade, such as become a purveyor of flammable and childishly drawn reproductions of US flags and American presidential effigies.

Something, however, tells me that I might not be alone with my personal issues. Also, the problems are easily fixed. For example, a little bit of encrypted, multi-platform, cloud-based KeePass action is starting to work well for me now that I’ve finally managed to memorise the master key.

As an IT trainer, too, I admit to having a certain insight into how most people learn to use software interfaces. From the learner’s point of view, it helps if you have an idea of what you are going to achieve in the next few minutes and how this fits into the bigger picture, and then you are led through the process which – and this is important – you carry out yourself. Then you repeat it on your own.

Back in t’old days, software came with manuals. No, no, I’m not talking about the hardbacked, ring-bound tomes that came with the likes of dBase III, which was a rare luxury that no software company or its customers could reasonably afford these days. Nor am I so stuffy that I insist on paperback doorstops included in the box. Nor indeed do I expect my software to come in a box at all.

Thorn EMI Liberator Manual

Ah, those were the days

Rather – and call me foolishy demanding if you will – I just want something that tells me how to use the software. But these days, if I hit F1, the chances are that nothing will happen at all.

My pet hate is calling up the ‘Time Waste Option’ command that some idiot developer chose to label ‘Help’ but which launches a web browser and directs it to an ‘Irrelevant Off-Topic Periphery’ page that some idiot webmaster has titled ‘Frequently Asked Questions’.

Apparently, “How do I use this software?” is not a question that is frequently asked.

I use a cloud-based business accounting program – no need for me to say which one, they’re all owned by the same company now – that is infuriating in this respect. Its partially out-of-date ‘knowledgebase’ is full of notionally vague articles that describe in general terms what functions exist in the software but without explaining how to use them.

So every time you want to do anything, you have to email the support team to ask how to do it and wait for them to reply with the necessary instructions. When I observed to them that this seemed like a waste of resources compared to just writing a proper online software manual that users can read, they stressed that the knowledgebase contained everything. But it doesn’t, I replied: that’s why I’m emailing you.

On one occasion, I insisted that they sent me step-by-step instructions – you know, like you used to get with, oh I dunno, software manuals – and these turned up in an email that fizzled out at the end with a suggestion that I ask my accountant for his suggestions.

So I called my accountant. His suggestion was that I ditch this half-arsed software, buy a copy of Sage and sign myself onto a training course or buy a For Dummies... book.

clippy

The small developers are not alone in failing customers in this way. I’m a heavyweight Adobe user – that is, I use Adobe software and I weigh quite a lot – and its Help system is just about the worst in existence. Calling up Help instigates a baffling process by which a program you’ve never seen before tells you that software manuals you didn’t know were on your computer are out of date for products you didn’t know you had, then laboriously tries to update them all for the next 72 hours while you sit around trying to remember what it was you were doing before all hell broke loose on-screen.

If you are reckless enough to search for help on the Adobe website, you end up trawling through a dustbin of seemingly random results referring to old versions of the program and, worse, the wrong program. Take a tip from long-suffering Adobe customers: forget about the Help system and instead go straight to the user forums and ask other customers. They’ll be happy to tell you how to use Adobe’s software, even if Adobe won’t.

My other pet hate is the shit-munching video tutorial. I fail to see how spending a quarter of an hour watching a blurry rectangle of illegibility while an American spits and wheezes into a microphone that’s so muffled it might as well have been be shoved up his arse is superior to reading a step-by-step workthrough that I could complete myself in less than five minutes.

And by doing it myself in real time rather than watch someone else do it first, I will have completed both the task and the tutorial simultaneously and learnt the process more thoroughly as a result.

All my software manuals sit happily on my tablet, allowing me to work on my computer with the manual on my desk or in my lap – like a book, I suppose.

But so many phone and tablet apps have no proper instructions at all. This is, as Shakespeare said of Richard III, a right old bugger. The self-obsessed developers who churn out this junk are clearly of the opinion that their software is so intuitive that manuals are unnecessary.

No it isn’t and yes they are.

Their websites show glossy promo vids of geeky bearded models using their apps to cure diseases, solve centuries of climate change and put an end to conflict between nations with little more than a swipe, pinch and zoom. Two minutes later, I’ve download the app for myself and I’m left staring at a black screen surrounded by designer hieroglyphs. I swipe, I pinch and, oh heavens to Betsy, I even zoom – to no avail.

None of the hieroglyphs looks like a Help label so I check the developer’s website. No instructions. No manual. Now that I’m thinking about it, there isn’t even anything that tells me what the app actually does in any practical sense, just that it’s supposed to revolutionise something that wasn’t possible before I downloaded it. As Shakespeare noted – after penning The Tempest, I believe – what the flying fuck am I supposed to do next?*

Instructions, please. ®

*It is said that The Bard hired a freelance writer to dash off Henry VIII and The Two Noble Kinsmen while he himself relocated to Spain, spending his twilight years selling flammable Union Jacks and raffia effigies of James I...

Alistair DabbsAlistair Dabbs is a freelance technology tart, juggling IT journalism, editorial training and digital publishing. He appreciates that selling the idea to software publishers of getting proper manuals written is just a cynical ploy to drum up more work for himself.

Remote control for virtualized desktops

More from The Register

next story
PEAK APPLE: iOS 8 is least popular Cupertino mobile OS in all of HUMAN HISTORY
'Nerd release' finally staggers past 50 per cent adoption
Tim Cook: The classic iPod HAD TO DIE, and this is WHY
Apple, er, couldn’t get parts for HDD models
Apple spent just ONE DOLLAR beefing up the latest iPad Air 2
New iPads look a lot like the old one. There's a reason for that
Google Glassholes are UNDATEABLE – HP exec
You need an emotional connection, says touchy-feely MD... We can do that
Microsoft fitness bands slapped on wrists: All YOUR HEALTH DATA are BELONG TO US
Wearable will deliver 'actionable insights for healthier living'
Lawyers mobilise angry mob against Apple over alleged 2011 Macbook Pro crapness
We suffered 'random bouts of graphical distortion' - fanbois
Caterham Seven 160 review: The Raspberry Pi of motoring
Back to driving's basics with a joyously legal high
Back to the ... drawing board: 'Hoverboard' will disappoint Marty McFly wannabes
Buzzing board (and some future apps) leave a lot to be desired
prev story

Whitepapers

Why cloud backup?
Combining the latest advancements in disk-based backup with secure, integrated, cloud technologies offer organizations fast and assured recovery of their critical enterprise data.
Getting started with customer-focused identity management
Learn why identity is a fundamental requirement to digital growth, and how without it there is no way to identify and engage customers in a meaningful way.
High Performance for All
While HPC is not new, it has traditionally been seen as a specialist area – is it now geared up to meet more mainstream requirements?
New hybrid storage solutions
Tackling data challenges through emerging hybrid storage solutions that enable optimum database performance whilst managing costs and increasingly large data stores.
Mitigating web security risk with SSL certificates
Web-based systems are essential tools for running business processes and delivering services to customers.