Developing Quality Technical Information: A Handbook for Writers and Editors

Hargis, Gretchen; IBM Books

ISBN 10: 0137903200 ISBN 13: 9780137903207

Publisher: Prentice Hall, 1997

Synopsis

This is a method tested reference guide (developed over 10 yrs. at IBM's technical Info Labs) for technical writers and editors in communication and engineering companies. It features extensive examples, illustrations and before and after excerpts from real technical information to help the reader/user become a very competent writer or editor.

About this title

From the Back Cover

79032-9

The #1 guide to excellence in documentation!

Create documentation that even the most demanding users will appreciate!

All you need to deliver top-quality technical information -- in print, online, and on the Web!

• Extensive, practical before-and-after examples
• Sample windows, illustrations, excerpts, tables, checklists, and more
• Smarter ways to use visuals
• Based on the experience of professionals at an IBM software laboratory for over 10 years
• For every writer, editor, designer, and reviewer of technical information

Straight from IBM's own software documentation experts, this is the first practical guide to developing excellent technical information.

From start to finish, you'll learn how to create documentation that's easy for users to find, understand, and use.

Discover how to make sure your documentation focuses on the tasks and topics users care about. Learn style points and organization techniques that help users access information quickly -- and use it effectively. See how to use graphics and other visual elements to deliver useful information in inviting ways. Walk through the review process, and learn ways to add the most value using minimal words.

Whether you're a writer, editor, designer, or reviewer, if you want to create great documentation, this book shows you how!

“Developing Quality Technical Information is unequaled in the field today as a comprehensive textbook on how to do technical communications right. Every technical communicator around the world can surely apply this model to their information; those that do so systematically will surely see an improvement in the quality of their deliverables." Lori Fisher, Manager, Data Management User Technology, IBM; Instructor, University of California Extension Santa Cruz

"The writers have done an excellent job of keeping the editorial advice simple and clear enough for technical writers who didn't major in English or journalism. The book should make a very good technical writing and editing text in universities, but I think it will be even more valuable for experienced writers, editors, and managers concerned with raising the quality of their publishing programs." Carolyn Mulford, Freelance Writer and Editor Instructor, Georgetown University Continuing Education

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.

Edition details

• Publisher: Prentice Hall
• Publication date: 1997
• ISBN 10: 0137903200
• ISBN 13: 9780137903207
• Binding: Textbook Binding
• Language: English
• Edition number: 1
• Number of pages: 336