Commit 94a4126
docs(quickstart): declare the compile timing as machine-variable (#260)
`content/docs/quickstart.mdx`'s Path B block publishes `✓ Build complete
(72ms)`. Every other visible byte in both blocks is deterministic; that
number is whatever the transcribing machine measured — `117ms` at CLI
17.1.0, `72ms` at 17.2.0, with no behavioural change behind the difference.
The block is a faithful transcript, so the number stays exactly as captured.
What changes is the declaration sentence that already tells the reader which
parts of their own output will differ: it named the expanded project paths
but not the timing, so a reader whose scaffold compiles in 300ms had no way
to know that is expected rather than a symptom. The timing now sits in that
same list.
Second effect: the recurring re-transcription of these blocks at each CLI
publish no longer has to justify a one-line timing change as drift, because
the value is declared rather than asserted.
Path A checked for the same shape and needs nothing: its published lines
carry no measured value. Verified against `@objectstack/cli` 17.2.0 source
rather than by re-booting — `printServerReady` (the banner both paths share)
interpolates no duration, `start.ts` prints no timer at all, and the only
`Build complete` timer in the CLI is on the compile path Path B exercises.
Claude-Session: https://claude.ai/code/session_01ChPQM8jamxLUfUAxwFpJ8S
Co-authored-by: Claude <noreply@anthropic.com>1 parent b730b54 commit 94a4126
1 file changed
Lines changed: 5 additions & 4 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
197 | 197 | | |
198 | 198 | | |
199 | 199 | | |
200 | | - | |
201 | | - | |
202 | | - | |
203 | | - | |
| 200 | + | |
| 201 | + | |
| 202 | + | |
| 203 | + | |
| 204 | + | |
204 | 205 | | |
205 | 206 | | |
206 | 207 | | |
| |||
0 commit comments