طلب السحب (PR) هو إحدى ميزات GitHub التي تسمح لك باقتراح تغييرات على مستودع ليس لديك حق الوصول للكتابة إليه. يمكن لمشرفي المستودعات مراجعة هذه التغييرات ، وإذا اختاروا دمجها في المستودع الأصلي.
يعد فتح طلبات السحب على GitHub أمرًا بالغ الأهمية في المساهمة في المشاريع مفتوحة المصدر والتعاون مع المطورين الآخرين. تعرف على كيفية إنشاء وفتح طلب سحب على GitHub في بضع خطوات سهلة.
الخطوة 1: تقسيم المستودع
Forking المستودع على منصة جيثب يُنشئ نسخة - تُعرف أيضًا باسم "fork" - من هذا المستودع ، ضمن حسابك. يتيح لك عمل المستودع إجراء تغييرات على الكود دون التأثير على المستودع الأصلي.
لتقسيم مستودع ما ، انتقل إلى صفحته الرئيسية وانقر فوق ملف شوكة زر في الزاوية اليمنى العليا:
أدخل اسم المستودع (fork) ووصفًا اختياريًا وانقر إنشاء شوكة:
لقد قمت الآن بإنشاء نسخة من المستودع الأصلي. يحتوي هذا المستودع الجديد على اتصال بالأصل بحيث يمكن مقارنة أي تغييرات تجريها على الكود بسهولة ودمجها مرة أخرى.
الخطوة الثانية: إجراء تغييرات على المدونة
بعد الانتهاء من المستودع ، قد تحتاج إلى استنساخه إلى جهازك المحلي ، اعتمادًا على مقدار وطبيعة التغييرات التي ترغب في اقتراحها. إذا كنت تجري تغييرات بسيطة للغاية لا تحتاج إلى اختبارها ، فيمكنك إجراء ذلك عبر الإنترنت باستخدام محرر GitHub المستند إلى الويب.
لنسخ مستودع إلى جهازك المحلي باستخدام Git ، قم بتشغيل هذا الأمر الطرفي:
شخص سخيف استنساخ
يستبدل باستخدام عنوان URL للمستودع الخاص بك - يمكنك العثور عليه على GitHub. سيؤدي هذا الأمر إلى استنساخ المستودع إلى جهازك المحلي ، حيث يمكنك تجربة التعليمات البرمجية وإجراء تغييرات عليها بحرية.
يجب أن تحافظ على تغييراتك صغيرة ومركزة ، حيث قد تكون طلبات السحب الكبيرة صعبة للمراجعة والدمج. حاول أن تجعل تغييراتك محددة لمشكلة أو ميزة واحدة ، لتسهيل قيام المشرفين بمراجعتها وقبولها.
بعد إجراء التغييرات المطلوبة محليًا ، قم بإلزامها وادفعها إلى مفترق GitHub الخاص بك باستخدام Git.
الخطوة 3: فتح طلب سحب
بعد تنفيذ التغييرات على GitHub ، يجب أن ترى رسالة فورية تنبهك إلى أن فرعك عبارة عن عدد من "الالتزامات" قبل المستودع الذي تفرقته منه ، على سبيل المثال:
انقر على يساهم اسقاط. سيطالبك النقر فوق هذا الزر بفتح طلب سحب. ثم ، انقر فوق فتح طلب السحب زر:
تحتوي بعض المستودعات على إرشادات مساهمة محددة ، والتي يمكنك أن تجدها عادةً في ملف CONTRIBUTING.md ، والتي تحتاج إلى اتباعها. تأكد من قراءة واتباع هذه الإرشادات قبل إرسال طلب سحب.
بعد ذلك ، املأ الحقول المطلوبة وانقر فوق إنشاء طلب سحب زر:
يجب أن تكون رسالة الالتزام واضحة وموجزة ، وتصف التغييرات التي أجريتها والأسباب الكامنة وراءها. سيساعد ذلك المشرفين على فهم التغييرات التي أجريتها ويسهل عليهم مراجعة الكود.
بمجرد إنشاء السحب ، ستحتاج إلى الانتظار حتى يقوم مشرفو المشروع بمراجعته ودمجه أو إغلاقه. قد يكون للمشرفين اقتراحات أو تعليقات على طلب السحب الخاص بك. كن منفتحًا على التغييرات ومستعدًا لإجراء المراجعات إذا طلب منك ذلك.
أهمية طلبات السحب
تسهل طلبات السحب التعاون بين المطورين من خلال تمكينهم من اقتراح التغييرات وتقديم الملاحظات ومراجعة التعليمات البرمجية. يساعد هذا في تعزيز الشعور بالمجتمع والتعاون داخل المشروع ، مما يؤدي إلى المزيد من المساهمات والتنمية الأسرع.
علاوة على ذلك ، تنظم طلبات السحب تاريخ المشروع وتعيين الإصدار من خلال السماح للمشرفين بتتبع الإصدارات المختلفة من الكود والتغييرات التي تم إجراؤها على كل إصدار.
