or
Sign in to turn on 1-Click ordering.
More Buying Choices
Have one to sell? Sell yours here
Sorry, this item is not available in
Image not available for
Colour:
Image not available

 
Tell the Publisher!
I’d like to read this book on Kindle

Don't have a Kindle? Get your Kindle here, or download a FREE Kindle Reading App.

Read Me First!: A Style Guide for the Computer Industry [Paperback]

Sun Technical Publications

RRP: £25.99
Price: £20.81 & this item Delivered FREE in the UK with Super Saver Delivery. See details and conditions
You Save: £5.18 (20%)
o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o
Only 1 left in stock (more on the way).
Dispatched from and sold by Amazon. Gift-wrap available.
Want delivery by Friday, 24 May? Choose Express delivery at checkout. See Details
Amazon.co.uk Trade-In Store
Did you know you can trade in your old books for an Amazon.co.uk Gift Card to spend on the things you want? Visit the Books Trade-In Store for more details. Learn more.
There is a newer edition of this item:
Read Me First! A Style Guide for the Computer Industry (Sun Technical Publications) Read Me First! A Style Guide for the Computer Industry (Sun Technical Publications) 5.0 out of 5 stars (1)
£30.36
In stock.

Book Description

6 May 2003 0131428993 978-0131428997 2

READ ME FIRST! is the definitive guide to creating technical documentation that is clear, consistent, and easy to understand. Sun Microsystems' award-winning tech writers and editors cover everything from grammar to clarity, illustrations to workflow. This fully revised Second Edition reflects dramatic changes in the technology industries, with extensive new coverage of Web/online documentation, internationalization, and much more.


Customers Who Viewed This Item Also Viewed


Product details


Product Description

From the Back Cover

The must-have reference for every technical writer, editor, and documentation manager—now fully updated!

Read Me First! is the definitive guide to creating technical documentation that is clear, consistent, and easy to understand. Sun Microsystems' award-winning technical writers and editors cover everything from grammar to clarity, illustrations to workflow. This fully revised second edition reflects dramatic changes in the production and delivery of technical documentation. Coverage includes:

  • Detailed grammar, punctuation, typographic, and legal guidelines
  • Extensive guidance on creating effective step-by-step procedures
  • Techniques for documenting Web applications and graphical user interfaces
  • Expert help with creating indexes and glossaries
  • Extensive recommendations for using hyperlinks
  • Checklists and forms for editing, tracking manuscripts, and verifying production status
  • Guidelines for using commonly confused words and terms
  • Practical tips for gender-neutral writing
  • Internationalization guidelines that simplify translation and improve clarity for non-native English speakers
  • Real-world help for managers: hiring writers, working with illustrators, managing schedules and workflow, coordinating with printers, and more
  • Expanded and updated recommended reading list

About the Author

The Members of Sun Technical Publications are award-winning senior editors and writers for Sun Microsystems, Inc.


Sell a Digital Version of This Book in the Kindle Store

If you are a publisher or author and hold the digital rights to a book, you can sell a digital version of it in our Kindle Store. Learn more

Customer Reviews

There are no customer reviews yet on Amazon.co.uk.
5 star
4 star
3 star
2 star
1 star
Most Helpful Customer Reviews on Amazon.com (beta)
Amazon.com: 4.6 out of 5 stars  5 reviews
9 of 9 people found the following review helpful
4.0 out of 5 stars excellent chapter about documents with links 13 Sep 2005
By W Boudville - Published on Amazon.com
Sun offers a style sheet for technical writers. These suggestions are used by Sun in its documents and are a very clean and internally consistent guide. Of course, it is not restricted to descriptions of Sun's products. A lot of care has gone into the guide.

Plus, the suggestions are not just for printed documents. Nowadays, a lot is expressed in languages with links, like HTML or PDF, and the advice pertains here too.

For illustrations, you are shown how to display interactable icons differently from non-interactable images. Subtleties, to be sure. But taking these into consideration makes for a clean document.

On the subject of documents with links, a chapter has cogent suggestions on the proper usage. Like avoiding overlinking, which is a common flaw amongst writers new to this. Also avoid linking with anchor text that is generic, like "click this". Instead, use more descriptive strings to help search engines classify the document that is pointed to. Assuming that both documents will be on the Web. But even if not, they might still be in your internal corporate web, and you might have an internal search engine spidering these. The strings will help the engine better classify both documents. This chapter may be the most vital of the book.
11 of 12 people found the following review helpful
5.0 out of 5 stars A good book gets even better in 2nd edition 1 Aug 2003
By Jean Hollis Weber - Published on Amazon.com
The first edition of this style guide was good, especially if you wanted an alternative to the Microsoft Manual of Style, but this edition is even better. It covers a wider range of issues (for example, adding much information about writing online material), and covers them very well. In fact, the book goes a bit beyond style in an appendix on developing a publications department, but the topics covered are certainly relevant and valuable, so I'm glad they were included. I don't always agree with the style choices, but that's irrelevant; I've never seen any style guide I completely agree with. Overall, I'm so impressed with this book, I'm likely to use it as a textbook for teaching technical editors. As you can tell, I'm giving it the "highly recommended" stamp.
1 of 1 people found the following review helpful
5.0 out of 5 stars Second Edition of Read Me First! 29 Sep 2011
By Sudakshina Piercy - Published on Amazon.com
Amazon Verified Purchase
I found an errata page shipped with the book stating that some of the index entries were off by 1-2 pages. Although the errata sheet gives a download link for a PDF for the corrected index, an errata sheet is not something we expect from a production document from Sun Technical Publications. Otherwise, the book is great as usual (I have the earlier edition as well). I have referred to the Organize Text by Task Map section (page 91) several times in my consulting jobs.
Were these reviews helpful?   Let us know

Customer Discussions

This product's forum
Discussion Replies Latest Post
No discussions yet

Ask questions, Share opinions, Gain insight
Start a new discussion
Topic:
First post:
Prompts for sign-in
 

Search Customer Discussions
Search all Amazon discussions
   


Listmania!

Create a Listmania! list

Look for similar items by category


Feedback


Amazon.co.uk Privacy Statement Amazon.co.uk Delivery Information Amazon.co.uk Returns & Exchanges