Record the S01 stand-in rule and the wiki publish token (ADR-0002, ADR-0003) #50

Merged
Tirsvad merged 2 commits from mil-005-record-decisions into main 2026-10-10 04:34:24 +02:00
Owner

Records two decisions and the review records for them.

Changes

  • ADR-0002: an artifact approved by S01 counts as approved for the other named reviewers (S05, S03), and the record says S01 stood in. It closes the independent-review action items that RC-001 and later records carry.
  • ADR-0003: the wiki is published with a separate TOKEN_FOR_GITEA_WIKI (bare token, write:repository, dedicated user); the workflow falls back to TOKEN_FOR_GITEA only when it is absent. Dot-named titles (Home.da, Home.ms) work, which resolves the open point in ADR-0001 and the RC-012 action item.
  • RC-013 and RC-014 (QC-ADR-001): Go, Accepted. RC-014 had one finding (the decision ran to three sentences), fixed during the review.
  • TM-001 lists ADR-0002, ADR-0003, RC-013 and RC-014. Registry: next ADR 0004, next RC 015.

Things a reviewer should know

  • ADR-0002 conflicts with the text of SA-001 (credential, token and permission design cannot be accepted without S05) and with the Business Case mitigation "S05 reviews every change". Both still say so and need an amendment, or S05 needs to accept the stand-in. RC-013 carries an action item for S01 (due 2026-10-17).
  • There is no independent reader of any artifact; RC-013 and RC-014 are approved under the rule they record.
  • The credentials guide and MIL-005 task 2 still say that S05 decides which token to use; ADR-0003 records the decision. Updating them regenerates wiki pages and needs retranslation, so it is a follow-up (RC-014 action item for S03: scope the secret to this repository, due 2026-10-24).

Verification of the publish (issue #38)

Run 65 created all 15 pages; a read-back matched wiki/ byte for byte, every page returns HTTP 200 and its tables and code blocks render. Review of the Danish and Bahasa Malaysia text by a native reader (#36) is still open.

Closes #33
Closes #38

Records two decisions and the review records for them. ## Changes - **ADR-0002:** an artifact approved by S01 counts as approved for the other named reviewers (S05, S03), and the record says S01 stood in. It closes the independent-review action items that RC-001 and later records carry. - **ADR-0003:** the wiki is published with a separate `TOKEN_FOR_GITEA_WIKI` (bare token, `write:repository`, dedicated user); the workflow falls back to `TOKEN_FOR_GITEA` only when it is absent. Dot-named titles (`Home.da`, `Home.ms`) work, which resolves the open point in ADR-0001 and the RC-012 action item. - **RC-013 and RC-014** (QC-ADR-001): Go, `Accepted`. RC-014 had one finding (the decision ran to three sentences), fixed during the review. - TM-001 lists ADR-0002, ADR-0003, RC-013 and RC-014. Registry: next ADR 0004, next RC 015. ## Things a reviewer should know - **ADR-0002 conflicts with the text of SA-001** (credential, token and permission design cannot be accepted without S05) and with the Business Case mitigation "S05 reviews every change". Both still say so and need an amendment, or S05 needs to accept the stand-in. RC-013 carries an action item for S01 (due 2026-10-17). - There is no independent reader of any artifact; RC-013 and RC-014 are approved under the rule they record. - The credentials guide and MIL-005 task 2 still say that S05 decides which token to use; ADR-0003 records the decision. Updating them regenerates wiki pages and needs retranslation, so it is a follow-up (RC-014 action item for S03: scope the secret to this repository, due 2026-10-24). ## Verification of the publish (issue #38) Run 65 created all 15 pages; a read-back matched `wiki/` byte for byte, every page returns HTTP 200 and its tables and code blocks render. Review of the Danish and Bahasa Malaysia text by a native reader (#36) is still open. Closes #33 Closes #38
Tirsvad added 2 commits 2026-10-10 04:29:42 +02:00
ADR-0002: an artifact approved by S01 counts as approved for the other
named reviewers, with the stand-in recorded. ADR-0003: the wiki is published
with a separate TOKEN_FOR_GITEA_WIKI, dot-named titles work. Add review
records RC-013 and RC-014 and update TM-001.
Resolve pending commit links in ADR-0002, ADR-0003, RC-013, RC-014 and TM-001
Validate workflows / validate (pull_request) Successful in 13s
481a381fbc
Tirsvad merged commit 1d2829d6e1 into main 2026-10-10 04:34:24 +02:00
Tirsvad deleted branch mil-005-record-decisions 2026-10-10 04:34:24 +02:00
Sign in to join this conversation.