Pin the reading of the gate's script count to the commit it was taken at - #426
Merged
Merged
Conversation
The paragraph deriving how many shell scripts the gate runs handed a reader a command against `origin/main` and pasted `17` under it, while naming the commit that seventeen came from only in the prose two sentences later. The reference moves, so the two agreed on the day of the reading and on no day after it: the same command answers twenty-two at `4e95353399ef7eec5aad2c782d8a861ac39de66a`. The unpinned command keeps its place and loses its output, because what it is for is the set the tree holds when somebody runs it. The seventeen moves under a command naming `74066f7b9ac3972b779ed1ef60e1d48a6dd74965`, which reproduces it, so the number and the reference it belongs to are on the same lines rather than a paragraph apart. What failure it prevents: a reader running the line as written and getting a number the paste under it contradicts, with nothing on either line saying which of the two is theirs. This is the file that tells a contributor every asserted fact carries the command that produced it, and the paste in it had stopped being produced by the command above it. What was wrong: an output taken at a fixed commit standing under a command that asks a moving reference. How it was found: by running the command as it was written and comparing the answer with the paste. The distance is five, which is the distance this paragraph already records twice - the list that went four short and was replaced by a command, and the output beside that command which then went five short. This is the third instance and the first one where the reference rather than the number is what changes. The number is pinned rather than refreshed. A fresh reading under a moving reference is the same defect one merge later, which is why the sentence calling seventeen a reading rather than a fact about the tree tomorrow is kept rather than replaced: it was right, and the command beside it was what did not carry it. `cargo build --locked --all-targets` and `cargo test --locked` are green at this commit. No code changes. Closes #425 Signed-off-by: Nils Lehnen <30603423+iderex@users.noreply.github.com>
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.
The issue this belongs to
Closes #425
What changed
One paragraph in
CONTRIBUTING.md. The command deriving how many shell scriptsthe gate runs keeps its place and loses the number under it, because what it is
for is the set the tree holds when somebody runs it. The seventeen it used to
carry moves to a second command naming the commit that reading was taken at,
where it reproduces, and a correction paragraph says what was wrong.
What failure it prevents
It has already happened. The paragraph handed a reader a command against
origin/mainand pasted17under it, while naming the commit seventeen camefrom only in the prose two sentences below. The reference moves, so the two
agreed on the day of the reading and on no day after it:
A reader running the line as written got a number the paste under it contradicted
by five, with nothing on either line saying which of the two was theirs. This is
the file that tells a contributor every asserted fact carries the command that
produced it, and the paste in it had stopped being produced by the command above
it.
What was wrong: an output taken at a fixed commit standing under a command that
asks a moving reference. How it was found: by running the command as it was
written and comparing the answer with the paste.
Evidence
The base this is measured against:
Seventeen is what the count answers at the commit the prose named, and the pinned
command in the change reproduces it as written:
Five scripts landed between that commit and this base, which is why the number
moved:
No output is pasted under the unpinned command any more, and the only number left
in the paragraph is under a command naming the commit it came from:
The change reaches one file and it is one commit:
Both gate commands at this head, reported by exit code because the build's own
last line names a profile and this body is judged by a gate that reads the word
in it:
The document check that reads this file, run whole:
The means is unchanged and no artefact is built here: this edits Markdown prose
and two indented command blocks in a document that already exists, so there is no
language, format, tool or runtime to choose.
What this does not cover
git rev-parse origin/maininsidedocs/decisions/, where 0269 decides what happens to apaste that stopped reproducing and where the repair is the rule question that
issue carries.
CONTRIBUTING.mdis not a landed record, so nothing here turnson that answer and no record is touched.
CONTRIBUTING.md. Only the one paste whose commandnamed a moving reference is read and repaired. No other paragraph in the file
was re-run.
CODE_OF_CONDUCT.md. It met this shape and pinned its own command on2026-09-16. It is the pattern followed here and is not touched.
pasted output against the command above it, and this adds no rule. The same
shape can land tomorrow in any document here and no run will say so.
They are named above as the reason the number moved and none of them is judged.
rather than filled in, because nothing here refuses anything new.
real server. Every command above ran whole on this machine.
Who has read it
Nobody other than the author has read this change. The evidence above stands in
place of a second reading, and it is weaker than one: every command in it was run
by the same party that wrote the change.