TOPIC — Assessment (formed YYYY-MM-DD)
Overview
Compare this area to common good practice, score it (Table 2), and track prioritized gaps (section 4.3).
Scope and methodology
…
Table: Reference practices
Legend: use table.audit-ref-table. …
…
Table: AS-IS situation
One row per Table 1 practice. …
Use table.audit-score-table. Columns: #, Practice,
Evidence / notes, Justification, Score
(td.score-excellent|score-good|score-needs-attention).
…
Scoring summary
Narrative overall (Table 2 judgment)
Overall (our guess, …): about X / 10.
To move toward top decile: … — see
section 4.3 (Top five gaps).
Weighted axis model (explicit arithmetic)
Optional cross-check: show reproducible math that is not the same as the narrative headline in §4.1 (which may weight importance). Pick one style and stick to it:
- Docs (DX) style: a small set of axes with fixed weights summing to 100%; table columns Axis, Weight, Score, Contribution (weight × score); total row → ≈ headline.
- API style: unweighted mean of all Table 2 row scores; table columns Step, Operation, Figures, Result; total row for the explicit mean.
| … | … | … | … |
|---|---|---|---|
| … | … | … | … |
| Total | … | — | ≈ X / 10 |
Interpretation (optional): one short paragraph reconciling the explicit arithmetic with the narrative score.
Top five gaps — priority and workflow status
Status colours: TODO (not started), IN PROGRESS (owned work in flight), DONE (accepted in main). Update started / closed / PR when you pick up or finish work.
| Priority | Gap | Status | Started | Closed | PR / reference |
|---|---|---|---|---|---|
| P0 | … | TODO | — | — | — |
Page history
| Date | Change | Author |
|---|---|---|
| YYYY-MM-DD | Initial publication. | Name or team |
Page history
| Date | Change | Author |
|---|---|---|
| Added Page history section (repository baseline). | Ivan Boyarkin |