Feeds

BLOG - RTFM - and why not?

It's a cold Xmas chez Norfolk...

Choosing a cloud hosting partner with confidence

My central heating chose to pack up on Xmas Eve, as it does, and this nice man from British Gas came round to fix it. [As an aside, even in Midwinter, you don't actually need central heating, especially these days when winters aren't so cold - we're not actually freezing. Which is worth remembering, since central heating is probably a major contributor to global warming - woolly jumpers are OK, which gives us a nice warm feeling; even if all the wood we're now burning is more problematic.]

We’re burning wood because, of course, he couldn't fix it on the spot - one of several control boards had failed. Which is becoming the story of our times, computer chips fail before the mechanics becomes unrepairable. No more vintage cars, say, because the vintage engine-control circuit boards (or chips) will be unavailable. Or, perhaps, a lucrative job for retired nerds recreating old circuit boards by hand? Is a vintage Mondeo going to be worth it?

But the real point of this post is that as I watched my Man from BG working through his fault-finding flowcharts on his portable PC, I suddenly took pity on him and found him the original manuals with the charts on paper. These were gratefully accepted - it's still easier to jump around a printed manual than flip between screens on a PC.

And that's something for systems developers to remember - you're designing a whole system, not just a computer system - and you’re designing for its whole lifecycle, not just for the day after delivery. So, you need to design support and repair processes as part of the system, not just as a later add-on - and sometimes this'll mean designing manual procedures to complement the automated processes (the human mind is still cost-effective for dealing with unexpected contingencies); and even, perhaps, paper manuals...

But you do need some empathy with the people using your system. Years ago, when paper instruction manuals were the norm, I met a system for managing equipment on the floor of a steel mill, which had clever iconised instructions on-screen with not much English anywhere (rather like you'll see when you open a Korean DVD recorder or whatever today). This was in Australia, paper wouldn't have survived long on the shop floor, most of the immigrant work force didn't have English as a first language and certainly couldn't agree on a consistent name for a "floggle-toggle" - although they could all recognise its picture.

So, should The Man from BG be given a set of computerised pictorial flow diagrams or a printed manual or something else entirely? There's no right answer, of course, it depends on the cultural background of BG employees and what they need the documentation for (and whether they're trying to read a PC balanced on the bog while using it). However, I'm sure that translating a printed manual directly into PDF page-images on a PC screen is usually the wrong (well, sub-optimal) answer...

So, do you have a professional technical writer on the team and a specialist in the psychology of man-machine interactions? And, if not, should you have? ®

Secure remote control for conventional and virtual desktops

More from The Register

next story
ONE MILLION people already running Windows 10
A third of them are doing it in VMs, but early feedback focuses on frippery
Sign off my IT project or I’ll PHONE your MUM
Honestly, it’s a piece of piss
Netscape Navigator - the browser that started it all - turns 20
It was 20 years ago today, Marc Andreeesen taught the band to play
Torvalds CONFESSES: 'I'm pretty good at alienating devs'
Admits to 'a metric ****load' of mistakes during work with Linux collaborators
Sway: Microsoft's new Office app doesn't have an Undo function
Content aggregation, meet the workplace ... oh
Do Moan! MONSTER 6-day EMAIL OUTAGE hits Domain Monster
Customers freaked out by frightful service
Ploppr: The #VultureTRENDING App of the Now
This organic crowd sourced viro- social fertiliser just got REAL
Return of the Jedi – Apache reclaims web server crown
.london, .hamburg and .公司 - that's .com in Chinese - storm the web server charts
NetWare sales revive in China thanks to that man Snowden
If it ain't Microsoft, it's in fashion behind the Great Firewall
prev story

Whitepapers

Forging a new future with identity relationship management
Learn about ForgeRock's next generation IRM platform and how it is designed to empower CEOS's and enterprises to engage with consumers.
Win a year’s supply of chocolate
There is no techie angle to this competition so we're not going to pretend there is, but everyone loves chocolate so who cares.
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.
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?
Saudi Petroleum chooses Tegile storage solution
A storage solution that addresses company growth and performance for business-critical applications of caseware archive and search along with other key operational systems.