Enhance Docs

Overview

Improve documentation so it is up to date, coherent, and centered on users' jobs-to-be-done. Favor less content with higher clarity.

Inputs (ask if missing, max 5)

• Docs scope (which files or sections)
• Primary audiences and their jobs-to-be-done
• Source of truth for product behavior (code, APIs, changelog)
• Recent changes or upcoming releases
• Constraints (tone, length, compliance, deadlines)

Principles

• Less is more: reduce noise, keep only what helps users act.
• Low cognitive load: short paragraphs, clear headings, predictable structure.
• High signal: prioritize steps, outcomes, and decision points.
• JTBD-first: structure around what users are trying to accomplish.