اولین مشارکت شما در یک پروژه بزرگ منبع باز – گام به گام [Beginner Edition] 🛠️🚀

tl;dr

1. زمینه های بهبود را پیدا کنید در مستندات پروژه (اشتباهات، دستور زبان، جمله بندی، مختصر و غیره)
2. Fork + کلون کردن مخزن React (مخفف مخزن) = مخزن را در GitHub خود کپی کنید + آن را در رایانه محلی خود بارگیری کنید
3. تغییرات خود را اضافه کنید + آنها را ذخیره کنید
4. مطمئن شوید که مخازن همگام هستند با مخازن اصلی – اگر نه، از git stash استفاده کنید
5. Git push = تغییرات خود را در حساب GH خود آپلود کنید
6. درخواست کشش خود را ایجاد کنید (PR) = تغییرات خود را در Main React Repo به روز کنید
7. برای خودت یه آبجو سرد خوب بگیر و منتظر بمانید تا نگهبانان روابط عمومی شما را بررسی کنند 🍻

---

سلام دوستان 👋،

آیا تا به حال آن هیجان را احساس کردید که به طور تصادفی به یک پروژه منبع باز جالب برخورد کردید و فکر کردید: “آههه، ای کاش می توانستم مشارکت کنم، اما هنوز آنقدرها خوب نیستم…”

خب، امروز کار من این خواهد بود که سعی کنم به شما ثابت کنم اشتباه می کنید … و فکر می کنم ممکن است موفق شوم (متاسفم اما نه متاسفم 💚).

اگر نمی‌دانستید، معمولاً زمانی که توسعه‌دهندگان تلاش می‌کنند در مستندات پروژه مشارکت کنند، یک شروع خوب برای کمک به منبع باز اتفاق می‌افتد.

این بهترین راه برای درک بیشتر در مورد پروژه است و تمام مکانیک های پیشرفته ای که پشت مشارکت در یک مخزن بزرگ است را به شما می آموزد. در واقع، استفاده صحیح از GitHub در ابتدا چیز بسیار ترسناکی است.

اکنون، در این مقاله، شما را با دو چیز کلیدی مجهز می کنم:

1. رویکردی تدریجی و سیستماتیک به مشارکت های منبع باز
2. دانش و طرز فکر برای مشارکت مؤثر در مستندسازی لازم است.

پس از تکمیل این کار، می‌توانید از quine.sh دیدن کنید، که به شما کمک می‌کند پروژه‌های منبع باز را برای مشارکت در آنها کشف کنید. این پروژه ها را بر اساس موضوعات و زبان های برنامه نویسی دلخواه شما مطابقت می دهد (در اینجا یک لیست پخش کوتاه وجود دارد تا نحوه استفاده از آن را بدانید). استفاده از آن کاملا رایگان است. 🫶

اکنون، بیایید تمام مراحل را گام به گام بررسی کنیم تا شما را از “هرگز در اسناد در منبع باز مشارکت نکرده” به “من به تازگی یکی از بزرگترین پروژه های منبع باز در جهان را مستند کرده ام!”

توجه داشته باشید: مشارکت های شما منوط به تایید نگهدارنده(های) پروژه است. شما منتظر پاسخ نگهدارنده(های) خواهید بود که می توانند مشارکت های شما را بپذیرند، رد کنند یا درخواست تغییر کنند. 😀

---

امروز، شما مشارکت خود را در اسناد React ارسال خواهید کرد – یکی از کمک های منبع باز ضروری که توسط متا و معروف ترین کتابخانه جاوا اسکریپت جلویی ایجاد شده است.

با این حال، می توانید هر پروژه ای را که دوست دارید انتخاب کنید و مراحل زیر را دنبال کنید (اگر به یادگیری ماشین علاقه دارید Pytorch را توصیه می کنم). 🙃🪄

هر چیزی که در React Documentation می بینید در فایلی در GitHub نوشته شده است که نقطه باز بودن منبع باز را نشان می دهد. شما می توانید با آپلود تغییرات در یک فایل GitHub آنچه را که در وب سایت رسمی ظاهر می شود تغییر دهید – به نظر من این کاملاً شگفت انگیز است! 🤯

