ساهم

ترقيعات نقبلها. ترقيعات نرفضها.

عملية مساهمة مفتوحة — ذات رأي بسيط في الانضباط، لا في هويتك أبدًا.

01

اختر شيئًا تعمل عليه

يصنّف المستودع قضايا اللمسة الأولى بوسم good-first-issue. يفرز المشرفون هذه للتأكيد أن النطاق عادل وأن الخطوات واضحة. إن أنهيت واحدة، فاترك وسمها — فهذا يساعد الشخص التالي.

للأعمال الأكبر، افتح نقاشًا أولًا. سنقول نعم، لا، أو ليس بعد، وهذا هو السبب. قول "لا" جزء من احترام وقتك.

02

وقّع التزاماتك

shell# in your local clone
git config user.signingkey YOUR_KEY_FINGERPRINT
git config commit.gpgsign true
git config tag.gpgsign true

نشترط التزامات موقّعة بـ GPG. لا يتعلّق هذا بحراسة البوّابات — بل بإبقاء سلسلة توريد المشروع نزيهة. إن لم يكن لديك مفتاح بعد، فإن ويكي المستودع يرشدك إلى توليد واحد.

سطر التوقيع (sign-off)
يجب أن تنتهي كل رسالة التزام بتوقيع شهادة منشأ المطوّر (Signed-off-by: Name <email>). استخدم git commit -s لإضافته تلقائيًا.
03

اكتب رسالة التزام اصطلاحية

commit messagefeat(lsia): emit telemetry on safe-mode entry

Adds a single counter when the immune-system engine enters safe mode.
The counter is hashed-pattern only and respects the privacy gate.

Refs: #842
Signed-off-by: A. Researcher <a@example.org>

نتّبع مواصفة Conventional Commits للسطر الأول. يشرح الجسد لماذا. يشير التذييل إلى القضايا أو التغييرات ذات الصلة.

04

افتح طلب السحب

تمرّ طلبات السحب عبر ثلاث بوابات آلية ومراجعة بشرية:

  • يتحقّق فحص البناء القابل لإعادة الإنتاج من أن ترقيعك لا يكسر الحتمية.
  • تتحقّق بوابة الخصوصية من عدم إدخال أي مسار بيانات خام.
  • يجب أن تنجح مجموعة اختبارات الوحدة والتكامل.
  • يوافق مراجِعان قبل الدمج. تتطلّب المناطق الحساسة أمنيًا مراجِعًا أمنيًا.
إذا فشلت بوابة الخصوصية
توقّف. أعد قراءة الفرق (diff) بعناية — يفشل الاختبار حين يمكن لمسار شيفرة أن يسرّب معرّفات خام (IP، بريد إلكتروني، IMEI، GPS). الإصلاح يكاد لا يكون أبدًا تعطيل الاختبار.
05

التقدير

تظهر كل مساهمة مقبولة في ملاحظات الإصدار التالي — مع النسب، ما لم تطلب إخفاء الهوية. يُحدَّث ملف AUTHORS تلقائيًا أول مرة تدمج فيها تغييرًا.

للأعمال الأكبر — ميزة كبرى، أو تدقيق، أو ترجمة — يذكرك قيد سجلّ التغييرات بالاسم. النسب المجهول طلب عادي، لا طلب خاص.

06

مدونة السلوك

نتّبع Contributor Covenant 2.1. الهجمات الشخصية والتهديدات وكشف الهوية والتحرّش انتهاكات تستوجب الإزالة الفورية، دون حاجة إلى سلسلة شكاوى. النصّ الكامل في CODE_OF_CONDUCT.md بالمستودع.