Appearance
Documentation style audit
This inventory tracks the Google developer documentation style pass across the 61 Markdown files in the public documentation site and its root contributor entry points: README.md, CODEBASE.md, and CONTRIBUTING.md.
Audit date: August 20, 2026
Status definitions
- Complete: Reviewed line by line for audience, active voice, present tense, sentence case, terminology, link text, accessibility, example data, and time-sensitive claims.
- Targeted: Updated for a specific issue or normalized structurally, but still requires a complete line-by-line review.
- Pending: Not changed during this pass.
Generated command inventories and historical benchmark receipts have additional constraints. Update generated text through its source, and preserve recorded measurements, hashes, versions, and limitations when improving historical prose.
Complete
CODEBASE.mdCONTRIBUTING.mdREADME.mddocs/architecture/audio-enhancement-ap-bwe-report.mddocs/architecture/audio-enhancement-universr-report.mddocs/architecture.mddocs/architecture/music-source-separation-roformer-report.mddocs/architecture/vfx-geometry-model-report.mddocs/benchmark-fused.mddocs/benchmarks/minimax-h3-bf16-m4-max.mddocs/benchmarks/minimax-h3-compact-bf16-q8-m4-max.mddocs/benchmarks/minimax-h3-h3c-transfer.mddocs/benchmarks/minimax-h3-ref2va-mlx-8bit.mddocs/benchmarks/vfx-geometry-apple-silicon.mddocs/benchmarks/laguna-min-p-m4-max.mddocs/benchmarks/fused-reference-runs.mddocs/benchmarks/minimax-music3-m4-max.mddocs/benchmarking.mddocs/cli.mddocs/cookbooks.mddocs/configuration.mddocs/development-workflow.mddocs/README.mddocs/documentation-style.mddocs/documentation-style-audit.mddocs/gate.mddocs/graph/studio.mddocs/index.mddocs/internals/cli-and-runtime.mddocs/internals/dit-performance.mddocs/internals/guarded-acceleration.mddocs/internals/source-layout.mddocs/ios-studio.mddocs/ltx25-upstream-parity.mddocs/linux-quickstart.mddocs/macos-deep-links.mddocs/macos-studio-roadmap.mddocs/mlx-swift-fork.mddocs/plugins.mddocs/raycast.mddocs/repository-tour.mddocs/evaluation-packs.mddocs/falcon-perception-disparity-report.mddocs/runtime/acestep-validation.mddocs/getting-started.mddocs/internals/structured-runs-preflight-actions.mddocs/model-sources.mddocs/runtime/api-server.mddocs/runtime/audio.mddocs/runtime/geo.mddocs/runtime/image.mddocs/runtime/model-management.mddocs/runtime/music.mddocs/runtime/sfx.mddocs/runtime/speech.mddocs/runtime/text.mddocs/runtime/video.mddocs/runtime/vision.mddocs/runtime/world.mddocs/testing.mddocs/workflows.md
The VitePress navigation in docs/.vitepress/config.mts also received a full sentence-case and destination review.
Remaining pages
None. All 61 files in this audit have received a complete pass.
Complete-pass checklist
Move a page to Complete only after all of these checks pass:
- Identify the intended reader and lead with the task or outcome.
- Use direct, active, present-tense instructions.
- Use sentence case while preserving proper names.
- Replace vague links and positional references with descriptive wording.
- Use reserved values for examples and label real public sources accurately.
- Replace unstable words such as "latest" with a version, date, or named state when possible.
- Preserve command accuracy, generated-content ownership, benchmark receipts, security boundaries, and validation limits.
- Run
bash ./scripts/check-docs-examples.sh,pnpm docs:build, and the relevant documentation contract tests.