My Hacktoberfest - تجارب المساهمة في المصادر المفتوحة كموقت أول

يمكن أن تبدو المساهمة في المصادر المفتوحة والمشاريع عملية شاقة. سيعرض محرك البحث المفضل لديك الكثير من النتائج على الأدلة والمستودعات للبدء. لكن في كثير من الأحيان ، لا يسفر بحثك عن النتيجة التي تريدها ، ولكنك لا تزال لا تعرف كيفية المساهمة في Open Source حتى بعد قراءة منشورات المدونة المتعددة. لا تساعد السمعة المعوقة لبعض المشاريع والمشهد القاسي في هذا الأمر وقد تزيد الأمور تعقيدًا.

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

بالاحباط وخيبة الأمل قليلا ، بدأت التركيز على مشاريع أخرى بدلا من ذلك.

ولكن كل شيء تغير عندما رأيت ملصق Hacktoberfest لزميل الموظف على الكمبيوتر المحمول. كنت مفتون - هل كان هذا من بقايا هاكاثون آخر؟

تحولت Hacktoberfest إلى أن تكون مختلفة جدا.

إذن ما هو Hacktoberfest بالضبط؟

تلميح: إنه لا يتعلق بأي من البيرة أو القرصنة أو مهرجان أكتوبر (الذي يحدث بالفعل في سبتمبر ، duh!).

Hacktoberfest هو احتفال مدته شهر واحد للمساهمة في Open Source ، والذي يستمر من 1 أكتوبر إلى 31 أكتوبر. تم إطلاقه بواسطة DigitalOcean بالتعاون مع GitHub. خلال شهر أكتوبر ، نشجعك على المساهمة وتقديم طلبات السحب إلى مستودعاتك المفضلة على GitHub. إذا تمكنت من جمع ما مجموعه أربعة ، فأنت مؤهل لتلقي تي شيرت ضخم مثل هذا!

جمال هذا القميص هو ما تتلقاه بعد إكمال Hacktoberfest (الائتمان:mahsinger على Twitter)

التسميات ، التسميات ، التسميات

أثبت Hacktoberfest أن يكون شهرًا رائعًا للوصول إلى المصدر المفتوح. تمتلئ GitHub بالمشكلات المسماة Hacktoberfest والتي كانت بحاجة إلى مساعدتكم. كان هناك ما يكفي من المشاريع للاختيار من بينها - تتراوح من الوثائق إلى بيثون إلى RUST. خلال هذا الوقت ، تعلمت كيفية البحث في GitHub عن المشكلات حسب التصنيفات وكيفية العثور على مشكلات جيدة للمساهمة فيها.

بالنسبة لأشخاص مثلي ، الذين ليس لديهم أي خبرة ، أثبتت الملصقات ، مثل أول مرة فقط أو سهلة أو جيدة ، أنها صديقي. هناك أيضًا بعض المواقع الجيدة التي تهدف إلى تسهيل عملية العثور على هذه المشكلات. على سبيل المثال ، up-for-grabs.net أو تعليمات برمجية - ربما يكون هناك الكثير.

اذهب وتسجيل لعدد قليل من هذه أو تحقق من مشاكلهم!

تعلم كيفية المساهمة

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

لقد وجدت أن دليل Kent C. Dodds المجاني على egghead.io مفيد ، وقد لاحظت أوامر سطر الأوامر التي نفذتها أثناء المتابعة.

يمكن تلخيص التعليمات لشيء بسيط مثل هذا:

// أولاً ، تحتاج إلى العثور على مستودع تريد المساهمة فيه وشوكة!
/ / ثم عليك استنساخ الريبو متشعب
 git clone git@github.com: اسم المستخدم / المساهمة- repo.git
// قم بتغيير الدليل إلى الريبو الجديد الذي قمت بنسخه
 مؤتمر نزع السلاح المساهمة ريبو
// قم بتعيين مستودع upstream إلى المستودع الأصلي (وليس الذي قمت بنسخه للتو)
 git remote add upstream git@github.com: the-owner-username / المساهمة-repo.git
// تحديث أي تغييرات
 بوابة جلب المنبع
