Contributing to docs content

Voice and punctuation

• Write in plain, direct sentences. Avoid marketing speak and filler.
• Do not use em-dashes (—) or spaced double-hyphens (--) in prose. Use a comma for a continuation, a period to start a new sentence, or restructure the sentence to avoid the pause entirely.
• Colons are fine to introduce a list or definition (e.g. **Term**: definition).
• Parentheses are fine for brief asides.
• Code spans and fenced code blocks may contain -- as part of CLI flags or JSON. That is the only permitted use.

Frontmatter

Every page needs title, description, and updatedAt (ISO date string).