تجريبي

تحتوي هذه المجلدة على مساحة دنيا ومنفصلة بوضوح للتكرار السريع على الأفكار الجديدة.

عقد الاستقرار: أي شيء يقع تحت trl.experimental قد يتغير أو يُحذف في أي إصدار (بما في ذلك إصدارات التصحيح) دون أي إنذار مسبق. لا تعتمد على هذه الواجهات البرمجية في أحمال العمل الإنتاجية.

مسار الترقية (البسيط)

1. أنشئ النموذج الأولي خارج المستودع الرئيسي: ابدأ التطوير في فرع خاص بك أو في مستودع منفصل للتكرار بسرعة.
2. إدراج تجريبي: بمجرد أن يصبح جاهزًا للمستخدمين الأوائل، انقل الفكرة إلى trl.experimental.<feature>.
3. تحسين: إضافة اختبارات، وثيقة/مثال قصير، وإظهار طريقة الاستخدام.
4. ترقية: بمجرد إثبات استقرار واجهة برمجة التطبيقات ووجود اهتمام واضح أو تبني من المجتمع، قم بنقلها إلى trl.<feature> (وحدة مستقرة).

الإزالة

تُعدّ Experimental منطقةً مؤقتةً للتجريب، وليست مكانًا للتخزين طويل الأمد: فكل ميزة إما أن تُعتمد أو تُحذف. ولا تتطلب عملية الحذف دورةً للإسقاط، كما هو مبيّن في عقد الاستقرار أعلاه. ويبقى الكود متاحًا في سجل git، كما تبقى مدخلة فهرس الأوراق موجودةً، مشيرةً إلى آخر إصدار شمل التنفيذ.

لا يوجد حدّ أدنى يُطلق عملية الإزالة. بل هو قرار يُتّخذ في طلب الإزالة، مع عرض الأرقام أمام الجميع. ما يقيّمه هذا القرار:

• الاستخدام. بيانات التتبع، ووسوم Hub، والردود على طلب الدمج أو على خيط النقاش. لا يُعد أيٌّ منها حاسماً بذاته، لكن صمت جميعها معاً يُشكّل إشارة قوية.
• المشكلات وطلبات الدمج الخارجية الناتجة عن تشغيل الميزة، على عكس التقارير التي يتم إنشاؤها بفحص الكود.
• ما إذا كان مُدرِّب مستقر يغطي ذلك بالفعل. إذا كان الأمر كذلك، فإن ذلك يتفوق على الاستخدام.
• التكلفة. وقت الاختبار المستمر، الصيانة، عبء الفرز.
• المستهلكون في المراحل اللاحقة. المكتبات التي تستورده.
• المالك. شخص يرغب في ترقية المشروع ومستعد للقيام بالعمل اللازم.
• العمر. ما إذا كان متاحًا لفترة كافية حتى تتمكن المجتمع من اكتشافه وتجربته.

الأسئلة الشائعة

لماذا لا نكتفي باستخدام الفروع؟ لأن الفروع لا تُشحن للمستخدمين؛ أما الكود التجريبي داخل الحزمة فيتيح للمتبكرين في التجربة اختبار الأمور وتقديم ملاحظات.

هل يمكن أن تتغير هذه الواجهات البرمجية أو تختفي دون سابق إنذار؟ نعم. أي شيء داخل trl.experimental يمكن أن يتغير أو يختفي في أي إصدار.

هل يجب عليّ استخدام هذا في بيئة الإنتاج؟ فقط إذا كنت لا تمانع في تحديث كودك بسرعة عند حدوث تغييرات.

هل سيُصلح المسؤولون المشكلات في trl.experimental على الفور؟ ليس بالضرورة. فوحدة التجارب هي مساحة لتجربة أفكار جديدة، وقد لا يُعطي المسؤولون الأولوية لإصلاح الأخطاء أو طلبات الميزات فيها. وقد تبقى المشكلات دون حل حتى (أو ما لم) تتحول الميزة إلى واجهة برمجة التطبيقات المستقرة.

قدّمتُ تنفيذًا لورقة بحثية. هل يمكن إزالته؟ نعم. أي شيء يقع تحت trl.experimental يمكن إزالته، بما في ذلك تنفيذه الورقية. وإذا حدث ذلك، فإن عنصر فهرس الأوراق يبقى ويشير إلى آخر إصدار شمل الكود.

كيف تُسكت تنبيه وقت التشغيل؟

الاستخدام: export TRL_EXPERIMENTAL_SILENCE=1.