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:
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