Book description
The IBM Style Guide distills IBM wisdom for developing superior content: information that is consistent, clear, concise, and easy to translate. The IBM Style Guide can help any organization improve and standardize content across authors, delivery mechanisms, and geographic locations.
This expert guide contains practical guidance on topic-based writing, writing content for different media types, and writing for global audiences.
Throughout, the authors illustrate the guidance with many examples of correct and incorrect usage.
Writers and editors will find authoritative guidance on issues ranging from structuring information to writing usable procedures to presenting web addresses to handling cultural sensitivities.
The guidelines cover these topics:
Using language and grammar to write clearly and consistently
Applying punctuation marks and special characters correctly
Formatting, organizing, and structuring information so that it is easy to find and use
Using footnotes, cross-references, and links to point readers to valuable, related information
Presenting numerical information clearly
Documenting computer interfaces to make it easy for users to achieve their goals
Writing for diverse audiences, including guidelines for improving accessibility
Preparing clear and effective glossaries and indexes
The IBM Style Guide can help any organization or individual create and manage content more effectively. The guidelines are especially valuable for businesses that have not previously adopted a corporate style guide, for anyone who writes or edits for IBM as an employee or outside contractor, and for anyone who uses modern approaches to information architecture.
Table of contents
- Cover Page
- Title Page
- Copyright Page
- Contents
- Foreword
- About this publication
- Acknowledgments
- About the authors
- Chapter 1. Language and grammar
- Chapter 2. Punctuation
- Chapter 3. Formatting and organization
- Chapter 4. Structure
- Chapter 5. References
- Chapter 6. Numbers and measurements
- Chapter 7. Computer interfaces
- Chapter 8. Writing for diverse audiences
- Chapter 9. Glossaries
- Chapter 10. Indexes
- Appendixes
- Index
Product information
- Title: IBM Style Guide, The: Conventions for Writers and Editors
- Author(s):
- Release date: October 2011
- Publisher(s): IBM Press
- ISBN: 9780132118989
You might also like
book
Visual Basic® Style Guide, The
The essential companion for Visual Basic development teams and individuals. Master effective practices to create crystal-clear, …
book
Abduzeedo Inspiration Guide for Designers
Brazilian designer Fábio Sasso, who has wildly popular design blog Abduzeedo, has created the definitive guide …
book
Read Me First! A Style Guide for the Computer Industry, Third Edition
The definitive reference for technical writers, editors, and documentation managers, Read Me First! A Style Guide …
book
Clout: The Art and Science of Influential Web Content
Results. Everyone wants them, whether to sell more products, spread good ideas, or win more funding. …