Documentation and when things go wrong

The latest edition of the IET’s “Engineering & Technology” magazine looks at engineering disasters and, in doing so, provides food for thought regarding the role of documentation. “Hard lessons” looks at ten disasters, such as the Challenger Space Shuttle, and the reasons why these disasters can occur.  Looking at the disasters, I could see some common themes:… Read more »

Does size matter for a technical author?

Pity the poor software project manager who needs to ship their product in ten languages, because today they are looking at roughly £1.20 ($2.20) per word* in translation costs alone. If they have a programmer delegated to develop the online Help or user guide, then every unnecessary phrase, sentence or paragraph they write can eat… Read more »

Technical authors, documents and getting lost

Via Twitter, someone responded to one of my messages with the statement, “maybe, if you need a manual, it’s a poor product”. I don’t think that’s the case, and my reply on Twitter was: “A map is to a city, what a manual is to an application.” Let me explain. Imagine you need to visit… Read more »

Will SEO be replaced by AEO (Answer Engine Optimisation)?

Internet psychologist Graham Jones has just posted an interesting Blog called “Search is on its deathbed…bye, bye SEO“. In it he states: “They (Search Engines) would like us to think that we are constantly “searching” for things online – but we aren’t. We are “locating” stuff we already know about, a lot of the time.”… Read more »

How barcodes could be the technical author’s best new friend

The latest mobile phones in the UK are using barcodes to provide one of the first practical applications of augmented reality. It’s technology that could see barcodes appear on thousands of physical items – something which would open up new opportunities for technical authors providing user assistance for equipment. The advert below shows how it’s… Read more »