docs-standards

Context

Squad documentation follows the Microsoft Style Guide with Squad-specific conventions. Consistency across docs builds trust and improves discoverability.

Patterns

Microsoft Style Guide Rules

• Sentence-case headings: "Getting started" not "Getting Started"
• Active voice: "Run the command" not "The command should be run"
• Second person: "You can configure..." not "Users can configure..."
• Present tense: "The system routes..." not "The system will route..."
• No ampersands in prose: "and" not "&" (except in code, brand names, or UI elements)

Squad Formatting Patterns

• Scannability first: Paragraphs for narrative (3-4 sentences max), bullets for scannable lists, tables for structured data
• "Try this" prompts at top: Start feature/scenario pages with practical prompts users can copy
• Experimental warnings: Features in preview get callout at top
• Cross-references at bottom: Related pages linked after main content