Jedes JSON-Element muss eine stabile Kennung, einen eindeutigen Slug, ein Veröffentlichungsdatum und ein Änderungsdatum haben. Die Datei muss auch ihre Schemaversion und ihr eigenes Update-Datum bekannt geben.

Die nützliche Antwort hängt vom Zweck der Seite, den Personen ab, die sie ändern dürfen, und den Kosten eines Fehlers. Ein zuverlässiger Workflow trennt die redaktionelle Entscheidung, die technische Übertragung und die endgültige Verifizierung, anstatt diese drei Schritte in einer einzigen Automatisierung zu verbergen.

Die Entscheidung, zuerst zu treffen

Version Die Daten und ihre Struktur. Das Hinzufügen eines optionalen Feldes ist einfach. Umbenennen oder Entfernen eines Feldes erfordert eine explizite Migration, Laufwerkssteuerung und überprüfbare Historie.

Eine konkrete Methode

  1. Weisen Sie einen unveränderlichen titelunabhängigen Bezeichner zu.
  2. Halten Sie veröffentlichte Schnecken oder bereiten Sie eine Weiterleitung vor.
  3. Sortieren Sie die Schlüssel konsistent, um lesbare Unterschiede zu erhalten.
  4. Überprüfen Sie vor jedem Commit Duplikate, Typen und Daten.
  5. Label in Git wichtige redaktionelle Stapel.

Prüfungen vor der Veröffentlichung

  • Die Quelle der Wahrheit ist explizit und kann wiederhergestellt werden.
  • URLs, Daten und Anweisungen, die sichtbar sind, entsprechen der Broadcast-Seite.
  • Ein menschlicher Rezensent kann die Steuerung ohne versteckten Service reproduzieren.

Die Hauptfalle

Wiederverwenden eines Bezeichners oder Regenerieren aller Slugs verursacht Kollisionen, unterbrochene Links und den Verlust der Rückverfolgbarkeit. Die Identität eines Artikels sollte nicht von einem bearbeitbaren Feld abhängen.

Nächster Schritt empfohlen

Schreiben Sie ein CLI-Steuerelement, das Artikel zählt, doppelte Slugs erkennt und die erforderlichen Felder in jeder Sprache validiert.

A change worth versioning

Ein Team korrigiert die Antwortzeit in zwölf JSON-Artikeln. Es aktualisiert die Quelltatsache, zeichnet die zwölf betroffenen IDs auf und überprüft dann, dass Titel, Daten und Links nicht versehentlich geändert wurden. Ein Dateivergleich vor Release zeigt genau, welche Antworten bearbeitet wurden.

Behalten Sie eine stabile ID für jeden Artikel und validieren Sie JSON vor der Bereitstellung. Eine Ein-Satz-Korrektur sollte keine neue URL oder Löschverlauf erstellen. Notieren Sie, warum die Änderung vorgenommen wurde und wer sie genehmigt hat.

Organisieren Sie den Inhalt einer Website im Laufe der Zeit →