mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-13 17:21:50 +00:00
Merge branch 'main' into translate-how-to-contribute-ro
This commit is contained in:
@@ -31,7 +31,7 @@ If you're making changes to a translation, please request a review from our prev
|
||||
| ქართული | [Georgian](../translations/README.ka.md) | [<img width="100" src="https://avatars0.githubusercontent.com/u/9116447?s=460&v=4" alt="@iko1133" />](https://github.com/iko1133) |
|
||||
| Galego | [Galician](../translations/README.gl.md) | [<img width="100" src="https://avatars1.githubusercontent.com/u/16878891?s=460&v=4" alt="@siderio2" />](https://github.com/siderio2) |
|
||||
| Greek | [Greek](../translations/README.gr.md) | [<img width="100" src="https://avatars.githubusercontent.com/u/63111742?v=4" alt="@adreaskar" />](https://github.com/adreaskar) [<img width="100" src="https://avatars.githubusercontent.com/u/19299306?v=4" alt="@porfanid" />](https://github.com/porfanid) |
|
||||
| Gujarati | [Gujarati](../translations/README.guj.md) | [<img width="100" src="https://avatars2.githubusercontent.com/u/38134283?s=460&v=4" alt="@smitgajjar" />](https://github.com/smitgajjar) [<img width="100" src="https://avatars.githubusercontent.com/u/16669911?v=4" alt="@kaushalgosaliya5" />](https://github.com/kaushalgosaliya5/) |
|
||||
| ગુજરાતી | [Gujarati](../translations/README.guj.md) | [<img width="100" src="https://avatars2.githubusercontent.com/u/38134283?s=460&v=4" alt="@smitgajjar" />](https://github.com/smitgajjar) [<img width="100" src="https://avatars.githubusercontent.com/u/16669911?v=4" alt="@kaushalgosaliya5" />](https://github.com/kaushalgosaliya5/) |
|
||||
| Hausa | [Hausa](../translations/README.hau.md) | []() |
|
||||
| עברית | [Hebrew](../translations/README.hb.md) | [<img width="100" src="https://avatars1.githubusercontent.com/u/23402988?s=460&v=4" alt="@TomerPacific" />](https://github.com/TomerPacific) |
|
||||
| हिन्दी | [Hindi](../translations/README.hi.md) | [<img width="100" src="https://avatars2.githubusercontent.com/u/4654382?s=460&v=4" alt="@arshadkazmi42" />](https://github.com/arshadkazmi42) [<img width="100" src="https://avatars2.githubusercontent.com/u/7047079?s=460&v=4" alt="@sara-02" />](https://github.com/sara-02) [<img width="100" src="https://avatars.githubusercontent.com/u/20799404?v=4" alt="shrut1996" />](https://github.com/shrut1996) |
|
||||
|
||||
@@ -6,4 +6,4 @@ If you're doing something in the checklist below, put an `x` inside `[ ]` so tha
|
||||
|
||||
- [ ] I had fun going through this tutorial (ノ^o^)ノ and learned on the way ٩(^◡^)۶
|
||||
- [ ] There are some things I'd like to improve in this tutorial. I have written them below.
|
||||
- [ ] There were steps where I had errors while following this tutorial. I have written them below.
|
||||
- [ ] There were steps where I had errors while following this tutorial. I have written them below.
|
||||
+2728
-4620
File diff suppressed because it is too large
Load Diff
@@ -85,6 +85,7 @@
|
||||
<kbd>[<img title="Malagasy" alt="Malagasy" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/mg.svg" width="22">](docs/translations/README.mg.md)</kbd>
|
||||
<kbd>[<img title="ភាសាខ្មែរ" alt="ភាសាខ្មែរ" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/kh.svg" width="22">](docs/translations/README.kh.md)</kbd>
|
||||
<kbd>[<img title="Morocco" alt="Moroccan Darija" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/ma.svg" width="22">](docs/translations/README.ma.md)</kbd>
|
||||
<kbd>[<img title="Mongolian" alt="Mongolian" src="https://cdn.statically.io/flags/mn.svg" width="22">](docs/translations/README.mn.md)</kbd>
|
||||
|
||||
# First Contributions
|
||||
|
||||
|
||||
@@ -0,0 +1,164 @@
|
||||
# حاجات ممكن اللي مش مبرمج يعملها
|
||||
## اسمع الأول
|
||||
|
||||
كل حاجة في الـ Open Source بتعتمد على الناس اللي شغالة فيها.
|
||||
إنت عايز تنضم لفريق، وده معناه إنك تفهم المجتمع شغال إزاي.
|
||||
لو دخلت على مشروع وقلت "هاي، أنا شايف إن المشروع المفروض يعمل كذا" غالبًا ده مش هيكون مقبول.
|
||||
ممكن مشاريع معينة تكون بتحب الأسلوب ده، لكن لو المشروع ليه فترة شغال، نسبة إن الناس تتقبل الكلام ده قليلة.
|
||||
**أحسن حاجة تعملها في الأول إنك تسمع وتشوف الناس شغالة إزاي.**
|
||||
|
||||
1. **اشترك في Mailing List**: في مشاريع كتير، الـ mailing list هي وسيلة التواصل الرئيسية بين الناس اللي بتطور المشروع.
|
||||
في المشاريع الكبيرة، هتلاقي كذا mailing list.
|
||||
مثلاً، مشروع PostgreSQL عنده أكتر من 12 mailing list للمستخدمين و6 للمطورين.
|
||||
ابدأ بمتابعة الـ list الأساسية للمستخدمين وواحدة من بتوع المطورين علشان تفهم اللي بيحصل.
|
||||
|
||||
2. **تابع Blog**: المطورين الكبار غالبًا بيكتبوا تدوينات بيشرحوا فيها اللي هيحصل في النسخ الجاية،
|
||||
وبيتكلموا عن اللي اتعمل علشان نوصل للمرحلة دي.
|
||||
في مواقع اسمها Planet بتجمع التدوينات والأخبار من كذا مصدر عن المشروع.
|
||||
لو فيه planet زي planet.gnome.org أو planet.mysql.com، يبقى ده مكان كويس تبدأ منه.
|
||||
اكتب في جوجل "planet <اسم المشروع>".
|
||||
|
||||
3. **ادخل على قناة IRC**: معظم مشاريع الـ Open Source عندها قنوات IRC الناس بتدخل تتكلم فيها عن المشاكل والتطوير.
|
||||
ادخل على موقع المشروع وشوف اسم القناة على أي شبكة IRC.
|
||||
|
||||
**اشتغل على التذاكر**
|
||||
الكود هو الأساس في أي مشروع مفتوح المصدر، بس ده مش معناه إن الكود هو الطريقة الوحيدة اللي ممكن تساهم بيها.
|
||||
فيه حاجات تانية كتير الناس بتكسل تعملها، زي صيانة النظام أو متابعة المشاكل.
|
||||
ابدأ من هنا وهتلاقي نفسك بقيت جزء من الفريق.
|
||||
|
||||
معظم المشاريع عندها نظام تذاكر على الموقع الرسمي.
|
||||
ده بيكون وسيلة تواصل بين الناس اللي بتستخدم البرنامج والمطورين.
|
||||
تنضيف التذاكر دي وتحديثها بيساعد الفريق جدًا.
|
||||
|
||||
ممكن تحتاج صلاحيات علشان تعدل على التذاكر، بس صدقني، أول ما تقول إنك عايز تساعد، هيدوك الصلاحيات دي على طول.
|
||||
|
||||
4. **حلل مشكلة (Bug)**: ساعات الناس بتبلّغ عن مشاكل بشكل مش واضح.
|
||||
لو حد قال "البرنامج بيهنّج لما بعمل كذا"، خد وقتك وحاول تعرف المشكلة دي بتحصل إزاي.
|
||||
هل بتتكرر؟ تقدر تكتب خطوات تثبت بيها إنها بتحصل؟ بتحصل على متصفح معين؟ ولا في نظام تشغيل معين؟
|
||||
|
||||
حتى لو معرفتش تحلها، إنك توضّح المشكلة أكتر بيسهّل على حد تاني ييجي يحلها.
|
||||
وكل اللي تكتشفه، اكتبه في التذكرة علشان غيرك يستفيد.
|
||||
|
||||
5. **اقفل التذاكر القديمة**: كتير من المشاكل بتكون اتحلت، بس التذاكر لسه مفتوحة.
|
||||
البحث في التذاكر القديمة وتنضيفها حاجة مهمة جدًا.
|
||||
|
||||
ابدأ بدور على تذاكر بقالها أكتر من سنة وشوف هل المشكلة لسه موجودة ولا اتصلحت.
|
||||
راجع سجل التغييرات في الإصدارات وشوف لو فيه ذكر للمشكلة.
|
||||
لو اتحلت، اكتب رقم النسخة في التذكرة واقفلها.
|
||||
|
||||
جرّب تعيد المشكلة في آخر نسخة من البرنامج.
|
||||
لو مشتغلتش، اكتب ده في التذكرة واقفلها.
|
||||
لو لسه موجودة، اكتبه برضو وسيب التذكرة مفتوحة.
|
||||
|
||||
## الشغل على الكود
|
||||
الناس اللي عندها خبرة مختلفة في البرمجة تقدر تساعد في الكود.
|
||||
مش لازم تكون مبرمج جامد علشان تساهم.
|
||||
|
||||
لو ناوي تعدل على الكود، اعرف الأول المشروع بيشتغل إزاي في موضوع استلام التعديلات.
|
||||
كل مشروع ليه طريقة معينة، فاسأل الأول.
|
||||
|
||||
مثلاً، PostgreSQL بيستقبل التعديلات على شكل Patch في mailing list، والمطورين بيراجعوها كويس جدًا.
|
||||
لكن في مشروع زي Parrot، ممكن تاخد صلاحيات التعديل بسهولة.
|
||||
لو المشروع على GitHub، غالبًا بيستخدموا Pull Requests.
|
||||
كل مشروع وليه طريقته.
|
||||
|
||||
لما تعدل حاجة، خليك محترم مع باقي الفريق وحافظ على تنسيق الكود زي ما هو.
|
||||
ما تحاولش تفرض أسلوبك.
|
||||
الكود اللي بتكتبه لازم يشبه اللي موجود، حتى لو مش عاجبك.
|
||||
|
||||
6. **اختبر نسخة Beta أو Release Candidate**:
|
||||
المشاريع اللي بتشتغل على كذا نظام تشغيل ساعات بيكون فيها مشاكل توافق.
|
||||
قبل الإصدارات، المطورين بينزلوا نسخ تجريبية علشان الناس تجربها.
|
||||
لو شغّلت البرنامج على نظام تشغيل مختلف واشتغل، ده بيساعدهم يعرفوا إن النسخة كويسة.
|
||||
|
||||
مش لازم تعمل حاجة غير إنك تبني البرنامج وتفتحه وتجربه.
|
||||
لو شغال، بلغهم.
|
||||
ده بيفرق كتير جدًا مع المطورين.
|
||||
|
||||
7. **صلّح Bug**: ده غالبًا أول حاجة الناس بتعملها لما تبدأ تشتغل في الكود.
|
||||
دور على Bug شكله بسيط، وجرب تصلحه.
|
||||
اكتب ملاحظاتك جوه الكود، ولو في Test يوضح إن المشكلة اتحلت، ضيفه.
|
||||
لو معرفتش تصلحها، اكتب اللي وصلتله في التذكرة.
|
||||
|
||||
8. **اكتب Test**:
|
||||
معظم المشاريع عندها Tests، بس دايمًا فيه مكان لإضافة تانية.
|
||||
استخدم أدوات بتقيس مدى التغطية، زي `gcov` أو `Devel::Cover`.
|
||||
وشوف أجزاء الكود اللي مش متغطية، وضيف لها Test.
|
||||
|
||||
9. **اسكت تحذير من الكومبايلر**:
|
||||
لما تبني برامج C، ممكن يطلعلك تحذيرات.
|
||||
مش دايمًا معناها إن فيه مشكلة، بس بتشوّش.
|
||||
لو شفت تحذير، شوف هل فعلاً فيه مشكلة؟
|
||||
لو لأ، عدل الكود علشان تسكت التحذير.
|
||||
|
||||
10. **ضيف تعليق**:
|
||||
لو لقيت جزء في الكود مش مفهوم، اكتبه تعليق.
|
||||
أكيد في ناس غيرك هتتلخبط برضو.
|
||||
ابعت تعديل فيه التعليقات دي.
|
||||
|
||||
## الشغل على التوثيق
|
||||
المستندات دايمًا بتتاخد بشكل بسيط.
|
||||
وساعات بتكون مكتوبة كأن اللي بيقراها أصلاً فاهم المشروع.
|
||||
لو حسيت إن التوثيق مش واضح، قول.
|
||||
اللي عنيهم جديدة بيشوفوا حاجات الناس اللي شغالة عليها مش شايفاها.
|
||||
|
||||
11. **اعمل مثال**:
|
||||
مفيش مشروع عنده أمثلة كتير كفاية.
|
||||
لو فيه API، أو مكتبة، أو برنامج GUI زي Gimp، أو حتى أداة سطر أوامر – اعمل مثال عملي بيشرح ازاي تستخدمه.
|
||||
|
||||
ممكن المثال يكون حاجة بسيطة من كود انت كتبته، أو حتى فيديو Screen Recording وانت بتستخدمه.
|
||||
الناس بتحب تشوف التطبيق العملي أكتر من الكلام.
|
||||
|
||||
## اشتغل مع المجتمع
|
||||
الـ Open Source مش بس كود. المجتمع هو اللي بيخلي المشاريع دي تعيش وتكبر.
|
||||
فيه طرق كتير تقدر تساعد بيها في تقوية المجتمع حوالي المشروع.
|
||||
|
||||
12. **جاوب على سؤال**:
|
||||
أحسن طريقة تساعد بيها المشروع والمجتمع هي إنك تساعد غيرك.
|
||||
لما حد جديد يسأل سؤال، وحضرتك تجاوبه بدل ما تقول له "روح اقرأ الـ Manual"، كده إنت مش بس ساعدته،
|
||||
إنت كمان شجّعته يكمل، ويمكن كمان يبقى عضو نشيط في المشروع بعد كده.
|
||||
|
||||
كلنا بدأنا من الصفر، والمشاريع محتاجة دايمًا ناس جديدة تدخل علشان تفضل عايشة.
|
||||
|
||||
13. **اكتب تدوينة (Blog Post)**:
|
||||
لو عندك مدونة، احكي فيها عن تجربتك مع المشروع اللي بتستخدمه.
|
||||
قول واجهت إيه مشاكل، وازاي حليتها.
|
||||
كده بتساعد المشروع بطريقتين:
|
||||
- إنك بتخلي الناس تفكر في المشروع وتسمع عنه.
|
||||
- وإنك بتسيب أثر للي بعدك لو حد واجه نفس المشكلة وعمل بحث على جوجل.
|
||||
|
||||
(والتدوينة دي كمان ممكن تبقى وسيلة كويسة توري بيها خبرتك الحقيقة في الشغل لما تيجي تدور على شغل.)
|
||||
|
||||
14. **طوّر موقع المشروع**:
|
||||
لو عندك خبرة في تصميم المواقع، وساعدت في تحسين الموقع أو شكله العام، ده وقتك مش بيضيع.
|
||||
يمكن المشروع محتاج لوجو، أو ستايل أحسن، أو تنظيم أحسن للمحتوى.
|
||||
الحاجات دي ساعات بتكون ناقصة عند المبرمجين، وساعتها أي حد عنده ذوق أو خبرة في التصميم بيفرق جامد.
|
||||
أنا عن نفسي بتمنى ألاقي حد يساعدني في التصميم في مشاريعي!
|
||||
|
||||
15. **اكتب توثيق تقني (Documentation)**:
|
||||
لو تقدر تشرح ازاي برنامج أو أداة شغالة، يبقى تقدر تكتب توثيق تقني عنها.
|
||||
مشاريع Open Source كتير بتبقى محتاجة توثيق جديد، أو تطوير اللي موجود، أو تبسيطه للناس.
|
||||
|
||||
كل ما كانت كتابتك أبسط وأوضح، كل ما كانت أحسن.
|
||||
وأجمل حاجة؟ مش لازم تكون مبرمج علشان تكتب Documentation.
|
||||
|
||||
والأهم من كل ده، اسمع الناس بتتكلم عن إيه.
|
||||
حاول تلاحظ المشاكل اللي محتاجة حل.
|
||||
مثلاً، في مرة على Mailing List لمشروع Parrot، قرروا ينقلوا من Trac لـ GitHub في نظام التذاكر.
|
||||
ناس كتير كانوا ضد القرار علشان مفيش طريقة ينقلوا التذاكر القديمة.
|
||||
دخلت وقلت "طب ما أكتب أنا برنامج يحوّل التذاكر؟" والناس فرحت جدًا.
|
||||
فعلاً كتبت برنامج نقل أكتر من 450 تذكرة، واحتفظنا بتاريخهم.
|
||||
نجاح جميل، وساعدت الفريق، والمطورين ركزوا في شغلهم بدل وجع الدماغ.
|
||||
|
||||
16. **علّم وساعد غيرك**:
|
||||
أحسن طريقة تتعلم بيها أكتر، إنك تشرح اللي فهمته لحد تاني.
|
||||
المدرّس الشاطر هو اللي يقدر يشرح حاجة معقدة بطريقة بسيطة.
|
||||
|
||||
لو علمت حد، أو ساعدته، مش بس هتحس إنك عملت حاجة كويسة،
|
||||
ده كمان هيثبت المعلومة في دماغك، ويقوّي مهاراتك.
|
||||
ولما حد يساعدك، ما تحتفظش بالمعلومة لنفسك.
|
||||
شارك اللي عرفته، وخلّي الدنيا مكان أحسن.
|
||||
|
||||
والسلام عليكم ورحمة الله وبركاته.
|
||||
|
||||
|
||||
@@ -101,7 +101,7 @@ Menjawab pertanyaan, terutama dari seseorang yang baru saja memulai, sangat pent
|
||||
Waktu yang Anda luangkan untuk membantu seorang pemula, bahkan jika mereka mengajukan pertanyaan di mana Anda dapat dengan mudah menjawab “RTFM” dengan cepat, akan terbayar di kemudian hari dengan mendapatkan anggota aktif lainnya di dalam komunitas.
|
||||
Semua orang memulai dari suatu tempat, dan proyek membutuhkan arus masuk orang yang konstan jika ingin tetap hidup.
|
||||
|
||||
13. **Tulislah sebuah postingan blog:
|
||||
13. **Tulislah sebuah postingan blog**:
|
||||
Jika Anda memiliki sebuah blog, tulislah tentang pengalaman Anda dengan proyek yang Anda gunakan.
|
||||
Ceritakan tentang masalah yang Anda hadapi dengan menggunakan perangkat lunak dan apa yang Anda lakukan untuk menyelesaikannya.
|
||||
Anda akan membantu dengan dua cara, yaitu dengan membantu menjaga proyek tetap berada di benak orang lain di sekitar Anda,
|
||||
|
||||
@@ -122,3 +122,40 @@ Most of all, listen to what people around you discuss. See if you can recognize
|
||||
16. **Teach and Help others**:
|
||||
The best way to learn more about a topic is to try to teach it.
|
||||
The best teacher is the one who can explain complex stuff with simple examples. So you need to try to be the best teacher to be the best learner and the best in your programming world. Teaching others will make you feel better about yourself and it will help you get better skills and knowledge in your profession. When you get help from someone don't keep it to yourself share it with others. Make the world a better place to live.
|
||||
|
||||
17. **Improve Accessibility**
|
||||
- Audit project documentation/websites for:
|
||||
- Alt text for images.
|
||||
- Screen reader compatibility.
|
||||
- Suggest fixes for:
|
||||
- Color contrast.
|
||||
- Keyboard navigation.
|
||||
- Semantic HTML.
|
||||
|
||||
18. **Organize Community Events**
|
||||
- Help organize:
|
||||
- Virtual meetups or hackathons.
|
||||
- "Ask Me Anything" (AMA) sessions with maintainers.
|
||||
- Moderate forums/Discord/Slack to keep discussions productive.
|
||||
|
||||
19. **Curate Resources**
|
||||
- Create an **"Awesome [Project Name]"** list with:
|
||||
- Tutorials, videos, third-party tools.
|
||||
- Compile a **FAQ section** from common questions in forums/issues.
|
||||
|
||||
20. **Social Media & Outreach**
|
||||
- Manage project’s Twitter/LinkedIn:
|
||||
- Share updates, milestones, or contributor spotlights.
|
||||
- Write **"Getting Started" threads** or tweetorials for new users.
|
||||
|
||||
21. **Localization & Internationalization**
|
||||
- Translate UI strings (via Crowdin/Weblate).
|
||||
- Adapt docs for regional contexts (e.g., date formats, idioms).
|
||||
|
||||
22. **Design & UX Feedback**
|
||||
- Mockup UI improvements (Figma/Canva sketches).
|
||||
- Report confusing workflows (e.g., "Settings menu is hard to find").
|
||||
|
||||
23. **Grant Writing & Fundraising**
|
||||
- Apply for open-source grants (GitHub Sponsors, NLnet).
|
||||
- Draft **case studies** showcasing project impact.
|
||||
|
||||
@@ -0,0 +1,84 @@
|
||||
# গিট কনফিগারেশন
|
||||
|
||||
প্রথমবারের মতো যখন আপনি `commit` করার চেষ্টা করবেন, তখন এই ধরনের বার্তা দেখতে পাবেন:
|
||||
|
||||
```bash
|
||||
$ git commit
|
||||
*** Please tell me who you are.
|
||||
|
||||
Run
|
||||
|
||||
git config --global user.email "you@example.com"
|
||||
git config --global user.name "Your Name"
|
||||
|
||||
to set your account's default identity.
|
||||
Omit --global to set the identity only in this repository.
|
||||
```
|
||||
|
||||
একটি `commit` তৈরি করতে গিটকে জানতে হবে যে এর লেখক কে। সহযোগী কাজের ক্ষেত্রে, প্রকল্পের বিভিন্ন অংশের পরিবর্তন করেছেন কে এবং কবে, তা জানা খুবই গুরুত্বপূর্ণ। তাই গিটে প্রতিটি `commit`-এর সাথে ব্যবহারকারীর নাম এবং ইমেল ঠিকানা সংযুক্ত করা হয়।
|
||||
|
||||
এখানে কিছু উপায় আছে যার মাধ্যমে আপনি আপনার ইমেল এবং নাম `git commit` কমান্ডের সাথে যুক্ত করতে পারেন।
|
||||
|
||||
### গ্লোবাল কনফিগারেশন
|
||||
|
||||
গ্লোবাল কনফিগারেশনে সংরক্ষিত তথ্য সমস্ত গিট রিপোজিটরিতে প্রযোজ্য। এটি হল সবচেয়ে ব্যবহৃত পদ্ধতি।
|
||||
|
||||
গ্লোবাল কনফিগারেশনে কিছু সেট করতে, আপনি `config` কমান্ডটি এভাবে ব্যবহার করতে পারেন:
|
||||
|
||||
```bash
|
||||
$ git config --global <variable name> <value>
|
||||
```
|
||||
|
||||
ব্যবহারকারীর তথ্য সেট করার জন্য, এটি এভাবে হবে:
|
||||
|
||||
```bash
|
||||
$ git config --global user.email "you@example.com"
|
||||
$ git config --global user.name "Your Name"
|
||||
```
|
||||
|
||||
### রিপোজিটরি স্তরের কনফিগারেশন
|
||||
|
||||
এই ধরনের কনফিগারেশন শুধুমাত্র আপনার বর্তমান রিপোজিটরিতে প্রযোজ্য। যদি আপনি কোনও নির্দিষ্ট রিপোজিটরিতে কাজ করতে চান (উদাহরণস্বরূপ, কোম্পানির প্রকল্পে), তবে এই পদ্ধতি ব্যবহার করতে পারেন।
|
||||
|
||||
রিপোজিটরি স্তরের কনফিগারেশন সেট করতে, `--global` বাদ দিয়ে `config` কমান্ডটি ব্যবহার করুন:
|
||||
|
||||
```bash
|
||||
$ git config <variable name> <value>
|
||||
```
|
||||
|
||||
ব্যবহারকারীর তথ্য সেট করার জন্য, এটি এভাবে হবে:
|
||||
|
||||
```bash
|
||||
$ git config user.email "you@alternate.com"
|
||||
$ git config user.name "Your Name"
|
||||
```
|
||||
|
||||
### কমান্ড লাইনে কনফিগারেশন
|
||||
|
||||
এই ধরনের কনফিগারেশন শুধুমাত্র একটি নির্দিষ্ট কমান্ডের জন্য প্রযোজ্য। সব গিট কমান্ডে `-c` ব্যবহার করে আপনি কনফিগারেশন পরামিতি সেট করতে পারেন।
|
||||
|
||||
একটি কমান্ডের জন্য কনফিগারেশন পরিবর্তন করতে, গিট কমান্ডটি এভাবে ব্যবহার করুন:
|
||||
|
||||
```bash
|
||||
$ git -c <variable-1>=<value> -c <variable-2>=<value> <command>
|
||||
```
|
||||
|
||||
আমাদের ক্ষেত্রে, `commit` কমান্ডটি এভাবে হবে:
|
||||
|
||||
```bash
|
||||
git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Your commit message"
|
||||
```
|
||||
|
||||
### অগ্রাধিকারের ক্রম
|
||||
|
||||
এই তিনটি কনফিগারেশন পদ্ধতির মধ্যে অগ্রাধিকারের ক্রম হল: `কমান্ড লাইন > রিপোজিটরি > গ্লোবাল`। এর মানে হল যদি কোনও পরিবর্তনশীল গ্লোবাল এবং কমান্ড লাইনে উভয় ক্ষেত্রেই সেট করা থাকে, তবে কমান্ড লাইনের মান ব্যবহার করা হবে।
|
||||
|
||||
## শুধু ব্যবহারকারীর তথ্য নয়
|
||||
|
||||
এখন পর্যন্ত আমরা গিট কনফিগারেশন নিয়ে আলোচনা করেছি শুধু ব্যবহারকারীর তথ্যের ক্ষেত্রে। কিন্তু গিট আরও অনেক পরামিতি কনফিগার করতে দেয়। এখানে কিছু উল্লেখযোগ্য উদাহরণ:
|
||||
|
||||
1. `core.editor` - কমিট মেসেজ এডিট করার জন্য ব্যবহৃত টেক্সট এডিটর,
|
||||
2. `commit.template` - কমিটের জন্য প্রাথমিক টেমপ্লেট ফাইল,
|
||||
3. `color.ui` - টার্মিনালে গিট মেসেজে রঙিন ফন্ট ব্যবহার করা যাবে কিনা তা নির্ধারণ করে।
|
||||
|
||||
আরও বিস্তারিত জানতে [git-scm.com](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration) দেখুন।
|
||||
@@ -0,0 +1,58 @@
|
||||
# ওপেন সোর্স অবদানের জন্য Git অনুমতি ত্রুটি সমাধান
|
||||
|
||||
## সমস্যা
|
||||
|
||||
আমি "first-contributions" রিপোজিটরিতে অবদান রাখার চেষ্টা করার সময় একটি অনুমতি ত্রুটি পেয়েছিলাম। আমি নতুন ব্রাঞ্চ তৈরি করে এবং পরিবর্তনগুলি পুশ করার চেষ্টা করার পর:
|
||||
|
||||
```bash
|
||||
$ git checkout -b fahimar_oss_YYYY
|
||||
Switched to a new branch 'fahimar_oss_YYYY'
|
||||
|
||||
$ git push origin fahimar_oss_YYYY
|
||||
remote: Permission to firstcontributions/first-contributions.git denied to fahimar.
|
||||
fatal: unable to access 'https://github.com/firstcontributions/first-contributions.git/': The requested URL returned error: 403
|
||||
```
|
||||
|
||||
সমস্যাটি ছিল যে, আমি মূল রিপোজিটরিটি সরাসরি ক্লোন করেছিলাম এবং সেখানে পুশ করার চেষ্টা করেছিলাম। একজন বাইরের অবদানকারী হিসেবে, আমার মূল রিপোজিটরিতে লেখার অনুমতি নেই।
|
||||
|
||||
## সমাধান
|
||||
|
||||
আমি নিম্নলিখিত উপায়ে এই সমস্যাটি সমাধান করেছি:
|
||||
|
||||
1. আমার রিমোট URL পরিবর্তন করে এটিকে আমার ব্যক্তিগত ফর্কে পয়েন্ট করানো:
|
||||
|
||||
```bash
|
||||
$ git remote set-url origin https://github.com/yourname/first-contributions.git
|
||||
```
|
||||
|
||||
2. রিমোট ঠিকভাবে আপডেট হয়েছে কিনা তা যাচাই করা:
|
||||
|
||||
```bash
|
||||
$ git remote -v
|
||||
origin https://github.com/yourname/first-contributions.git (fetch)
|
||||
origin https://github.com/yourname/first-contributions.git (push)
|
||||
```
|
||||
|
||||
3. সফলভাবে আমার ফর্কে পুশ করা:
|
||||
|
||||
```bash
|
||||
$ git push origin fahimar_oss_YYYY
|
||||
```
|
||||
|
||||
4. GitHub আমাকে একটি লিঙ্ক দিয়েছিল যাতে আমি আমার ব্রাঞ্চ থেকে পুল রিকোয়েস্ট তৈরি করতে পারি:
|
||||
```
|
||||
remote: Create a pull request for 'fahimar_oss_YYYY' on GitHub by visiting:
|
||||
remote: https://github.com/fahimar/first-contributions/pull/new/fahimar_oss_YYYY
|
||||
```
|
||||
|
||||
## প্রধান শিক্ষা
|
||||
|
||||
ওপেন সোর্স অবদানের জন্য সঠিক কাজের ধারাবাহিকতা হল:
|
||||
|
||||
1. মূল রিপোজিটরিটি আপনার GitHub অ্যাকাউন্টে ফর্ক করুন
|
||||
2. আপনার ফর্কটি স্থানীয়ভাবে ক্লোন করুন
|
||||
3. একটি নতুন ব্রাঞ্চে পরিবর্তন করুন
|
||||
4. আপনার ফর্কে পুশ করুন
|
||||
5. আপনার ফর্ক থেকে মূল রিপোজিটরিতে পুল রিকোয়েস্ট তৈরি করুন
|
||||
|
||||
যদি আপনি আগে মূল রিপোজিটরি ক্লোন করে থাকেন এবং আপনার ফর্ক না করে থাকেন, তবে উপরে দেখানো মতো রিমোট URL আপডেট করে এটি ঠিক করতে পারেন।
|
||||
@@ -1,140 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-old-version-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# First Contributions
|
||||
|
||||
| <img alt="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> | Git Bash Edition |
|
||||
| ------------------------------------------------------------------------------------------------------------------ | ---------------- |
|
||||
|
||||
It's hard. It's always hard the first time you do something. Especially when you are collaborating, making mistakes isn't a comfortable thing. But open source is all about collaboration & working together. We wanted to simplify the way new open-source contributors learn & contribute for the first time.
|
||||
|
||||
Reading articles & watching tutorials can help, but what comes better than actually doing the stuff without messing up anything. This project aims at providing guidance & simplifying the way rookies make their first contribution. Remember the more relaxed you are the better you learn. If you are looking for making your first contribution just follow the simple steps below. We promise you, it will be fun.
|
||||
|
||||
If you don't have Git Bash on your windows machine, [install it](https://git-scm.com/download/win).
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt="fork this repository" />
|
||||
|
||||
## Fork this repository
|
||||
|
||||
Fork this repo by clicking on the fork button on the top right of this page.
|
||||
This will create a copy of this repository in your account.
|
||||
|
||||
## Clone the repository
|
||||
|
||||
Now clone this repo to your machine.
|
||||
|
||||
IMPORTANT: DO NOT CLONE THE ORIGINAL REPO. Go to your fork and clone it.
|
||||
|
||||
To clone the repo, click on "Code" and then copy the string down below.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copy string" />
|
||||
|
||||
Open the git bash application you just downloaded. It should look like the image down below if it's on a windows machine.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="open git bash terminal" />
|
||||
|
||||
Go to the folder that you want to save this project on by using this command
|
||||
|
||||
```bash
|
||||
cd <folder>
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-2.png" alt="cd into a folder" />
|
||||
|
||||
Use the string you copied in the step above to clone the repository using this command
|
||||
|
||||
```bash
|
||||
git clone <repo-url>
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-2.png" alt="clone the repository" />
|
||||
|
||||
Go to the directory where the repo is and open it up on vs code to make your changes.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-3.png" alt="cd into the newly cloned repo" />
|
||||
|
||||
## Create a branch
|
||||
|
||||
Now create a branch by using this simple command. This command not only creates a branch for you but also lets you switch to that branch.
|
||||
|
||||
```bash
|
||||
git checkout -b <branch-name>
|
||||
```
|
||||
|
||||
Name your branch `<add-your-name>`. For example, "add-james-smith"
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-branch.png" alt="create a branch" />
|
||||
|
||||
## Make necessary changes and commit those changes
|
||||
|
||||
Now open `Contributors.md` file in a text editor, scroll to the bottom of the page and add your name to it, then save the file.
|
||||
|
||||
Example: If your name is James Smith, It should look like this.
|
||||
|
||||
\[James Smith](https://github.com/jamessmith)
|
||||
|
||||
You can see that there are changes to Contributors.md by simply running this command
|
||||
|
||||
```bash
|
||||
git status
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="check the status" />
|
||||
|
||||
Now commit those changes:
|
||||
|
||||
First add the change you made to the staging area by using
|
||||
|
||||
```bash
|
||||
git add file-name
|
||||
```
|
||||
|
||||
Then write a commit message by sing this command
|
||||
|
||||
```bash
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
Replace `<your-name>` with your name.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit changes" />
|
||||
|
||||
To see if your commit has been made you can run a simple `git log --oneline` command.
|
||||
|
||||
## Push changes to github
|
||||
|
||||
Once you are done with the above steps you can push your changes by using this command
|
||||
|
||||
```bash
|
||||
git push origin <branch-name>
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-push.png" alt="push changes" />
|
||||
|
||||
## Submit your changes for review
|
||||
|
||||
If you go to your repository on github, you'll see `Compare & pull request` button. click on that button.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Now submit the pull request.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Soon I'll be merging all your changes into the master branch of this project. You will get a notification email once the changes have been merged.
|
||||
|
||||
## Where to go from here?
|
||||
|
||||
Congrats! You just completed the standard _fork -> clone -> edit -> PR_ workflow that you'll encounter often as a contributor!
|
||||
|
||||
Celebrate your contribution and share it with your friends and followers by going to [web app](https://firstcontributions.github.io#social-share).
|
||||
|
||||
You can join our slack team in case you need any help or have any questions. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
### [Additional material](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Tutorials Using Other Tools
|
||||
|
||||
[Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
|
||||
@@ -0,0 +1,96 @@
|
||||
|
||||
|
||||
|
||||
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# ആദ്യ സംഭാവനകൾ
|
||||
|
||||
\| <img alt="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> | Git Bash പതിപ്പ് |
|
||||
\| ------------------------------------------------- ------------------------------------------------- ------------- | ---------------- |
|
||||
|
||||
ആദ്യമായി എന്തെങ്കിലും ചെയ്യുമ്പോൾ എല്ലായ്പ്പോഴും അത് കഠിനമായി തോന്നും. പ്രത്യേകിച്ച് സഹകരിച്ച് പ്രവർത്തിക്കുമ്പോൾ തെറ്റുകൾ ചെയ്യുന്നത് ആരും ഇഷ്ടപ്പെടില്ല. പക്ഷേ **ഓപ്പൺ സോഴ്സ്** സഹകരണവും കൂട്ടായ പ്രവർത്തനവുമാണ്. പുതിയ സംഭാവനക്കാർക്ക് അവരുടെ **ആദ്യ സംഭാവന** നൽകുന്നത് എളുപ്പമാക്കാൻ ഞങ്ങൾ ആഗ്രഹിക്കുന്നു.
|
||||
|
||||
ലേഖനങ്ങൾ വായിക്കുകയോ ട്യൂട്ടോറിയലുകൾ കാണുകയോ ചെയ്യുന്നത് സഹായകരമാണ്, പക്ഷേ നേരിട്ട് ചെയ്യുന്നതിന് പകരമൊന്നുമില്ല.
|
||||
ഈ പ്രോജക്റ്റ് പുതിയവർക്ക് അവരുടെ ആദ്യ സംഭാവന നൽകുന്നത് ലളിതമാക്കുകയാണ് ലക്ഷ്യം.
|
||||
ഒരുപക്ഷേ നിങ്ങൾക്ക് ശാന്തമായിരുന്നാൽ നിങ്ങൾ കൂടുതൽ മികച്ച രീതിയിൽ പഠിക്കും.
|
||||
|
||||
നിങ്ങൾ നിങ്ങളുടെ ആദ്യ സംഭാവന നൽകാൻ ആഗ്രഹിക്കുന്നുവെങ്കിൽ, താഴെ കാണുന്ന ലളിതമായ ഘട്ടങ്ങൾ പിന്തുടരുക.
|
||||
|
||||
നിങ്ങളുടെ **Windows കമ്പ്യൂട്ടറിൽ Git Bash ഇല്ലെങ്കിൽ**, [ഇവിടെ നിന്ന് ഇൻസ്റ്റാൾ ചെയ്യുക](https://git-scm.com/download/win).
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt="ഈ റീപോസിറ്ററി Fork ചെയ്യുക" />
|
||||
|
||||
## ഈ റീപോസിറ്ററി Fork ചെയ്യുക
|
||||
|
||||
ഈ പേജിന്റെ മുകളിലെ വലത് വശത്ത് കാണുന്ന **Fork** ബട്ടൺ അമർത്തി ഈ റീപോയെ Fork ചെയ്യുക.
|
||||
ഇത് നിങ്ങളുടെ GitHub അക്കൗണ്ടിൽ ഒരു പകർപ്പ് സൃഷ്ടിക്കും.
|
||||
|
||||
## റീപോസിറ്ററി Clone ചെയ്യുക
|
||||
|
||||
ഇപ്പോൾ നിങ്ങളുടെ **Fork ചെയ്ത റീപോ** നിങ്ങളുടെ കമ്പ്യൂട്ടറിലേക്ക് Clone ചെയ്യുക.
|
||||
|
||||
പ്രധാനമാണ്: **ഒറിജിനൽ റീപോ** Clone ചെയ്യരുത്. നിങ്ങളുടെ Fork ചെയ്തത് മാത്രം Clone ചെയ്യുക.
|
||||
|
||||
Clone ചെയ്യാൻ “Code” അമർത്തി, താഴെ കാണുന്ന URL copy ചെയ്യുക.
|
||||
|
||||
```bash
|
||||
git clone <repo-url>
|
||||
```
|
||||
|
||||
പിന്നീട് നിങ്ങൾ Clone ചെയ്ത റീപോ തുറക്കാൻ git bash (അല്ലെങ്കിൽ VS Code) ഉപയോഗിക്കുക.
|
||||
|
||||
## ഒരു ബ്രാഞ്ച് സൃഷ്ടിക്കുക
|
||||
|
||||
ഒരു പുതിയ ബ്രാഞ്ച് സൃഷ്ടിക്കാൻ:
|
||||
|
||||
```bash
|
||||
git checkout -b <branch-name>
|
||||
```
|
||||
|
||||
ഉദാഹരണം: `add-your-name`
|
||||
|
||||
## ആവശ്യമായ മാറ്റങ്ങൾ വരുത്തുക
|
||||
|
||||
ഇപ്പോൾ `Contributors.md` ഫയൽ തുറന്ന്, ഏറ്റവും അവസാനം നിങ്ങളുടെ പേര് ചേർത്ത് **save** ചെയ്യുക.
|
||||
|
||||
ഉദാഹരണം:
|
||||
|
||||
```
|
||||
[ജിതിൻ പി](https://github.com/jithin-dotcom)
|
||||
```
|
||||
|
||||
ഫയൽ മാറ്റം വന്നിട്ടുണ്ടോ എന്ന് പരിശോധിക്കാൻ:
|
||||
|
||||
```bash
|
||||
git status
|
||||
```
|
||||
|
||||
## മാറ്റങ്ങൾ Commit ചെയ്യുക
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
git commit -m "നിങ്ങളുടെ പേര് Contributors പട്ടികയിൽ ചേർത്തു"
|
||||
```
|
||||
|
||||
Commit വിജയമായോ എന്ന് അറിയാൻ:
|
||||
|
||||
```bash
|
||||
git log --oneline
|
||||
```
|
||||
|
||||
## മാറ്റങ്ങൾ GitHub-ലേക്ക് Push ചെയ്യുക
|
||||
|
||||
```bash
|
||||
git push origin <branch-name>
|
||||
```
|
||||
|
||||
ഇതിന് ശേഷം, GitHub-ൽ നിങ്ങളുടെ Fork തുറക്കുമ്പോൾ **Compare & pull request** ബട്ടൺ കാണും.
|
||||
അത് അമർത്തി **Pull Request** തുറക്കുക. 🎉
|
||||
|
||||
---
|
||||
|
||||
വേണോ ഞാൻ മുഴുവൻ ഗൈഡും (പിന്നിലെ pull request ഭാഗം വരെ) മലയാളത്തിലേക്ക് convert ചെയ്ത് തരട്ടേ?
|
||||
@@ -0,0 +1,119 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/Readme/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Erste Beiträge
|
||||
|
||||
| <img alt="Visual Studio Code" src="https://upload.wikimedia.org/wikipedia/commons/1/1c/Visual_Studio_Code_1.35_icon.png" width="40"> | Visual Studio Code |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ |
|
||||
|
||||
|
||||
Es ist schwer. Es ist immer schwer, wenn man etwas zum ersten Mal macht. Vor allem, wenn man mit anderen zusammenarbeitet, ist es nicht angenehm, Fehler zu machen. Aber bei Open Source geht es gerade um Zusammenarbeit und gemeinsames Arbeiten. Wir wollten neuen Open-Source-Mitwirkenden den Einstieg erleichtern, damit sie lernen und zum ersten Mal einen Beitrag leisten können.
|
||||
|
||||
Das Lesen von Artikeln und das Anschauen von Tutorials kann hilfreich sein, aber nichts ist besser, als die Dinge einfach auszuprobieren, ohne etwas zu vermasseln. Dieses Projekt zielt darauf ab, Anfängern eine Anleitung zu bieten und ihnen den Weg zu ihrem ersten Beitrag zu erleichtern. Denke daran: Je entspannter Du bist, desto besser lernst Du. Wenn Du Deinen ersten Beitrag leisten möchtest, folge einfach den folgenden einfachen Schritten. Wir versprechen Dir, es wird Spaß machen.
|
||||
|
||||
Wenn du Visual Studio Code nicht auf deinem Computer installiert hast, [installiere es jetzt.](https://code.visualstudio.com/download).
|
||||
|
||||
**Anmerkung:** Dieses Tutorial wurde mit Visual Studio Code (Version 1.27.2) auf einem Windows 10-Rechner erstellt. Später in diesem Tutorial werden wir einige Tastaturkürzel verwenden. Diese können sich je nach Betriebssystem (macOS/Linux) und Tastatursprache (UK, DE usw.) unterscheiden. Du kannst Deine Liste der Tastaturkürzel durchsuchen, indem Du in der Befehlspalette nach „shortcut” suchst.
|
||||
|
||||
## Dieses Repository forken
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
Forke dieses Repository, indem Du oben rechts auf dieser Seite auf die Schaltfläche „Fork“ klickst. Dadurch wird eine Kopie dieses Repositorys in Ihrem GitHub-Konto erstellt.
|
||||
|
||||
GitHub verfolgt die Beziehung zwischen Ihrem Repository und dem Repository, von dem Sie es geforkt haben. Sie können sich Ihr Repository als Arbeitskopie vorstellen.
|
||||
|
||||
Die meisten Top-Level-Repositorys auf GitHub (d. h. solche, die nicht von einem anderen Repository geforkt wurden) haben ein kleines Kernteam von Personen, welche Änderungen direkt committen können. Alle anderen Mitwirkenden müssen das Repo forken und Änderungen im Fork vornehmen, dann einen Pull Request erstellen, um zu beantragen, dass ihre Änderungen wieder in das Top-Level-Repo übernommen werden. Wenn dem Administrator des Top-Level-Repos die Änderungen gefallen, werden sie übernommen und Du wirst sofort berühmt und reich! Mehr dazu später.
|
||||
|
||||
## Das Repository klonen
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Der nächste Schritt besteht darin, Dein Repository auf Deinen Computer zu klonen, damit Du Änderungen vornehmen kannst. VS Code benötigt die URL Deines Repositories, also klicke auf die Schaltfläche „Code“ und dann auf das Symbol „In die Zwischenablage kopieren“.
|
||||
|
||||
**ACHTUNG:** Ein Fehler, den neue Mitwirkende oft machen, ist, dass sie das Repository, von dem sie geforkt haben klonen an Stelle ihres eigenen. Überprüfe die Adressleiste Deines Browsers und stelle sicher, dass Du Dein Repository klonst.
|
||||
|
||||
Öffne nun Visual Studio Code. Die Willkommensseite von VS Code wird angezeigt. Drücke `F1`, um die Leiste zu öffnen, die unten gezeigt wird. Beachte, dass bereits ein `>` (größer als) Zeichen im Textfeld steht. Du kannst auch über `CTRL-P` zum Eingabeaufforderung gelangen und das `>`-Zeichen eingeben.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-clone.png" alt="Clone Popup (Command Popup)" />
|
||||
|
||||
Vielleicht bemerkst Du, dass bereits einige obskure Befehle aufgelistet sind. Das sind meine zuletzt verwendeten Befehle. Also kümmere Dich nicht darum.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-clone1.png" alt="Clone repo" />
|
||||
|
||||
Nun tippe `git clone`, nur `git` oder `clone` (es funktioniert wie eine Suche).
|
||||
Wähle den Eintrag `Git: Clone` aus und drücke `Enter`.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-clone2.png" alt="Paste Repository URL in" />
|
||||
|
||||
Füge die URL Deines Repositories ein und drücke `Enter`. Dadurch wird der Datei-Explorer geöffnet, in dem Du auswählen kannst, wo das Git-Repository gespeichert werden soll.
|
||||
|
||||
**Wichtig**: Achte darauf, dass es sich um das geforkte Repository handelt und nicht um das Original, da es sonst nicht funktioniert.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-clone3.png" alt="Status popup" />
|
||||
|
||||
Du solltest eine Statusmeldung in der unteren rechten Ecke von Visual Studio Code sehen. Nachdem der Vorgang abgeschlossen ist, kannst Du das geklonte Repository (jetzt ein Ordner auf Deinem Computer) mit den Schaltflächen im Dialogfeld öffnen.
|
||||
|
||||
## Erstelle einen Branch
|
||||
|
||||
Öffne die Befehls-Palette erneut, indem Du `F1` drückst. Tippe `branch` ein und wähle den Befehl `create branch` aus. Im nächsten Schritt gib den Namen Deines neuen Branches ein, zum Beispiel `add-david-kroell`. Drücke `Enter`, um den Branch zu erstellen. Der Branch ist auch bereits ausgecheckt. [Was bedeutet checkout?](https://www.git-scm.com/docs/git-checkout)
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-branch.png" alt="Branches Command Palette" />
|
||||
|
||||
## Nötige Änderungen vornehmen
|
||||
|
||||
Öffne `Contributors.md` in einem Texteditor und füge Deinen Namen hinzu. Achte darauf, dass Du den Namen nicht am Anfang oder am Ende der Datei hinzufügst. Speichere die Datei anschließend.
|
||||
Diese Datei enthält GFM (GitHub Flavored Markdown), eine proprietäre Variante der <a href="https://en.wikipedia.org/wiki/Markdown">Markdown-Syntax</a>.
|
||||
|
||||
Kopiere eine der anderen Mitwirkenden-Zeilen und passe sie mit Deinem Namen an, um sicherzustellen, dass die Syntax korrekt ist - sie kann schwierig sein. Speichere die Datei, um die Änderung zu registrieren.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-changes.png" alt="Add your name" />
|
||||
|
||||
## Änderungen committen und zu GitHub pushen
|
||||
|
||||
Auf der linken Seite von VS Code befindet sich ein Menü mit 5 Symbolen. Wähle das Versionskontroll-/Quellcodeverwaltungssymbol aus.
|
||||
(Shortcut: `Ctrl + Shift + G`)
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-commit.png" alt="Commit changes" />
|
||||
|
||||
Der Datei-Explorer zeigt alle Dateien an, die seit dem letzten Commit geändert wurden. Wenn Du mit der Maus über die Dateien fährst und auf das `+` (Plus) klickst, werden die Dateien zum Staging hinzugefügt.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-commit1.png" alt="Stashed Files">
|
||||
|
||||
Tippe etwas in die Zeile oben im Explorer und drücke das Häkchen. Die Änderungen sind jetzt in Deiner lokalen Kopie committed. Jetzt müssen die Änderungen zurück zu GitHub gepusht werden.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-push.png" alt="Stashed Files">
|
||||
|
||||
Klicke auf das Drei-Punkte-Symbol, um das Menü zu öffnen, in dem Du die Option `Publish Branch` auswählst. Dadurch sollte ein Dialogfeld geöffnet werden, in dem Du Deine GitHub-Anmeldeinformationen eingeben kannst.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-windows-vs-code-tutorial/vscode-2018-08-gh-auth.png" alt="Stashed Files">
|
||||
|
||||
## Änderungen zur Überprüfung absenden
|
||||
|
||||
An diesem Punkt hast Du Deine Änderung abgeschlossen, aber sie befindet sich noch nur in Deinem Repository. Dieser Schritt zeigt Dir, wie Du eine Anfrage an den Administrator des Top-Level-Repos stellen kannst, um Deine Änderung zusammenzuführen.
|
||||
|
||||
In Deinem Repository auf GitHub siehst Du neben der Benachrichtigung über den neuen Branch die Schaltfläche `Compare & pull request`. Klicke auf diese Schaltfläche.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Sende jetzt den Pull Request ab.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Ich werde nun Deine Änderungen in den Master-Branch dieses Projekts mergen. Du erhältst eine E-Mail, sobald dies geschehen ist.
|
||||
|
||||
## Und jetzt?
|
||||
|
||||
Herzlichen Glückwunsch! Du hast gerade den Standard-Workflow _fork -> clone -> edit -> PR_ abgeschlossen, den Du als Contributor häufig antreffen wirst!
|
||||
|
||||
Feiere Deinen Beitrag zum Projekt und teile ihn mit Deinen Freunden und Followern über unsere [Web-App](https://firstcontributions.github.io#social-share).
|
||||
|
||||
Du kannst dem Slack-Team beitreten, falls Du Hilfe benötigst oder Fragen hast. [Slack-Team beitreten](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
|
||||
### [Weiterführende Materialien](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Tutorials mit anderen Tools
|
||||
[Zurück zur Hauptseite](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
|
||||
@@ -0,0 +1,73 @@
|
||||
# ఓపెన్ సోర్స్కు ఎలా సహకరించాలి: ప్రారంభకులకు సమగ్ర మార్గదర్శి
|
||||
|
||||
TL;DR మీరు ఓపెన్ సోర్స్ ప్రాజెక్ట్కి మీ మొదటి పుల్ అభ్యర్థనను చేయాలనుకుంటున్నట్లయితే, [Readme](https://github.com/firstcontributions/first-contributions)లోని సూచనలను అనుసరించండి.
|
||||
|
||||
డెవలపర్గా ఎదగడానికి, మీ పోర్ట్ఫోలియోను రూపొందించడానికి మరియు కమ్యూనిటీకి తిరిగి ఇవ్వడానికి ఓపెన్ సోర్స్కు సహకారం అందించడం అనేది అత్యంత బహుమతినిచ్చే మార్గాలలో ఒకటి. మీరు అనుభవజ్ఞుడైన ప్రోగ్రామర్ అయినా లేదా ఇప్పుడే ప్రారంభించినా, ఓపెన్ సోర్స్ తెలుసుకోవడానికి, సహకరించడానికి మరియు ప్రభావం చూపడానికి అంతులేని అవకాశాలను అందిస్తుంది. ఈ గైడ్లో, సరైన ప్రాజెక్ట్ను కనుగొనడం నుండి మీ మొదటి సహకారం అందించడం వరకు ఓపెన్ సోర్స్కు సహకరించడం గురించి మీరు తెలుసుకోవలసిన ప్రతిదానిని మేము మీకు తెలియజేస్తాము.
|
||||
|
||||
## ఓపెన్ సోర్స్కి ఎందుకు సహకరించాలి?
|
||||
|
||||
"ఎలా"లోకి ప్రవేశించే ముందు, "ఎందుకు" అనేదాన్ని అన్వేషిద్దాం. ఓపెన్ సోర్స్కు సహకారం అందించడం వలన అనేక ప్రయోజనాలను అందిస్తుంది:
|
||||
|
||||
* నైపుణ్యాభివృద్ధి: ఓపెన్ సోర్స్ ప్రాజెక్ట్లు మిమ్మల్ని వాస్తవ ప్రపంచ కోడ్బేస్లకు బహిర్గతం చేస్తాయి, మీ కోడింగ్, డీబగ్గింగ్ మరియు సహకార నైపుణ్యాలను మెరుగుపరచడంలో మీకు సహాయపడతాయి.
|
||||
* పోర్ట్ఫోలియో బిల్డింగ్: ప్రసిద్ధ ప్రాజెక్ట్లకు విరాళాలు మీ రెజ్యూమ్ మరియు GitHub ప్రొఫైల్ను మెరుగుపరుస్తాయి, తద్వారా మీరు సంభావ్య యజమానులకు ప్రత్యేకంగా నిలుస్తారు.
|
||||
* నెట్వర్కింగ్: మీరు ప్రపంచవ్యాప్తంగా ఉన్న డెవలపర్లతో కనెక్ట్ అవుతారు, నిపుణుల నుండి నేర్చుకుంటారు మరియు గ్లోబల్ కమ్యూనిటీలో భాగం అవుతారు.
|
||||
* గివింగ్ బ్యాక్: ఓపెన్ సోర్స్ మనం రోజూ ఉపయోగించే చాలా సాఫ్ట్వేర్లకు శక్తినిస్తుంది. మీరు ఆధారపడే సాధనాలు మరియు సాంకేతికతలకు మద్దతు ఇవ్వడానికి సహకారం అందించడం ఒక మార్గం.
|
||||
* కెరీర్ అవకాశాలు: చాలా కంపెనీలు ఓపెన్ సోర్స్ అనుభవంతో డెవలపర్లను చురుకుగా కోరుకుంటాయి, ఎందుకంటే ఇది చొరవ మరియు జట్టుకృషిని ప్రదర్శిస్తుంది.
|
||||
|
||||
## ఓపెన్ సోర్స్ కంట్రిబ్యూషన్లతో ఎలా ప్రారంభించాలి
|
||||
|
||||
### 1. సరైన ప్రాజెక్ట్ను ఎంచుకోండి
|
||||
|
||||
సరైన ప్రాజెక్ట్ను కనుగొనడం చాలా ముఖ్యం. మీ ఆసక్తులు, నైపుణ్యం స్థాయి మరియు లక్ష్యాలకు అనుగుణంగా ఉండే ప్రాజెక్ట్ల కోసం చూడండి. వాటిని ఎలా కనుగొనాలో ఇక్కడ ఉంది:
|
||||
|
||||
* GitHubని అన్వేషించండి: GitHub యొక్క అన్వేషణ పేజీని ఉపయోగించండి లేదా "గుడ్-ఫస్ట్-ఇష్యూ" లేదా "హెల్ప్-వాంటెడ్" వంటి అంశాల కోసం శోధించండి.
|
||||
* ఓపెన్ సోర్స్ ప్రోగ్రామ్లను తనిఖీ చేయండి: గూగుల్ సమ్మర్ ఆఫ్ కోడ్ లేదా హ్యాక్టోబర్ఫెస్ట్ వంటి ప్రోగ్రామ్లు ప్రారంభకులకు గొప్పవి.
|
||||
* మీ సాధనాలను అనుసరించండి: మీరు ఇప్పటికే ఉపయోగిస్తున్న లైబ్రరీలు, ఫ్రేమ్వర్క్లు లేదా సాధనాలకు సహకరించండి.
|
||||
|
||||
### 2. ప్రాజెక్ట్ను అర్థం చేసుకోండి
|
||||
|
||||
సహకరించే ముందు, ప్రాజెక్ట్ను అర్థం చేసుకోవడానికి సమయాన్ని వెచ్చించండి:
|
||||
|
||||
* డాక్యుమెంటేషన్ను చదవండి: README ఫైల్, సహకార మార్గదర్శకాలు మరియు ప్రవర్తనా నియమావళితో ప్రారంభించండి.
|
||||
* కోడ్బేస్ను అన్వేషించండి: ప్రాజెక్ట్ నిర్మాణం మరియు కోడింగ్ శైలితో మిమ్మల్ని మీరు పరిచయం చేసుకోండి.
|
||||
* సంఘంలో చేరండి: కమ్యూనిటీ కోసం ఒక అనుభూతిని పొందడానికి ఫోరమ్లు, స్లాక్ లేదా డిస్కార్డ్పై చర్చల్లో పాల్గొనండి.
|
||||
|
||||
### 3. చిన్నగా ప్రారంభించండి
|
||||
|
||||
విశ్వాసాన్ని పెంపొందించడానికి చిన్న, నిర్వహించదగిన పనులతో ప్రారంభించండి:
|
||||
|
||||
* బగ్లను పరిష్కరించండి: "మంచి-మొదటి సమస్య" లేదా "బిగినర్స్-ఫ్రెండ్లీ" అని లేబుల్ చేయబడిన సమస్యల కోసం చూడండి.
|
||||
* డాక్యుమెంటేషన్ను మెరుగుపరచండి: డాక్యుమెంటేషన్ అప్డేట్లు తరచుగా విస్మరించబడతాయి కానీ చాలా విలువైనవి.
|
||||
* పరీక్షలు రాయండి: పరీక్షలను జోడించడం అనేది కోడ్బేస్ గురించి తెలుసుకోవడానికి మరియు సహకరించడానికి ఒక గొప్ప మార్గం.
|
||||
|
||||
### 4. ఉత్తమ పద్ధతులను అనుసరించండి
|
||||
|
||||
సహకరించేటప్పుడు, ప్రాజెక్ట్ మార్గదర్శకాలకు కట్టుబడి ఉండండి:
|
||||
|
||||
* ఫోర్క్ మరియు క్లోన్: రిపోజిటరీని ఫోర్క్ చేసి మీ స్థానిక మెషీన్కు క్లోన్ చేయండి.
|
||||
* ఒక శాఖను సృష్టించండి: మీ మార్పుల కోసం ప్రత్యేక శాఖలో పని చేయండి.
|
||||
* క్లీన్ కోడ్ వ్రాయండి: ప్రాజెక్ట్ యొక్క కోడింగ్ ప్రమాణాలను అనుసరించండి మరియు స్పష్టమైన, సంక్షిప్త కోడ్ను వ్రాయండి.
|
||||
* మీ మార్పులను పరీక్షించండి: మీ మార్పులు ఇప్పటికే ఉన్న కార్యాచరణను విచ్ఛిన్నం చేయలేదని నిర్ధారించుకోండి.
|
||||
* ఒక పుల్ అభ్యర్థన (PR) సమర్పించండి: స్పష్టమైన PR వివరణ, సూచన సంబంధిత సమస్యలను వ్రాయండి మరియు అభిప్రాయానికి సిద్ధంగా ఉండండి.
|
||||
|
||||
## ఓపెన్ సోర్స్లో విజయం కోసం చిట్కాలు
|
||||
|
||||
ప్రభావవంతంగా కమ్యూనికేట్ చేయండి: అన్ని పరస్పర చర్యలలో గౌరవప్రదంగా మరియు వృత్తిపరంగా ఉండండి. అవసరాల గురించి అస్పష్టంగా ఉన్నప్పుడు ప్రశ్నలు అడగండి. సమీక్షకులకు వారి సమయం మరియు అభిప్రాయానికి ధన్యవాదాలు. సమీక్ష ప్రక్రియలో ఓపికగా ఉండండి
|
||||
|
||||
స్థిరంగా ఉండండి: రెగ్యులర్ కంట్రిబ్యూషన్లు, చిన్నవి కూడా, కాలక్రమేణా పెద్ద ప్రభావాన్ని చూపుతాయి.
|
||||
|
||||
అభిప్రాయం నుండి నేర్చుకోండి: కోడ్ సమీక్షలు నేర్చుకునే అవకాశం. అభిప్రాయాన్ని స్వీకరించండి మరియు మీ నైపుణ్యాలను మెరుగుపరచండి.
|
||||
|
||||
తిరిగి ఇవ్వండి: మీరు సౌకర్యవంతంగా ఉన్న తర్వాత, PRలను సమీక్షించడం, ప్రశ్నలకు సమాధానం ఇవ్వడం లేదా కొత్తవారికి మార్గదర్శకత్వం చేయడం ద్వారా ఇతరులకు సహాయం చేయండి.
|
||||
|
||||
## సాధారణ సవాళ్లు మరియు వాటిని ఎలా అధిగమించాలి
|
||||
|
||||
* ఇంపోస్టర్ సిండ్రోమ్: చాలా మంది ప్రారంభకులు తమకు సహకరించడానికి తగినంత నైపుణ్యం లేదని భావిస్తారు. గుర్తుంచుకోండి, ప్రతి ఒక్కరూ ఎక్కడో ఒకచోట ప్రారంభించబడతారు మరియు చిన్న విరాళాలు కూడా ముఖ్యమైనవి.
|
||||
* సమయాన్ని కనుగొనడం: చిన్న, నిర్వహించదగిన పనులతో ప్రారంభించండి. వారానికి 30 నిమిషాలు కూడా తేడా రావచ్చు.
|
||||
* పెద్ద కోడ్బేస్లను నావిగేట్ చేయడం: అభ్యాస ప్రక్రియను విచ్ఛిన్నం చేయండి: - డాక్యుమెంటేషన్ను పూర్తిగా చదవడం ద్వారా ప్రారంభించండి - ఒక సమయంలో ఒక భాగాన్ని అర్థం చేసుకోవడంపై దృష్టి పెట్టండి - కోడ్ అమలును ట్రేస్ చేయడానికి డీబగ్గింగ్ సాధనాలను ఉపయోగించండి - స్పష్టత కోసం అడగడానికి వెనుకాడకండి
|
||||
|
||||
## తీర్మానం
|
||||
|
||||
ఓపెన్ సోర్స్కు సహకరించడం అనేది అపారమైన వ్యక్తిగత మరియు వృత్తిపరమైన వృద్ధిని అందించే ప్రయాణం. చిన్నగా ప్రారంభించడం ద్వారా, స్థిరంగా ఉండటం మరియు సంఘంతో సన్నిహితంగా ఉండటం ద్వారా, మీరు మీ నైపుణ్యాలను మెరుగుపరుచుకుంటూ అర్ధవంతమైన సహకారాన్ని అందించవచ్చు. గుర్తుంచుకోండి, ఓపెన్ సోర్స్ సహకారంతో అభివృద్ధి చెందుతుంది మరియు ప్రతి సహకారం-ఎంత చిన్నదైనా-మెరుగైన డిజిటల్ ప్రపంచాన్ని నిర్మించడంలో సహాయపడుతుంది. మునిగిపోవడానికి సిద్ధంగా ఉన్నారా? మిమ్మల్ని ఉత్తేజపరిచే ప్రాజెక్ట్ను కనుగొనండి, మీ మొదటి సహకారాన్ని అందించండి మరియు ఈరోజే గ్లోబల్ ఓపెన్ సోర్స్ ఉద్యమంలో చేరండి!
|
||||
|
||||
## చివరి సమాధా
|
||||
@@ -70,3 +70,4 @@ Give Back: Once you’re comfortable, help others by reviewing PRs, answering qu
|
||||
|
||||
Contributing to open source is a journey that offers immense personal and professional growth. By starting small, staying consistent, and engaging with the community, you can make meaningful contributions while honing your skills. Remember, open source thrives on collaboration, and every contribution—no matter how small—helps build a better digital world. Ready to take the plunge? Find a project that excites you, make your first contribution, and join the global open source movement today!
|
||||
|
||||
Open source is more than just code — it’s about people, collaboration, and continuous learning. By taking small, consistent steps and engaging with the community, you’ll not only grow as a developer but also make meaningful contributions to projects used by millions.
|
||||
@@ -114,7 +114,7 @@ Urime! Ti sapo ke kompletuar procesin _fork -> clone -> edit -> PR_ që do ta ha
|
||||
|
||||
Festoje kontributin tënd dhe ndaje me shokët dhe ndjekësit duke shkuar te [web aplikacioni](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Ti mund të bashkohesh në ekipin tonë në slack nëse të duhet ndihmë ose nëse ke ndonjë pyetje. [Bashkohu ekipit në slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
Nëse dëshiron më shumë praktikë, shiko [kontributet e kodit](https://github.com/roshanjossey/code-contributions)
|
||||
|
||||
Tani të të ndihmojmë që të kontribuosh në projekte tjera. Ne kemi krijuar një listë projektesh me probleme të lehta tek të cilat mund të fillosh. Shiko [listën e projekteve në web apliacion](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
|
||||
@@ -115,7 +115,6 @@ git push origin <add-your-branch-name>
|
||||
|
||||
### [Допълнителни материали](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
## Уроци за иползването на други приложения
|
||||
|
||||
| <a href="../gui-tool-tutorials/github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="../gui-tool-tutorials/github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a> | <a href="../gui-tool-tutorials/gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="100"></a> | <a href="../gui-tool-tutorials/github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/1/1c/Visual_Studio_Code_1.35_icon.png" width=100></a> | <a href="../gui-tool-tutorials/sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a> | <a href="../gui-tool-tutorials/github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/9c/IntelliJ_IDEA_Icon.svg/512px-IntelliJ_IDEA_Icon.svg.png" width=100></a> |
|
||||
|
||||
@@ -121,7 +121,7 @@ git push origin -u <your-new-branch-name>
|
||||
|
||||
আপনার অবদানের আনন্দ উপভোগ করুন এবং [ওয়েব অ্যাপ](https://firstcontributions.github.io/#social-share)-এর মাধ্যমে বন্ধু ও অনুসরণকারীদের সাথে শেয়ার করুন।
|
||||
|
||||
যদি আপনি আরও অনুশীলন করতে চান, তাহলে [কোড অবদানগুলি](https://https://github.com/roshanjossey/code-contributions) চেকআউট করুন।
|
||||
যদি আপনি আরও অনুশীলন করতে চান, তাহলে [কোড অবদানগুলি](https://github.com/roshanjossey/code-contributions) চেকআউট করুন।
|
||||
|
||||
এখন আপনি অন্যান্য প্রজেক্টগুলোতেও অবদান রাখতে পারেন। আপনার সুবিধার্থে আমরা সহজ সমস্যা সম্বলিত প্রজেক্টগুলোর একটি তালিকা তৈরি করেছি। ওয়েব অ্যাপে [প্রজেক্টগুলোর তালিকা](https://firstcontributions.github.io/#project-list) দেখুন।
|
||||
|
||||
|
||||
+105
-59
@@ -1,120 +1,166 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# Erste Beiträge
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="Repository forken" />
|
||||
# First Contributions
|
||||
|
||||
Aller Anfang ist schwer. Gerade dann, wenn wir gemeinsam an etwas arbeiten, will niemand etwas Falsches tun. Aber Open Source dreht sich um Kooperation und lebt von den Beiträgen vieler Freiwilliger. Deshalb haben wir es uns zur Aufgabe gemacht, neuen Mitgliedern in der Open-Source-Gemeinde ihre ersten Schritte so einfach wie möglich zu machen.
|
||||
Dieses Projekt zielt darauf ab, Anfängern den Einstieg zu erleichtern und sie bei ihrem ersten Beitrag zu unterstützen. Wenn du deinen ersten Beitrag leisten möchten, befolge die folgenden Schritte.
|
||||
|
||||
Natürlich helfen die vorhandenen Artikel und Videoanleitungen. Aber was kann besser sein, als es einfach einmal auszuprobieren mit dem Wissen, dass man nichts kaputt machen kann? Dieses Projekt will Anfängern zeigen, wie sie möglichst einfach ihren ersten Beitrag leisten. Bedenke: Je entspannter du bist, desto besser lernst du. Wenn du deinen ersten Beitrag leisten möchtest, folge diesen einfachen Schritten. Wir versprechen dir, es wird Spaß machen.
|
||||
_Wenn du nicht weißt wie man das Terminal/CMD bedient, [hier findest du Anleitungen für GUI Tools.](#Anleitungen-für-andere-Tools)_
|
||||
|
||||
Wenn du Git noch nicht installiert hast, [installiere es](https://help.github.com/articles/set-up-git/)
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="Forke dieses Repository" />
|
||||
|
||||
## Repository forken
|
||||
#### Wenn du Git nicht auf deinem System installiert hast, [installiere es](https://...github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
Forke das Repository durch das Anklicken der Schaltfläche "Fork". Dadurch erhältst du deine eigene Version des Projektes in deinem Profil.
|
||||
## Forke dieses Repository
|
||||
|
||||
## Repository klonen
|
||||
Forke dieses Repository indem du auf den Fork Button oben auf dieser Seite klickst.
|
||||
Dies wird eine Kopie dieses Repository's in deinem Account erstellen.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="Repository klonen" />
|
||||
## Klone das Repository
|
||||
|
||||
Klone das Repository auf deinen Computer. Klicke auf die Schaltfläche "Clone or download" und anschließend auf das "copy to clipboard"-Symbol.
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="Klone dieses Repository" />
|
||||
|
||||
Öffne eine Kommandozeile und gib den folgenden git-Befehl ein:
|
||||
Klone jetzt das geforkte Repository auf deinen Computer. Gehe zu deinem Github Account, öffne das geforkte Repository, drücke auf den Code Button, dann auf den SSH Tab und dann drücke auf das _copy url to clipboard_ icon.
|
||||
|
||||
```
|
||||
git clone "Deine kopierte URL"
|
||||
Öffne ein Terminal Fenster und führe den folgenden Git Befehl aus:
|
||||
|
||||
```bash
|
||||
git clone "kopierte url"
|
||||
```
|
||||
|
||||
Statt 'Deine kopierte URL' (ohne Anführungszeichen) füge die Repository-URL aus dem vorherigen Schritt ein.
|
||||
wobei "kopierte url" (ohne die Anführungszeichen) die url zu diesem Repository ist (deine Fork von diesem Projekt). Im vorherigen Schritt siehst du wie du diese erhälst .
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="URL kopieren" />
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="URL in die Zwischenablage kopieren" />
|
||||
|
||||
Beispiel:
|
||||
Zum Beispiel:
|
||||
|
||||
```
|
||||
git clone https://github.com/dein-Name/first-contributions.git
|
||||
```bash
|
||||
git clone git@github.com:das-bist-du/erster-Beitrag.git
|
||||
```
|
||||
|
||||
An der Stelle 'dein-Name' muss dein GitHub-Nutzername stehen. Mit diesem Befehl kopierst du den Inhalt deines first-contributions-Repository von GitHub auf deinen Computer.
|
||||
wobei `das-bist-du` dein Github Nutzername ist. Hier kopierst du den Inhalt des first-contributions Repository's auf Github auf deinen Computer.
|
||||
|
||||
## Erstelle einen Branch
|
||||
## Erstelle einen Zweig
|
||||
|
||||
Wechsle zum Repository-Verzeichnis auf deinem Computer (falls du es nicht schon getan hast).
|
||||
Wechsle zum Repository Ordner (wenn du nicht bereits dort bist):
|
||||
|
||||
```
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Erstelle nun einen Branch mit dem Befehl `git checkout`:
|
||||
Erstelle nun einen Zweig, indem du den `git switch` Befehl benutzst:
|
||||
|
||||
```
|
||||
git checkout -b <add-dein-Name>
|
||||
```bash
|
||||
git switch -c dein-neuer-zweig-name
|
||||
```
|
||||
|
||||
Beispiel:
|
||||
Zum Beispiel:
|
||||
|
||||
```
|
||||
git checkout -b add-max-mustermann
|
||||
```bash
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
(Der Name des Branches muss nicht unbedingt das Wort _add_ beinhalten aber hier ist es sinnvoll, denn der Zweck deines Branches ist es ja, deinen Namen zur Liste hinzuzufügen.)
|
||||
<details>
|
||||
<summary> <strong>Wenn du auf irgendeinen Fehler bei der Nutzung von git switch stößt, drücke hier:</strong> </summary>
|
||||
|
||||
## Mache die nötigen Änderungen und committe sie
|
||||
Wenn die Fehlermeldung "Git: `switch` is not a git command. See `git –help`" erscheint, liegt dies wahrscheinlich daran das du eine veraltete Version von Git nutzt.
|
||||
|
||||
Öffne `Contributors.md` in einem Text-Editor und füge deine Namen hinzu. Beachte, dass du den Namen nicht am Anfang oder am Ende der Datei hinzufügst. Speichere die Datei anschließend.
|
||||
|
||||
Gibst du in der Kommandozeile nun `git status` ein, siehst du die Änderungen.
|
||||
|
||||
Füge die Änderungen mit dem Befehl `git add` zu deinem eben erstellten Branch hinzu:
|
||||
In diesem Fall versuche stattdessen `git checkout` zu nutzen:
|
||||
|
||||
```bash
|
||||
git checkout -b dein-neuer-zweig-name
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## Make necessary changes and commit those changes
|
||||
|
||||
Öffne nun die Datei `Contributors.md` in einem Texteditor und füge deinen Namen hinzu. Füge ihn nicht ganz am Anfang oder am Ende hinzu, sondern irgendwo dazwischen, mittendrin. Speichere jetzt die Datei.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Wenn du in den Projektordner gehst und den Befehl `git status`, ausführst werden dir die Änderungen angezeigt.
|
||||
|
||||
Füge diese Änderungen nun zu dem Zweig hinzu den du gerade erstellt hast, indem du den Befehl `git add` ausführst.
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Nun committest du deine Änderungen mit `git commit`:
|
||||
Jetzt commite diese Änderungen mit dem `git commit` Befehl:
|
||||
|
||||
```
|
||||
git commit -m "Add <dein-Name> to Contributors list"
|
||||
```bash
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
Ersetze `<dein-Name>` mit deinem Namen.
|
||||
ersetze `your-name` mit deinem Namen.
|
||||
|
||||
## Pushe die Änderung zu GitHub
|
||||
## Änderungen auf Github pushen
|
||||
|
||||
Pushe die Änderungen mit `git push`:
|
||||
Übertrage deine Änderungen mit `git push`:
|
||||
|
||||
```
|
||||
git push origin <add-dein-Name>
|
||||
```bash
|
||||
git push -u origin dein-zweig-name
|
||||
```
|
||||
|
||||
Ersetze `<add-dein-Name>` mit dem Namen des Branches, den du zuvor erstellt hast.
|
||||
ersetze `dein-zweig-name` mit dem Namen des Zweiges den du vorhin erstellt hast.
|
||||
|
||||
## Sende deine Änderungen zum Review
|
||||
<details>
|
||||
<summary> <strong>Solltest du auf irgendwelche Fehler beim Pushen stoßen, drücke hier:</strong> </summary>
|
||||
|
||||
Wenn du jetzt zu deinem Repository auf GitHub gehst, siehst du einen Knopf `Compare & pull request`. Klicke darauf.
|
||||
- ### Authentifizierungs Fehler
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Gehe zu [GitHub's tutorial](https://...github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) wie du einen ssh Key zu deinem Account hinzufügst und konfigurierst.
|
||||
Außerdem, kannst du 'git remote -v' ausführen um deine Remote Addresse anzuzeigen.
|
||||
|
||||
Wenn es so aussieht:
|
||||
<pre>origin https://github.com/your-username/your_repo.git (fetch)
|
||||
origin https://github.com/your-username/your_repo.git (push)</pre>
|
||||
|
||||
ändere es mit diesem Befehl:
|
||||
```bash
|
||||
git remote set-url origin git@github.com:dein-nutzername/dein_repo.git
|
||||
```
|
||||
Ansonsten wirst du noch immer aufgefordert Passwort und Benutzername einzugeben und bekommst einen Authentifizierungs Fehler.
|
||||
</details>
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="Erstelle einen pull request" />
|
||||
## Reiche deine Änderungen für ein Review ein
|
||||
|
||||
Erstelle einen Pull Request indem du auf die Schaltfläche `Create pull request` klickst.
|
||||
Wenn du jetzt zu deinem Repository auf Github gehts, wirst du einen `Compare & pull request` Knopf sehen. Drücke diesen Knopf.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="Pull Request senden" />
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="erstelle eine Pull-Request" />
|
||||
|
||||
Roshan Jossey wird nun deine Änderungen in den Master Branch dieses Projekts mergen. Du erhältst eine E-Mail, sobald dies geschehen ist.
|
||||
Jetzt, reiche deine Pull-Request ein.
|
||||
|
||||
## Wie geht es weiter?
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="Reiche deine Pull-Request ein" />
|
||||
|
||||
Glückwunsch! Du hast so eben den Standard-Workflow _Fork -> Clone -> Edit -> Pull Request_ beendet, der dir als Mitwirkender häufig begegnen wird.
|
||||
Bald werde ich alle deine Änderungen in den Haupt-Zweig dieses Projektes mergen. Du wirst eine Benachrichtigungs Email bekommen sobald die Änderungen gemerged wurden.
|
||||
|
||||
Feiere deinen Beitrag zum Projekt und teile ihn mit deinen Freunden und Followern über unsere [Web-App](https://firstcontributions.github.io/#social-share).
|
||||
## Was nun?
|
||||
|
||||
Wenn Du noch mehr üben möchtest, schau Dir das [Code-Contributions Repository](https://github.com/roshanjossey/code-contributions) an.
|
||||
Falls du jetzt zu anderen Projekten beitragen möchtest, dann haben wir für dich eine Liste von einfachen, ersten Issues zusammengestellt, an denen du arbeiten kannst. Diese Projekt-Liste findest du [in unserer Web-App](https://firstcontributions.github.io/#project-list).
|
||||
Gratulation! Du hast gerade den Standard _Forken -> Klonen -> Bearbeiten -> Pull-Request_ Workflow durchgeführt, dem du als Beitragender oft begegnen wirst!
|
||||
|
||||
## Tutorials mit anderen Tools
|
||||
Feier deinen Beitrag und teile in mit deinen Freunden und Followern indem du hier drückst [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Wenn du gerne mehr Übung hättest, schau dir [code contributions](https://github.com/roshanjossey/code-contributions) an.
|
||||
|
||||
Jetzt los gehts, mit Beiträgen zu anderen Projekten. Wir haben eine Liste von Projekten mit leichten Fehlern für Einsteiger bereitgestellt. Schau dir [die Liste der Projekte in der Web-App an](https://firstcontributions.github.io/#project-list) an.
|
||||
|
||||
### [Zusätzliches Material](../additional-material)
|
||||
|
||||
## Anleitungen für andere Tools
|
||||
|
||||
| <a href="../gui-tool-tutorials/github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="../gui-tool-tutorials/github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a> | <a href="../gui-tool-tutorials/gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="100"></a> | <a href="../gui-tool-tutorials/github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/1/1c/Visual_Studio_Code_1.35_icon.png" width=100></a> | <a href="../gui-tool-tutorials/sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a> | <a href="../gui-tool-tutorials/github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/9c/IntelliJ_IDEA_Icon.svg/512px-IntelliJ_IDEA_Icon.svg.png" width=100></a> |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |
|
||||
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |
|
||||
|
||||
<p>Dieses Projekt wird unterstützt von:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
# <div dir="rtl">مساهمتك الأولى</div>
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/Readme/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
@@ -83,7 +82,7 @@ Ahora haz un *commit* sobre estos cambios ejecutando el comando `git commit`:
|
||||
```
|
||||
git commit -m "Add <tu-nombre> to Contributors list"
|
||||
```
|
||||
cambiando `<tu-nombre>` por tu nombre.
|
||||
Cambiando `<tu-nombre>` por tu nombre.
|
||||
|
||||
## Sube (*Push*) tus cambios a GitHub
|
||||
|
||||
@@ -111,7 +110,7 @@ Pronto estaré fusionando tus cambios (haciendo *merge*) con la rama master de e
|
||||
|
||||
Celebra tu contribución y compártela con tus amigos y seguidores yendo a [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
También podrías unirte a nuestro *equipo* de Slack en caso de que necesites ayuda o tengas alguna pregunta. [Únete a nuestro Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
Si quieres más práctica, echa un vistazo a [contribuciones de código](https://github.com/roshanjossey/code-contributions).
|
||||
|
||||
Ahora empieza a contribuir en otros proyectos. Hemos reunido una lista de proyectos con *issues* sencillas para que puedas empezar. Échale un ojo a la [lista de proyectos en la aplicación web](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
|
||||
@@ -49,7 +49,7 @@ git clone https://github.com/this-is-you/first-contributions.git
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Τώρα δημιουργείστε ένα νέο παρακλάδι χρησιμοποιώντας την εντολή `git switch` :
|
||||
Τώρα δημιουργήστε ένα νέο παρακλάδι χρησιμοποιώντας την εντολή `git switch` :
|
||||
|
||||
```
|
||||
git switch -c your-new-branch-name
|
||||
@@ -63,7 +63,7 @@ git switch -c add-alonzo-church
|
||||
|
||||
(Το όνομα του παρακλαδιού δεν χρειάζεται να περιέχει την λέξη _add_ αλλά είναι λογικό να την συμπεριλάβουμε μιας και ο σκοπός του παρακλαδιού είναι να προσθέσουμε το όνομα μας σε μια λίστα.)
|
||||
|
||||
## Πραγματοποιήστε τις αλλαγές και αποθηκεύστετες (add & commit)
|
||||
## Πραγματοποιήστε τις αλλαγές και αποθηκεύστε τες (add & commit)
|
||||
|
||||
Τώρα ανοίξτε το αρχείο `Contributors.md` με έναν επεξεργαστή κειμένου. Χρειάζεται να είστε εξοικειωμένοι με την Markdown, μια ελαφριά γλώσσα σήμανσης. Δείτε στο [cheat sheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) για το πως να χρησιμοποιήσετε την Markdown.
|
||||
|
||||
@@ -107,13 +107,13 @@ git push origin <add-your-name>
|
||||
|
||||
όπου `<add-your-name>` αντικαταστήστε με το όνομα του παρακλαδιού(branch) που δημιουργήσατε προηγουμένως
|
||||
|
||||
## Υποβάλλετε τις αλλαγές σας για έλεγχο
|
||||
## Υποβάλετε τις αλλαγές σας για έλεγχο
|
||||
|
||||
Εάν πάτε στο αποθετήριο (repository) στο github θα δείτε ένα κουμπί με τίτλο `Compare & pull request`. Κάντε κλικ σε αυτό το κουμπί.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Τώρα υποβάλλετε το pull request.
|
||||
Τώρα υποβάλετε το pull request.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/Readme/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/Readme/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
@@ -129,9 +129,9 @@ git push -u origin your-branch-name
|
||||
|
||||
## 다른 도구들을 사용한 튜토리얼
|
||||
|
||||
| <a href="gui-tool-tutorials/github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="gui-tool-tutorials/github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a> | <a href="gui-tool-tutorials/gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="100"></a> | <a href="gui-tool-tutorials/github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/2/2d/Visual_Studio_Code_1.18_icon.svg" width=100></a> | <a href="gui-tool-tutorials/sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a> | <a href="gui-tool-tutorials/github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/9c/IntelliJ_IDEA_Icon.svg/512px-IntelliJ_IDEA_Icon.svg.png" width=100></a> |
|
||||
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) |
|
||||
| <a href="../gui-tool-tutorials/github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="../gui-tool-tutorials/github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a> | <a href="../gui-tool-tutorials/gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="100"></a> | <a href="../gui-tool-tutorials/github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/2/2d/Visual_Studio_Code_1.18_icon.svg" width=100></a> | <a href="../gui-tool-tutorials/sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a> | <a href="../gui-tool-tutorials/github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/9c/IntelliJ_IDEA_Icon.svg/512px-IntelliJ_IDEA_Icon.svg.png" width=100></a> |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |
|
||||
|
||||
<p>This project is supported by:</p>
|
||||
<p>
|
||||
|
||||
@@ -0,0 +1,162 @@
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# First Contributions
|
||||
|
||||
Нээлттэй эх код баазад өөрийн хувь нэмрээ оруулах хүсэл програмч болгонд байдаг байх. Харин яг хаанаас эхлэхээ мэдэхгүй үе тохиолдох нь элбэг. Иймд, бид хэд шиг будилсан хөгжүүлэгч нарт ядаж хийх үйлдлийн зохих дарааллыг нь таниулчих зорилгоор энэхүү төсөл нь эхэлжээ. Та ч бас нээлттэй эх код баазад өөрийн нэмрээ оруулмаар байгаа бол доорх алхмуудыг дагаад хийгээрэй.
|
||||
|
||||
|
||||
_Терминалтай ажиллах дургүй бол [GUI ашигласан хичээл рүү ороорой.](#tutorials-using-other-tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### Компьютер дээрээ git суулгаагүй бол [энд дарж суулгана уу.](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## Энэ рэпог форклох
|
||||
|
||||
Та энэ хуудасны дээд хэсэгт орших fork товчийг дарснаар энэ рэпоны хуулбар таны хаягт үүсэх юм.
|
||||
|
||||
## Энэ рэпог хувилах
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Форк хийчихсэн рэпогоо компьютер дээрээ суулгахын тулд хлээд Гитхаб хаяг дээрээ очоод, форклосон рэпогоо олоод, code гэсэн товчин даар дараад, SSH хэсэг дээр дарж, _хуулах_ товчлуур дээр дарах хэрэгтэй.
|
||||
|
||||
Дараа нь, терминалаа нээгээд доорх үйлдлийг хийнэ:
|
||||
|
||||
```bash
|
||||
git clone "саяны хуулсан линк"
|
||||
```
|
||||
|
||||
"саяны хуулсан линк" хэсгийн оронд эхний алхам дээр хуулсан линкээ наана.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Жишээ нь:
|
||||
|
||||
```bash
|
||||
git clone git@github.com:таны-гитхаб-хаяг/first-contributions.git
|
||||
```
|
||||
|
||||
`таны-гитхаб-хаяг` гэсний оронд Гитхабын хэрэглэгчийн нэрээ бичнэ. Ингэснээр та өөрийн хаяг дээрээ үүсгэсэн энэхүү рэпоны хуулбарыг өөрийн компьютер дээрээ хувилан авч чадлаа.
|
||||
|
||||
## Шинэ бранч үүсгэх
|
||||
|
||||
Дараа нь, хувилсан рэпоныхоо фолдер луу шилжинэ:
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
`git switch` үйлдлийг ашиглан шинэ бранч үүсгэнэ:
|
||||
|
||||
```bash
|
||||
git switch -c шинэ-бранчийн-нэр
|
||||
```
|
||||
|
||||
Жишээ нь:
|
||||
|
||||
```bash
|
||||
git switch -c add-alonzo-church
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary> <strong>git switch үйлдлийг хийхэд ямар нэгэн алдаа гарсан бол энд дар:</strong> </summary>
|
||||
|
||||
Дараах алдаа гарсан бол Гит програмын чинь хувилбар нийцэхгүй байна гэсэн үг: "Git: `switch` is not a git command. See `git –help`"
|
||||
|
||||
Дээрх тохиолдолд `git checkout` үйлдлийг хэрэглээд үзээрэй:
|
||||
|
||||
```bash
|
||||
git checkout -b шинэ-бранчийн-нэр
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## Код баазад өөрчлөлт хийгээд өөрчлөлтөө коммит хийх
|
||||
|
||||
`Contributors.md` файлыг дурын текст эдитор дээр нээгээд өөрийн нэрээ нэмээрэй. Файлын эхэнд болон сүүлд нэмэхгүй л байхад болно.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Дараа нь, үндсэн фолдер луу шилжээд `git status` үйдлийг хийвэл танд таны өөрчилсөн файлууд харагдана.
|
||||
|
||||
Харагдаж буй өөрчлөлтүүдээ эхлээд бранчдаа `git add` үйлдлийг ашиглан нэмнэ:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Дараа нь `git commit` үйлдлийг ашиглан коммит хийнэ (`your-name` гэснийг нэмсэн нэрээрээ солихоо мартуузай):
|
||||
|
||||
```bash
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
## Гитхаб руу пушлэх
|
||||
|
||||
Дараа нь, `git push` үйлдлийг ашиглан саяны коммитоо пушлэнэ (`your-branch-name` гэснийг үүсгэсэн бранчийнхаа нэрээр солихоо мартуузай):
|
||||
|
||||
```bash
|
||||
git push -u origin your-branch-name
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary> <strong>Пушлэх үйлдэл дээр ямар нэгэн алдаа заавал энд дарж харах:</strong> </summary>
|
||||
|
||||
- ### Нэвтрэх эрхийн алдаа
|
||||
<pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
|
||||
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
|
||||
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Хэрэв дээрх янзаар алдаа зааж байвал шинэ SSH түлхүүр үүсгэн хаягтайгаа холбох хэрэгтэй гэсэн үг бөгөөд хэрхэн холбохыг [энд дарж харна уу](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account).
|
||||
|
||||
Мөн, аль рэпотой холбогдсон байгаагаа 'git remote -v' үйлдлээр шалгачихад гэмгүй.
|
||||
|
||||
Хэрэв дээрх үйлдлийн хариу доорх маягаар байвал:
|
||||
<pre>origin https://github.com/таны-хэрэглэгчийн-нэр/таны-рэпо-нэр.git (fetch)
|
||||
origin https://github.com/таны-хэрэглэгчийн-нэр/таны-рэпо-нэр.git (push)</pre>
|
||||
|
||||
дараах үйлдлээр өөрчлөх хэрэгтэй:
|
||||
```bash
|
||||
git remote set-url origin git@github.com:таны-хэрэглэгчийн-нэр/таны-рэпо-нэр.git
|
||||
```
|
||||
Ингэснээр та нууц үгээр биш хаягтай чинь холбогдсон SSH түлхүүрээр нэвтэрч эхэлнэ.
|
||||
</details>
|
||||
|
||||
## Нэгтгэх хүсэлт илгээх
|
||||
|
||||
Гитхаб дээрх рэпо руу очмогц `Compare & pull request` товчлуур харагдах болно. Уг товчлуур дээр дарснаар шинэ нэгтгэх хүсэлт (pull request) үүсгэх хуудас гарч ирнэ.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Дараа нь нэгтгэх хүсэлтээ илгээнэ.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Таны хүсэлтийг бид хүлээн аваад автоматаар код бааздаа нэгтгэсэн байх болно. Энэ талаар бүртгэлтэй и-мейл хаяг дээр чинь мэдэгдэл ирнэ.
|
||||
|
||||
## Одоо яг яах билээ?
|
||||
|
||||
Нээлттэй эх код баазад өөрийн нэмрээ оруулахын тулд ерөнхийд нь мөрдөх ёстой _fork -> clone -> edit -> pull request_ гэсэн дарааллыг та одоо мэддэг боллоо.
|
||||
|
||||
Нээлттэй эхэд нэмэр оруулж эхлэх анхны алхамаа хийсэн талаараа [энд дарж](https://firstcontributions.github.io/#social-share) нөхөдтэйгөө хуваалцана уу.
|
||||
|
||||
Өшөө дасгал ажиллахын тулд [энд дар](https://github.com/roshanjossey/code-contributions).
|
||||
|
||||
Нээлттэй эх код баазтай янз бүрийн төслүүдийн жагсаалтыг [энд дарж харна уу](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Нэмэлт материал](docs/additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Өөр програмууд ашигласан хичээлүүд
|
||||
|
||||
| <a href="docs/gui-tool-tutorials/github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a> | <a href="docs/gui-tool-tutorials/gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="100"></a> | <a href="docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/1/1c/Visual_Studio_Code_1.35_icon.png" width=100></a> | <a href="docs/gui-tool-tutorials/sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a> | <a href="docs/gui-tool-tutorials/github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/9c/IntelliJ_IDEA_Icon.svg/512px-IntelliJ_IDEA_Icon.svg.png" width=100></a> |
|
||||
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [GitHub Desktop](docs/gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](docs/gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](docs/gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](docs/gui-tool-tutorials/github-windows-intellij-tutorial.md) |
|
||||
|
||||
<p>Энэ төслийг дэмжсэн:</p>
|
||||
<p>
|
||||
<a href="https://www.digitalocean.com/">
|
||||
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
|
||||
</a>
|
||||
</p>
|
||||
@@ -1,5 +1,4 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/Readme/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/Readme/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
|
||||
# ਪਹਿਲਾ ਯੋਗਦਾਨ
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/Readme/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
@@ -78,7 +77,7 @@ git checkout -b உங்கள்-கிளையின்-பெயர்
|
||||
|
||||
## தேவையான மாற்றங்களைச் செய்து அந்த மாற்றங்களை commit செய்யுங்கள்
|
||||
|
||||
இப்போது *text editor* அல்லது *notepad* இல் `Contribitors.md` கோப்பைத் திறந்து, அதில் உங்கள் பெயரைச் சேர்க்கவும். கோப்பின் தொடக்கத்திலோ அல்லது முடிவிலோ இதைச் சேர்க்க வேண்டாம். இடையில் எங்கும் வைக்கவும். இப்போது, கோப்பை சேமிக்கவும்.
|
||||
இப்போது *text editor* அல்லது *notepad* இல் `Contributors.md` கோப்பைத் திறந்து, அதில் உங்கள் பெயரைச் சேர்க்கவும். கோப்பின் தொடக்கத்திலோ அல்லது முடிவிலோ இதைச் சேர்க்க வேண்டாம். இடையில் எங்கும் வைக்கவும். இப்போது, கோப்பை சேமிக்கவும்.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
@@ -141,7 +140,7 @@ GitHub இல் உள்ள உங்கள் களஞ்சியத்த
|
||||
|
||||
உங்கள் பங்களிப்பைக் கொண்டாடுங்கள் மற்றும் உங்கள் நண்பர்கள் மற்றும் பின்தொடர்பவர்களுடன் [web app](https://firstcontributions.github.io/#social-share) சென்று பகிர்ந்து கொள்ளுங்கள்.
|
||||
|
||||
உங்களுக்கு ஏதேனும் உதவி தேவைப்பட்டால் அல்லது ஏதேனும் கேள்விகள் இருந்தால் எங்கள் slack team இல் இணையலாம். [Join our slack crew](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)..
|
||||
உங்களுக்கு மேலும் பயிற்சி தேவைப்பட்டால், [code contributions](https://github.com/roshanjossey/code-contributions) என்னும் செயலை சரிபார்க்கலாம்.
|
||||
|
||||
இப்போது மற்ற திட்டங்களுக்கு பங்களிப்பதன் மூலம் தொடங்குவோம். நீங்கள் தொடங்கக்கூடிய எளிதான சிக்கல்களுடன் திட்டங்களின் பட்டியலை நாங்கள் தொகுத்துள்ளோம். பாருங்கள் [the list of projects in the web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
|
||||
@@ -1,38 +1,26 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/Readme/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
# ఓపెన్సోర్స్కు మీ మొదటి సహకారం
|
||||
|
||||
వ్యాసాలు చదవడం & చూడటం ట్యుటోరియల్స్ సహాయపడతాయి, కానీ వాస్తవంగా ఆచరణాత్మక వాతావరణంలో నేర్పిస్తున్నదాని కంటే మెరుగైనది ఏమిటి?
|
||||
ఇది కష్టం. మీరు ఏదైనా మొదటిసారి చేస్తున్నప్పుడు, ముఖ్యంగా ఇతరులతో కలిసి పని చేస్తున్నప్పుడు, తప్పులు చేయడం సౌకర్యంగా ఉండదు. కానీ ఓపెన్ సోర్స్ అంటే సహకారం మరియు కలిసి పనిచేయడం. మొదటిసారి ఓపెన్ సోర్స్ కంట్రిబ్యూటర్లు నేర్చుకోవాలని మరియు కంట్రిబ్యూట్ చేయాలని అనుకునే విధానాన్ని సరళం చేయాలని మేము అనుకుంటున్నాము.
|
||||
|
||||
మార్గదర్శిని అందించడం మరియు ఈ ప్రాజెక్ట్ ప్రారంభకులకు వారి మొదటి ఓపెన్ సోర్స్ సహకారం అందించే విధానాన్ని సరళీకరించడం మరియు మార్గనిర్దేశం చేయడం లక్ష్యంగా పెట్టుకుంది. మీరు మీ మొదటి ఓపెన్ సోర్స్స హకారం అందించాలని చూస్తున్నట్లయితే, దిగువ దశలను అనుసరించండి.
|
||||
వ్యాసాలు చదవడం మరియు ట్యుటోరియల్స్ చూడటం సహాయపడవచ్చు, కానీ వాస్తవంగా ఆచరణాత్మక వాతావరణంలో చేయడం కంటే మెరుగైనది ఏముంది? ఈ ప్రాజెక్ట్ యొక్క లక్ష్యం ప్రారంభకులకు మార్గదర్శకత్వం మరియు వారి మొదటి కంట్రిబ్యూషన్ చేసే విధానాన్ని సరళీకరించడం. మీరు మీ మొదటి కంట్రిబ్యూషన్ చేయాలని చూస్తున్నట్లయితే, దిగువ దశలను అనుసరించండి.
|
||||
|
||||
|
||||
#### *మీకు ఆదేశ పంక్తితో సౌకర్యంగా లేకపోతే, [ఇక్కడ GUI సాధనాలను ఉపయోగించి ట్యుటోరియల్స్ ఉన్నాయి.](#ఇతర-సాధనాలను-ఉపయోగించి-ట్యుటోరియల్స్)*
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
మొదటిసారి ఓపెన్ సోర్స్ కొరకు సహకరించాలి అనుకునే ప్రారంభకులకు పద్దతులను సులభతరం చేయడం ఈ ప్రాజెక్ట్ **ముఖ్య ఉద్దేశం**
|
||||
|
||||
మీరు మొదటిసారి ఒపెన్ సోర్స్ ప్రాజెక్ట్ లకొరకు కాంట్రిబ్యూట్ చేయాలి అనుకుంటే కింది సూచనలు పాటించండి.
|
||||
|
||||
మీరు `గిట్(git)`వర్షన్ కట్రోల్ సిస్టమ్ తో సౌకర్యవంతంగా లేకపోతే [ఇక్కడ GUI సాధనాలను ఉపయోగించి ట్యుటోరియల్స్ ఉన్నాయి.](#ఇతర-సాధనాలను-ఉపయోగించి-ట్యుటోరియల్స్)*
|
||||
#### *మీకు కమాండ్ లైన్తో సౌకర్యంగా లేకపోతే, [ఇక్కడ GUI సాధనాలను ఉపయోగించి ట్యుటోరియల్స్ ఉన్నాయి.](#ఇతర-సాధనాలను-ఉపయోగించి-ట్యుటోరియల్స్)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
మీ కంప్యూటర్ లో `GIT` లేకపోతే, [గిట్ వర్షన్ కంట్రోల్ సిస్టమ్ ను ఇన్స్టాల్ చేయండి](https://help.github.com/articles/set-up-git/).
|
||||
#### మీ కంప్యూటర్లో git లేకపోతే, [దాన్ని ఇన్స్టాల్ చేయండి](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## ఈ రిపోజిటరీని ఫోర్క్ చెయ్యండి
|
||||
## ఈ రిపోజిటరీని ఫోర్క్ చేయండి
|
||||
|
||||
ఈ రిపోజిటరీని ఫోర్క్ చెయ్యండి ఈ పేజీ ఎగువ భాగంలో ఫోర్క్ బటన్ పై క్లిక్ చేయడం ద్వారా క్లిక్ చేయండి.
|
||||
ఈ రిపోజిటరీని ఫోర్క్ చేయండి ఈ పేజీ ఎగువ భాగంలో ఫోర్క్ బటన్పై క్లిక్ చేయడం ద్వారా.
|
||||
ఇది మీ ఖాతాలో ఈ రిపోజిటరీ కాపీని సృష్టిస్తుంది.
|
||||
|
||||
## ఈ రిపోజిటరీని క్లోన్ చెయ్యండి
|
||||
## రిపోజిటరీని క్లోన్ చేయండి
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
|
||||
File diff suppressed because one or more lines are too long
@@ -5,7 +5,7 @@
|
||||
|
||||
# İlk katkı
|
||||
|
||||
Zor gelir... Herhangi bir işi ilk kez yapmak daima zor gelir. Özellikle başkalarıyla ortak çalışıyorsanız, hata yapmak içinize sinmez. Ancak "Açık Kaynakın" temelinde işbirliği ve birlikte çalışma yatmakta. Biz, açık kaynak projelere ilk kez katkıda bulunacak kişilerin bu süreci öğrenmesini ve ilk katkılarını sunmalarını kolaylaştırmayı istiyoruz.
|
||||
Zor gelir... Herhangi bir işi ilk kez yapmak daima zor gelir. Özellikle başkalarıyla ortak çalışıyorsanız, hata yapmak içinize sinmez. Ancak "Açık Kaynağın" temelinde işbirliği ve birlikte çalışma yatmakta. Biz, açık kaynak projelere ilk kez katkıda bulunacak kişilerin bu süreci öğrenmesini ve ilk katkılarını sunmalarını kolaylaştırmayı istiyoruz.
|
||||
|
||||
Makale okumak ve eğitim videoları izlemek yardımcı olabilir, fakat bir işi gerçekten yapmanın yerini ne tutabilir ki? Bu proje yeni başlayanların veya ilk defa katkıda bulunacakların işini kolaylaştırmak ve onlara rehberlik etmek amacındadır. Unutmayın ki ne kadar rahat olursanız o kadar rahat öğrenirsiniz. Eğer bir GitHub projesine ilk defa katkıda bulunacaksanız, aşağıda gösterilen basit adımları takip etmeniz yeterli olacaktır. Söz veriyoruz, eğlenceli olacak.
|
||||
|
||||
|
||||
@@ -127,7 +127,6 @@ Tabriklayman! Siz horizgina contributor sifatida tez-tez uchraydigan standard is
|
||||
|
||||
Hissangizni nishonlang va [web app](https://firstcontributions.github.io/#social-share)ga o'tish orqali do'stlaringizga va ergashuvchilaringizga ulashing.
|
||||
|
||||
|
||||
Agar koʻproq mashq qilishni istasangiz, [kod hissalarini](https://github.com/roshanjossey/code-contributions) tekshiring.
|
||||
|
||||
|
||||
|
||||
@@ -81,4 +81,5 @@
|
||||
| <img alt="Tükmençe" title="Türkmençe" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/tm.svg" width="22"> | [Türkmençe](README.tm.md) |
|
||||
| <img alt="հայերեն" title="հայերեն" src="https://cdn.statically.io/gh/hjnilsson/country-flags/master/svg/am.svg" width="22"> | [հայերեն](README.arm.md) |
|
||||
| <img title="አማርኛ dili" alt="አማርኛ ቋንቋ" src="https://cdn.statically.io/flags/et.svg" width="22"> | [አማርኛ ቋንቋ](translations/README.et.md) |
|
||||
| <img title="Монгол хэл" alt="Монгол хэл" src="https://cdn.statically.io/flags/mn.svg" width="22"> | [Монгол хэл](README.mn.md) |
|
||||
| <img alt="Kurdî" title="Kurdî (Kurdish)" src="https://upload.wikimedia.org/wikipedia/commons/3/35/Flag_of_Kurdistan.svg" width="22"> | Kurdî |
|
||||
|
||||
Reference in New Issue
Block a user