Heading names and page titles

Courses and tutorial headings can differ from product documentation headings. Here are examples of introductory and conceptual headings that can are mistakenly used interchangeably:

Type of Title Meaning
Introduction to Adobe Target Introduces Adobe Target to new customers.
Introduces a new product named Adobe Target to customers.
Note: Often used in courses, but use sparingly in help. (Customers looking for help aren’t typically looking for an introduction to a product.)
Overview of Adobe Target Describes features of Adobe Target and what you can do with them.
Fundamentals of Adobe Target Similar to Overview of Adobe Target but usually more detailed and hands-on.
Getting started with Adobe Target Walks through the initial steps to perform when using Adobe Target. Customers will expect to be using the interface in a getting started article or lesson.

Style guidelines for headings

Guidelines Examples
Avoid double headings Avoid following a heading with another heading. At least one line of text must separate headings.
Use sentence-style capitalization for all headings Per Adobe’s standards, headings should use sentence style capitalization.
Example: Create a workspace
However, for guide titles, use headline style capitalization.
Example: Experience Cloud Documentation
Keep headings short A heading isn’t a sentence. Keep page titles short with important keywords at the beginning.
Example: Upload customer attributes
Use nouns or short noun phrases for conceptual, overview headings (and TOC entries) Audiences
Experience Cloud integrations
Use keywords Keywords are feature names and accurate task names (verbs).
Example: Upload customer attribute data to Experience Cloud
This example contains all the keywords to accurately name a task and improve search results.
Create meaningful headings in an active, natural language.
Use infinitive verbs for task headings Run a Fallout report
Use the singular form for task headings Save a workspace
Use sentence style capitalization for all headings Create an audience
Use parallel structures A table of contents (TOC) or list should begin with the same verb or noun phrase. (see Structure and syntax for headings)

Heading structure

Information design typically follows an overview > concept > task hierarchy. In highly structured authoring environments (like DITA), these content types are defined as separate pages or files, which are merged at help-build time. In Markdown authoring, however, you can put these content types natively on the page.

See Content types for a discussion about organizing content on the page.

On this page