Skip to content

docs(garage): two study pages cite a pipeline at a path that is three moves old - #571

Merged
oddharsh merged 1 commit into
mainfrom
docs/garage-www-copy
Aug 24, 2026
Merged

oddharsh merged 1 commit into
mainfrom
docs/garage-www-copy

Conversation

@oddharsh

Copy link
Copy Markdown
Owner

The page-copy half of #569, which fixed the comments and deliberately left these.

/garage/encoding

Four cites of the photo pipeline, all still at www/scripts/:

line was is
"the live pipeline (www/scripts/add-photos.sh)" tools/photos/add-photos.sh
www/scripts/zenc/ x3 tools/photos/zenc/

zenc is the Rust wrapper this page's entire corpus study is an argument for,
so the three dead cites are on the sentences doing the most work. The path has
moved twice since (www/scripts to scripts/ to tools/photos/, #452 and
#453), and the prose is present tense throughout.

/garage/horizon

The JXL section priced a third format tier as "another stem format in
www/images/". This one is not a literal rename. public/images/ holds the
photo DATA surfaces (metadata, exif, alt text, hashes); the pixel tiers have
lived in content-addressed public/i/ since 2026-07-03. So the corrected
sentence names the directory a JXL tier would actually land in rather than the
one the old path maps to.

The "120 stems" count beside it is left alone on purpose: that is the site's
photo count when the study was written (158 now), and updating a measured number
without re-running the study invents data.

/garage/workers, untouched on purpose

It quotes "main": "www/_worker.js/index.js" and names
www/_worker.js/counter.js. That page is ABOUT the Pages-to-Workers migration,
so the old config is its subject matter and correcting it would falsify the
page.

notes

Both edited files are hand-authored, not generated: pipelines/garage/pages.json
covers six pages (pqc, octane, useragent, typed-config, hidden-flags, ig-prep)
and neither of these is one, so editing src/pages/ directly is the whole edit.

Page bytes move, so both p-dict snapshots go stale until the next nightly roll.

Checked: bun run test 369/369, bun run pages:check, bun run lint, and a
full build (51 documents, 3015 refs resolve, 33 understanding payloads
byte-equal, no tripwires). Confirmed in the SERVED bytes: .build copies of both
pages carry the new paths and zero www/.

… moves old

/garage/encoding names the photo pipeline four times and every one of them
still says `www/scripts/`: the sentence "the live pipeline
(www/scripts/add-photos.sh)" plus three cites of `www/scripts/zenc/`, the Rust
wrapper the page's whole corpus study is an argument for. Both are
`tools/photos/` now, after www/scripts to scripts/ to tools/photos (#452, #453).
Present tense, on a public page, pointing at nothing.

/garage/horizon's JXL section priced a third format tier as "another stem
format in www/images/". That one is NOT a literal rename: `public/images/` holds
the photo DATA surfaces (metadata, exif, alt text, hashes) while the pixel tiers
have lived in content-addressed `public/i/` since 2026-07-03, so the sentence
names the directory a JXL tier would actually land in. The "120 stems" count is
left alone deliberately: it is the site's photo count when the study was
written, and updating a measured number without re-running the study invents
data.

/garage/workers is UNTOUCHED on purpose. It quotes `"main":
"www/_worker.js/index.js"` and names `www/_worker.js/counter.js`, but that page
is about the Pages-to-Workers migration and the old config IS its subject
matter. Correcting it would falsify the page.

Both files are hand-authored rather than generated: pipelines/garage/pages.json
covers six pages (pqc, octane, useragent, typed-config, hidden-flags, ig-prep)
and neither of these is one, so editing src/pages directly is the whole edit.

Page bytes move, so both p-dict snapshots go stale until the next roll, which is
what that roll is for. Build clean: 51 documents, 3015 refs resolve, 33
understanding payloads byte-equal, no tripwires.
@github-actions

Copy link
Copy Markdown
Contributor

Wire-size diff vs merge base

8702b4d → 993be8b

Brotli q11, the quality the edge serves. Every number here is deterministic:
an unchanged file produces no row. Advisory — this check fails on nothing.

Client assets

No change. 22 files, 77.80 KiB Brotli total.

Pages

Total Brotli: 552.47 KiB → 552.50 KiB (+0.03 KiB, +0.0%) across 52 files, 2 changed.

No single file moved by 0.13 KiB or more.

Plus 2 files under the 0.13 KiB floor, net +0.03 KiB — usually content-hash churn in /a/ references, counted in the total above.

Worker bundle

No change. 238.20 KiB gzip.

Dictionary deltas (pd/)

148 → 148 deltas, 514.58 KiB → 514.67 KiB (+0.09 KiB).

@oddharsh
oddharsh merged commit 8c06fc8 into main Aug 24, 2026
7 checks passed
@oddharsh
oddharsh deleted the docs/garage-www-copy branch August 24, 2026 20:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant