Developing Quality Technical Information: A Handbook for Writers and Editors (IBM Press Series--Information Management) Hardcover – 6 Apr 2004
- Choose from over 13,000 locations across the UK
- Prime members get unlimited deliveries at no additional cost
- Find your preferred location and add it to your address book
- Dispatch to this address when you check out
There is a newer edition of this item:
Customers Who Bought This Item Also Bought
Enter your mobile number below and we'll send you a link to download the free Kindle App. Then you can start reading Kindle books on your smartphone, tablet, or computer - no Kindle device required.
Getting the download link through email is temporarily not available. Please check back later.
To get the free app, enter your mobile phone number.
From the Back Cover
"The examples are excellent--right on target and easy to understand and adapt. Even those who don't adopt the entire procedure can profit from the parts, but the greatest value will flow to those who adopt the whole." --Carolyn Mulford, senior writer and editor of Writing That Works
"This is also a book that students can keep for their professional libraries because it will increase in its value to them after they leave class and face real life experiences on the job. It is plain enough for them to understand while they are learning, and at the same time comprehensive enough to support them as professionals." --Elizabeth Boling, Instructional Systems Technology, Indiana University
"It practices what it preaches. Its guidelines are understandable and appropriate; its examples clear. It contains exactly what writers and editors need to know. It is the book that I would have written." --Cynthia E. Spellman, UnisysThe #1 guide to excellence in documentation--now completely updated! A systematic, proven approach to creating great documentation
- Thoroughly revised and updated
- More practical examples
- More coverage of topic-based information, search, and internationalization
Direct from IBM's own documentation experts, this is the definitive guide to developing outstanding technical documentation--for the Web and for print. Using extensive before-and-after examples, illustrations, and checklists, the authors show exactly how to create documentation that's easy to find, understand, and use. This edition includes extensive new coverage of topic-based information, simplifying search and retrievability, internationalization, visual effectiveness, and much more.
- Focusing on the tasks and topics users care about most
- Saying more with fewer words
- Using organization and other means to deliver faster access to information
- Presenting information in more visually inviting ways
- Improving the effectiveness of your review process
- Learning from example: sample text, screen captures, illustrations, tables, and much more
Whether you're a writer, editor, designer, or reviewer, if you want to create great documentation, this book shows you how!
About the Author
The authors have served on the Editing Council at IBM Silicon Valley Laboratory in San Jose, California, an organization dedicated to excellence in technical information. Gretchen Hargis is a technical manager at IBM for a group that provides user assistance and user-centered design for application development tools. She was a technical editor and writer and a pioneer of IBM Darwin Information Typing Architecture (DITA). Michelle Carey is a technical writer at IBM and a technical writing instructor at University of California Santa Cruz Extension. She is an expert on topic-based information systems and on writing for international audiences. Ann Kilty Hernandez is a technical editor at IBM and has been a technical writer, manager, and marketing specialist. She was a co-author of An Introduction to DB2 for OS/390 and contributed to its next edition, The Official Guide to DB2 UDB for z/OS. Polly Hughes, now retired from IBM, worked as a visual designer for technical information and software interfaces and as a technical writer. Deirdre Longo is a technical editor and writer at IBM who edits product interfaces and writes customer information, mostly for content management products. Shannon Rouiller is a technical editor at IBM who has written and edited topicbased information systems, books, contextual help, wizards, and interfaces for products that are marketed worldwide. She co-authored Designing Effective Wizards. Elizabeth Wilde is a technical editor at IBM and a leader in developing quality metrics and quality assurance processes for technical documentation. She also educates writers and editors throughout IBM on developing user-centered information.
What Other Items Do Customers Buy After Viewing This Item?
Top Customer Reviews
Readers wanting ideas and examples for writing software manuals might also consider "Read Me First! A Style Guide for the Computer Industry" written by Sun Technical Publications.
I own both books, and have found them invaluable.
The book covers ease of use, ease of understanding, and ease of retrieval of information. It then discusses how to apply the quality characteristics that have been covered in the preceding chapters and how to ensure that those characteristics have been met. Throughout these chapters, extensive "before and after" examples are provided, helping to clarify the points made.
Appendixes provide a quality checklist, a definition of who checks which characteristic, and a correlation of quality characteristics and information elements.
I have bought many copies of this book, which I have given to systems architects, project planners, programmers, and testers who were required, as part of their job, to write technical information. In doing this, I was being entirely selfish. In a grossly understaffed editorial department, I needed to educate those "authors" in correct and appropriate grammar and punctuation, to help them write more clearly and, thus, reduce the workload on my tiny editorial group. Of all the options available, this excellent book was most likely to succeed.
Look for similar items by category
- Books > Business, Finance & Law > Management > Management Skills > Communication & Presentation
- Books > Computing & Internet > Software & Graphics > Desktop Publishing
- Books > Reference > Language > Handwriting
- Books > Reference > Writing > Editing
- Books > Reference > Writing > Writing Skills
- Books > Science & Nature > Engineering & Technology > Engineering Skills & Design > Technical Writing
- Books > Science & Nature > Mathematics > Education > Higher Education
- Books > Science & Nature > Mathematics > Reference