Documentatie-eigendom (orthodox-ronl)¶
Status: normatief (juni 2026).
Voorkomt dubbele, uit elkaar lopende specificaties tussen repository's.
Waar hoort wat?¶
| Type documentatie | Canonieke repo | Voorbeelden |
|---|---|---|
| Organisatie-breed, tool-onafhankelijk | bron |
terminologie.md, repo-scripts.md, inhoudslevenscyclus.md, zangstuk-formaat.md, parochie-lokaal zangstukken |
| Org-contracten conversie/export (wat/wanneer) | bron |
conversiemechanismen, exportcontracten, exporttype-/conversiemechanisme-pagina's |
| Tool-specifiek (VSA), incl. CLI man-pages en Hugo-build | VSA-tooling | VSA-syntax, parser, SVG-rendering, Hugo-build, vsa CLI-referentie |
| Product-/gebruikseisen presentatie (dragers, uitgaveprofielen) | VSA-tooling | gebruikseisen-dragers; stub in bron toegestaan |
| Toekomstige andere tool | eigen tool-repo | Alleen wat bij die tool hoort (incl. CLI-howto); link naar bron voor gedeelde termen |
| Parochie-inhoud / demosite | parochie- / VSA-demo | Samenstellingen, lokaal/ — geen normatieve specs dupliceren |
Regels¶
| Regel | Inhoud |
|---|---|
| D1 — één bron | Normatieve org-specs staan alleen in bron/docs/. Andere repo's: link, geen volledige kopie. |
| D2 — stub toegestaan | Een korte stub (≤ ~30 regels) met link naar de canonieke plek is oké (tool→bron of bron→tool) voor discoverability. |
| D3 — wijzigingspad | Wijzig org-brede specs via PR op bron; daarna stubs/links in andere repo's controleren. |
| D4 — terminologie | terminologie.md §0 (R1–R5) geldt overal; zie ook .cursor/rules/orthodox-ronl-terminologie.mdc. |
Cursor-regel (alle org-repo's)¶
Elke repository onder github.com/orthodox-ronl hoort het bestand .cursor/rules/orthodox-ronl-terminologie.mdc in git te hebben (zelfde inhoud).
Gerelateerd¶
- Specificaties — index
- Repo-scripts
- VSA-tooling — tool-specifieke documentatie