ابدأ مستندات واجهة متعددة اللغات مع تعريفات الحقول: الأسماء والأنواع والوحدات والنطاقات ومعاني القيم الفارغة والمفقودة. تمييز معرفات البروتوكول عن تفسيرات القارئ. ما لم يسمح تعريف الواجهة بذلك، لا تقم بتغيير معرفات الحقول أو قيم التعداد أو رموز الخطأ عند ترجمة اللغة الطبيعية.

احتفظ بالإصدارات والتعيينات للتغييرات

عندما يتغير معنى المعلمة أو الإعدادات الافتراضية أو معالجة الأخطاء أو البنية، قم بتسجيل إصدار الواجهة وقواعد الترحيل. ربط المستندات المترجمة بنفس الإصدار ووضع علامة على الأقسام التي لم يتم تحديثها بعد. احفظ التعريفات والمراجعات والأمثلة السابقة لمنع الخلط بين التعليمات القديمة والجديدة.

تحقق من الأمثلة مقابل الواجهة الفعلية

تحليل الطلبات والاستجابات في البيئة المتفق عليها. التحقق من الحقول والقيم وفروع الخطأ. استخدم معرفات مستقرة لربط تفسيرات الخطأ المترجمة. تحقق من المعلمات المفقودة والقيم غير الصالحة والإصدارات غير المدعومة. قم بالإبلاغ عن الأمثلة المترجمة على أنها تم التحقق منها فقط بعد إجراء عمليات التحقق المقابلة.

تحقق من اللغة واتجاه النص معًا

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

يرى إرشادات التدويل W3C.