REVIEW - Read Me First! - A Style Guide for the Computer Industry


Read Me First!

A Style Guide for the Computer Industry


Sun Technical Publications



Prentice Hall Professional (2003)




Francis Glassborow


October 2003



As titles go this must be one of the least descriptive. The subtitle is a bit more helpful 'A Style Guide for the Computer Industry'. But that could easily lead you to think that it might be something about software/source code style. You would be completely mistaken.

This book is about writing, ordinary technical writing. In this context the injunction of the title is right on the mark. If you have never written before (or even if you have, but are yet to get glowing tributes about the clarity of your writing) this is a book that would be worth investing some time with before you write your next article, manual or book. Mind you, I am not happy with all the advice and examples in the book. For example the authors sometimes get so focused on one aspect of a piece of advice that they miss some other aspect. For example on page 10 concerning pronouns:

  • l Do not use first person pronouns


We recommend that you install the custom components only on large systems


Install the custom components only on large systems.

Now I do not know about you, but the correct version would seem to be: Only install the custom components on
large systems.

The book covers all forms of writing including writing for the Web.

While I am happy to recommend this
book as being better than nothing I think that the book (now in its second edition) would benefit from having a genuinely fluent writer of English involved in its next edition.
Much of the language is unnecessarily
stilted and thereby gets between the reader
and the content. In other words the content
is fine but the book fails to teach by

Book cover image courtesy of Open Library.

Your Privacy

By clicking "Accept All Cookies" you agree ACCU can store cookies on your device and disclose information in accordance with our Privacy Policy and Cookie Policy.

By clicking "Share IP Address" you agree ACCU can forward your IP address to third-party sites to enhance the information presented on the site, and that these sites may store cookies on your device.