---
title: Doc Health
review-state: drafting
last-human-review: 2026-06-03
depends-on:
  - tools/docs/doc_drift.py
  - tools/docs/doc_polish.py
owner: tradcliffe
---

# Doc Health

Live status of the documentation corpus, refreshed on every push to
`main` by the `pages` CI job (no separate cron, no bot push). Two
signals: the polish-score summary (counts of docs in each
`review-state`, plus unowned and per-quadrant breakdowns) and the
current drift list (docs whose `last-human-review` is older than any
commit on their `depends-on` paths).

```{health-dashboard}
:data: meta/_health_data.json
```

## How to read this page

- **Polish summary** — the goal is to grow `polished` and shrink
  `unowned`. Drifting docs (below) are the priority queue for the next
  review pass.
- **Drift** — polished-tier drift fails CI on the next build that
  touches `src/`. Lower-tier drift is reported here but does not block.
  The point of the page is **accountability, not nagging**; the
  numbers exist to be looked at when deciding where to spend a review
  pass.