Tirsvad
1d35410b8d
Create the Business Case, Stakeholder Analysis (S01 course participant, S02 Udemy coursists, S03 GitHub viewers), Project Plan and the milestone documents MIL-001 (project setup, 6 tasks) and MIL-002 (game implementation, 8 tasks) for the console Blackjack game. Register PP and MIL in the artifact registry, set the PO language to en, and link the synced Gitea milestones in the Gateway Schedule. Refs #1 Refs #2 Refs #3 Refs #4 Refs #5 Refs #6 Refs #7 Refs #8 Refs #9 Refs #10 Refs #11 Refs #12 Refs #13 Refs #14
1.2 KiB
1.2 KiB
Architecture Decision Record (ADR)
Files: docs/adr/adr-NNNN-kebab-case-title.md. NNNN is 4-digit and
sequential; the ID is ADR-NNNN and must match the filename number (an
intentional exception to the usual 3-digit IDs). Use
new-artifact.sh ADR --file docs/adr/adr-NNNN-title.md.
Cite in CrossReference the artifacts this decision is about (pass each
with --cite <ID>=<path>); ADR has no fixed candidate list.
Required sections (after Metadata / Version History)
- Context — the problem, the options evaluated and the forces (cost, risk, constraints).
- Decision — the outcome in one or two sentences, no hedging.
- Consequences — two bold labels, Positive: and Negative:, each with a bullet list.
- Affected Artifacts — other artifacts impacted, as
[ID]links, or a single-if none.
Allowed statuses: Proposed, Accepted, Rejected, Deprecated,
Superseded by ADR-NNNN; no others (an ADR is never Approved). Status
changes (Proposed → Accepted → Deprecated / Superseded by ADR-NNNN, or
Proposed → Rejected) are new rows in ## Version History (only the two
latest are kept; earlier ones stay in git); never rewrite a retained row.