كيفية إجراء أول طلب سحب لك على GitHub

كيف تنشئ علاقات عامة لتحرير مشروع على GitHub؟

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

ماذا لو كنت بحاجة فقط إلى تعديل ملف ، ربما مشروع README لإصلاح خطأ مطبعي؟

لا تحتاج إلى معرفة كيفية البرمجة أو كيفية استخدام Git للقيام بذلك. ولكن بمجرد أن تبدأ في تنفيذ طلبات السحب ، يمكنك القيام بالعديد من الأشياء والتعاون في المشاريع مع أشخاص آخرين! وربما يدفعك هذا إلى المساهمة أيضًا في الكود لاحقًا.

أفترض أن لديك بالفعل (مجاني)جيثبالحساب. إذا لم تقم بذلك ، فانتقل إلىgithub.comواحصل على واحدة.

اسمحوا لي أن أريك العملية.

ذهبت إلى هذه الصفحةhttps://web.dev/prefers-color-scheme/ووجدت خطأ مطبعي محتمل. يفتقد هذا السطر إلى نقطة في نهايته.

The article I want to edit

أنا لست قواعد نحوية ، هذا فقط من أجل إيجاد مثال 😄

أعلم أن هذا الموقع مستضاف على GitHub ، وأن هذه المقالة بالتحديد مستضافة هنا:https://github.com/GoogleChrome/web.dev/tree/master/src/site/content/en/blog/prefers-color-scheme

The github folder of the article

أقوم بفتح ملف index.mdhttps://github.com/GoogleChrome/web.dev/blob/master/src/site/content/en/blog/prefers-color-scheme/index.mdمباشرة على GitHub وأضغط على أيقونة القلم الرصاص في شريط أدوات الملف. تحوم تقول "افرق هذا المشروع وحرر الملف".

The index.md file

يؤدي هذا إلى عرض طريقة عرض محرر بهذه المعلومات:

أنت تقوم بتحرير ملف في مشروع ليس لديك حق الوصول للكتابة إليه. سيؤدي إرسال تغيير إلى هذا الملف إلى كتابته إلى فرع جديد في fork flaviocopes / web.dev ، حتى تتمكن من إرسال طلب سحب.

The editor view

يمكنني الذهاب وإضافة تلك النقطة ، ثم في النموذج في الأسفل أشرح التغييرات التي أجريتها:

Propose file change

لقد ضغطت على الزر "اقتراح تغيير الملف" وظهر عرض مقارنة.

Compare view

هناك يمكنني مراجعة التغييرات التي أجريتها ، للتأكد من أن كل شيء على ما يرام ، وأخيراً يمكنني النقر فوق الزر "إنشاء طلب سحب". حاليا تم إجراء التغييرات علىشوكة الخاص بكمن المشروع ، الذي تم إنشاؤه تلقائيًا بواسطة GitHub عند النقر فوق رمز القلم الرصاص.

Open pull request

في الجزء العلوي من هذا العرض ، يمكنك أن ترى أنني على وشك إرسال PR إلىGoogleChrome/web.devمشروع من شكليflaviocopes/web.dev، من فرعيpatch-2لهمmasterفرع.

يؤدي الضغط على زر "إنشاء طلب سحب" إلى إظهار نموذج آخر حيث يمكنني كتابة وصف تفصيلي لطلب السحب.

يمكن أن تحتوي طلبات السحب على العديد من التغييرات المختلفة ، لذلك من الناحية النظرية يمكن أن يكون لديك الكثير من الملفات التي تم تحريرها في نفس العلاقات العامة ، ولهذا السبب يمكنك إضافة ملخص.

يحتوي هذا المستودع على نموذج لنص العلاقات العامة لمساعدة الفريق على إدارته. العلاقات العامة الخاصة بنا بسيطة جدًا ، لذا أقوم بإزالة القالب ولصق المحتوى من رسالة الالتزام من قبل.

لاحظ التلميح على اليمين؟ أخبروني أن المشروع يحتوي على ملف CONTRIBUTING.md ، والذي يشرح كيفية المساهمة والمبادئ التوجيهية. لطيف جدا.

Contributing

يبدو أننا بحاجة إلى توقيع CLA (اتفاقية ترخيص المساهم) لإكمال العلاقات العامة الخاصة بنا. لقد وقعت بالفعل على Google CLA في الماضي ، لذا فإن هذه الخطوة واضحة بالنسبة لي ، ولكن قد تحتاج إلى إصلاح ذلك. معظم المشاريع لا تحتاجها حقًا.

لقد نقرت على "إنشاء طلب سحب" وتم إرسال العلاقات العامة الآن!

Pull Request sent

الآن الأمر متروك لمسؤولي المشروع للتدخل وقبوله ، ما عليك سوى انتظار رسالة بريد إلكتروني تخبرك بأنه قد تم دمجها ، أو أي تعليقات لدى أشخاص آخرين.

[... مرت ساعتان ...]

تلقيت بريدًا إلكترونيًا ، تم رفض العلاقات العامة لأن هذه النقطة كانت في الواقع في المكان الصحيح! (لم أكن أعرف ذلك).

ولكن على أي حال ، هناك شيء أردت إضافته: لا تغضب أو تنزعج إذا لم يتم قبول أحد العلاقات العامة التي ترسلها. يعمل المشرفون على المشروع عليه لأشهر أو سنوات وهم يعرفون أفضل منك ما هو الأفضل بالنسبة له.

بالإضافة إلى ذلك ، خاصةً مع الكود ، قد تكون طرق العرض مختلفة جدًا وقد لا تكون العلاقات العامة التي تعتقد أنها رائعة أمرًا مرحبًا به.

من الأفضل أيضًا أن تسأل قبل العمل على علاقات عامة كبيرة ، لمعرفة ما إذا كان هذا شيء يحتاجه المشروع بالفعل.

لكن هذا موضوع في حد ذاته.


المزيد من دروس git: