Releases aanmaken en beheren

Releaseopmerkingen zijn beschrijvingen die uitleggen wat er nieuw, verbeterd of opgelost is in een specifieke versie. Ze zijn essentieel om wijzigingen aan je gebruikers te communiceren.

• Gebruik duidelijke, beknopte taal.
• Benadruk belangrijke functies en foutoplossingen.
• Markdown-opmaak wordt ondersteund voor uitgebreide tekst.

Releasebestanden zijn bestanden die je aan een release kunt toevoegen, zodat gebruikers ze kunnen downloaden. Dit kunnen onder andere de volgende bestanden zijn:

• Gecompileerde binaire bestanden (bijvoorbeeld .exe, .dmg)
• Gecomprimeerde broncode (.zip, .tar.gz)
• Documentatiebestanden of installatieprogramma's

Ze bieden alles wat gebruikers voor die specifieke versie nodig hebben op één plek.

Zo maak je een release:

1. Ga naar je repository op GitHub.
2. Klik op 'Releases' (vaak in de rechterzijbalk of onder het tabblad 'Code').
3. Klik op de knop 'Draft a new release'.

Hiermee open je een formulier waarin je de details van je release definieert.

Op de pagina voor het maken van een release doe je het volgende:

• Kies een bestaande Git-tag of maak een nieuwe.
• Geef een releasetitel op (bijvoorbeeld 'Versie 1.0.0 - Eerste release').
• Schrijf je uitgebreide releaseopmerkingen.

Je kunt de release markeren als 'pre-release' (om te testen) of deze direct publiceren.

GitHub kan je helpen automatisch releaseopmerkingen te genereren!

Wanneer je op 'Generate release notes' klikt, doorzoekt GitHub de commits en pull requests die sinds de vorige releasetag zijn samengevoegd en stelt het een samenvatting voor. Je kunt die vervolgens bewerken en verfijnen.

Zodra je releaseopmerkingen klaar zijn, kun je bestanden uploaden.

Sleep bestanden eenvoudig naar het aangewezen gebied of klik om te bladeren. GitHub uploadt ze en ze verschijnen als downloadbare bestanden op je releasepagina.

Fouten maken is menselijk! Je kunt een release altijd bewerken of verwijderen.

• Zoek op de pagina 'Releases' de release die je wilt wijzigen.
• Klik op het potloodpictogram om te bewerken of op het prullenbakpictogram om te verwijderen.

Bij bewerken kun je de opmerkingen, titel of bestanden wijzigen. Bij verwijderen verdwijnt de release uit GitHub, maar de onderliggende Git-tag blijft bestaan.

Je hebt geleerd hoe je GitHub Releases maakt en beheert!

• Releases bieden formele momentopnamen van je project met een versienummer.
• Ze zijn gebaseerd op Git-tags en bevatten releaseopmerkingen en optionele bestanden.
• Je kunt releases maken, bewerken en verwijderen via de GitHub-gebruikersinterface.

Zo kunnen gebruikers eenvoudig stabiele versies van je software vinden en downloaden.