Skip to content

Commit cca2328

Browse files
[docs](convention): use "Section" not "§" in DECISIONS.md / EXTENDING.md
Brings the two new root docs in line with the repo's no-§ convention (link targets unchanged). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 0c6b28a commit cca2328

2 files changed

Lines changed: 5 additions & 5 deletions

File tree

DECISIONS.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,14 @@ few notable interpretations. The model values themselves are canonical — see t
88
## Model
99

1010
- **D4/D5 `qaFit` were not invented here.** The Build Spec left them "to assign & document," but
11-
they are already ratified in [Model Data Sheet §4](docs/03-blueprint/model-data-sheet.md)
11+
they are already ratified in [Model Data Sheet Section 4](docs/03-blueprint/model-data-sheet.md)
1212
(interim, ADR-0001). `src/config/dimensions.ts` reproduces those exact vectors.
1313
- **Cost & operational-complexity indicators** (`src/config/costOps.ts`) are **defensible expert
1414
defaults**, not values from the Model Data Sheet (the prototype shows none). Chosen profile per
1515
D1 option: Layered/Monolith/Modular-Monolith = ops *low* / infra *low*; Microservices = *high* /
1616
*high*; Serverless = *med* / *med* (scales to zero but variable + lock-in). Editable like any
1717
config; an independent reviewer may revise.
18-
- **Display normalization** is `round(composite / 5 × 100)` (Scoring Algorithm §7), **not** min-max
18+
- **Display normalization** is `round(composite / 5 × 100)` (Scoring Algorithm Section 7), **not** min-max
1919
— min-max would always show the worst option as 0 and exaggerate small gaps.
2020
- **`migrationPathChosen` is kept `false`** in the anti-pattern engine so the `legacy-without-plan`
2121
rule still fires; the migration card is informational guidance, not a model input.
@@ -52,7 +52,7 @@ few notable interpretations. The model values themselves are canonical — see t
5252
know" narrative, per-option blurbs, migration steps, and short radar labels were ported from the
5353
prototype (English) and **translated to Indonesian** to match. The 3 factor questions and 4 QA
5454
labels shown in the prototype are verbatim; the rest follow the same register. Indonesian copy is
55-
**interim** — a professional translator review is welcome (charter §14.2).
55+
**interim** — a professional translator review is welcome (charter Section 14.2).
5656
- **Canonical bilingual content** (factor labels/levels/help, option names, anti-pattern messages,
5757
fitness templates, risks) is reproduced verbatim from the Model Data Sheet and Option Content
5858
Sheet — see [EXTENDING.md](EXTENDING.md) for where each lives.

EXTENDING.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ edit data, not UI.
2121
| Factor → QA influence matrix | `src/config/factorQaMatrix.ts` | `budget` is inverted in the engine — don't add a sign here |
2222
| Dimension options + `qaFit` | `src/config/dimensions.ts` | Vectors in `QA_ORDER`; option order = tie-break order |
2323
| Default factor levels | `src/config/defaults.ts` | All 0 except `ttm:1`, `budget:2` |
24-
| Scenario presets | `src/config/presets.ts` | Full 14-level sets; must hit the SRS §5.3 targets |
24+
| Scenario presets | `src/config/presets.ts` | Full 14-level sets; must hit the SRS Section 5.3 targets |
2525
| Anti-pattern rules | `src/config/antiPatterns.ts` | Pure predicate over factors + selected options |
2626
| Fitness-function templates | `src/config/fitnessFunctions.ts` | One per QA |
2727
| Risk register data | `src/config/risks.ts` | Keyed `"<dim>:<optId>"`; ported from the Option Content Sheet |
@@ -54,4 +54,4 @@ npm run lint && npm run build # types + lint + production build
5454
```
5555

5656
If a model change breaks a preset target, **adjust the preset levels — not the targets** — and
57-
re-run, per the Model Data Sheet §6.
57+
re-run, per the Model Data Sheet Section 6.

0 commit comments

Comments
 (0)