Headings

Use the imperative mood.

Write titles using short, descriptive words

Focus on what the user can do rather than describe a feature

Rules

• Do not use stacked headings: a subsection heading immediately following a section heading
• Avoid using one or two-word headings
• Write brief but descriptive headings
• Keep the structure of headings of the same level grammatically aligned
• Avoid formatting headings (italic, bold, underlined, etc.) and using abbreviations (because they should be introduced first)
• Don’t end headings with a period or a colon
• There should be only one H1 in the document

Contact Us

For free technical help, visit the Percona Community Forum.

To report bugs or submit feature requests, open a JIRA ticket.

For paid support and managed or consulting services , contact Percona Sales.

---

Last update: June 26, 2023
Created: June 26, 2023