Zo bouw je een changelogpagina: items, tags, RSS en ‘Wat is er nieuw’

Een changelogpagina is een gedateerde lijst van wat er in je product is veranderd, nieuwste eerst, geschreven voor de mensen die het gebruiken. Om er een te bouwen heb je items nodig met een datum, een duidelijke titel, een korte uitleg en een tag (Nieuw, Verbeterd, Opgelost), een pagina die ze toont, een eigen URL per item, en idealiter een RSS-feed en een manier om gebruikers te laten weten dat er iets nieuw is. Het is een van de eenvoudigste dingen om te bouwen, en de belangrijkste keuze is waar de items staan: als bestanden in je site, of in een database met een beheerpagina.

Waarom een changelog de moeite waard is

Een changelog laat klanten en potentiële klanten zien dat het product wordt onderhouden. Het geeft support en sales een link om te sturen als iemand vraagt „kan het al X?”. Het is ook een plek om de feedbacklus te sluiten: wanneer een gevraagde functie live gaat, is het changelog-item wat je mensen laat zien. Als je een portaal voor klantfeedback draait, link je opgeleverde verzoeken direct naar hun items.

Een changelog is niet je interne commitgeschiedenis. „Facturatieservice herschreven” zegt een gebruiker niets. „Facturen tonen nu het btw-nummer van je bedrijf” wel.

Wat de pagina nodig heeft

Inhoud per item

Pagina’s

• Changelog-overzicht: nieuwste eerst, met tagfilters en eenvoudige paginering of „meer laden”.
• Itempagina: één item per URL, zodat het gedeeld en gelinkt kan worden.
• RSS- of Atom-feed: laat mensen en tools updates volgen zonder e-mail.
• Beheerpagina (alleen in de databaseversie): items schrijven, voorbeeld bekijken, inplannen en publiceren.

Extra’s in de app

• „Wat is er nieuw”-badge: een stip bij een menu-item wanneer er items zijn die de gebruiker nog niet heeft gezien. Sla de datum van het laatste item dat ze openden op, per gebruiker of in de browser.
• E-mailsamenvatting: een overzicht dat wordt gestuurd naar gebruikers die zich hebben aangemeld. Dit vraagt om een verzendprovider; zie hoe je e-mails vanuit je app verstuurt.

De belangrijkste keuze: bestanden of database

Items als bestanden in de site

Elk item is een Markdown-bestand in het project. Een item publiceren betekent een bestand toevoegen en opnieuw deployen. Dit is de eenvoudigste en meest robuuste aanpak: geen database, geen beheerlogin, niets om te beveiligen, en pagina’s kunnen vooraf worden gerenderd zodat ze snel laden en makkelijk leesbaar zijn voor zoekmachines.

Dit past bij teams waarin de mensen die items schrijven er prima mee om kunnen een AI-bouwer iets te vragen of een bestand te bewerken.

Items in een database met een beheerpagina

Items staan in een tabel, en een privébeheerpagina laat iedereen in het team schrijven, voorbeeld bekijken, inplannen en publiceren. Dit past bij teams waarin marketing of support updates schrijft, of waar je geplande publicatie of items per doelgroep wilt (bijvoorbeeld alleen enterprisefuncties tonen aan enterpriseklanten).

De prijs is meer werk om te bouwen en te onderhouden: een beheerlogin, uploads van afbeeldingen, en zorgen dat de openbare pagina’s nog steeds door zoekmachines te lezen zijn, wat niet vanzelf geldt voor een pagina die items alleen in de browser laadt.

Items schrijven die mensen lezen

• Begin met het voordeel. „Rapporten exporteren naar Excel” werkt beter dan „Nieuwe exportmodule”.
• Zeg voor wie het is. Alle abonnementen, alleen Pro, deze week uitgerold.
• Laat het zien. Eén screenshot of een korte clip.
• Groepeer kleine reparaties. Een wekelijks item „Reparaties en verbeteringen” met opsommingstekens voorkomt dat de pagina overspoeld raakt.
• Wees eerlijk over verwijderingen. Als iets verdwijnt, zeg wanneer en wat je in de plaats kunt gebruiken.

