Skip to content

Commit 94a4126

Browse files
os-billclaude
andauthored
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

File tree

‎content/docs/quickstart.mdx‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -197,10 +197,11 @@ You'll see:
197197

198198
That block is transcribed from `pnpm dev` on a scaffold created by
199199
`@objectstack/cli` 17.2.0. Project paths show as `my-app/…` — the CLI prints
200-
yours expanded. Your own run also prints pnpm's script header above the block,
201-
per-step compile progress, startup advisories (configuration load, dev
202-
secret-field crypto), the full list of loaded plugin names, boot diagnostics,
203-
and an MCP connection trailer below the banner.
200+
yours expanded, and the `Build complete` timing is whatever the transcribing
201+
machine measured, so yours will differ. Your own run also prints pnpm's script
202+
header above the block, per-step compile progress, startup advisories
203+
(configuration load, dev secret-field crypto), the full list of loaded plugin
204+
names, boot diagnostics, and an MCP connection trailer below the banner.
204205

205206
Note the dev server asks for port **3000**, the same port `os start` uses. If
206207
that port is taken it binds the next free one and says so:

0 commit comments

Comments
 (0)