Verschil tussen release en head van main

[Tomeriko96]

Naar aanleiding van issue cedanl/1cijferho#52 wil ik even in de groep gooien hoe we naar releases kijken vs. de head van main.

Mijn idee van een best practice:

• Een release is wat een gebruiker echt zou moeten downloaden/gebruiken: stabiel, getest, voorzien van tag/versienummer, en via workflows gekoppeld aan een build, executable of package. Zie hiervoor ook de PR voor studentprognose Maak een .exe bestand aan studentprognose#21
• De head van main is gewoon de laatste stand van de code: meestal wel bruikbaar, maar meer voor ontwikkelaars dan voor eindgebruikers, en niet per definitie “productie‑klaar”.

Het lijkt mij daarnaast handig om in de README’s van onze projecten expliciet te verwijzen naar de releases voor eindgebruikers.

Ter discussie

• Zien jullie dit ook zo?
• Welke extra checks (tests, QA, documentatie, changelog) vinden jullie minimaal nodig voor een release?

@cedanl/admin

[Muhammet369]

Versioning afspraken met elkaar. Denk aan
v1.1.2 (major.minor.patch)

Voor de rest zie ik het idd ook zo

[aslamht]

Ik ben er mee eens

[SKvdV]

Klinkt logisch en goed.

[CorneeldH]

Ik vind het prima, de releases kunnen we eventueel ook via andere wegen aanbieden dan github. Wat ik me wel afvraag bij head van main, als we met branchen en pull requests werken dan zijn dingen op main toch stabiel en getest.

Waar zit het verschil? Is het bijvoorbeeld dat we bepaalde workflows alleen willen doen bij releases?

[Tomeriko96]

Inderdaad, ik zit zelf met het idee een nieuwe release van github triggered een workflow die publiceert naar pypi. Zo is de canonieke versie altijd de versie die de gebruiker ziet van het package. Zo kan je ook beter is issues refereren naar versie als er een issue is.

Bijvoorbeeld in eencijferho v1.12 ipv dat een gebruiker zegt ja main van een tijdje terug of dat de gebruiker gaat zoeken welke commit message.

[CorneeldH]

mbt eencijfer had je ook vraag gesteld van eerdere jaren. Is dat hiermee te integreren?

Dat we ipv versies 0, 1, 2 en 3, 2024, 2025 etc doen. Dus 2025.1.0?

[SKvdV]

Als je een update doet in januari van een nieuw jaar op een versie van het jaar ervoor, krijgt deze dan ineens een nieuw jaar toegewezen? Dan is het de versie van 2025, maar in 2026 is er iets aan gewijzigd, blijft het dan de 2025 of wordt het dan 2026?