طلبات السحب (PRs) هي الطريقة التي تقدّم بها تغييراتك المقترحة على جزء من قاعدة كود Exercism.
إذا كنت تقرأ هذا وتجهّز طلب سحب، فشكرًا لك!
يهدف هذا الدليل إلى مساعدتك في الجانب غير التقني من طلبات السحب، لتحظى بتجربة رائعة وتساعد فريق الصيانة لدينا في الوقت نفسه.
ما الذي تتوقعه
تسير عملية طلبات السحب على النحو التالي:
- تقدّم طلب سحب.
- يراجع مشرف واحد أو أكثر طلب السحب، ويتركون تعليقات تتضمن مقترحات.
وفي بعض الحالات، قد يناقشون طلب السحب ككل، ليتأكدوا مما إذا كان يستحق الإضافة.
- يُدمج طلب سحبك وتُمنح السمعة على الموقع.
أو يُغلق طلب سحبك.
كيف أجعل طلب السحب يُدمج؟
هناك أمور يمكنك فعلها مسبقًا لتزيد فرص دمج طلب سحبك بأقل قدر من التغييرات.
أهم شيء هو أن تتأكد قبل أن تقدّم طلب السحب من أن المشرفين سيرحّبون بالتغييرات التي تجريها.
أسهل طريقة لذلك هي فتح تذكرة على GitHub أولًا، تشرح فيها ما تنوي فعله وتسأل إن كان المشرفون منفتحين على تلك التغييرات.
إذا وجدت مهمة على موقع Exercism، فلا حاجة إلى فتح تذكرة جديدة.
يمكنك التعليق على التذكرة الموجودة لتقول إنك ستعمل عليها ثم تمضي قدمًا.
الأمر الثاني الذي يجب الحرص عليه هو ترك وصف واضح داخل طلب السحب عند فتحه.
فطلبات السحب التي لا تحتوي على وصف مزعجة للغاية للمشرفين، لأنهم لا يملكون سياقًا عند قراءة الكود.
أخبرنا لماذا أجريت التغييرات، وضع رابطًا للتذكرة التي يتعلق بها طلب السحب، واشرح أي مقايضات اضطررت إليها، وهكذا.
وأخيرًا، تأكد من أن طلب سحبك يحتوي فقط على تغييرات تتعلق بتحسين واحد.
إذا كان لديك عدة تحسينات، فقسّمها على عدة طلبات سحب.
هذا يجعل مراجعة المشرفين أسهل وأسرع، وسيجعل حياتك أسهل أيضًا.
كم من الوقت عليّ أن أنتظر؟
عادةً ما يراجع المشرفون طلب سحبك في غضون أيام قليلة.
من فضلك لا تُكثر من إضافة تعليقات إضافية على طلب السحب خلال الأسبوع الأول؛ فمشرفونا متطوعون ومشغولون، وسيأتون إلى مراجعته في أقرب وقت يستطيعون.
إذا لم تحصل على رد خلال 7 أيام، فضع إشارة إلى @exercism/reviewers في تعليق جديد على طلب السحب، وسيُنبه ذلك فريقًا أوسع إليه.
شكرًا لك مرة أخرى على مساهمتك في Exercism.
نأمل أن تكون تجربة ممتعة ومفيدة!