آیا برای شروع کمی عصبی هستید؟ نگران نباش من تو رو گرفتم 🤝

مورد نیاز: اگر این اولین باری است که به هر چیزی در منبع باز کمک می کنید، باید مراحل نشان داده شده در این مقاله را بخوانید و انجام دهید (به طور متناوب، می توانید ویدیوی یوتیوب را تماشا کنید). این فقط 10 دقیقه از شما زمان می برد. 🧢

هشدار ⛔️: Git ابزار ضروری شما برای مشارکت های منبع باز است که رایانه محلی شما را از طریق ترمینال به GitHub پیوند می دهد. مبارزه با Git طبیعی است! اگر هنگام دنبال کردن گام به گام مشکلی پیش آمد، در مشورت با Google، ChatGPT یا StackOverflow تردید نکنید. به یاد داشته باشید، تقریباً هر کدنویسی با چالش های Git روبرو می شود. 🫶

برای 95٪ از ما که ویدیوها را به جای متن ترجیح می دهیم، ویدیوی زیر را بیابید تا به شما در مشارکت کمک کند! 🌟

---

1. مناطق بهبود یافته را در اسناد React بیابید

1️⃣ به React Documentation بروید.

2️⃣ سعی کنید مناطقی را پیدا کنید که قابل بهبود باشند. این می تواند یک بهبود گرامری، بازنویسی چیزی نامشخص یا مناطقی باشد که می تواند از مختصر بودن استفاده کند.

در مورد من، من فکر می کنم جمله دایره شده می تواند از مختصر استفاده کند.

من می خواهم آن را کوتاه کنم:

برنامه‌های React با استفاده از کامپوننت‌هایی ساخته می‌شوند که بخش‌های رابط کاربری مستقلی هستند که اندازه آن‌ها از دکمه‌ها تا کل صفحات متفاوت است و هر کدام منطق و استایل خود را دارند.

3️⃣ برای یافتن فایل کد اصلی به مخزن React GitHub بروید. جمله یا پاراگراف مستند React را که می‌خواهید تغییر دهید کپی کنید و در نوار جستجوی GitHub قرار دهید. گزینه را انتخاب کنید Search in this repository.

در این مرحله، فایل دقیقی را پیدا کرده اید که کد منبع در آن قرار دارد – آن را برای بعد یادداشت کنید.

---

2. Fork and Clone React Repo = Repo را روی GH و رایانه محلی خودم کپی کنید

1️⃣ به صفحه اصلی واکنش برگردید و مخزن را فورک کنید. Fork به این معنی است که شما یک کپی از این مخزن را در حساب GitHub خود ایجاد خواهید کرد. 💪

2️⃣ ترمینال خود را باز کنید و به پوشه (که در اصطلاح فنی دایرکتوری نیز نامیده می شود) مورد نظر خود بروید.

3️⃣ لینک HTTPS را از مخزن با کلیک بر روی مربع دوتایی زیر کپی کنید.

4️⃣ با اجرا کردن مخزن را کلون کنید git clone PASTE-YOUR-HTTPS-LINK-HERE داخل ترمینال شما اکنون یک کپی محلی از React در رایانه محلی خود دارید 💻

---

3. تغییرات خود را اضافه کنید و آنها را ذخیره کنید

1️⃣ قبل از ادامه، دستورالعمل صفحه «CONTRIBUTING.md» و «آیین رفتار» را بخوانید. این یک مرحله بسیار مهم است زیرا گاهی اوقات در مورد قوانین خاصی که هر مخزن هنگام مشارکت دارد، یاد می گیرید. توجه داشته باشید: صفحه README React برای بررسی جزئیات مشارکت عالی است و می توان از آن برای مشارکت های بعدی استفاده کرد.🫡

2️⃣ حالا پروژه react را با محیط کدنویسی مورد علاقه خود باز کنید.

