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
Infrastructure as Code, 2nd Edition
Six years ago, Infrastructure as Code was a new concept. Today, as even banks and other …
book
Spring Start Here
Spring Start Here teaches Java developers how to build applications using Spring framework. Informative graphics, relevant …
audiobook
Fall in Love with the Problem, Not the Solution
Unicorns-companies that reach a valuation of more than $1 billion-are rare. Uri Levine has built two. …
video
Full Stack Web Development Mastery Course - Novice to Expert
Full stack development refers to the development of both frontend (client-side) and backend (server-side) portions of …