Files
021-snake-game/docs/sqa/reviews/rc-003-dictionary.md
T
Tirsvad f13d004447 Plan the Day 21 repository: business case, stakeholders, plan and milestones
Adds the Business Case, Stakeholder Analysis, Domain Dictionary, Project Plan and milestones MIL-001 to MIL-003, with the review records RC-001 to RC-006 (all Go). The repository starts from the finished main of 020-snake-game, as S01 decided on 2026-10-08. The milestones and their 22 issues were synced to the git host.
2026-10-08 17:46:38 +08:00

5.2 KiB

RC-003: Review of DICT-001

Metadata

Key Value
ID RC-003
CrossReference DICT-001, QC-DICT-001, QC-LANG-001, BC-001, PP-001

Version History

Date Status Author Reviewer Change Commit
2026-10-08 Proposed Jens Tirsvad Nielsen S01 Initial version pending

Artifact Under Review

  • Instance reviewed: DICT-001
  • Checklist used: QC-DICT-001 and, for the language and domain, QC-LANG-001
  • Scope: full review
  • Language and domain: en / it
  • Language reviewer: none (S01 reads English and knows the IT domain)

Checklist Results

# Criterion Status Evidence/Notes
1 Every row has a PO term, its language, an IT term and a definition Pass 26 rows; a script found no empty cell.
2 Each PO term maps to exactly one IT term and the reverse (no synonyms) Pass A script found no PO term and no IT term twice. Turtle (segment) and 'subclass of Turtle' (inheritance) are different IT terms.
3 Every Domain Model concept has a row, and the Domain Model uses its PO term N-A No Domain Model exists in this project (the Dictionary's Rules section says so).
4 The Operation Contracts, Sequence Diagrams, Design Class Diagrams and ERD use the IT term, not the PO term N-A None of these artifacts exists in this project.
5 Definitions are written in the PO language and are one sentence Pass All definitions are English; a script found no definition with a second sentence.
6 "Used as PO term in" and "Used as IT term in" name artifact types that exist in the project Pass The columns name BC, SA, PP and MIL (all exist) and PY, the source-code type of the catalog.
7 The dictionary's Language and Domain rows, and the language of every row, match the PO language and domain in the project registry Pass Metadata en / it equals the registry's PO language and PO domain; the Language column of every row is en.

Language and Domain Results

# Criterion Status Evidence/Notes
1 The Metadata table has a Language row and a Domain row, and neither is a placeholder Pass Language is en and Domain is it in the Metadata table.
2 Language is a BCP 47 code and Domain is a value from the registry's domain list Pass en is a BCP 47 code; it is in the registry's domain list; check-languages.sh --list shows en and it for this document.
3 The content (prose and table cells) is written in the stated language Pass All prose and table cells are English. Titles of lectures are quoted in English.
4 The register matches the one the registry gives for the artifact type Pass Register is IT Professional English: one-sentence definitions with the IT term in backticks.
5 Domain terms are the PO terms of the domain's dictionary, with no synonyms Pass The document is the dictionary: its PO terms are its own rows. A script found no term twice. The two rules about 'step' and 'base' keep two project words out of the game vocabulary.
6 Metadata keys, section headings, IDs and statuses are in English Pass Keys, headings, IDs and statuses are English.
7 No translated twin (<name>.<language>.md) exists beside the document Pass docs/ holds one file per artifact; there is no <name>.<language>.md.
8 A change of language or domain since the previous accepted version has a Version History row and was reviewed again N-A First version; there is no earlier accepted version.
9 A reviewer competent in the domain, and in the language, has confirmed that the domain terms are used correctly Pass S01 (Product Owner and developer) reads English and knows the IT domain, and asked for this review in chat on 2026-10-08. The terms were also checked against DICT-001 by the reviewing assistant; S01's own reading is an action item below.
10 Abbreviations are spelled out on first use, in the stated language Pass Product Owner (PO) and information technology (IT) are spelled out on first use; the artifact short names in the last two columns are the catalog's.

Overall Verdict

Go — all Mandatory criteria pass (criteria 3 and 4 are N-A because the Domain Model and the design artifacts do not exist in this project). The checklist rows above were transcribed and assessed on 2026-10-08 by the assistant that drafted the documents, at S01's request in chat ("review them and start MIL-001"). S01 is named as reviewer and approves. This review is not independent: the drafter and the reviewer are the same assistant, and author and reviewer (S01) are one person in a single-person project (risk recorded in BC-001 and PP-001). S01 has not yet read the document line by line and can overrule this verdict at the pull request.

Action Items

Action Owner Due
Read DICT-001 and confirm or overrule this Go S01 2026-10-09