Tirsvad
be24d8d20b
TirSystem/git-workflows: OpenGrep / opengrep (push) Skipped
TirSystem/git-workflows: Publish wiki / publish-wiki (push) Skipped
TirSystem/git-workflows: Sync GitHub mirror metadata / sync-metadata (push) Skipped
TirSystem/git-workflows: Publish accepted milestones / publish (push) Skipped
TirSystem/git-workflows: Validate / validate (push) Skipped
TirSystem/git-workflows: Validate / validate (pull_request) Successful in 42s
TirSystem/git-workflows: OpenGrep / opengrep (pull_request) Successful in 4m48s
Selenium bot (src/tinder_bot) for the Day 50 lecture steps, unit tests, a mock-site Docker e2e harness for screenshots, and README plus wiki in English, Danish and Bahasa Malaysia.
57 lines
2.5 KiB
Markdown
57 lines
2.5 KiB
Markdown
# Artifact Registry
|
|
|
|
This project's artifact state. Types, short names and `CrossReference
|
|
Candidates` come from the framework catalog
|
|
(`framework/registry/artifact-catalog.md`); this file only records where
|
|
each document lives in *this* project and the next version to use.
|
|
|
|
Delete rows for types you don't use. Add a row the first time you create a
|
|
document of a type. `Primary File` may contain a glob (e.g.
|
|
`docs/use-cases/uc-*/uc.md`); `framework/scripts/find-crossreferences.sh` reads it.
|
|
|
|
| Short Name | Artifact Type | Primary File | Next Available Version |
|
|
| --- | --- | --- | --- |
|
|
| BC | Business Case | docs/business-case.md | 001 |
|
|
| SA | Stakeholder Analysis | docs/stakeholder-analysis.md | 001 |
|
|
|
|
## Languages
|
|
|
|
Set the PO language when the project starts; `project-planning` asks for it
|
|
if it is missing. An artifact of a type marked "Written in the PO language"
|
|
exists once, in that language, under its normal name (`business-case.md`); the
|
|
`artifact` skill ("One file per artifact") has the rule.
|
|
|
|
| Setting | Value |
|
|
| --- | --- |
|
|
| PO language | <language code, e.g. da> |
|
|
| PO domain | <value from the domain list below, e.g. it> |
|
|
| High-level register | IT Executive English |
|
|
| Technical register | IT Professional English |
|
|
| Wiki languages | en and the PO language, at least (`framework/process/wiki.md`) |
|
|
|
|
Every artifact of a type marked "Yes" below states its language and domain in
|
|
its `Language` and `Domain` Metadata rows; `new-artifact.sh` fills them from
|
|
`PO language` and `PO domain`. `Language` is a BCP 47 code (`da`, `en`).
|
|
`Domain` is a value from this list; add a row to introduce a domain, so a
|
|
reviewer can see at once which professional vocabulary a document uses.
|
|
|
|
| Domain | Meaning |
|
|
| --- | --- |
|
|
| it | Software and IT |
|
|
| medical | Healthcare and medical devices |
|
|
| construction | Construction and civil engineering |
|
|
|
|
| Artifact types | Register | Written in the PO language |
|
|
| --- | --- | --- |
|
|
| BC, KPI, PP, MIL | IT Executive English | Yes |
|
|
| SA, BMC, BPMN, UCD, US, UC, SSD, DM, RA, GOV, DICT | IT Professional English | Yes |
|
|
| OC, SD, DCD, ERD, TP, AD, ADR, TM, RC, QC, source code | IT Professional English | No |
|
|
|
|
## Notes
|
|
|
|
- "Next Available Version" is the zero-padded (3-digit) version to use the
|
|
*next* time a new document of that type is created. Increment it only when
|
|
a brand-new document is created, not when an existing document's
|
|
`## Version History` gets a row.
|
|
- `ADR` uses 4 digits (`0001`); `RC` is sequential across all artifact types.
|