يجب أن يحتوي كل عنصر من عناصر JSON على معرف ثابت وسبيكة فريدة وتاريخ نشر وتاريخ تعديل. يجب أن يعلن الملف أيضًا عن إصدار المخطط الخاص به وتاريخ التحديث الخاص به.
تعتمد الإجابة المفيدة على الغرض من الصفحة ، وسمح للأشخاص بتعديلها وتكلفة الخطأ. يفصل سير العمل الموثوق به القرار التحريري والبث الفني والتحقق النهائي بدلاً من إخفاء هذه الخطوات الثلاث في أتمتة واحدة.
قرار اتخاذ أولا
إصدار البيانات وهيكلها. إضافة حقل اختياري أمر بسيط ؛ تتطلب إعادة تسمية حقل أو إزالته ترحيلًا صريحًا وتحكمًا في محرك الأقراص وسجلًا يمكن التحقق منه.
طريقة ملموسة
- قم بتعيين معرف مستقل عن العنوان غير قابل للتغيير.
- احتفظ بالبزاقات المنشورة أو قم بإعداد إعادة توجيه.
- فرز المفاتيح باستمرار للحصول على اختلافات مقروءة.
- تحقق من التكرارات والأنواع والتواريخ قبل كل التزام.
- التسمية في Git دفعات تحريرية مهمة.
الشيكات قبل النشر
- مصدر الحقيقة واضح ويمكن استعادته.
- تتوافق عناوين URL والتواريخ والبيانات المرئية مع صفحة البث.
- يمكن للمراجع البشري إعادة إنتاج عنصر التحكم بدون خدمة مخفية.
الفخ الرئيسي
إعادة استخدام المعرف أو تجديد جميع الرخويات يؤدي إلى حدوث تصادمات ووصلات معطلة وفقدان إمكانية التتبع. يجب ألا تعتمد هوية المقال على حقل قابل للتحرير.
الخطوة التالية موصى بها
اكتب عنصر تحكم CLI يقوم بحساب المقالات ، ويحدد البزاقات المكررة ، ويتحقق من صحة الحقول المطلوبة في كل لغة.
تغيير يستحق الإصدار
يقوم الفريق بتصحيح وقت الاستجابة المذكور في اثني عشر مقالة JSON. يقوم بتحديث حقيقة المصدر ، ويسجل المعرفات الاثني عشر المتأثرة ، ثم يتحقق من أن العناوين والتواريخ والروابط لم يتم تغييرها عن طريق الخطأ. تُظهر مقارنة الملفات قبل الإصدار بالضبط الإجابات التي تم تحريرها.
احتفظ بمعرف ثابت لكل مقالة وقم بالتحقق من صحة JSON قبل النشر. لا ينبغي أن يؤدي تصحيح الجملة الواحدة إلى إنشاء عنوان URL جديد أو محو محفوظات. سجل سبب إجراء التغيير ومن وافق عليه.