Commit d2fa5b5
optimization_guide: flag missing graph-stats, fix walkthrough citation
The doc's primary diagnostic (`make graph-stats`) is referenced six
times throughout but the Make target was removed in Step E (it shipped
with the DOOM renderer). The principles in the doc are general — they
apply to any compiled graph — but the operational instructions point
at deleted tooling.
Two changes:
- Added a top-of-doc note explaining that `make graph-stats`
references describe a removed diagnostic, with a pointer to where
the original implementation lives. The DOOM-anchored worked
examples in the body are now flagged as illustrative — they
preserve the original numbers that informed each rule of thumb.
- Section § 11 'Correctness checks after structural changes' cited
`make walkthrough` (removed) and 'the relevant test file under
tests/doom/' (deleted directory) as the authoritative multi-position
check. Replaced with `make test`, which is the actual surviving
authoritative check.
The body's `make graph-stats` mentions are intentionally left in
place — they describe a real diagnostic concept ('per-annotation costs
and layer counts'), and the top-of-doc note now scopes them as
historical references rather than actionable instructions.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>1 parent b8a44cc commit d2fa5b5
1 file changed
Lines changed: 11 additions & 7 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
9 | | - | |
10 | | - | |
11 | | - | |
12 | | - | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
13 | 18 | | |
14 | 19 | | |
15 | 20 | | |
| |||
580 | 585 | | |
581 | 586 | | |
582 | 587 | | |
583 | | - | |
584 | | - | |
585 | | - | |
| 588 | + | |
| 589 | + | |
586 | 590 | | |
587 | 591 | | |
588 | 592 | | |
| |||
0 commit comments