İnsan sayfası, yapılandırılmış veri, kanonik JSON, indirilebilir…

Doğrudan cevap

Her yayın ailesi tek bir kanonik kayıt kümesine bağlanır. İnsan sayfası anlaşılır anlatım; yapılandırılmış veri keşif alanları; kanonik JSON tam makine kaydı; PDF veya DOCX sabit okuma sürümü; API ise programlı erişim sunabilir. Bu yüzeyler kelime kelime aynı olmak zorunda değildir. Fakat kayıt kimliği, soru, normatif statü, ana hüküm, sürüm, tarih, kaynak, lisans ve sınırlamalar için alan düzeyinde eşlik korunur. Farklılıklar eşlik bildirimi içinde izinli özet, erişim sınırı, gecikme veya hata olarak açıklanır.

Sade dille

Bir restoranın duvardaki menüsünü, internet menüsünü ve kasadaki fiyat listesini düşünün. Tasarımları farklı olabilir. Fakat aynı yemeğin adı, fiyatı ve alerjen bilgisi birbirini tutmalıdır. Bir yerde eski fiyat yazıyorsa sorun tasarım değil, gerçeklik çelişkisidir.

Neden önemli?

İnsan başka, AI başka, indirilen dosya başka bilgi görürse hangi sürümün doğru olduğu belirsizleşir. Eski JSON veya eksik API kaydı, düzeltilmiş insan sayfasına rağmen yanlış temsilin sürmesine neden olabilir.

Karıştırma

Sunum farkı, aynı gerçeğin farklı okuyucuya uygun biçimde gösterilmesidir.
İzinli özet, ana anlamı ve sınırı koruyan daha kısa anlatımdır.
Anlam kayması, özet veya dönüşüm sırasında hükmün güçlenmesi, zayıflaması ya da değişmesidir.
Veri gecikmesi, bir yüzeyin yeni sürüme henüz ulaşmamasıdır ve açık statü gerektirir.
Gerçek çelişki, iki yüzeyin aynı alan için bağdaşmayan değerler vermesidir.

Ne yapmalısın?

Kayıt kimliği ve bağlayıcı alanları içeren tek bir kanonik veri kaynağı belirleyin.
Her yüzeyin hangi kanonik alanı nasıl gösterdiğini alan eşleme tablosunda kaydedin.
JSON ve API çıktısını sürümlü şemaya göre doğrulayın; bilinmeyen veya eksik alanı sessizce uydurmayın.
Mümkün olduğunda HTML, JSON, indirme dosyası ve API’yi aynı kilitli kaynaktan üretin.
Yüzey sürümü, üretim zamanı, dosya bütünlük özeti ve kanonik kaydı eşlik bildirimi içinde bağlayın.
Kimlik, hüküm, normatif güç, kaynak, sınır, tarih ve lisans için otomatik eşlik testleri çalıştırın.
Kritik çelişkide yayını durdurun; gecikme varsa etkilenen yüzeyi açıkça eski veya beklemede işaretleyin.

Nasıl denetlersin?

Bütün yüzeyler aynı kayıt kimliği ve sürüm ailesine mi bağlı?
İnsan anlatımı ile makine alanının ana hükmü aynı mı?
Normatif güç bir yüzeyde zorunlu, diğerinde tavsiye olarak mı görünüyor?
Kaynak, tarih, lisans ve sınırlamalar kaybolmuş mu?
JSON ve API geçerli şemaya göre doğrulanmış mı?
İndirme dosyası ile canlı sayfa için sürüm ve dosya bütünlüğü ilişkisi kayıtlı mı?
Gecikmiş yüzey güncelmiş gibi sunulmuş mu?

Sınır

Eşlik, bütün yüzeylerin byte düzeyinde aynı olması değildir. Erişilebilirlik, gizlilik, güvenlik, dosya biçimi veya kullanıcı ihtiyacı bazı ayrıntıların farklı sunulmasını gerektirebilir. Ancak çıkarılan alan maddi anlamı etkiliyorsa bu fark ve gerekçesi görünür olmalıdır.