Tables

  • Avoid using captions for tables.
  • Don't add an introductory phrase (also known as a stem) to a task or table that appears soon after a topic’s title. For example, a set of steps that immediately follows the title Editing a File does not need the introductory phrase “To edit a file:”. If you include only essential introductory content in a task, you’ll never need a stem.
  • Don't introduce tables using “The following table.” Instead, say “The table” or “This table.”
  • Capitalize each column heading in a table, the first word of each column entry, and proper nouns. However, don't change the capitalization of objects, methods, calls, or other language constructs, such as the Account object or create(). Use sentence case if the heading is a complete sentence or partial introduction to a sentence, as in some FAQ tables.