Writing reference

Use these pages for a specific writing decision. Start with the house guide for the rules that apply throughout the site.

• Grammar and clarity: actors, conditions, modifiers, and natural English.
• Page structure: headings, lists, tables, and review.
• Procedures: prerequisites, steps, branches, and verified results.
• Punctuation: sentence punctuation, dashes, quotations, and emphasis.
• Technical notation: exact input, quantities, symbols, and addresses.
• Word usage: distinctions that change meaning or technical behavior.

For interface text, use actions and labels and feedback. For code and API documentation, use developer examples.

Global writing covers messages, accessibility, and scripts. The language guides cover local conventions; the glossary defines product concepts.