I’ve just launched my latest user documentation survey – click here to take part.
Please do take part (it will only take you five minutes), and please pass this invitation on to anyone who might be interested. I’d like to get feedback from people who use the user documentation that comes with gadgets and software, as well as from people who create the documentation.
While last Friday’s BBC Radio 4 programme presented by Mark Miodownik on How to write an Instruction Manual presented an upbeat and quirky view of the history and importance of instruction manuals, the BBC’s technology correspondent, Rory Cellan-Jones, has presented a very different view on his BBC blog. (That’s a Welsh double-L in Rory’s surname, so it’s pronounced something like ‘kethlin-jones’.)
Miodownik talked about the “amazingness” of technology, and his disappointment that the manuals for modern technology were not themselves as amazing as the technology they described. He thought that manuals that generally began with five pages of Health and Safety warnings, and had basic instructions in 17 languages crammed into one book, were “soulless”. His ideal manuals are like the “owner’s workshop manuals” for motor cars produced by Haynes publishers, and the obvious high point of the show for Miodownik was when he got to interview John Haynes himself. Read more
BBC Radio 4 is presenting a half-hour documentary on instruction manuals this Friday 21st August at 11:00am. One of the interviewees is Simon Butler, President of the ISTC.
A few weeks ago, the researcher working on this programme posted a message to a discussion list for teachers of technical writing, which was quickly forwarded to several other lists, and apparently generated a deluge of emails from technical writers around the world. Read more