Verschil in versie tussen bijlage en in `media/` directory voor linter

[TimvdLippe]

Gerapporteerd door @HenriKorver in developer-overheid-nl/don-site#526 (comment) De twee bestanden komen niet overeen.

We moeten uitzoeken waarom deze bestanden verschillen, want in principe zou Respec de bijlage genereren op basis van het bestand in de media/ directory.

[TimvdLippe]

Volgens mij is dit fout gegaan in Logius-standaarden/publicatie@8e9813a We hebben dit gepatcht naderhand (zonder de publicatie pipeline te draaien), omdat het geen wijziging was op het normatieve document. En omdat we er niet naar linken vanuit het normatieve document.

Echter, we hebben hier de verkeerde versie gepakt. Het had de versie uit de bijlage moeten zijn, niet een andere versie (geen idee welke het toen was, mogelijk die van de werkversie?!).

Volgens mij lossen we dit op door de versie van de bijlage te pakken en die weg te schrijven naar 2.1.0/media/linter.yaml.

[TimvdLippe]

Er draait een nachtelijke synchronisatie. Morgen zal https://gitdocumentatie.logius.nl/publicatie/api/adr/2.1.0/media/linter.yaml hetzelfde moeten tonen als wat er in https://gitdocumentatie.logius.nl/publicatie/api/adr/2.1.0/#spectral-linter-configuration staat

[Hugo-ter-Doest]

Ik heb gecheckt en de ruleset in de documentatie is een andere dan de directe link naar het YAML-bestand. Ook lijkt het me handig om een versienummer in het YAML-bestand te plaatsen.

(ik gebruik de ruleset voor een Common Ground Component Checker waarin API's worden gecontroleerd op compliance met ADR)

[TimvdLippe]

Wat gek, de bestanden staan correct in https://github.com/Logius-standaarden/publicatie/blob/main/api/adr/2.1.0/media/linter.yaml en toch gaat onze publicatie verkeerd. Ik ga contact opnemen met DICTU (die de server beheert) om te achterhalen wat er mis gaat.

[TimvdLippe]

Er is een onderzoek gestart om te kijken wat er mis gaat tijdens het synchroniseren. Het is niet duidelijk hoe lang dat gaat duren eer we er achter komen waar dit mis gaat.