الخلاصة

  • يقرر RFC 9907، وهو أفضل ممارسة حالية BCP 216 الصادر في مارس 2026، إرشادات مؤلفي ومراجعي المواصفات التي تحتوي نماذج بيانات YANG، بما فيها الوحدات التي تديرها IANA.
  • يلغي RFC 8407 ويحدّث RFC 8126، ويعامل جودة النص والشفرة المضمّنة والتتبع الإصداري وإجراءات السجل باعتبارها أدلة مراجعة قبل النشر.
  • لا يغيّر بروتوكولاً سلكياً ولا يضمن توافق التطبيقات؛ قوته التشغيلية هي جعل الغموض قابلاً للاكتشاف قبل أن يتحول إلى سلوك إدارة متباين.

النموذج البياني لـ YANG هو وصف مجرد للبيانات والعلاقات والقواعد. أما الوحدة فهي ملف YANG يطبق جزءاً من ذلك النموذج؛ فلا ينبغي الخلط بين النموذج والوحدة الفردية أو بين مثال توضيحي ووحدة معيارية. وتبدأ المشكلة العملية من هنا: قد يمر الملف محلل اللغة، لكن يظل غير واضح متى تنشأ البيانات أو تُحذف، وأي مخزن بيانات يحملها، ومن يملك تعديل السجل الذي يعرّفها.

يفرض RFC 9907 على الوحدات والوحدات الفرعية المعيارية أن تُحاط بعلامتي CODE BEGINS وCODE ENDS. هذه ليست زينة تحريرية؛ فهي تحدد حدود مكوّن الشفرة الذي يراجعه القارئ ويتتبعه. كما يجب أن تكون أسماء الوحدات المنشورة فريدة، وأن تبدأ الوحدات المعيارية في IETF بـ ietf-، بينما تستخدم الوحدات المثالّية example-. المثال يشرح الفكرة ولا يصبح بذلك معياراً واجب التطبيق.

وتتضمن ترويسة الوحدة بيان حقوق النشر الحالي لصندوق IETF Trust، وتعرّف سجل YANG Parameters. أما المراجع الخارجية، فلا تُترك في نثر الوثيقة إذا كان ينبغي أن تكون داخل عبارات reference في الوحدة. ولكل مراجعة منشورة بيان revision يحدد الوثيقة التي تحتوي الوحدة. هكذا تصبح الشفرة المستخرجة أثراً قابلاً للتدقيق، لا مقتطفاً بلا أصل.

تتطلب المراجعة أيضاً قراءة الدلالات في ضوء YANG 1.1 وعمارة مخازن إدارة الشبكة المعتمدة على الحالة التشغيلية (NMDA). لا يكفي وصف المسار؛ يجب أن يتبين للقارئ الفرق بين التهيئة والحالة التشغيلية، ومتى تكون القيمة قابلة للقراءة أو الكتابة، وما الذي يحدث عبر دورة حياة المورد. كما ينبغي فحص اللغة، والأمثلة، وتحليل الأمن، واعتبارات IANA. المثال وسيلة إيضاح، وتحليل الأمن وصف للمخاطر والضوابط، وكلاهما لا يحل محل الدلالة المعيارية.

في الوحدات التي تديرها IANA، تكون سياسة السجل هي المرجع الحاكم. لا يجوز معالجة اختلاف في نص وحدة مولدة بتحرير النص الناتج على نحو اعتباطي؛ بل يجب تحديد الإجراء، والجهة المخولة، وشروط التغيير في اعتبارات IANA وفق الإرشادات العامة في RFC 8126 والتحديث الذي أدخله RFC 9907. السلطة هنا للعملية والسجل، لا لنسخة تم توليدها في لحظة ما.

قائمة مراجعة ما قبل النشر

  1. هل فُصلت كل مكونات الشفرة بعلامتي CODE BEGINS وCODE ENDS؟
  2. هل الاسم فريد، وبادئته ietf- للوحدة المعيارية أو example- للمثال؟
  3. هل تشتمل الترويسة على بيان Trust وسجل YANG Parameters؟
  4. هل وُضعت المراجع الخارجية في عبارات reference المناسبة؟
  5. هل تربط كل مراجعة منشورة بالوثيقة التي تحتويها؟
  6. هل فُصل نموذج YANG عن الوحدة الفردية، ووُسم المثال بوضوح على أنه غير معياري؟
  7. هل تشرح الدلالة مخازن NMDA والتهيئة والحالة ودورة الحياة؟
  8. هل راجع الفريق الأمثلة واللغة وتحليل الأمن واعتبارات IANA؟
  9. هل تتبع أي تغيير في وحدة تديرها IANA إجراء السجل، بدلاً من تعديل النص المولد مباشرة؟

قرار القبول للمشغّل

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

المصادر