docs: scope "the runtime image" to ObjectOS where the claim depends on it - #258
Merged
Conversation
…n it The bare phrase names two incompatible artifacts across the corpus: the licensed commercial ObjectOS image and the Apache-2.0 ObjectStack framework image. Different licences, different distribution, different boot behaviour, so an unscoped sentence about one is not true of the other and a reader cannot tell which artifact to test it against. Applies the convention already in use at reference/cli.mdx and resources/license.mdx to the two sites where the phrase is bare AND the claim is referent-dependent. Subject only; no behavioural claim is added, softened or removed. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ChPQM8jamxLUfUAxwFpJ8S
Folds in the two sites the PM's grep sweep surfaced after the first commit, applying the same test: scope the phrase where the sentence's truth or the reader's action depends on which image is meant. - reference/runtime-capabilities.mdx:59 — "Pin the runtime image to one that includes every package" is an actionable instruction whose answer differs by image. - build/marketplace.mdx:60 — what a default catalog is pre-bundled with differs by image. English only; the seven locale siblings of each page are left to the translation pass, which reports them stale and non-blocking by design. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01ChPQM8jamxLUfUAxwFpJ8S
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #253
Scopes the bare phrase "the runtime image" to the ObjectOS runtime image at the four sites where the phrase is bare and the claim depends on which image is meant. Subject only — no behavioural claim is added, softened or removed anywhere in this diff.
The rule applied
Scope the phrase where the sentence's truth or the reader's action depends on which image is meant; leave it where the sentence holds for both. A bare phrase in a referent-independent sentence is not a defect, and renaming it would be churn.
What changed (4 sites, 4 files)
deploy/air-gapped.mdx:84reference/environment-variables.mdx:159OS_ARTIFACT_PATH"reference/runtime-capabilities.mdx:59build/marketplace.mdx:60Two paragraphs are re-wrapped to their file's prose width (77 and 70 columns respectively); that is the only reason the diff shows 7 insertions rather than 4.
Carve-outs — respected, and here is the check
reference/environment-variables.mdx:159— only the subject is made explicit. The refusal claim is byte-identical apart from the inserted word: no assertion that the refusal exists, no softening, no deletion. That question is [finding]reference/environment-variables.mdxlistsOS_ARTIFACT_PATHas retired and boot-refusing, but the open-source runtime image presets it andos startreads it #251's and stays open.reference/cli.mdx:54-56— not touched at all. It already writes "on the ObjectOS / runtime image" (wrapped across the line break), so it needed no edit.The fault line held: this PR fixes who a sentence is about, never whether that sentence is true.
The four bare uses deliberately left
architecture.mdx:120configure/runtime.mdx:25reference/environment-variables.mdx:89resources/license.mdx:104environment-variables.mdx:89is the judgment call worth naming: it sits in an edited file, so leaving it is a decision rather than an oversight. Scoping it would have made the corpus newly inconsistent — the identical release-axis claim scoped on one page and unscoped on two others.Sweep finding: the population is 13 sites, not 12
The card enumerated its sites. A single-line
grepreproduces that list exactly, but a multiline sweep finds one more:deploy/docker.mdx:13-14— "registry credentials for the private runtime / image" — wraps across a line break, so no line-oriented search can see it. Referent A, already scoped by "private", so it needs no edit. The same wrapping is whycli.mdx:55looks absent from a grep for "ObjectOS runtime image" while in fact being the one already-correct site.Population: 13 occurrences over 10 files. Enumeration under-counted by exactly the site a line-oriented method is blind to.
Locale handling
runtime-capabilities.mdxandmarketplace.mdxeach have 7 locale siblings;air-gapped.mdxandenvironment-variables.mdxhave zero. Per AGENTS.md, English is edited and the siblings are left to the translation pass — the freshness gate lists them underStale translations, which is the non-blocking category by design. No sibling file is modified, and notranslation:frontmatter is hand-written.zh-Hantis unaffected becausezh-Hansis untouched.Gates
Run at
38cdd9a. Exit codes captured by redirecting to a file first, never read through a pipe. Each gate's own verdict line:gen-zh-hant.mjs --checkzh-Hant: 73 generated file(s) match the zh-Hans sources byte for bytecheck-translations.mjstranslations gate passed— the 4 pages' siblings appear only underStale translations(non-blocking)check-translation-ownership.mjsThis PR touches 0 translation artifact(s) and 4 other file(s)check-translation-output.mjs --self-test29 rule case(s) ... every rule demonstrated able to failcheck-translation-output.mjs --filestranslation output gate passed (139 pre-existing finding(s) reported)— none in these filescheck-node-floor.mjsEvery declared floor clears what the dependency tree requiresturbo run type-check1 successful— cache miss, so it ran on this contentturbo run build1 successful— cache misscheck-locale-surface.mjsevery advertised URL has a source file and every source file is advertised; 397 docs entries, composition unchangedturbo run test1 successful, but FULL TURBO cached — its declared inputs excludecontent/docs, so it is not a measurement of this changeThe build logs 465
Failed to load dynamic fonterrors from OG-image generation (self-signed certificate in certificate chain). Pre-existing environmental noise from the sandbox proxy: the count is identical (465) in a build of the parent commit, and the build exits 0.Rendered-output check: all four new strings appear in
apps/docs/.next/server/app/**, and none of the four replaced strings appears anywhere in the build.🤖 Generated with Claude Code
https://claude.ai/code/session_01ChPQM8jamxLUfUAxwFpJ8S