Elk JSON-item moet een stabiele identificatie, een unieke slak, een publicatiedatum en een wijzigingsdatum hebben. Het bestand moet ook de schemaversie en de eigen updatedatum aankondigen.
Het nuttige antwoord hangt af van het doel van de pagina, de mensen die het mogen wijzigen en de kosten van een fout. Een betrouwbare workflow scheidt redactionele beslissingen, technische uitzendingen en definitieve verificatie in plaats van deze drie stappen in één enkele automatisering te verbergen.
de beslissing om eerst te nemen
versie de gegevens en de structuur ervan. Het toevoegen van een optioneel veld is eenvoudig; Een veld hernoemen of verwijderen vereist expliciete migratie, schijfbesturing en verifieerbare geschiedenis.
een concrete methode
- Wijs een onveranderlijke titel-onafhankelijke identificatie toe.
- Houd gepubliceerde slakken of bereid een omleiding voor.
- Sorteer sleutels consequent om leesbare verschillen te krijgen.
- Controleer duplicaten, typen en datums voor elke commit.
- Label in Git Belangrijke redactionele batches.
cheques voor publicatie
- De bron van de waarheid is expliciet en kan worden hersteld.
- zichtbare URL's, datums en verklaringen die zichtbaar zijn, komen overeen met de uitzendpagina.
- Een menselijke recensent kan de besturing reproduceren zonder verborgen service.
De belangrijkste val
Hergebruik een identifier of regenereer alle slugs en creëer botsingen, verbroken verbindingen en verlies van traceerbaarheid. De identiteit van een artikel mag niet afhangen van een bewerkbaar veld.
Volgende stap aanbevolen
Schrijf een CLI-besturingselement dat artikelen telt, spots dubbele naaktslakken en valideert de vereiste velden in elke taal.
Een wijziging die de versiering waard is
Een team corrigeert de responstijd die in twaalf JSON-artikelen wordt vermeld. Het werkt het bronfeit bij, registreert de twaalf betrokken ID's en controleert vervolgens of titels, datums en links niet per ongeluk zijn gewijzigd. Een bestandsvergelijking voor de release laat precies zien welke antwoorden zijn bewerkt.
Houd voor elk artikel een stabiele ID en valideer JSON vóór implementatie. Een correctie van één zin mag geen nieuwe URL maken of geschiedenis wissen. Noteer waarom de wijziging is aangebracht en wie het heeft goedgekeurd.