Files
025-squirrel/docs/sqa/reviews/rc-007-dictionary.md
T
Tirsvad 10d8a6de3d
Tests / Run the tests (pull_request) Successful in 45s
Resolve pending commit links
2026-10-13 16:22:22 +08:00

4.8 KiB

RC-007 Review of DICT-001

Metadata

Key Value
ID RC-007
CrossReference DICT-001, QC-DICT-001, QC-LANG-001

Version History

Date Status Author Reviewer Change Commit
2026-10-13 Deprecated Jens Tirsvad Nielsen AI as stand-in for S01 Initial version f1b3c03
2026-10-13 Accepted Jens Tirsvad Nielsen AI as stand-in for S01 Action item closed: criteria 3 and 4 re-reviewed in RC-018 (Go) 40c3387

Artifact Under Review

  • Instance reviewed: DICT-001
  • Checklist used: QC-DICT-001 and QC-LANG-001
  • Scope: full review
  • Language and domain: en / it
  • Language reviewer: none (the stand-in reviewer reads English and the it domain)
  • Mode: autonomous, not independent (reviewer: AI as stand-in for S01)

Checklist Results

# Criterion Status Evidence/Notes
1 Every row has a PO term, its language, an IT term and a definition (Mandatory) Pass All six rows have PO term, language, IT term and definition.
2 Each PO term maps to exactly one IT term and the reverse (no synonyms) (Mandatory) Pass One IT term per PO term and the reverse; no synonyms.
3 Every Domain Model concept has a row, and the Domain Model uses its PO term (Mandatory) N-A No Domain Model exists yet; DM is created in MIL-002 task 2 and must add a row for each concept in the same change.
4 The Operation Contracts, Sequence Diagrams, Design Class Diagrams and ERD use the IT term, not the PO term (Mandatory) N-A No Operation Contract, Sequence Diagram, Design Class Diagram or ERD exists yet.
5 Definitions are written in the PO language and are one sentence (Optional) Pass Definitions are single English sentences.
6 "Used as PO term in" and "Used as IT term in" name artifact types that exist in the project (Optional) Pass Used-in columns name types that exist or are planned in MIL-002; all exist as types.
7 The dictionary's Language and Domain rows, and the language of every row, match the PO language and domain in the project registry (Mandatory) Pass Language en and Domain it match the registry; rows are English.

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 (Mandatory) Pass Metadata has `Language
2 Language is a BCP 47 code and Domain is a value from the registry's domain list (Mandatory) Pass en is a BCP 47 code; it is in the registry domain list.
3 The content (prose and table cells) is written in the stated language (Mandatory) Pass The dictionary is written in English throughout.
4 The register matches the one the registry gives for the artifact type (Mandatory) Pass Professional register: term pairs and one-sentence definitions.
5 Domain terms are the PO terms of the domain's dictionary, with no synonyms (Mandatory) Pass This document is the dictionary; its terms are the reference for the other documents.
6 Metadata keys, section headings, IDs and statuses are in English (Mandatory) Pass Metadata keys, headings, IDs and statuses are English.
7 No translated twin (<name>.<language>.md) exists beside the document (Mandatory) Pass No translated twin exists in docs/.
8 A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) Pass First version; no earlier accepted language.
9 A reviewer competent in the domain, and in the language, has confirmed that the domain terms are used correctly (Mandatory) Pass Reviewer reads English and knows the software domain; no second reviewer needed.
10 Abbreviations are spelled out on first use, in the stated language (Optional) Pass Abbreviations are expanded on first use in the body (S-IDs and artifact IDs are framework labels).

Overall Verdict

Go-with-conditions — criteria 3 and 4 cannot be checked until DM-001 and the design artifacts exist; the row stays Proposed.

Action Items

Action Owner Due
Delta re-review of criteria 3 and 4 when DM-001 is created in MIL-002 S01 2026-10-15