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.
Diese Felder beschreiben einen vorgeschlagenen redaktionellen Vertrag; der JSON-Standard verlangt weder Slug noch Datum.
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
- Weisen Sie einen unveränderlichen titelunabhängigen Bezeichner zu.
- Halten Sie veröffentlichte Schnecken oder bereiten Sie eine Weiterleitung vor.
- Sortieren Sie die Schlüssel konsistent, um lesbare Unterschiede zu erhalten.
- Überprüfen Sie vor jedem Commit Duplikate, Typen und Daten.
- Label in Git wichtige redaktionelle Stapel.
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.
Dokumentierte Grundlagen zu diesem Thema
| Referenz | Wert oder Syntax | Geltungsbereich |
|---|---|---|
| RFC 8259 · JSON | application/json · UTF-8 | Standard-JSON erlaubt weder Kommentare noch abschließende Kommas; Zeichenfolgen nutzen doppelte Anführungszeichen. |
| WordPress · Tools Export | WXR / XML | Ein WordPress-Inhaltsexport kann Beiträge, Seiten, Inhaltstypen, Kommentare, eigene Felder und Taxonomien enthalten. Der Umfang hängt von Filtern ab. Mediendateien, Theme, Plugins und Konfiguration müssen für eine vollständige Übernahme gesondert geprüft werden. |
| HTTP · If-Match | If-Match: "r7" → 412 | If-Match vergleicht vor dem Schreiben einen starken Validator. Im dargestellten Vertrag erhält eine veraltete Version 412; den Entwurf für den Abgleich behalten. |
Die Daten geben die Prüfung der Quellen an. Diese Hinweise sind weder ein Website-Audit noch eine umfassende Konformitätserklärung.
Prüfwerkstatt: Belege vor der Entscheidung
Vorgeschlagene Übung für einen gewählten Umfang, bei Bedarf mit fiktiven Daten. Notieren Sie Beobachtungen; das Beispiel beschreibt keinen bereits durchgeführten Test Ihrer Website.
- Auszuprobierende Handlung
Korrigieren Sie in einer Arbeitskopie einen JSON-Artikelsatz unter Beibehaltung seiner ID. Vergleichen Sie Daten und erzeugen Sie die Seite erneut.
- Aufzubewahrender Nachweis
Bewahren Sie Diff, JSON-Prüfung und Seitenansicht auf. Kontrollieren Sie Titel, URL, Beziehungen und benachbarte Inhalte.
- Was der Nachweis nicht belegt
Gültiges JSON kann sachlich falsch sein. Eine stabile ID garantiert weder richtige Veröffentlichung noch Wiederherstellung.
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 →