مرحبا بكم في مشروعنا! نحن متحمسون لأنك تفكر في المساهمة في تطوير المصدر المفتوح. سوف يسير هذا الدليل عبر أوامر GIT الأساسية وأفضل الممارسات لجعل مساهمتك سهلة وناجحة.
قبل البدء في المساهمة ، تحتاج إلى توتر المستودع. يقوم Forking بإنشاء نسخة من المستودع تحت حساب GitHub الخاص بك.
خطوات:
بعد التغلب على المستودع ، تحتاج إلى استنساخه إلى جهازك المحلي حتى تتمكن من العمل عليه.
git clone https://github.com/your-username/repository-name.gitبعد استنساخ المستودع ، قم بإنشاء فرع جديد للعمل على تغييراتك. اعمل دائمًا في فرع منفصل لتجنب النزاعات مع الفرع الرئيسي:
git checkout -b feature/your-branch-nameالآن بعد أن كنت في فرعك ، قم بإجراء التغييرات اللازمة على الكود أو الوثائق أو أجزاء أخرى من المشروع. تأكد من اختبار كل شيء قبل الانتقال إلى الخطوة التالية.
بمجرد اكتمال التغييرات الخاصة بك ، حان الوقت لارتكابها. اتبع هذه الخطوات:
git add .git commit -m " Your descriptive message here "بعد ارتكاب تغييراتك محليًا ، ادفع الفرع إلى مستودع github الخاص بك.
git push origin feature/your-branch-nameسيؤدي ذلك إلى تحميل فرعك إلى مستودعك المتشعب على Github.
من خلال التغييرات التي تم دفعها إلى GitHub ، أنت مستعد لتقديم طلب سحب (PR) حتى يتمكن المشرفون من مراجعة عملك.
إذا تم تحديث المستودع الأصلي أثناء عملك ، فقد ترغب في مزامنة شوكة الخاص بك للحفاظ على تحديثه. إليكم كيف:
git remote add upstream https://github.com/original-owner/repository-name.gitgit fetch upstreamgit checkout main
git merge upstream/maingit push origin main