O'Reilly logo

The IBM Style Guide: Conventions for Writers and Editors by Eric Radzinski, Leslie McDonald, Amy Laird, Jana Jenkins, Peter Hayward, Francis DeRespinis

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Chapter 3. Formatting and organization

Follow these guidelines to format and organize information so that it stands out and is easy to locate.

Headings

Use headings to organize information into a logical structure.

Format of headings

Format headings consistently and logically:

• In books and topic-based information, do not number headings other than chapter titles. Numbering headings and subheadings is acceptable in articles, white papers, quick start guides, and other shorter publications.

• Make sure that the typographic style is consistent for each heading of a particular level in your publication. Use the formatting features of your authoring tool to apply a consistent style.

• Avoid placing one heading directly after another without text ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required