eho/register-referentie
1
0
Fork 0
Code Issues 10 Pull Requests 1 Actions Packages Projects Releases 1 Wiki Activity

docs(architecture): import the FDS architecture decisions from the lab repo #159

New Issue
Closed
opened 2026-09-03 09:27:26 +00:00 by eho · 0 comments
eho commented 2026-09-03 09:27:26 +00:00
Owner
Copy Link
Copy Source

Context

The Innovation Lab repo (Respellion/innovation-lab) holds both the strategic framing of the Open Register / FDS project and its engineer-facing architecture documentation. The engineer-facing part belongs next to the code.

What moves here

From projects/open-register-fd/ in the lab repo, translated to Dutch:

  • adr/0001 … adr/0006, plus the ADR index and template
  • the L3 component view
  • the slice-1 proposal

What stays in the lab repo

The architecture blueprint, the FDS gap analysis and the two privacy views. The OKRs cite them and they feed tender responses.

Numbering

The imported set lands in docs/architecture/fds/, keeping its own 0001–0006 numbering. This repo already owns adr-0001-loose-coupling … adr-0004-bdd-framework in docs/architecture/, so a flat import would collide. The subfolder keeps roughly thirty existing ADR-000N cross-references in the imported text valid without a rewrite.

Also needed

mkdocs.yml has pymdownx.superfences without custom_fences, so the imported mermaid diagrams would publish to Gitea Pages as raw code blocks. The import adds the mermaid custom fence and a nav group.

## Context The Innovation Lab repo (`Respellion/innovation-lab`) holds both the strategic framing of the Open Register / FDS project and its engineer-facing architecture documentation. The engineer-facing part belongs next to the code. ## What moves here From `projects/open-register-fd/` in the lab repo, translated to Dutch: - `adr/0001` … `adr/0006`, plus the ADR index and template - the L3 component view - the slice-1 proposal ## What stays in the lab repo The architecture blueprint, the FDS gap analysis and the two privacy views. The OKRs cite them and they feed tender responses. ## Numbering The imported set lands in `docs/architecture/fds/`, keeping its own `0001`–`0006` numbering. This repo already owns `adr-0001-loose-coupling` … `adr-0004-bdd-framework` in `docs/architecture/`, so a flat import would collide. The subfolder keeps roughly thirty existing `ADR-000N` cross-references in the imported text valid without a rewrite. ## Also needed `mkdocs.yml` has `pymdownx.superfences` without `custom_fences`, so the imported mermaid diagrams would publish to Gitea Pages as raw code blocks. The import adds the mermaid custom fence and a nav group.
eho added the type:chorearea:docs labels 2026-09-03 09:27:26 +00:00
eho closed this issue 2026-09-03 12:35:02 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area:acl
area:bff
area:docs
area:domain
area:event-subscriber
area:infra
area:portal-behandel
area:portal-beheer
area:portal-openbaar
area:portal-self-service
area:projection
area:workflow
type:adr-proposal
type:bug
type:chore
type:slice
No labels area:docs type:chore
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
eho (Edwin van den Houdt)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: eho/register-referentie#159