toolchain - opsplitsen van publication.json

[mvanbrab]

Het zou handig zijn mocht de publication.json kunnen worden opgesplitst. Motivatie:

• minder kans op kruisbevuiling
• beter overzicht van gerelateerde publicaties Suggestie:
• één publication-<...>.json per OSLOthema-<...> repo

[bertvannuffelen]

Ik zou de volgende oplossing voorzien:

de publication.json wordt samengesteld uit de concatinatie van

{thema}.{omgeving}.publication.json

Dus in de productie branch zou de volgende files kunnen

productie.publication.json
openbaardomein.productie.publication.json
erkendestandaarden.productie.publication.json
kandidaatstandaarden.productie.publication.json
ontwerpstandaarden.productie.publication.json

De test omgeving bevat minstens dezelfde files als die in productie, aangevuld met andere publicatiepunten

productie.publication.json
openbaardomein.productie.publication.json
erkendestandaarden.productie.publication.json
kandidaatstandaarden.productie.publication.json
ontwerpstandaarden.productie.publication.json

documentatie.test.publication.json
ontwerpstandaarden.test.publication.json

De oplossing moet wel de volgende invariant detecteren:

Er mogen geen 2 verschillende publicatiepunten voor hetzelfde url gedefinieerd zijn

[bertvannuffelen]

Het process voor publicatie op productie is dan als volgt:

1. bouw klad versie in test.data.vlaanderen.be
2. indien ok, verhuis publicatiepunt naar de target *productie.publication.json
3. maak hiervan een pull request op productiebranch

[mvanbrab]

Bert,

Ik kan je grosso modo volgen en recapituleer even voor een thema xxx.

Ik begin aan een kladversie op de test branch: xxx.test.publication.json De toolchain op de test branch bewaakt dit soort bestandsnamen en genereert dus output op https://test.data.vlaanderen.be/....

Ik ben "er content van" en kopieer (een selectie uit) xxx.test.publication.json, naar (nog altijd op de test branch!): xxx.production.publication.json De toolchain op de test branch bewaakt dit soort bestandsnamen niet en doet dus niets.

Ik maak mijn pull request naar de productiebranch. De pull request wordt aanvaard door iemand met voldoende permissies en dat resulteert in een update op de productie branch van xxx.production.publication.json De toolchain op de production branch bewaakt dit soort bestandsnamen en genereert dus output op https://data.vlaanderen.be/....

Leuk!

Ik zou dan wel streven naar een consequente opsplitsing per thema, en niet zoals in je voorbeelden ook groeperingen maken met "ontwerpstandaarden", "kandidaatstandaarden", "erkendestandaarden" etc.

En oh ja, waarvoor dient het bestand zonder thema-prefix productie.publication.json dan nog?