3️⃣ فایلی را که می خواهید تغییر دهید با استفاده از مسیر فایل مرحله 1.4 پیدا کنید. در مورد من اینطور بود src/content/learn/index.md

4️⃣ تغییرات خود را اضافه کنید و آنها را ذخیره کنید.

5️⃣ با اجرای روی ترمینال تغییرات خود را مرور کنید git diff. در این مرحله خواهید دید که چه تغییراتی ایجاد کرده اید و باید آماده انجام آن باشید!

می توانید مستقیماً به مرحله 6 بروید – اگر شما می خواهید. با این حال، من می‌خواهم مطمئن شوم که می‌توانید برخی از موارد لبه را مدیریت کنید، مانند زمانی که مخزن اصلی React در GitHub تغییر کرده است، در حالی که شما تغییراتی ایجاد کرده‌اید. 🤔

---

4. بررسی کنید که Repo آنلاین GitHub شما با مخزن اصلی react یکی باشد

شما در حال به روز رسانی آنچه در رایانه محلی خود است به آنچه در مخزن آنلاین گیت هاب فورکی شما وجود دارد – بله!

با این حال، کار درست این است که به صورت آنلاین به مخزن GitHub خود بروید و مطمئن شوید که آخرین نسخه مخزن رسمی react را دارید. این به این دلیل است که گاهی اوقات، در حین کار، مخزن اصلی ممکن است تغییراتی داشته باشد، بنابراین به نفع شماست که مطمئن شوید به روزترین نسخه را دارید.

برای انجام آن، کار ساده است: به مخزن آنلاین خود بروید و روی «کلیک کنید.چنگال همگام سازی“. اگر در برخی از تغییرات عقب مانده اید، GitHub به طور خودکار نسخه شما را به آخرین نسخه به روز می کند.

---

5. اگر در Sync نیست → از Git Stash استفاده کنید

اگر زمانی که شما در حال انجام تغییرات بودید، مخزن شما با تغییر مخزن React هماهنگ نبود، باید مراحل زیر را انجام دهید.

برای ادامه، باید مفهوم آن را درک کنید git pull. 👇

هنگامی که شما اجرا می کنید git pull دستور در ترمینال خود، بررسی می کنید که آیا شخص دیگری بخشی از فایلی را که روی آن کار می کردید تغییر داده است یا خیر. اگر مخزن اصلی تغییر کرده است، با git pull مطمئن شوید که «آخرین به‌روزرسانی‌ها» را وارد رایانه خود می‌کنید. این به شما امکان می دهد کد خود را با آخرین تغییرات از مخزن راه دور به روز نگه دارید.

به عبارت دیگر دویدن git pull راهی برای بررسی اینکه آیا شخص دیگری همان خطوط کد را تغییر داده است یا خیر و این تغییرات را در نسخه پروژه شما وارد می کند.

حالا نوبت شماست: 🪄

1️⃣ در ترمینال خود اجرا کنید git pull برای اطمینان از به روز بودن مخزن. در اینجا با یک خطا مواجه می شوید زیرا می دانید که نسخه فعلی شما پشت آخرین نسخه React قرار دارد.

توجه داشته باشید: اگر تغییرات در فایل‌های دیگر انجام شده باشد، خطایی دریافت نمی‌کنید و می‌توانید بدون نیاز به git stash ادامه دهید (و می‌توانید مستقیماً به مرحله 6 بروید).

2️⃣ بدوید git stash. این به طور موقت تغییراتی را که در فهرست کاری خود ایجاد کرده اید بدون اینکه هنوز انجام دهید ذخیره می کند. آنها در حال حاضر پنهان می شوند و به شما امکان می دهند نسخه فایل ها را از مخزن آنلاین GitHub خود دریافت کنید.

3️⃣ بدوید git pull از نو. اکنون با این کار آخرین نسخه از مخزن GitHub آنلاین شما به رایانه محلی شما منتقل می شود.

4️⃣ بدوید git stash pop. اکنون باید تغییرات را در IDE خود مشاهده کنید. تغییراتی را که نمی خواهید حذف کنید و تغییراتی را که می خواهید حفظ کنید.

