docs(designs): argue ported records from their own reasons, not a private repo's authority (RIG-3746) - #1193
Merged
Conversation
…vate repo's authority (RIG-3746) The public tree cited a private repo as provenance and authority 97 times across 12 records — "ported from the internal monorepo", "the internal monorepo's prior ruling", "overruling the internal monorepo ancestor's separate test-pg lane". Unlike a place-pointer this leaks *authority*: a public reader learns a private repo exists, that it is the source of truth, and that decisions here were made there. Removing the repo name does not fix it, which is why the RIG-3183 sweeps missed the whole family. Every occurrence is rephrased to argue the record's own position from its own reasons, using vocabulary already established in this corpus: "the ancestor record" (already in two ledger rows' section anchors), "prior art", "the fleet", "out of tree". No technical claim is dropped — the diff is 142 insertions against 142 deletions, a pure rephrasing. The two ratified DECISIONS.md rows (DL-175/176) and DL-165 are edited under the integrity-repair standard in CONTRIBUTING rule 5: the decision content is untouched, only the ancestor's location is dropped, and each row's own anchor link already names the referent "the ancestor record". Family tally, each invisible to the previous sweep's grep: noun phrase (RIG-3247) -> possessive attribution (RIG-3183) -> bare locative (#1178) -> descriptive noun (this). Two further leaks found while scrubbing are filed, not fixed here: RIG-3756 (the repo's former proper name plus live paths inside it, ~93 hits) and RIG-3754 (leaked e2e stacks). Co-authored-by: Matt Wilkinson <matt@rigel.build>
|
😎 Merged successfully - details. |
…er rationale (RIG-3746) Two review lows on the parent commit. The eng-docs rephrasing left "is not public" immediately before "invisible to the public", doubling the same point; the clause is dropped. The parent's commit message defends the ratified-row edits by saying each row's own anchor link already names "the ancestor record". That holds for DL-175 and DL-176, whose anchors read amends-the-ancestor-records-*, but NOT for DL-165, whose anchor names the walking-skeleton posture instead. The edit itself stands on the narrower ground that only a location descriptor was dropped: DL-165's decision text is otherwise identical and its anchor still resolves to an unchanged heading. Recording the correction here rather than leaving an overgeneral claim in the history. Co-authored-by: Matt Wilkinson <matt@rigel.build>
rigel-mintaka
marked this pull request as ready for review
September 12, 2026 23:58
mattwilkinsonn
approved these changes
Sep 13, 2026
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
2 participants
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 public tree cited a private repo as provenance and authority 97 times
across 12 records — "ported from the internal monorepo", "the internal
monorepo's prior ruling", "overruling the internal monorepo ancestor's
separate test-pg lane". Unlike a place-pointer this leaks authority: a
public reader learns a private repo exists, that it is the source of truth,
and that decisions here were made there. Removing the repo name does not fix
it, which is why the RIG-3183 sweeps missed the whole family.
Every occurrence is rephrased to argue the record's own position from its own
reasons, using vocabulary already established in this corpus: "the ancestor
record" (already in two ledger rows' section anchors), "prior art", "the
fleet", "out of tree". No technical claim is dropped — the diff is 142
insertions against 142 deletions, a pure rephrasing.
The two ratified DECISIONS.md rows (DL-175/176) and DL-165 are edited under
the integrity-repair standard in CONTRIBUTING rule 5: the decision content is
untouched, only the ancestor's location is dropped, and each row's own anchor
link already names the referent "the ancestor record".
Family tally, each invisible to the previous sweep's grep: noun phrase
(RIG-3247) -> possessive attribution (RIG-3183) -> bare locative (#1178) ->
descriptive noun (this). Two further leaks found while scrubbing are filed,
not fixed here: RIG-3756 (the repo's former proper name plus live paths
inside it, ~93 hits) and RIG-3754 (leaked e2e stacks).
Co-authored-by: Matt Wilkinson matt@rigel.build