كيفية المساهمة في المشاريع مفتوحة المصدر

سواء كنت مبتدئ في البرمجة، أو خبير في التطوير، فإن المساهمة بالمشاريع مفتوحة المصدر الموجودة في GitHub (قِت.هب) سيساعدك على أن تتعلم أكثر عن الممارسات الجيدة للبرمجة بلغة معينة، أو حول اكتشاف الأخطاء وإصلاحها وإن لم تكن خبيراً باللغة. مساهمتك في مشاريع قِت.هب أيضاً ستساهم في بناء سمعة جيدة عنك و بناء علاقات جيدة مع المبرمجين المهتمين بنفس اللغة. في هذا المقال، سنستعرض كيفية المساهمة في مشروع think-code-deliver بتعديل في ملف README.md، وفي الختام، سأشارككم كيفية البحث عن مشاريع تحتاج المساهمة.

إذا كنت تعرف ما هو قِت.هب و Git (قِت) فيمكنك الانتقال إلى الخطوة الأولى مباشرة، أما إذا كنت لا تعرفها فإن قِت عبارة عن برنامج يساعدك في حال كان لديك كود برمجي وتقوم بالتعديل عليه أكثر من مرة، وتريد تاريخ هذه التغييرات محفوظ لأنك قد تحتاج للعودة إلى أي نسخة منه في أي وقت، أو أنك تريد العمل على كود مع مبرمجين آخرين في نفس الوقت!

قِت يتم استخدامه عبر موجه الأوامر بينما قِت.هب يعتبر الموقع أو الخادم الذي يحتوي واجهة هذا البرنامج. كل ما تحتاجه قبل البدء هو أن يكون لديك حساب قِت.هب وأن تنزل قِت على جهازك.

الخطوة الأولى: انسخ المشروع في جهازك

اضغط على زر Fork الموجود في الزاوية اليمنى أعلى صفحة المشروع.

 

ستجد بعد ذلك نسخة مطابقة من المشروع على حسابك في قِت.هب، وأسفل اسم المشروع توضيح بأنه متفرع من DevExCodeHub/think-code-deliver.

في نفس الصفحة اضغط على زر Clone or download لنسخ الرابط.

سنستخدم الرابط لتحميل ملفات المشروع في الجهاز، عبر موجه الأوامر أدخل الأمر التالي:

git clone https://github.com/xnorax/think-code-deliver.git

ستكون النتيجة مشابهة لما في الصورة:

انتقل عبر موجه الأوامر إلى مجلد المشروع عبر الأمر التالي:

cd think-code-deliver

الخطوة الثانية: قم بالتعديل

الآن افتح مجلد المشروع في جهازك وقم بتعديل ما تريده. في المثال عدلت على ملف README و أضفت صورتين توضيحية.

بعد التعديل، عليك بعمل 3 أوامر.

git add .

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

git commit -m "Update README.md and add photos"

الآن تبقى أن نرفع هذه التغيرات إلى ملف المشروع في موقع قِت.هب، والذي يتم من خلال هذا الأمر:

git push

ستجدالمشروع تحدث في حسابك مع ذكر التعليق الذي كتبته مع الأمر السابق.

لكن تذكر! أنت ما زلت تعمل على النسخة المتفرعة في حسابك فقط.

الخطوة الثالثة: ارفع التغييرات للمشروع الأصلي

لترفع التغييرات إلى ملف المشروع الأصلي يتوجب عليك رفع طلب سحب (Pull Request) لصاحب المشروع، عبر الزر الموجود أسفل Clone or download.

سيريك التغييرات لمراجعتها، ثم اضغط على زر طلب سحب مرة أخرى.

أدخل عنوان التغيير واكتب تعليقاً لشرح ما قمت بعمله، ثم اضغط على زر إنشاء طلب السحب.

هذا كل شيء، تبقى أن يقرأ صاحب المشروع طلبك ويقبله لترى التغيير في المشروع الأصلي. 

مشاريع تحتاج مساهمتك

يمكنك البحث بهذه الكلمات لإيجاد مشاريع تحتاج مساهمة المبتدئين أو مساهمات بسيطة، ويمكنك تغيير الكلمات حسب مستواك ورغبتك.
is:issue is:open label:beginner
is:issue is:open label:easy
 

أخيراً، بعض المشاريع تتطلب طريقة معينة للمساهمة، وهذا المقال يشرح أبسط طريقة للمساهمة، آملة أن تكون كافية لبداية الانطلاق، لكن هناك بعض الممارسات التي يفضل مراعاتها مستقبلاً قبل طلب السحب مثل أن يكون كل تغيير في فرع (branch) مختلف، وعمل طلب سحب لكل تغيير على حدة، وغيرها من الأمور التي غالباً ما يتم تحديدها في ملف README للمشروع. 

لديك مشروع تحتاج مساهمين فيه؟ أو سبق لك أن ساهمت في مشروع؟ شاركنا تجربتك بتعليق. 

كلمات دليلية: git github open oss source