ACCU Home page ACCU Conference Page
Search Contact us ACCU at Flickr ACCU at GitHib ACCU at Facebook ACCU at Linked-in ACCU at Twitter Skip Navigation

Search in Book Reviews

The ACCU passes on review copies of computer books to its members for them to review. The result is a large, high quality collection of book reviews by programmers, for programmers. Currently there are 1949 reviews in the database and more every month.
Search is a simple string search in either book title or book author. The full text search is a search of the text of the review.
    View all alphabetically
Developing Quality Technical Information: A Handbook for Writers and Editors, 3rd Ed.
Michelle Carey, Moira McFadden Lanyi, Deirdre Longo, Eric Radzin
IBM Press (2014)
Paul Floyd
Appeared in:

Reviewed: May 2015

Well, I’m neither a writer (the odd thing for the ACCU journals apart), nor an editor. Nevertheless, I would recommend this book for anyone who writes software that has any sort of user interface. I was expecting a fairly dry text, reflecting the dry text that is most technical documentation. That isn’t what I found. I had jumped to the conclusion that ‘Technical Information’ equates to ‘User Guide and Technical Reference’. This book does cover ‘Technical Information’ in the widest sense. Early in the book, the authors state that the large majority of users don’t read the manuals, and either ask colleagues or search for information on Google. So in order to convey the information required to use software a significant part of this book covers GUI design and usability (with the emphasis on style, consistency, progressive disclosure, tooltips and contextual help). Another chapter that is ‘modern’ and far from dusty printed manuals is one covering search and information retrieval.

The tone is not prescriptive. There are a lot of guidelines, and many examples, in particular examples of poor interfaces and documentation followed by one or two improved versions, with the accompanying text pointing out the problems in the original and why the changes improve things. There is a fairly strong emphasis on conveying information in a way that is task oriented and minimalist. The final chapter on testing and reviewing was a nice rounded ending to the book.

There are a couple of chapters on clarity and style that fell into the classic tech writing stereotype that I half expected, but even these were concise and quite pleasant to read. Altogether a thoroughly professional piece of work.