Hoe je een productupdate-logboek bijhoudt op basis van officiële bronnen
Een changelog is nuttig wanneer het geen publicaties vastlegt, maar bevestigde wijzigingen in de productstatus: wat is veranderd, voor wie, onder welke voorwaarden en waar dit officieel is vermeld.
Een update-logboek draait om een eenvoudig schema: was → is nu → bewijs. Dit helpt om echte productwijzigingen te onderscheiden van aankondigingen, samenvattingen of eigen interpretaties.
Een entry wordt aangemaakt wanneer je de vorige en nieuwe status kunt vastleggen, aangeven wie dit betreft en een officiële bron kunt toevoegen. Als een van deze elementen ontbreekt, stel je de status van de entry in op ‘verduidelijking vereist’ in plaats van de leemte met gissingen op te vullen.
Koppel bronnen aan hun verantwoordelijkheidsgebied
Stel voor elk product een korte kaart samen van officiële pagina’s en kanalen. Verschillende typen wijzigingen worden doorgaans op verschillende plaatsen bevestigd.
- Releases en functies — updatesectie, releasenotities, documentatie, officiële blog of teamkanaal.
- Prijzen en limieten — prijzenpagina; als betalingsdetails relevant zijn, ook de bijbehorende voorwaarden.
- Gebruiksvoorwaarden en gegevensverwerking — servicevoorwaarden, privacybeleid, specifieke regels voor bepaalde functies.
- Storingen en beschikbaarheid — statuspagina, officiële incidentmeldingen en daaropvolgende verduidelijkingen.
Een officieel kanaal kan snel nieuws brengen, maar bevat niet altijd alle beperkingen. Als een post zegt dat ‘een nieuwe functie beschikbaar is’, maar de documentatie specificeert regio’s, abonnementen of inschakelprocedures, dan is het document met de voorwaarden het primaire bewijs. De post kan als aanvullende link worden bewaard.
Houd entries bij volgens het schema ‘was → is nu → bewijs’
Eén logboekentry beschrijft één wijziging. Voeg velden toe die latere verificatie mogelijk maken:
Gebruik dit entrysjabloon:
- Datum ontdekking: [DD.MM.JJJJ]
- Datum verificatie: [DD.MM.JJJJ]
- Ingangsdatum: [DD.MM.JJJJ of ‘niet gespecificeerd’]
- Was: [vorige status uit officiële bron]
- Is nu: [nieuwe status uit officiële bron]
- Betroffen gebruikers: [abonnement / regio / accounttype / ‘niet gespecificeerd’]
- Voorwaarden en beperkingen: [voorwaarden, limieten, uitzonderingen / ‘niet gespecificeerd’]
- Status wijziging: [aangekondigd / wordt ingevoerd / actief / geannuleerd]
- Actie: [wat moet worden gecontroleerd of aangepast]
- Bewijs: “[letterlijk citaat]”; [screenshot pagina: datum, URL]
- Origineel: [URL van officiële bron]
- Status entry: [bevestigd / verduidelijking vereist / vervangen door verduidelijking]
De status van de wijziging beantwoordt de vraag in welke fase de verandering zelf zit. De status van de entry geeft aan of je voldoende grond hebt om de huidige beschrijving te vertrouwen. Een wijziging kan bijvoorbeeld ‘aangekondigd’ zijn, terwijl de entry ‘bevestigd’ is als de officiële bron de toekomstige voorwaarden expliciet beschrijft. Of een wijziging kan ‘actief’ zijn, maar de entry ‘verduidelijking vereist’ als onduidelijk is welke gebruikers betroffen zijn.
Scheid feit van conclusie
Een significante entry heeft drie lagen:
- Bevestigd feit — wat er letterlijk in het origineel staat.
- Werkconclusie — wat dit voor jou kan betekenen.
- Open vraag — wat de bron niet uitlegt.
Stel dat de officiële tekst meldt dat er een nieuwe instelling is toegevoegd. Feit: ‘instelling toegevoegd’. Conclusie: ‘controleren of dit de huidige workflow wijzigt’. Vraag: ‘is deze beschikbaar op het gebruikte abonnement?’ Noteer deze delen apart, zodat een hypothese niet als bevestigde wijziging oogt.
Onafhankelijke reviews, commentaren of samenvattingen kunnen hints geven waar je moet kijken. Maar ze bevestigen geen prijs, voorwaarden, beschikbaarheid of oorzaak van een incident. Bewaar dergelijke materialen in notities bij de entry en laat in het veld ‘Origineel’ alleen de officiële bron staan.
Werk entries bij na verduidelijkingen
Een aankondiging kan onvolledig zijn en voorwaarden kunnen veranderen. Pas eerdere formuleringen niet stilletjes aan. Maak een nieuwe gerelateerde entry: voeg de datum van de nieuwe verificatie en een link naar de verduidelijking toe. Behoud de oude entry met de status ‘vervangen door verduidelijking’. Als de wijziging is geannuleerd, stel dan in de nieuwe entry de wijzigingsstatus in op ‘geannuleerd’ en bewaar het bewijs van annulering.
Zo blijven in het logboek zowel de oorspronkelijke versie als de reden waarom deze niet langer actueel is zichtbaar. Het logboek beantwoordt twee vragen: wat is nu bekend en op welke bron is dit gebaseerd.