---

6. Git push = تغییرات خود را در حساب GH خود آپلود کنید

1️⃣ بدوید git status برای نمایش وضعیت دایرکتوری کاری و ناحیه مرحله بندی. همیشه تمرین خوبی است که آن را اجرا کنید زیرا اساساً “چه اتفاقی افتاده” را می بینید. 👀

2️⃣ بدوید git add . این همه تغییراتی را که در Git انجام داده اید اضافه می کند.

3️⃣ با اجرای: git commit -m "grammatically updated the tech doc”.

4️⃣ بدوید git push. اگر این اولین باری است که تغییرات را انجام می دهید، از شما خواسته می شود که خود را احراز هویت کنید. من به شما توصیه می کنم مقاله قبلی من را از مرحله 4.4-4.8 بخوانید.

5️⃣ ممکن است یک خطا دریافت کنید، پس از آن باید این را کپی و اجرا کنید: git push origin HEAD

---

7. Create Your Pull Request = تغییرات خود را در Main React Repo به روز کنید

خوب، ما الان خیلی به آن نزدیکیم! آخرین فشار🪄

1️⃣ به مخزن فورک شده خود در GitHub برگردید.

2️⃣ کلیک کنید Contribute و سپس بر روی آن کلیک کنید Compare and pull request.

3️⃣ پیام تعهد خود و دلیل ایجاد تغییرات را شرح دهید – همیشه زمان خوبی برای بازگشت به دستورالعمل های مشارکت برای بررسی اینکه آیا همه چیز را به درستی انجام داده اید یا خیر. 🌟

4️⃣ بر روی “Pull Request” کلیک کنید! 🎉🍾👯‍♀️

5️⃣ درخواست کشش شما اکنون در راه است! متا از شما می خواهد که آنها را امضا کنید موافقت نامه مجوز مشارکت کننده من یک عکس را در زیر پیوست می کنم تا بتوانید ببینید که چگونه باید باشد:

---

پس از این، تنها کاری که باید انجام دهید این است که منتظر بمانید. اتفاقی که در حال رخ دادن است این است که صاحبان پروژه React (که نگهدارنده نیز نامیده می شود)، باید درخواست کشش شما را بپذیرند (به آن نیز گفته می شود. ادغام یک درخواست کشش).

بسته به مشارکت‌هایتان، می‌توانید آن را پذیرفته، رد کنید یا نگه‌دارنده‌ها می‌توانند تنظیماتی را درخواست کنند.

این کاملاً به نوع مشارکت‌هایی که داده‌اید بستگی دارد، بنابراین تا زمانی که آنچه اضافه/اصلاح کرده‌اید منطقی باشد، مشارکت شما باید پذیرفته شود! 🌟

---

همین مردم!

در کل باید به خودت افتخار کنی این کاملاً فنی بوده است، به خصوص با یادگیری مکانیک GitHub. با این حال، شما آن را عالی انجام دادید. 💃

پس بنشینید و استراحت کنید زیرا به تازگی هر کاری را که لازم داشتید انجام داده اید! ☀️🧘‍♂️🎉

ما می دانیم که همیشه برای اولین بار فوق العاده سخت است، و واقعا عالی است که به این نقطه رسیدید – خیلی به شما افتخار می کنم! 👯‍♀️💚

شما اکنون نکات فنی پشت کل فرآیند مشارکت GitHub و روش مشارکت را یاد گرفته اید!

اگر آماده شروع مشارکت در پروژه‌های دیگر هستید، ما فهرستی از پروژه‌ها را با مسائل آسانی که می‌توانید شروع کنید، گردآوری کرده‌ایم. لیست پروژه ها را در quine.sh بررسی کنید، و در صورت مسدود شدن شما، در اینجا یک لیست پخش کوتاه وجود دارد. 🚀

---

اگر هنوز این کار را نکرده‌اید، می‌توانید در صورت نیاز به کمک یا هر سؤالی به سرور discord ما بپیوندید. 🫶