fix(toolchain): breng drie documenten binnen bereik van de versiepoort (#598) #730

Merged
brenno merged 1 commit from fix/toolchain-drie-documenten-598 into main 2026-07-23 11:33:11 +00:00
Owner

Naloop op #598: de versiepoort keek langs drie documenten heen.

check-toolchain legt de versie-eisen naast .tool-versions, maar kende zeven
bestanden. Deze drie zaten er niet bij en stonden dus nog op 3.44.6 terwijl
de pin al op 3.44.7 staat:

Bestand Regel
docs/CONTRIBUTING_GUIDELINES.md 66
docs/DEVELOPMENT_SETUP_GUIDE.md 26 en 44
docs/TROUBLESHOOTING_GUIDE.md 222

Dat is precies de stille afwijking waarvoor die poort gebouwd is, één ronde
later herhaald — en het bewijst het punt van de poort beter dan wat ook: de bump
werd zorgvuldig gedaan, en er bleven er toch vier liggen.

Waarom ze buiten beeld vielen

De poort herkent een eis aan zijn opmaak: vetgedrukt is een eis,
code-geciteerd is geschiedenis. Die regel is er zodat een correctienotitie die
het oude getal aanhaalt niet meeverandert. Deze drie schreven het getal kaal op,
en vielen daarmee door geen van beide zeven.

Ze zijn nu in die vorm gezet in plaats van dat er drie losse patronen bij kwamen.
Eén regel die je kunt navertellen houdt langer stand dan een uitzonderingenlijst,
en de volgende schrijver leest hem af van wat er staat.

Eén plek kon dat niet. Het uitpakcommando in de opstelgids noemt
flutter_macos_3.44.7-stable.tar.xz, en een bestandsnaam in een codeblok laat
zich niet vetdrukken. Die krijgt een eigen helft in het patroon voor dat ene
bestand, met de reden erbij: een archiefnaam ís een eis — wie hem overtypt haalt
die versie binnen, en dan wijst de handleiding naar de verkeerde download
terwijl de zin erboven klopt.

Negentien eisen in tien bestanden nu (was vijftien in zeven); de telling in de
check-toolchain-uitleg van het Makefile liep mee.

Poorten

make check groen (inclusief check-toolchain: 19 versie-eis(en) in 10
bestanden zijn het eens
), make check-secrets groen, make sast groen (0 op
680 bestanden). De poort één keer rood gezien tegen een teruggezette 3.44.6 in
TROUBLESHOOTING_GUIDE.md, zodat vaststaat dat de drie nieuwe patronen ook
werkelijk iets doen.

Naloop op #598: de versiepoort keek langs drie documenten heen. `check-toolchain` legt de versie-eisen naast `.tool-versions`, maar kende zeven bestanden. Deze drie zaten er niet bij en stonden dus nog op **3.44.6** terwijl de pin al op 3.44.7 staat: | Bestand | Regel | | --- | --- | | `docs/CONTRIBUTING_GUIDELINES.md` | 66 | | `docs/DEVELOPMENT_SETUP_GUIDE.md` | 26 en 44 | | `docs/TROUBLESHOOTING_GUIDE.md` | 222 | Dat is precies de stille afwijking waarvoor die poort gebouwd is, één ronde later herhaald — en het bewijst het punt van de poort beter dan wat ook: de bump werd zorgvuldig gedaan, en er bleven er toch vier liggen. ### Waarom ze buiten beeld vielen De poort herkent een *eis* aan zijn opmaak: **vetgedrukt** is een eis, `code-geciteerd` is geschiedenis. Die regel is er zodat een correctienotitie die het oude getal aanhaalt niet meeverandert. Deze drie schreven het getal kaal op, en vielen daarmee door geen van beide zeven. Ze zijn nu in die vorm gezet in plaats van dat er drie losse patronen bij kwamen. Eén regel die je kunt navertellen houdt langer stand dan een uitzonderingenlijst, en de volgende schrijver leest hem af van wat er staat. **Eén plek kon dat niet.** Het uitpakcommando in de opstelgids noemt `flutter_macos_3.44.7-stable.tar.xz`, en een bestandsnaam in een codeblok laat zich niet vetdrukken. Die krijgt een eigen helft in het patroon voor dat ene bestand, met de reden erbij: een archiefnaam ís een eis — wie hem overtypt haalt die versie binnen, en dan wijst de handleiding naar de verkeerde download terwijl de zin erboven klopt. Negentien eisen in tien bestanden nu (was vijftien in zeven); de telling in de `check-toolchain`-uitleg van het Makefile liep mee. ### Poorten `make check` groen (inclusief `check-toolchain`: *19 versie-eis(en) in 10 bestanden zijn het eens*), `make check-secrets` groen, `make sast` groen (0 op 680 bestanden). De poort één keer rood gezien tegen een teruggezette 3.44.6 in `TROUBLESHOOTING_GUIDE.md`, zodat vaststaat dat de drie nieuwe patronen ook werkelijk iets doen.
`check-toolchain` legt de versie-eisen naast `.tool-versions`, maar kende zeven
bestanden. `CONTRIBUTING_GUIDELINES.md`, `DEVELOPMENT_SETUP_GUIDE.md` en
`TROUBLESHOOTING_GUIDE.md` zaten er niet bij en noemden dus nog 3.44.6 terwijl
de pin al op 3.44.7 stond — precies de stille afwijking waar die poort voor
gebouwd is, één ronde later herhaald.

Waarom ze buiten beeld vielen: de poort herkent een eis aan zijn opmaak — een
**vetgedrukte** versie is een eis, een `code-geciteerde` is geschiedenis — en
deze drie schreven het getal kaal op. Ze zijn in die vorm gezet in plaats van
dat er drie losse patronen bij kwamen. Eén regel die je kunt navertellen houdt
langer stand dan een uitzonderingenlijst, en de volgende schrijver leest de
regel af van wat er staat.

Eén plek kon dat niet: het uitpakcommando in de opstelgids noemt
`flutter_macos_3.44.7-stable.tar.xz`, en een bestandsnaam in een codeblok laat
zich niet vetdrukken. Die krijgt een eigen helft in het patroon, want een
archiefnaam ís een eis — wie hem overtypt haalt die versie binnen, en dan wijst
de handleiding naar de verkeerde download terwijl de zin erboven klopt.

Negentien eisen in tien bestanden nu; de telling in het Makefile-doel liep mee.
Eén keer rood gezien tegen een teruggezette 3.44.6 in TROUBLESHOOTING_GUIDE.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
brenno merged commit a987a68cf3 into main 2026-07-23 11:33:11 +00:00
Sign in to join this conversation.
No description provided.