diff --git a/docs/adr/adr-0004-shared-wiki-publishing-opt-in.md b/docs/adr/adr-0004-shared-wiki-publishing-opt-in.md index c25d645..904fdb9 100644 --- a/docs/adr/adr-0004-shared-wiki-publishing-opt-in.md +++ b/docs/adr/adr-0004-shared-wiki-publishing-opt-in.md @@ -4,13 +4,13 @@ | Key | Value | | --- | --- | | ID | ADR-0004 | -| CrossReference | [MIL-006], [ADR-0003], [ADR-0002] | +| CrossReference | [MIL-006], [ADR-0003], [ADR-0002], [ADR-0009] | ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-10 | Deprecated | Jens Tirsvad Nielsen | S01 | Initial version | [b22a2cd] | -| 2026-10-10 | Accepted | Jens Tirsvad Nielsen | S01 | Reviewed (RC-018): the `prune` variant added to the evaluated options | [b22a2cd] | +| 2026-10-10 | Deprecated | Jens Tirsvad Nielsen | S01 | Reviewed (RC-018): the `prune` variant added to the evaluated options | [b22a2cd] | +| 2026-10-14 | Superseded by ADR-0009 | Jens Tirsvad Nielsen | AI as stand-in for S01 | The scoped delivery and the `wiki/.publish` marker are replaced by the reusable workflow of ADR-0009 and removed (MIL-009); the token and the empty-folder rules stand and are carried by ADR-0009; reviewed (RC-065) | pending | Allowed Status values: `Proposed`, `Accepted`, `Rejected`, `Deprecated`, `Superseded by ADR-NNNN`. @@ -108,10 +108,12 @@ The rules that follow from it: - [ADR-0003] — its fallback to `TOKEN_FOR_GITEA` no longer applies to the shared workflow. - [ADR-0002] — the stand-in rule applies to the review of this ADR. +- [ADR-0009] — the successor: the reusable workflow replaces the scoped delivery and the marker. --- [MIL-006]: ../milestones/mil-006-shared-wiki-publishing.md [ADR-0003]: ./adr-0003-wiki-publish-token.md [ADR-0002]: ./adr-0002-s01-approves-as-stand-in.md +[ADR-0009]: ./adr-0009-wiki-publishing-reusable-workflow.md [b22a2cd]: https://git.tirsystem.com/TirSystem/github-action/commit/b22a2cd59235078656c4440b945b787f88fbd345 diff --git a/docs/artifact-registry.md b/docs/artifact-registry.md index 0a9b5ff..61d861b 100644 --- a/docs/artifact-registry.md +++ b/docs/artifact-registry.md @@ -11,7 +11,7 @@ each document lives in *this* project and the next version to use. | SA | Stakeholder Analysis | docs/stakeholder-analysis.md | 002 | | PP | Project Plan | docs/project-plan.md | 002 | | MIL | Milestone / Gateway | docs/milestones/*.md | 010 | -| RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 065 | +| RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 066 | | TM | Traceability Matrix | docs/sqa/traceability-matrix.md | 002 | | ADR | Architecture Decision Record | docs/adr/adr-NNNN-*.md | 0010 | | UCD | Use Case Diagram | docs/use-case-diagram.md | 002 | diff --git a/docs/sqa/reviews/rc-065-adr-0004-superseded.md b/docs/sqa/reviews/rc-065-adr-0004-superseded.md new file mode 100644 index 0000000..25a21bf --- /dev/null +++ b/docs/sqa/reviews/rc-065-adr-0004-superseded.md @@ -0,0 +1,55 @@ +# Review Record: ADR-0004 superseded by ADR-0009 + +## Metadata +| Key | Value | +| --- | --- | +| ID | RC-065 | +| CrossReference | [ADR-0004], [ADR-0009], [QC-ADR-001], [MIL-009] | + +## Version History +| Date | Status | Author | Reviewer | Change | Commit | +| --- | --- | --- | --- | --- | --- | +| 2026-10-14 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | pending | + +--- + +## Artifact Under Review + +- Instance reviewed: [ADR-0004] after the status change to `Superseded by ADR-0009` on 2026-10-14 +- Checklist used: [QC-ADR-001] +- Scope: delta re-review of the criteria the status change touches (7, 8, 9, 11); the earlier record is RC-018 +- Language and domain: n/a (technical type) +- Mode: autonomous, not independent (the reviewer is `AI as stand-in for S01`; the user accepted the plan [MIL-009] in chat on 2026-10-14) + +## Checklist Results + +| # | Criterion | Status | Evidence/Notes | +| --- | --- | --- | --- | +| 1 | The ID matches the filename number and is unique and sequential | Pass | Unchanged. | +| 2 | Context states the problem, the forces and the options evaluated | Pass | Unchanged. | +| 3 | At least two options were considered | Pass | Unchanged. | +| 4 | Decision is stated in one or two unhedged sentences and matches an evaluated option | Pass | Unchanged. | +| 5 | Consequences list both Positive and Negative outcomes | Pass | Unchanged. | +| 6 | Quality-attribute impacts are named where the decision affects them | Pass | Unchanged. | +| 7 | Affected Artifacts are listed as links, and each is also in CrossReference | Pass | ADR-0009 is added to both. | +| 8 | Status changes are recorded as new Version History rows with a Change summary and Commit link; retained rows are never rewritten | Pass | The change is a new row; the earlier `Accepted` row became `Deprecated` and its content is unchanged. | +| 9 | A superseded or deprecated ADR names its successor, and the successor links back | Pass | The status names ADR-0009; ADR-0009 lists ADR-0004 under Affected Artifacts and in CrossReference. This closes the N-A of RC-018. | +| 10 | Written in the language of the domain, with no unexplained abbreviations | Pass | Unchanged. | +| 11 | Status is one of the allowed values and every row uses only these | Pass | `Deprecated` and `Superseded by ADR-0009`. | + +## Overall Verdict + +Go - all criteria pass. The scoped delivery and the marker are replaced and removed (MIL-009 tasks 2 to 6); the token and empty-folder rules of this ADR stand and are carried by ADR-0009. The AI records the acceptance as stand-in for S01; there is no independent reader, and the decision stays open to challenge in the run summary. + +## Action Items + +| Action | Owner | Due | +| --- | --- | --- | +| None open | - | - | + +--- + +[ADR-0004]: ../../adr/adr-0004-shared-wiki-publishing-opt-in.md +[ADR-0009]: ../../adr/adr-0009-wiki-publishing-reusable-workflow.md +[QC-ADR-001]: ../../../framework/qc/artifacts/qc-adr.md +[MIL-009]: ../../milestones/mil-009-migrate-wiki-callers-and-remove-scoped-workflow.md diff --git a/docs/sqa/traceability-matrix.md b/docs/sqa/traceability-matrix.md index f14c90e..d490322 100644 --- a/docs/sqa/traceability-matrix.md +++ b/docs/sqa/traceability-matrix.md @@ -4,13 +4,13 @@ | Key | Value | | --- | --- | | ID | TM-001 | -| CrossReference | [BC-001], [SA-001], [PP-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006], [MIL-007], [MIL-008], [MIL-009], [RC-001], [RC-002], [RC-003], [RC-004], [RC-005], [RC-006], [RC-007], [RC-008], [RC-009], [RC-010], [RC-011], [RC-012], [RC-013], [RC-014], [RC-015], [RC-016], [RC-017], [RC-018], [RC-019], [RC-020], [RC-021], [RC-022], [RC-023], [RC-024], [RC-025], [RC-026], [RC-027], [RC-028], [RC-029], [RC-030], [RC-031], [RC-032], [RC-033], [RC-034], [RC-035], [RC-036], [RC-037], [RC-038], [RC-039], [RC-040], [RC-041], [RC-042], [RC-043], [RC-044], [RC-045], [RC-046], [RC-047], [RC-048], [RC-049], [RC-050], [RC-051], [RC-052], [RC-053], [RC-054], [RC-055], [RC-056], [RC-057], [RC-058], [RC-059], [RC-060], [RC-061], [RC-062], [RC-063], [RC-064], [ADR-0007], [ADR-0008], [ADR-0009], [UC-007], [UC-006], [ADR-0006], [UC-005], [ADR-0005], [UCD-001], [US-001], [UC-001], [UC-002], [UC-003], [UC-004], [ADR-0001], [ADR-0002], [ADR-0003], [ADR-0004] | +| CrossReference | [BC-001], [SA-001], [PP-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004], [MIL-005], [MIL-006], [MIL-007], [MIL-008], [MIL-009], [RC-001], [RC-002], [RC-003], [RC-004], [RC-005], [RC-006], [RC-007], [RC-008], [RC-009], [RC-010], [RC-011], [RC-012], [RC-013], [RC-014], [RC-015], [RC-016], [RC-017], [RC-018], [RC-019], [RC-020], [RC-021], [RC-022], [RC-023], [RC-024], [RC-025], [RC-026], [RC-027], [RC-028], [RC-029], [RC-030], [RC-031], [RC-032], [RC-033], [RC-034], [RC-035], [RC-036], [RC-037], [RC-038], [RC-039], [RC-040], [RC-041], [RC-042], [RC-043], [RC-044], [RC-045], [RC-046], [RC-047], [RC-048], [RC-049], [RC-050], [RC-051], [RC-052], [RC-053], [RC-054], [RC-055], [RC-056], [RC-057], [RC-058], [RC-059], [RC-060], [RC-061], [RC-062], [RC-063], [RC-064], [RC-065], [ADR-0007], [ADR-0008], [ADR-0009], [UC-007], [UC-006], [ADR-0006], [UC-005], [ADR-0005], [UCD-001], [US-001], [UC-001], [UC-002], [UC-003], [UC-004], [ADR-0001], [ADR-0002], [ADR-0003], [ADR-0004] | ## Version History | Date | Status | Author | Reviewer | Change | Commit | | --- | --- | --- | --- | --- | --- | -| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | S01 | Added MIL-009 and RC-064 (the MIL-009 plan row) | [86e69ce] | | 2026-10-14 | Proposed | Jens Tirsvad Nielsen | S01 | MIL-009, PP-001 and RC-064 accepted | [2f267df] | +| 2026-10-14 | Proposed | Jens Tirsvad Nielsen | S01 | Added RC-065 (ADR-0004 superseded by ADR-0009) | pending | --- @@ -49,7 +49,7 @@ updated whenever an artifact instance is created or reviewed. | [ADR-0001] | ADR | [BC-001], [MIL-005] | [ADR-0003] | [RC-012] | | [ADR-0002] | ADR | [SA-001], [RC-001] | - | [RC-013] | | [ADR-0003] | ADR | [MIL-005], [ADR-0001], [RC-011] | [ADR-0004] | [RC-014] | -| [ADR-0004] | ADR | [MIL-006], [ADR-0003], [ADR-0002] | - | [RC-018] | +| [ADR-0004] | ADR | [MIL-006], [ADR-0003], [ADR-0002] | [ADR-0009] | [RC-018], [RC-065] | | [RC-011] | RC | [MIL-005] | - | - | | [RC-012] | RC | [ADR-0001] | - | - | | [RC-013] | RC | [ADR-0002] | - | - | @@ -118,6 +118,7 @@ updated whenever an artifact instance is created or reviewed. | [RC-062] | RC | [PP-001] | - | - | | [RC-063] | RC | [ADR-0009] | - | - | | [RC-064] | RC | [MIL-009], [PP-001] | - | - | +| [RC-065] | RC | [ADR-0004] | - | - | ## Coverage Notes @@ -214,6 +215,7 @@ updated whenever an artifact instance is created or reviewed. [RC-062]: ./reviews/rc-062-pp-001-mil-008.md [RC-063]: ./reviews/rc-063-adr-0009.md [RC-064]: ./reviews/rc-064-mil-009-plan.md +[RC-065]: ./reviews/rc-065-adr-0004-superseded.md [ADR-0008]: ../adr/adr-0008-cpp-csharp-quality-check-contract.md [ADR-0009]: ../adr/adr-0009-wiki-publishing-reusable-workflow.md [ADR-0007]: ../adr/adr-0007-release-publish-destination.md @@ -224,5 +226,4 @@ updated whenever an artifact instance is created or reviewed. [ADR-0005]: ../adr/adr-0005-quality-check-contract.md [faf13b2]: https://git.tirsystem.com/TirSystem/github-action/commit/faf13b2c2a4901c0171977de1ffc2841023f537a [1bc56f8]: https://git.tirsystem.com/TirSystem/github-action/commit/1bc56f8b771531f221f218fc00b147ecc73c051e -[86e69ce]: https://git.tirsystem.com/TirSystem/github-action/commit/86e69ce85df72ea3caed40253e08231c73187fde [2f267df]: https://git.tirsystem.com/TirSystem/github-action/commit/2f267df2a270087cb7dc482af4ce4f4341e97b03