Release notes formatter
Plak je notities, één wijziging per regel. Ze worden hier op deze pagina opgeschoond, en er wordt nergens iets naartoe gestuurd.
Probeer een voorbeeld:
Wat het doet
Elke update heeft een paar regels nodig die zeggen wat er veranderd is, en de meeste Mac-apps hebben ze op meer dan één plek nodig: de What's New-tekst in App Store Connect, de release notes die Sparkle in zijn updatevenster toont, en een GitHub-release of een changelogpagina. Deze tool neemt wat je hebt, zoals ruwe notities, een lijst of de regels die git log --oneline afdrukt, en sorteert elke regel in Nieuw, Verbeterd of Opgelost. Hij haalt commit-hashes, prefixen zoals feat: en fix: en pull request-nummers weg, laat regels weg die alleen voor jou tellen, zoals chore-, ci-, docs-, test- en merge-commits, en schrijft drie kopieën die je kunt plakken. Daarna leest hij het resultaat zoals App Review dat zou kunnen doen.
Waar elke kopie heen gaat
| Kopiëren | Waar het heen gaat |
|---|---|
| App Store | What's New in This Version, in App Store Connect. Platte tekst, tot 4.000 tekens. Verplicht voor elke versie na de eerste. |
| Sparkle | In de description van de release in je appcast, omgeven door CDATA, of op een pagina waar sparkle:releaseNotesLink naar verwijst. |
| Markdown | Een GitHub-release, een CHANGELOG.md, of Sparkle 2.9 en nieuwer op macOS 12 en nieuwer, met sparkle:format="markdown". |
Uit te voeren commando's
git log --oneline v2.0..HEAD git log --pretty=format:"%s" v2.0..HEAD
Beide tonen de commits sinds je laatste release-tag, hier v2.0, één per regel. De tweede laat de hashes weg. Plak er een hier, en herschrijf dan elke regel die nog als een briefje aan jezelf leest.
Wat elk resultaat betekent
| Markering | Wat het betekent |
|---|---|
| Oplossen | App Store Connect neemt het niet aan, zoals What's New van meer dan 4.000 tekens. |
| Uiterlijk | Het plakt, maar een regel kan mensen in verwarring brengen of een vraag opleveren bij de beoordeling, zoals een ticketnummer, een bestandsnaam of de naam van een ander platform. |
| OK | Het past en zegt wat er veranderd is. |
| Let op | Wat is bewaard, wat is weggelaten en waar elke kopie heen gaat. |
Bronnen: App Store Connect Help, Platform version information, App Review Guidelines (2.2, 2.3.10 en 2.3.12) en Sparkle, Publishing an update, allemaal gelezen op 13 november 2026.
Zo werkt het
Het zijn een paar eenvoudige tekstregels die op deze pagina draaien. Hij sorteert een regel op het eerste woord of de prefix, dus "Add" en feat: komen onder Nieuw, "Fix" en fix: onder Opgelost, en alles wat hij niet kan plaatsen onder Verbeterd. Een kop in je notities, zoals "Fixed:", sorteert de regels eronder. Hij herschrijft je zinnen niet en kan niet zien of een regel waar of duidelijk is: dat deel blijft van jou. Niets wat je plakt wordt opgeslagen of verstuurd.
Vragen
Hoe lang mogen release notes in de App Store zijn?
What's New in This Version in App Store Connect neemt tot 4.000 tekens platte tekst aan. Het is verplicht voor elke versie na de eerste.
Mag ik gewoon “bugfixes en prestatieverbeteringen” schrijven?
Voor een simpele bugfix, beveiligings- of prestatie-update, ja. App Review Guideline 2.3.12 zegt dat grotere wijzigingen en nieuwe functies in de notities moeten staan.
Hoe voeg ik release notes toe aan een Sparkle-appcast?
Zet HTML in het description-element van de release, omgeven door CDATA, of host een pagina en laat sparkle:releaseNotesLink daarnaar verwijzen. Sparkle 2.9 en nieuwer kan ook Markdown lezen met sparkle:format ingesteld op markdown.
Kan ik git log-uitvoer plakken?
Ja. Commit-hashes, prefixen zoals feat: en fix: en pull request-nummers worden verwijderd, en chore-, ci-, docs-, test- en merge-regels worden weggelaten.
Worden mijn notities ergens naartoe gestuurd?
Nee. Ze worden op deze pagina opgeschoond en er wordt niets verstuurd of opgeslagen.