إجابة مباشرة
يحمل كل نص بشري ومخطط بيانات وحزمة ملفات منشورة إصداراً. صنّف بصورة منفصلة التغيير غير الجوهري مثل تصحيح إملائي، والحقل أو الشرح الجديد المتوافق مع الإصدارات السابقة، والتغيير الكاسر الذي يعطل حقلاً أو حكماً أو سلوك مستهلك قائم. لا تكتب فوق إصدار أقدم بصمت عند تغيير كاسر. انشر مخططاً جديداً مع سجل تغييرات وقائمة سجلات متأثرة وربط ترحيل من القديم إلى الجديد واختبار توافق وتاريخ إهمال تدريجي وعلاقة أرشيفية.
بلغة بسيطة
فكر في خريطة طرق مدينة. تصحيح خطأ إملائي في اسم شارع يختلف عن إغلاق جسر وفتح طريق جديد. يحتاج مستخدمو المسار الجديد إلى تاريخ وبديل والنقطة التي تبقى الخريطة القديمة صالحة حتى بلوغها.
لماذا يهم؟
قد يؤدي حذف حقل أو تغيير حكم بصمت إلى قراءة التطبيقات القديمة البيانات خطأً وإنشاء أحكام مختلفة بين اللغات. ولا يكفي رقم الإصدار؛ يجب معرفة الأثر ومسار الترحيل.
لا تخلط
- التصحيح الإملائي تغيير تحريري لا يغير المعنى الجوهري.
- توفر الإضافة المتوافقة حقلاً أو خياراً جديداً من دون تعطيل المستهلكين الأقدم.
- قد يجعل تغيير مخطط كاسر مستهلكاً أقدم يعمل خطأً أو بنقص.
- يغير التغيير المعياري ما هو مطلوب أو محظور؛ وليس مجرد تغيير تقني في المخطط.
- الإهمال التدريجي دورة حياة لها نهاية معلنة ومسار ترحيل، لا حذف فوري لحقل.
ماذا تفعل؟
- عرّف الحقول العامة والسجلات المعيارية وعقود الملفات بصيغة ذات إصدار.
- صنّف كل تغيير تحريرياً أو متوافقاً أو كاسراً أو معيارياً أو أمنياً.
- اذكر في سجل التغيير الحقل المتغير والسبب والسجلات المتأثرة والتاريخ وصاحب القرار.
- اربط إصدارات الإنسان وJSON والمخطط وAPI وPDF واللغات ببيان إصدار واحد.
- قدّم للتغيير الكاسر ربط حقول من القديم إلى الجديد ومثال تحويل وأداة أو تعليمات ترحيل.
- أعلن تحذير الإهمال ومدة الدعم وتاريخ الإزالة ومسار الرجوع الآمن.
- اختبر التوافق مع أمثلة أقدم، وتحقق من المخطط والتكافؤ بأمثلة جديدة، وأرشف الإصدار بصورة لا تتغير.
كيف تدقّق؟
- هل فئة التغيير وأثره الجوهري صريحان؟
- هل يدل رقم الإصدار على الإصدار نفسه في كل سطح؟
- هل أُخفي تغيير كاسر بوصفه تصحيحاً بسيطاً؟
- هل سجل التغيير والسجلات المتأثرة ومسار الترحيل كاملة؟
- هل اختُبر التوافق مع المستهلكين والملفات الأقدم فعلاً؟
- هل للحقل المهمل تاريخ وتحذير وبديل؟
- هل الإصدار القديم متاح بلا تغيير ومرتبط بالجديد؟
الحد
توفر أنماط الترقيم مثل MAJOR.MINOR.PATCH إشارة مفيدة إلى التغيير؛ لكنها لا تثبت التوافق. وقد يؤثر التغيير نفسه في كتاب وقاعدة معيارية ومجموعة بيانات وAPI بصورة مختلفة. وقد تقصر ضرورة أمنية أو قانونية مدة الترحيل، لكن يجب تسجيل السبب والأثر.
تذكّر في جملة
الإصدار الجديد ليس رقماً جديداً فقط؛ بل وعداً مفسراً بشأن التغيير.
مصادر هذا السجل
- S07W3C, *JSON-LD 1.1*معيار
- S14DataCite, *Versioning*بنية تحتية للهوية
- S15DataCite, *Connecting Versions with Related Identifiers*بنية تحتية للهوية
- S35W3C, *PROV-O: The PROV Ontology*معيار
- S53JSON Schema, *Specification — Draft 2020-12*مواصفة تقنية مفتوحة
- S54*Semantic Versioning 2.0.0*مواصفة مفتوحة لإدارة الإصدارات
- S58Zenodo, *About Records*وثائق مستودع رسمية