Een eerste prompt die werkt

Voeg een openbare changelog toe aan onze site op /changelog. Elk item is een Markdown-bestand met een titel, datum, tag (Nieuw, Verbeterd of Opgelost), optionele omslagafbeelding en tekst. De overzichtspagina toont items nieuwste eerst, met datum, tag en de eerste alinea, heeft tagfilterknoppen, en toont 10 items per pagina. Elk item heeft een eigen pagina op /changelog/<slug> met een goede paginatitel en beschrijving voor zoekmachines. Voeg een RSS-feed toe op /changelog/rss.xml. Maak drie voorbeelditems. Pas het ontwerp van de bestaande site aan, houd het leesbaar op telefoons, en render de pagina’s vooraf zodat ze snel laden.

Voor de databaseversie vervang je de eerste zin door: „Bewaar items in een database met concept/gepubliceerd-status en een publicatiedatum, en voeg een met wachtwoord beveiligde beheerpagina toe om ze te schrijven, voorbeeld te bekijken en te publiceren.”

Bouwstappen

1. Bepaal bestanden of database met de tabel hierboven.
2. Bouw de overzichts- en itempagina’s met een paar voorbeelditems.
3. Voeg tags en filters toe.
4. Voeg de RSS-feed toe en link ernaar vanaf de pagina.
5. Voeg paginatitels, beschrijvingen en een sitemap-regel toe voor elk item. Onze gids over SEO voor met AI gebouwde websites behandelt de basis.
6. Beheerpagina en login, als je voor de databaseroute hebt gekozen.
7. „Wat is er nieuw”-badge in je app.
8. Schrijf echte items voor de afgelopen maanden, zodat de pagina niet leeg start.

Veelgemaakte fouten

• Commitberichten kopiëren. Schrijf voor gebruikers, niet voor ontwikkelaars.
• Eén grote pagina zonder URL per item. Niemand kan naar een specifieke wijziging linken, en zoekmachines zien één pagina in plaats van veel.
• Updates stoppen na een maand. Een changelog die al een jaar niet is bijgewerkt, wekt de indruk van een verlaten product. Kies een ritme dat je kunt volhouden.
• Items alleen in de browser laden. Zoekmachines en linkvoorvertoningen zien dan misschien een lege pagina. Render vooraf of op de server.
• Incidenten mengen. Storingen horen op een statuspagina, niet in de changelog.

Wanneer een gehoste changelogtool de betere keuze is

Er bestaan gehoste changelog- en productupdatetools, en sommige zijn gebundeld met feedbackborden of widgets in de app. Ze zijn het waard als je een pop-up in de app, doelgroepselectie en analyse wilt zonder die zelf te bouwen, of als je team al een tool betaalt die er een bevat. Het format van je blog- of helpcentersoftware kan ook al geschikt zijn.

Zelf bouwen heeft zin als je de changelog op je eigen domein wilt, in je eigen ontwerp, en volledig indexeerbaar. Voor een eenvoudige lijst met gedateerde berichten is dat niet veel werk.

Bouwen met Mythex

Bij Mythex kun je de agent vragen een changelog aan een bestaand project toe te voegen of hem als eigen kleine site te bouwen, en het live te zien terwijl het wordt gebouwd. De bestandsversie heeft geen database nodig. Kies je voor de beheerversie, dan voegt de agent een eigen Postgres-database toe wanneer items moeten worden opgeslagen (of typ /database), en screenshots gaan in de bestandsopslag van het project. Inloggen voor het beheer voeg je toe met je eigen authenticatieaanpak (recept voor inloggen).

Nieuwe Mythex-apps zijn vaak client-gerenderde single-page-apps, en het SEO-recept merkt op dat die zwakker zijn voor zoekmachines. Vraag dus om statische of vooraf gerenderde changelogpagina’s als je wilt dat items in zoekresultaten worden gevonden. Hetzelfde recept behandelt titels, beschrijvingen en sitemaps. Voor een startpunt met een ingebouwde changelog, zie de sjabloon productkennishub.

Veelgestelde vragen