Record the answers to entries 5 and 7 where the work reads them - #203
Merged
Merged
Conversation
The Done-when here asks that every entry carry an answer written down where the work that depends on it can read it, and that an entry whose answer belongs in a decision record point at the record carrying it. Nine entries have answers and four of them are written only on the tracker. Two of those four are the ones this tree has already built against. The mark is produced by the build and its package doc states what was decided, with nothing in the repository behind that sentence, which is the shape the decisions directory exists to prevent: a record has to exist before the code that assumes it, and here the code went first. 0015 carries what the mark is. 0016 carries whether the pages carry pictures. Both are the answers as they were taken, with the alternatives and what each would have cost, and neither decides anything on its own. The icon package now cites 0015 rather than stating the decision unattributed. The two entries left writing only on the tracker are 8 and 9. They are named in the issue rather than here, because the pages they belong to are not this change. 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.
What was wrong
The Done-when on #7 asks for more than answers. It asks that every one of the
nine entries carry an answer written down where the work that depends on it can
read it, and that an entry whose answer belongs in a decision record point at
the record carrying it.
Nine entries have answers. Four of them are written only on the tracker, and the
tree behind the domain holds nothing for any of the four:
Run 2026-08-26 at
c6fe593. Every line is empty, which is the finding.Two of those four are entries this tree has already been built against, and one
of them was built against by the change immediately before this one. The mark is
produced by the build now, and the package that draws it opened by stating what
was decided with nothing in the repository behind the sentence:
Run 2026-08-26. That is the shape this directory exists to prevent. Its own
README puts it plainly: the decisions have to exist before the code that assumes
them, and here the code went first.
What this does
Two records, in the shape the README and the template fix.
0015-what-the-mark-is.mdcarries entry 7: a typographic icon and no drawnmark, with the measurement the entry was taken against, why a derivable letter
is worth more here than an asset nothing can check, what a drawn mark and no
icon at all would each have cost, and what would make it worth revisiting.
0016-whether-the-pages-carry-pictures.mdcarries entry 5: one current image onthe landing page and textual plugin pages, with the staleness surface and the
budget as the reasons, and per-plugin screenshots left as something that arrives
additively rather than something refused.
Each names the other under
## What this record does not decide, because thetwo were answered on one day and are the two halves a reader will otherwise
assume one record settled.
Neither record decides anything. Both are answers already taken, written where
the work reads them, with the alternatives and their costs as the entry laid
them out.
The icon package cites 0015 instead of stating the decision unattributed:
Run at
c9771ac.Closes
Closes nothing. #7 closes when all nine entries meet its Done-when, and this
change meets it for two of them. Entries 8 and 9 are still written only on the
tracker, and the second half of the condition, that each issue which waited on
an entry names the answer it proceeded on, is a reading across the board rather
than a change to this tree. Both are written into #7 with what is left.
What was run
The formatter that judges markdown on a pull request here reaches further than
the gate does, so it was run at the pinned version rather than assumed:
The
needs-networkset was not asked for and no result from it is claimed here.Nothing was skipped for a display or for elevation.
No guard is added by this change, so there is none to show biting. What it adds
is prose, and the README beside it says plainly that nothing reads these
headings and no check refuses a record that omits one. That is the residual and
this sentence is the disclosure, not a softening of it.
The means
Markdown in
decisions/, which is where this repository already puts a decisionof record, in the shape
0000-template.mdcarries andREADME.mdstates. Themeans is not chosen here so much as followed: a record written anywhere else
would be a second home for the same class of thing, and the directory is the one
a reader is sent to.
Nothing about these two records is a number or a rule, so neither carries a
## What was measuredheading of the kind the template makes room for, with oneexception: 0015 carries the reading the entry was taken against, because that
reading is what made the question unavoidable.
It adds no language, no runtime and no dependency.
Who read it
Nobody. This board requires no approving review and no status check on the
default branch, so this pull request is merged by whoever opened it, and there is
no second reader on it tonight. The evidence above stands in place of one.
These two records state answers taken elsewhere and add nothing to them. If
either has put an answer differently from how it was given, that is the failure
to look for, and the entry on #7 is the authority rather than the record.