// قم بتعيين فرعنا الرئيسي على نفس فرع المنبع
git branch --set-upstream-to = upstream / master master
/ / قم بإنشاء فرع جديد خاص بك لطلب السحب
git checkout -b pr / my-new-cool-المساهمة
/ / قم بإجراء أي تغييرات في محرر النصوص المفضل لديك واحفظه
/ / التحقق من حالة (يجب أن تظهر الملفات المعدلة)
حالة بوابة
/ / إلقاء نظرة على التغييرات وإعادة تقييم العمل
فرق فرقه
// أضف أي تغييرات على منطقة التدريج الخاصة بك (. لجميع الملفات)
بوابة إضافة
// الالتزام بجميع التغييرات وإضافة رسالة لصاحب الريبو
git ارتكاب -m "لقد أضفت هذا النص الرائع إلى مستودع الدليل الخاص بك"
// اضغط على مصدر الريبو وخلق طلب السحب
بوابة دفع أصل العلاقات العامة / بلدي جديد بارد مساهمة

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

مباراة مصنوعة في الجنة - المساهمة في أدلة freeCodeCamp

قمت بفتح "متوسطة" ذات يوم ورأيت أن "كوينسي لارسون" قد قدم دليلًا كاملاً حول كيفية مساهمة الأشخاص بسهولة في مستودع أدلة freeCodeCamp. مصدر المعرفة المشتركة عبر التطوير والمنتج والتصميم وعلوم البيانات. المساهمة في هذا المستودع لم تكن مشجعة للغاية فحسب ، بل كانت سهلة للغاية أيضًا. يمكنك تقديم المساهمات في متصفحك.

لم يكن العثور على موضوع أمرًا صعبًا حيث غطى مستودع الأدلة أي شيء من إمكانية الوصول إلى HTML إلى تطوير الألعاب.

أكثر ما أثار اهتمامي هو مدى سهولة جعل freeCodeCamp العملية لتمكين القادمين الجدد مثلي من تقديم مساهمة ذات مغزى. تبادل المعرفة مع الآخرين.

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

الائتمان: freeCodeCamp - المساهمة في مستودع أدلة freeCodeCamp

بعد بعض المداولات ، قررت تقديم مساهمة صغيرة في توزيعات Linux المختلفة. واكتب قسمًا جديدًا تمامًا عن تطوير الألعاب لاستكمال طلبات السحب الأربعة. لقد صنعت لعبة خلال الصيف كجزء من مشروع أطروحة بلدي. تبدو الكتابة عن تطوير الألعاب وأدواتها وسيلة جيدة لمشاركة معارفي المكتسبة حديثًا مع الآخرين.

في الإرشادات Contribute.md الخاصة بهم ، قدم freeCodeCamp الكثير من التفاصيل وطريقة للتأكد من أن كتابتك كانت مختصرة. فعلت كل ما عندي من البحوث ، ودعمته بالمصادر وأطلقه من خلال تطبيق همنغواي. صوت نشط وجمل قصيرة للفوز!

لقد تقدمت بطلب السحب وكان على سطح القمر عندما تم دمجها. كانت التعليقات المشجعة أيضًا بمثابة إضافة رائعة من مجتمع freeCodeCamp.

سحب طلب للحصول على قسم تطوير اللعبة كتبت لأدلة freeCodeCamp

ماذا يمكننا أن نأخذ بعيدا عن هذا؟

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

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

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

عندما وصل أخيرًا تي شيرت Hacktoberfest في منتصف ديسمبر بعد أن تم شحنه من أمريكا ، شعرت أن عيد الميلاد قد جاء مبكرًا. جعلني إمساكها بيدي قد أدركت أنني ساعدت في إنشاء وتوسيع شيء مهم. شعور أعتقد أن العديد من الأشخاص الذين يساهمون في "المصدر المفتوح" بشكل منتظم سيواجهون ذلك. ارتداء هذا يذكرني دائمًا بمشاركة معرفتي ، وسأحاول هذا العام أيضًا تحقيق قفزة للمساهمة في المزيد من الكود ، بعد كل شيء لم أعد أنا أول مرة!