docs-writinglisted

# Documentation Writing 52 rules across 9 categories for documentation quality. Focuses on concrete issues with concrete fixes. ## Doc Writing/Audit Workflow Copy and track this checklist during the audit: ```text Doc writing/audit progress: - [ ] Step 1: Determine doc type (tutorial, how-to, reference, explanation) and audience - [ ] Step 2: Run CRITICAL checks (voice and tone, structure and organization) - [ ] Step 3: Run HIGH checks (clarity and language, code examples) - [ ] Step 4: Run MEDIUM+ checks for remaining categories in scope - [ ] Step 5: Report findings with file:line and concrete fixes ``` 1. Audit only changed files unless a full sweep is requested. 2. Identify the doc type (tutorial, how-to, reference, explanation) and intended audience to select relevant categories. 3. Load rule files progressively by category prefix — read only what applies. 4. Prioritize CRITICAL and HIGH findings before medium-priority polish. 5. After fixes, rerun the relevant rules before finalizing. ## Rule Categories by Priority | Priority | Category | Impact | Prefix | Rules | |----------|----------|--------|--------|-------| | 1 | Voice & Tone | CRITICAL | `voice-` | 4 | | 2 | Structure & Organization | CRITICAL | `structure-` | 10 | | 3 | Clarity & Language | HIGH | `clarity-` | 6 | | 4 | Code Examples | HIGH | `code-` | 7 | | 5 | Formatting & Syntax | MEDIUM-HIGH | `format-` | 8 | | 6 | Navigation & Linking | MEDIUM-HIGH | `nav-` | 6 | | 7 | Scanability & Readability | MED