السياسة العامة

حوكمة التوثيق

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

01

حد عام واضح

هذه البوابة تشرح تشغيل FoodTech للعملاء والفرق. توثيق API وSDK والطلبات والاستجابات يعيش في موقع المطورين المستقل.

02

لا محتوى داخلي

Manager وأدوات فريق FoodTech الداخلية وإجراءات الدعم المميز لا تُنشر هنا. يُسمح فقط بذكر الحد لفهم المنظومة.

03

الدليل قبل الادعاء

كل معلومة تحمل حالة نضج: موثّق، مراجع، أو تأسيسي. لا تُعرض ميزة مخططة كأنها متاحة.

04

الخصوصية افتراضيًا

لا تُستخدم بيانات عملاء حقيقية أو أسرار أو رموز وصول في النصوص واللقطات وأمثلة استكشاف الأخطاء.

دورة النشر

من التغيير إلى الإنتاج

تُدار جودة المحتوى بالطريقة نفسها التي تُدار بها جودة البرمجيات: ملكية، مراجعة، اختبار، إصدار، ورجوع.

  1. 1

    يفتح مالك المحتوى طلب تغيير مرتبطًا بإصدار أو مشكلة.

  2. 2

    يكتب الدليل بهوية ثابتة ويحدث العربية والإنجليزية معًا.

  3. 3

    يراجع مختص المنتج الدقة ويختبر المسار ويُنقّح الأدلة.

  4. 4

    تفشل بوابة النشر إذا غابت لغة أو سُرّب محتوى API أو داخلي.

  5. 5

    يُنشر التغيير تدريجيًا وتبقى النسخة السابقة نقطة رجوع.

BCP 47 · Unicode · RTL/LTR

معمارية قابلة لألف لغة

Stable ID

هوية الدليل مستقلة عن عنوانه ومساره المترجم.

Locale registry

سجل واحد يحدد الرمز والاتجاه والطبقة وحالة الإطلاق.

Fallback policy

لا تُخلط اللغات بصمت؛ يظهر النقص ويُقاس قبل النشر.