Changelog (NL)

Bij elke nieuwe versie schrijft Coodoo een changelog voor de mensen die je app gebruiken: alleen wat zij merken, in gewone taal. Op de pagina Changelog (knop links) lees je die per versie en per taal, pas je hem aan en laat je ontbrekende stukken schrijven.

Talen kiezen

De talen kies je bij Autopilot-instellingen → Changelog voor gebruikers. De knop Talen kiezen op de pagina brengt je daar meteen heen. Standaard is dat Nederlands. Per taal staat de changelog in een eigen bestand in je project: changelog/nl.md, changelog/en.md enzovoort.

De changelog hoort bij de versies. Staat Versienummers bijhouden uit, dan schrijft Coodoo hem niet en zegt de pagina dat.

De pagina

• Links staan alle versies, de nieuwste bovenaan, met hun datum. Een rood label Geen item betekent dat die versie nog in geen enkele taal een tekst heeft. Een oranje label, bijvoorbeeld Mist EN, noemt de talen die nog ontbreken. Een vinkje betekent dat de versie compleet is.
• Bovenaan staat een tabblad per gekozen taal. Het getal op een tabblad is het aantal versies dat in die taal nog geen tekst heeft.
• In het midden staat de tekst van de gekozen versie in de gekozen taal.

Heeft je project meer onderdelen met een eigen versie, dan kies je het onderdeel naast de titel.

Zelf aanpassen

Klik op Bewerken (of Zelf schrijven als er nog niets staat). Je past de tekst aan met kopjes (### Nieuw) en punten met een streepje (- …). Opslaan zet de tekst in het bestand van die taal, op de plek van die versie.

Laten schrijven

• Opnieuw schrijven laat de agent de tekst van deze versie in deze taal opnieuw maken. Andere talen blijven zoals ze zijn.
• Ontbrekende aanvullen schrijft in één keer alle versies en vertalingen die nog ontbreken. Heeft een versie al een tekst in een andere taal, dan vertaalt de agent die, zodat elke taal hetzelfde zegt.

De agent volgt dezelfde strenge regels als bij een nieuwe versie: alleen wat gebruikers merken, niets over de techniek erachter, geen bestandsnamen, pakketten of versienummers. Een tweede stap haalt technische woorden weg en een vast filter schrapt regels die nog technisch klinken.

Bovenaan de pagina zie je wat de agent doet en hoe ver hij is. Met Stoppen breek je het af. Lukt een versie niet, dan staat er in gewone taal waarom; de andere versies gaan gewoon door.

Vastleggen

Wat je op de pagina verandert of laat schrijven, komt in de bestanden in je projectmap. Commit het met Commit & push op de pagina GitHub, of laat het meegaan met de volgende versie-commit van de autopilot.

Let op: de changelog wordt niet gepubliceerd. Wil je hem in je app of op een website tonen, dan staan de teksten klaar in de map changelog.