Context
Concept pages here run long. Telling a reader up front that a page is a
four-minute read or a twenty-minute one lets them decide whether to read now or
bookmark — a small affordance that measurably reduces bounce on long pages.
Scope
- Compute reading time at build time from word count, excluding code blocks from
the prose rate and counting them at a slower separate rate.
- Display it under the page title alongside the last-updated date.
- A slim reading-progress indicator in the header, driven by scroll position.
- Respect
prefers-reduced-motion; the indicator must never animate jerkily or
cause layout shift.
- Hide both on pages under a minimum length, where they are noise.
Acceptance criteria
Out of scope
- Persisted per-user reading position.
Spec: docs/dx_1/001_docs_site.md · Depends on: DX-061
Context
Concept pages here run long. Telling a reader up front that a page is a
four-minute read or a twenty-minute one lets them decide whether to read now or
bookmark — a small affordance that measurably reduces bounce on long pages.
Scope
the prose rate and counting them at a slower separate rate.
prefers-reduced-motion; the indicator must never animate jerkily orcause layout shift.
Acceptance criteria
Out of scope
Spec:
docs/dx_1/001_docs_site.md· Depends on: DX-061