mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-13 17:21:50 +00:00
Merge branch 'main' into remove-slack-link-fil
This commit is contained in:
Roshan Jossy
+1224
-3287
File diff suppressed because it is too large
Load Diff
@@ -242,9 +242,4 @@ Now let's get you started with contributing to other projects. We've compiled 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>This project is supported by:</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>
|
||||
|
||||
@@ -0,0 +1,124 @@
|
||||
プログラマーでなくてもできること
|
||||
聞くことから始めよう
|
||||
|
||||
オープンソースはすべて、他の人々を巻き込むことです。
|
||||
あなたはチームに加わろうとしており、それにはコミュニティとその仕組みを理解する必要があります。
|
||||
プロジェクトに参加して「こんにちは、このプロジェクトにはこうしたほうがいいと思います」と言うのは、通常あまり歓迎されません。
|
||||
一部のプロジェクトではそのようなアプローチを歓迎するかもしれませんが、長く続いているプロジェクトでは、その考え方はあまり受け入れられません。
|
||||
プロジェクトのニーズを理解するには、まず聞くことが最も重要です。
|
||||
|
||||
1. メーリングリストに参加する
|
||||
|
||||
多くのプロジェクトでは、メーリングリストが開発に関する主なコミュニケーション手段となっています。
|
||||
大規模なプロジェクトには、複数のメーリングリストがあります。
|
||||
たとえば、PostgreSQLプロジェクトには、少なくとも12のユーザー向けリストと6つの開発者リストがあります。
|
||||
主要なユーザー向けと開発者向けリストをフォローし、まずは「聞くこと」から始めましょう。
|
||||
2. ブログをフォローする
|
||||
|
||||
主要な開発者が運営しているブログでは、今後のリリースや現在進行中の作業についての情報が得られます。
|
||||
Planetサイトは、関連する複数のニュースソースやブログ投稿を一か所でまとめて表示します。
|
||||
たとえば planet.gnome.org や planet.mysql.com のようなサイトがそうです。
|
||||
Googleで「Planet <プロジェクト名>」と検索してみましょう。
|
||||
|
||||
3. IRCチャンネルに参加する
|
||||
|
||||
多くのオープンソースプロジェクトにはIRC（インターネットリレーチャット）チャンネルがあり、開発者やユーザーが問題や開発について話し合っています。
|
||||
プロジェクトのWebサイトで、チャンネル名や使用しているIRCネットワークを確認しましょう。
|
||||
チケットを使った作業
|
||||
|
||||
コードはオープンソースプロジェクトの中心ですが、貢献方法はそれだけではありません。
|
||||
コードの周囲のシステムの保守は、新機能の追加やバグ修正の際に見過ごされがちです。
|
||||
こうした分野に関わることは、プロジェクトへの入り口となります。
|
||||
多くのプロジェクトには、公開されているトラブルチケットシステムがあり、公式Webサイトのトップページやドキュメントからリンクされています。
|
||||
これはユーザーと開発者間の主なコミュニケーション手段です。これを最新に保つことは、大きな貢献となります。
|
||||
一部の操作には特別な権限が必要ですが、多くのプロジェクトリーダーは喜んで協力してくれます。
|
||||
|
||||
4. バグの診断
|
||||
|
||||
バグはしばしば不正確に報告されます。
|
||||
バグを診断して説明することは、開発者が問題の原因を特定する助けになります。
|
||||
たとえば「Xをしたときにソフトが動かない」と報告された場合、再現できるか確認しましょう。
|
||||
特定のブラウザでのみ発生するのか、特定のディストリビューションでのみ発生するのかを絞り込むことが重要です。
|
||||
原因が分からなくても、可能な限り情報を絞り込むことで他の人が修正しやすくなります。
|
||||
見つけたことはすべてチケットに記録しましょう。
|
||||
|
||||
5. 修正されたバグを閉じる
|
||||
|
||||
バグがコードで修正されても、チケットが更新されていないことがあります。
|
||||
このような「ごみ」を掃除するのは時間がかかりますが、プロジェクト全体にとっては非常に重要です。
|
||||
1年以上前のチケットを検索し、バグがまだ存在するか確認してください。
|
||||
リリースの変更ログを確認し、修正されたことが明らかであればチケットを閉じてください。
|
||||
バグが再現できなければそれを記録し、閉じます。再現できれば、続けてオープンにしておきます。
|
||||
コードを使った作業
|
||||
|
||||
経験レベルに関係なく、誰でもコードで貢献できます。
|
||||
貢献するために天才である必要はありません。
|
||||
コードの修正を行う場合は、そのプロジェクトがどのようにコードを受け入れているか確認してください。
|
||||
各プロジェクトには独自のワークフローがあります。
|
||||
たとえば PostgreSQL ではパッチをメーリングリストに送る厳格なルールがありますが、Parrot のようなプロジェクトではもっと簡単です。
|
||||
GitHubを使用している場合は、Pull Requestを通じて貢献できます。
|
||||
修正時は、既存のコードスタイルに従い、責任あるメンバーとして行動してください。
|
||||
|
||||
6. ベータ版やリリース候補版をテストする
|
||||
|
||||
さまざまな環境で動作するソフトウェアには、移植性に関する問題が多く存在します。
|
||||
リリース前にベータ版やRC版が公開された際は、異なる環境でのテストが期待されます。
|
||||
あなたもその一員となり、自分の環境でビルド・実行・テストをして、動作報告を送りましょう。
|
||||
|
||||
7. バグを修正する
|
||||
|
||||
これはコードに貢献したい人のための一般的な方法です。
|
||||
チケットシステムから興味のあるバグを探し、修正に挑戦してください。
|
||||
テストが必要であれば、それも追加しましょう。
|
||||
修正できなかった場合でも、調査内容を記録することが次の人の助けになります。
|
||||
|
||||
8. テストを書く
|
||||
|
||||
ほとんどのプロジェクトにはテストスイートがありますが、十分にカバーされていないこともあります。
|
||||
テストカバレッジツールを使用して未カバー部分を探し、そこに対するテストを追加しましょう。
|
||||
|
||||
9. コンパイラ警告を修正する
|
||||
|
||||
多くのC系プロジェクトでは、ビルド時に警告が出ます。
|
||||
それらの多くは深刻な問題ではありませんが、見た目が悪く、重要な警告を埋もれさせてしまうことがあります。
|
||||
警告を解消するためのコード変更は、プロジェクトにとって役立ちます。
|
||||
|
||||
10. コメントを追加する
|
||||
|
||||
コードを読む中で混乱する箇所があれば、他の人も同じように困る可能性があります。
|
||||
そこにコメントを追加し、パッチとして提出しましょう。
|
||||
ドキュメントで貢献する
|
||||
|
||||
ドキュメントはしばしば軽視されがちであり、経験者の視点で書かれていることが多いため、初心者にはわかりにくいことがあります。
|
||||
新しい視点から欠点を見つけ、改善することができます。
|
||||
|
||||
11. 使用例を作成する
|
||||
|
||||
どんなプロジェクトでも、How-toの使用例は歓迎されます。
|
||||
API、GUIアプリ、CLIツールなど、実用的な例を作りましょう。
|
||||
セットアップ手順のスクリーンショットを追加するのも良いアイデアです。
|
||||
コミュニティとの関わり方
|
||||
|
||||
オープンソースはコードだけではありません。コミュニティこそがそれを支える柱です。
|
||||
|
||||
12. 質問に答える
|
||||
|
||||
他人を助けることは、コミュニティを強くする最高の方法です。
|
||||
特に初心者の質問に親切に答えることで、活発な参加者が増え、プロジェクトの将来が明るくなります。
|
||||
|
||||
13. ブログ投稿を書く
|
||||
|
||||
使っているソフトウェアに関して、経験や問題・解決策を書いてください。
|
||||
他のユーザーが同様の問題に直面したとき、あなたのブログが役立つかもしれません。
|
||||
また、将来そのソフトを使って職探しをする際の実績としても使えます。
|
||||
|
||||
14. Webサイトを改善する
|
||||
|
||||
もしWebデザインのスキルがあれば、プロジェクトのWebサイトを改善することで貢献できます。
|
||||
新しいロゴやバナー、レイアウトの改善など、あなたのスキルが生かされる場面は多くあります。
|
||||
|
||||
最も重要なのは、周囲の人々がどんな話をしているのか、耳を傾けることです。
|
||||
必要なものに気づき、積極的に提案・行動することで、大きなインパクトを残すことができます。
|
||||
|
||||
たとえば、Parrotの開発者がTracからGitHubへチケットを移行するか議論していた際、
|
||||
「コンバーターを書きましょうか？」と申し出たことで、450以上のチケットを失わずに済み、大きな成功となりました。
|
||||
+94
@@ -0,0 +1,94 @@
|
||||
# ஓபன் சோர்ஸிற்குப் பயனளிக்க எப்படி: ஒரு விரிவான வழிகாட்டி (குவிகட்டிய தொடக்கத்திற்காக)
|
||||
|
||||
**TL;DR** - நீங்கள் ஓபன் சோர்ஸ் திட்டத்தில் உங்கள் முதல் புல் ரிக்வஸ்டை செய்ய விரும்பினால், [Readme](https://github.com/firstcontributions/first-contributions) லுள்ள வழிமுறைகளைப் பின்பற்றுங்கள். நான் ஒரு சிறிய பிழையை திருத்தும் பங்களிப்பை என் முதல் பங்களிப்பாகச் செய்கிறேன்.
|
||||
|
||||
ஓபன் சோர்ஸிற்குப் பயனளிப்பது ஒரு மென்பொருள் டெவலப்பராக வளரவும், உங்கள் போர்ட்ஃபோலியோவை உருவாக்கவும், சமூகத்திற்குப் பங்களிக்கவும் சிறந்த வழிகளில் ஒன்றாகும். நீங்கள் அனுபவம் வாய்ந்த நிரலாளராக இருந்தாலும், அல்லது புதியதாக இருந்தாலும், ஓபன் சோர்ஸ் உங்களுக்கு நிறைய கற்றல், இணைப்பு, மற்றும் தாக்கம் செலுத்தும் வாய்ப்புகளை வழங்குகிறது.
|
||||
|
||||
இந்த வழிகாட்டியில், சரியான திட்டத்தைத் தேர்ந்தெடுப்பதிலிருந்து உங்கள் முதல் பங்களிப்பைச் செய்வது வரை, ஓபன் சோர்ஸில் பங்களிப்பதற்கான அனைத்து முக்கிய விஷயங்களையும் ஆராய்வோம்.
|
||||
|
||||
---
|
||||
|
||||
## ஏன் ஓபன் சோர்ஸில் பங்களிக்க வேண்டும்?
|
||||
|
||||
"எப்படி" என்பதைப் பார்க்கும் முன், "ஏன்" என்பதை ஆராய்வோம். ஓபன் சோர்ஸில் பங்களிப்பது பல நன்மைகளை வழங்குகிறது:
|
||||
|
||||
- **திறமைகளை மேம்படுத்துதல்** – உண்மையான புரொஜெக்ட் கோடுகளைப் பார்க்க வாய்ப்பு கிடைக்கும், எங்கேயும் சேர முடியாத அனுபவம் கிடைக்கும்.
|
||||
- **போர்ட்ஃபோலியோ உருவாக்கம்** – பிரபலமான ஓபன் சோர்ஸ் திட்டங்களில் பங்களிப்பது உங்கள் ரெஸ்யூமேயை மெருகூட்டும்.
|
||||
- **நெட்வொர்க்கிங்** – உலகளாவிய டெவலப்பர்களுடன் இணைவது, புதிய விஷயங்களைப் பழகுவது.
|
||||
- **சமூகத்திற்குப் பங்களிக்க** – நாம் தினமும் பயன்படுத்தும் மென்பொருள்களுக்கு உதவிக்கரம் நீட்டும் வாய்ப்பு.
|
||||
- **வேலை வாய்ப்புகள்** – ஓபன் சோர்ஸ் அனுபவம் கொண்டவர்களை பல நிறுவனங்கள் விரும்பி பணியமர்த்துகின்றன.
|
||||
|
||||
---
|
||||
|
||||
## ஓபன் சோர்ஸில் பங்களிக்க எப்படி தொடங்கலாம்?
|
||||
|
||||
### 1. சரியான திட்டத்தைத் தேர்ந்தெடுங்கள்
|
||||
|
||||
உங்களுக்குப் பொருத்தமான திட்டத்தை கண்டுபிடிப்பது முக்கியம். இதைப் பற்றிச் சில வழிகள்:
|
||||
|
||||
- **GitHub-ஐ ஆராயுங்கள்** – ["good-first-issue"](https://github.com/search?q=label%3Agood-first-issue) போன்ற தொடக்க நபர்களுக்கான குறிச்சொற்களைப் பயன்படுத்தி தேடுங்கள்.
|
||||
- **ஓபன் சோர்ஸ் நிகழ்ச்சிகளைப் பின்பற்றுங்கள்** – Google Summer of Code, Hacktoberfest போன்றவை சிறந்த தொடக்க புள்ளிகள்.
|
||||
- **உங்களுக்குப் பழக்கமான கருவிகளைத் தேர்வு செய்யுங்கள்** – நீங்கள் பயன்படுத்தும் புத்தகங்கள், libraries, frameworks ஆகியவற்றில் பங்களிக்கலாம்.
|
||||
|
||||
---
|
||||
|
||||
### 2. திட்டத்தைப் புரிந்துகொள்ளுங்கள்
|
||||
|
||||
பங்களிக்க முன்பாக, திட்டத்தை முழுமையாகப் புரிந்துகொள்ள முயற்சி செய்யுங்கள்:
|
||||
|
||||
- **README மற்றும் வழிமுறைகளை வாசிக்கவும்** – பங்களிப்பு வழிகாட்டி, கோட்பாடு (code of conduct) போன்றவற்றைப் பாருங்கள்.
|
||||
- **கோட்பணியை ஆராயுங்கள்** – கோப்புகளின் அமைப்பு, கோடிங் ஸ்டைல் போன்றவற்றை அறிந்து கொள்ளுங்கள்.
|
||||
- **சமூகத்தில் ஈடுபடுங்கள்** – Forums, Slack, Discord போன்ற இடங்களில் கலந்துரையாடுங்கள்.
|
||||
|
||||
---
|
||||
|
||||
### 3. சிறிய பங்களிப்புகளுடன் தொடங்குங்கள்
|
||||
|
||||
முதலில் எளிதான விடயங்களில் பங்களிக்கலாம்:
|
||||
|
||||
- **பிழைகளை சரிசெய்யுங்கள்** – "good-first-issue" அல்லது "beginner-friendly" போன்ற குறிச்சொற்களைப் பயன்படுத்தி சரிபாருங்கள்.
|
||||
- **ஆவணங்களை மேம்படுத்துங்கள்** – Documentation முக்கியமான பங்களிப்பு வழியாக இருக்கலாம்.
|
||||
- **Unit Testing எழுதுங்கள்** – Code coverage அதிகரிக்க இது உதவும்.
|
||||
|
||||
---
|
||||
|
||||
### 4. சிறந்த நடைமுறைகளைப் பின்பற்றுங்கள்
|
||||
|
||||
ஒரு நிரல்பாக பங்களிக்கும்போது, திட்ட விதிமுறைகளைப் பின்பற்றுங்கள்:
|
||||
|
||||
- **Fork & Clone செய்யுங்கள்** – உங்கள் கணக்கில் repository-ஐ fork செய்து, அதை local க்கு clone செய்யுங்கள்.
|
||||
- **Branch-ஐ உருவாக்குங்கள்** – தனியான branch-ல் வேலை செய்யுங்கள்.
|
||||
- **சுத்தமான கோட்களை எழுதுங்கள்** – திட்டத்திற்கேற்ப coding style-ஐ பின்பற்றுங்கள்.
|
||||
- **Test செய்யுங்கள்** – உங்கள் மாற்றங்கள் ஏதாவது பிரச்சனை ஏற்படுத்துகிறதா என்று சரிபாருங்கள்.
|
||||
- **Pull Request (PR) சமர்ப்பியுங்கள்** – PR-க்கு சரியான விளக்கம், issue reference, மற்றும் தயார் இருக்கும் மனப்பான்மை ஆகியவற்றுடன் சமர்ப்பியுங்கள்.
|
||||
|
||||
---
|
||||
|
||||
## ஓபன் சோர்ஸில் வெற்றி பெற சில குறிப்புகள்
|
||||
|
||||
✅ **தெளிவாக தொடர்புகொள்ளுங்கள்** – கேள்விகள் கேளுங்கள், புல்ல ரிக்வஸ்டுக்கு மறுமொழி கொடுப்பவர்களுக்கு நன்றி சொல்லுங்கள்.
|
||||
✅ **தொடர்ச்சியாக பங்களியுங்கள்** – சிறிய சிறிய பங்களிப்புகள் கூட பெரிய தாக்கத்தை ஏற்படுத்தும்.
|
||||
✅ **விமர்சனத்திலிருந்து கற்றுக்கொள்ளுங்கள்** – Code review மூலம் மேம்படுங்கள்.
|
||||
✅ **மற்றவர்களுக்கு உதவுங்கள்** – புல்ல ரிக்வஸ்டுகளை மதிப்பாய்வு செய்யுங்கள், புதியவர்களை வழிநடத்துங்கள்.
|
||||
|
||||
---
|
||||
|
||||
## பொதுவான சவால்கள் & அதை சமாளிக்க வழிகள்
|
||||
|
||||
❌ **Imposter Syndrome (நான் போதுமான திறமையுள்ளவரா? 🤔)**
|
||||
➡️ எல்லோருக்கும் இது வரும். சிறிய பங்களிப்புகளாலும் பெரிய தாக்கத்தை ஏற்படுத்தலாம்.
|
||||
|
||||
❌ **நேரம் இல்லாமை**
|
||||
➡️ ஒரு வாரத்திற்கும் 30 நிமிடங்கள் செலுத்தினாலும், நீங்கள் மெல்ல வளர முடியும்.
|
||||
|
||||
❌ **பெரிய கோட்பணியை புரிந்துகொள்வது கடினம்**
|
||||
➡️ டாக்குமென்டேஷனை வாசியுங்கள், ஒரு பிரிவில் கவனம் செலுத்துங்கள், Debugging tool-களை பயன்படுத்துங்கள்.
|
||||
|
||||
---
|
||||
|
||||
## முடிவுரை
|
||||
|
||||
ஓபன் சோர்ஸில் பங்களிப்பது வளர்ச்சிக்கு மிக நல்ல வழியாகும். சிறிய செயல்களில் தொடங்குங்கள், தொடர்ந்து பங்களியுங்கள், சமூகத்தில் ஈடுபடுங்கள். ஒவ்வொரு பங்களிப்பும் ஓபன் சோர்ஸை மேம்படுத்த உதவுகிறது.
|
||||
|
||||
🚀 **தொடங்க தயார்?**
|
||||
உங்களுக்கு பிடித்த திட்டத்தை தேடுங்கள், உங்கள் முதல் பங்களிப்பைச் செய்யுங்கள், மற்றும் உலகளாவிய ஓபன் சோர்ஸ் இயக்கத்தில் சேருங்கள்! 🎉
|
||||
@@ -0,0 +1,109 @@
|
||||
[](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/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# 첫 기여
|
||||
|
||||
| <img alt="GitHub Desktop" src="https://cdn.icon-icons.com/icons2/2157/PNG/512/github_git_hub_logo_icon_132878.png" width="200"> | GitHub 명령줄 인터페이스 (CLI) |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
|
||||
|
||||
이 가이드는 모든 것을 터미널로 처리하고 싶은 우리 터미널 덕후를 위한 것입니다. [Github-CLI](https://cli.github.com/)가 이를 가능하게 합니다. 첫 기여는 즐겁고, 기여를 계속 이어나갈 계기가 되어야 한다는 것을 기억하세요!
|
||||
|
||||
이 가이드는 그래픽 인터페이스를 사용하지 않아서, 약간 도전적이지만, 여전히 재미있고, 따라하기 쉽습니다!
|
||||
|
||||
먼저, 다음 작업이 필요합니다:
|
||||
|
||||
- Git 설치 (설치방법 [git](https://git-scm.com/downloads))
|
||||
- Github 계정
|
||||
|
||||
그리고 [공식 문서](https://github.com/cli/cli#installation)를 참고하여 `github-cli`를 설치합니다.
|
||||
|
||||
그 다음, 아래 명령으로 CLI에 로그인 합니다:
|
||||
|
||||
```bash
|
||||
gh auth login
|
||||
```
|
||||
|
||||
지시사항을 따라 로그인을 하면, 준비 완료입니다!
|
||||
|
||||
# 저장소 Fork 하기
|
||||
|
||||
다음 명령으로 간단히 진행합니다:
|
||||
|
||||
```bash
|
||||
gh repo fork firstcontributions/first-contributions
|
||||
```
|
||||
|
||||
**중요: Clone 여부에 대한 질문이 나오면 "yes"를 선택하세요**
|
||||
|
||||
# Branch 만들기
|
||||
|
||||
이 단계에서는 git을 사용하므로, 아래 명령에서 이름(역주: john-doe 부분)을 변경해서 사용하세요.
|
||||
|
||||
```bash
|
||||
git switch -c add-john-doe
|
||||
```
|
||||
|
||||
# 필요한 내용을 수정하고, Commit 하기
|
||||
|
||||
이제 문서 편집기로 `Contributors.md` 파일을 열어서 수정 할 수 있습니다. 여러분의 이름을 중간 부분에 적은 후 파일을 저장하세요.
|
||||
|
||||
프로젝트 디렉토리에서 `git status`를 실행하면 변경내용을 확인 할 수 있습니다.
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
이 변경 사항을 위에서 만든 branch에 추가 하기 위해 `git add`명령을 사용합니다:
|
||||
`git add Contributors.md`
|
||||
|
||||
그리고 `git commit`명령으로 추가된 변경 사항들을 branch에 commit 합니다:
|
||||
`git commit -m "Add your-name to Contributors list`
|
||||
명령에서 `your-name` 부분을 여러분의 이름으로 변경해서 사용하세요.
|
||||
|
||||
# github에 변경 사항을 Push 하기
|
||||
|
||||
`git push` 명령으로 수정한 내용을 Push 합니다:
|
||||
|
||||
```
|
||||
git push origin -u your-branch-name
|
||||
```
|
||||
|
||||
위 명령에서 `your-branch-name` 부분에 위에서 만들었던 branch 이름으로 변경해서 사용하세요.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Push 과정에서 에러가 발생하면, 여기를 클릭하세요:</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키 생성이 필요합니다. [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)를 참고하세요.
|
||||
|
||||
</details>
|
||||
|
||||
# 검토를 받기 위해 수정한 내용을 제출
|
||||
|
||||
다음 명령으로 프로젝트 디렉토리에서 실행하여 변경사항 검토를 위한 pull request를 만들 수 있습니다:
|
||||
|
||||
```bash
|
||||
gh pr create --repo firstcontributions/first-contributions
|
||||
```
|
||||
|
||||
그 다음 작성한 pull request를 제출하세요.
|
||||
|
||||
`gh status`명령으로 pull request가 실제로 실행되는 모습을 확인할 수 있습니다.
|
||||
|
||||
## 이제 무얼 할까요?
|
||||
|
||||
축하합니다! 기여자로서 자주 마주하게 되는 _fork -> clone -> 수정 -> pull request_ 단계를 완료 하셨습니다!
|
||||
|
||||
[web app](https://firstcontributions.github.io/#social-share)에서 여러분의 기여를 축하하고 공유하세요.
|
||||
|
||||
도움이 필요하거나, 질문이 있으면 [slack에 참여하세요](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA).
|
||||
|
||||
이제 다른 프로젝트에 기여해보세요. 시작하기 쉬운 이슈가 있는 프로젝트 목록을 정리했습니다. [web app에서 목록을 확인해보세요](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [추가 자료](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## 다른 도구에 대한 튜토리얼
|
||||
|
||||
[첫 페이지로 돌아가기](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
|
||||
@@ -0,0 +1,142 @@
|
||||
[](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)
|
||||
|
||||
# Перші внески
|
||||
|
||||
| <img alt="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> | Версія з Git Bash |
|
||||
| ------------------------------------------------------------------------------------------------------------------ | ----------------- |
|
||||
|
||||
Це складно. Завжди складно робити щось уперше. Особливо, коли ви працюєте у команді — помилятися завжди некомфортно. Але open source — це саме про співпрацю та командну роботу. Ми хотіли спростити спосіб, у який новачки в open-source навчаються та роблять свій перший внесок.
|
||||
|
||||
Читати статті й дивитися відеоуроки корисно, але немає нічого кращого, ніж спробувати на практиці без ризику щось зіпсувати. Цей проєкт має на меті зробити зрозумілий посібник і спростити спосіб, у який новачки роблять свій перший внесок. Пам’ятайте: чим спокійніше вам, тим краще ви навчаєтесь. Якщо ви хочете зробити свій перший внесок — просто дотримуйтесь інструкцій нижче. Обіцяємо — це буде весело!
|
||||
|
||||
Якщо у вас немає Git Bash на Windows, [встановіть його](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 у верхньому правому куті цієї сторінки.
|
||||
Це створить копію репозиторію у вашому акаунті.
|
||||
|
||||
## Клонуйте репозиторій
|
||||
|
||||
Тепер клонуйте репозиторій на ваш комп'ютер.
|
||||
|
||||
ВАЖЛИВО: НЕ КЛОНУЙТЕ ОРИГІНАЛЬНИЙ РЕПОЗИТОРІЙ. Перейдіть до вашого форку і клонуте його.
|
||||
|
||||
Щоб клонувати, натисніть на "Code" і скопіюйте запропонований рядок.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copy string" />
|
||||
|
||||
Відкрийте програму git bash, яку ви щойно встановили. Вона має виглядати як на наступній картинці, якщо ви використовуєте операційну систему Windows.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="open git bash terminal" />
|
||||
|
||||
Перейдіть до папки, куди хочете зберегти проєкт, використовуючи наступну команду:
|
||||
|
||||
```bash
|
||||
cd <папка>
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-2.png" alt="cd into a folder" />
|
||||
|
||||
Вставте скопійований раніше рядок і виконайте команду клонування:
|
||||
|
||||
```bash
|
||||
git clone <url-репозиторію>
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-2.png" alt="clone the repository" />
|
||||
|
||||
Перейдіть у директорію репозиторію та відкрийте його у VS Code для редагування.
|
||||
|
||||
<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" />
|
||||
|
||||
## Створіть гілку (branch)
|
||||
|
||||
Використайте наступну просту команду для створення гілки. Ця команда не тільки створює нову гілку, а також переходить на цю гілку.
|
||||
|
||||
```bash
|
||||
git checkout -b <назва-гілки>
|
||||
```
|
||||
|
||||
Назвіть свою гілку у форматі `<add-your-name>`, наприклад: `add-james-smith`
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-branch.png" alt="create a branch" />
|
||||
|
||||
## Зробіть необхідні зміни і зафіксуйте їх (commit)
|
||||
|
||||
Відкрийте файл `Contributors.md` у текстовому редакторі, додайте ваше ім'я внизу сторінки і збережіть файл:
|
||||
|
||||
Приклад: якщо ваше ім’я — James Smith, результат повинен виглядати так.
|
||||
|
||||
\[James Smith](https://github.com/jamessmith)
|
||||
|
||||
Перевірте зміни командою:
|
||||
|
||||
```bash
|
||||
git status
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="check the status" />
|
||||
|
||||
Зафіксуйте ці зміни:
|
||||
|
||||
Спочатку додайте зміну, яку ви зробили, до області індексації (staging area), використовуючи команду:
|
||||
|
||||
```bash
|
||||
git add ім'я_файлу
|
||||
```
|
||||
|
||||
Потім напишіть повідомлення до коміту за допомогою цієї команди:
|
||||
|
||||
```bash
|
||||
git commit -m "Add <ваше-ім'я> to Contributors list"
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit changes" />
|
||||
|
||||
Щоб перевірити історію комітів:
|
||||
|
||||
```bash
|
||||
git log --oneline
|
||||
```
|
||||
|
||||
## Відправте зміни на GitHub
|
||||
|
||||
Коли ви завершите виконання наведених вище кроків, ви можете надіслати свої зміни за допомогою цієї команди:
|
||||
|
||||
```bash
|
||||
git push origin <назва-гілки>
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-push.png" alt="push changes" />
|
||||
|
||||
## Надішліть запит для перевірки
|
||||
|
||||
Перейдіть до вашого репозиторію на GitHub. Ви побачите кнопку "Compare & pull request". Натисніть її.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Після цього відправте pull request.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Незабаром ваші зміни буде об'єднано з основною гілкою проєкту. Ви отримаєте сповіщення електронною поштою після злиття вашої гілки з основною.
|
||||
|
||||
## Що далі?
|
||||
|
||||
Вітаємо! Ви щойно завершили стандартний процес: _fork -> clone -> edit -> PR_!
|
||||
|
||||
Поділіться своєю участю з друзями або підпишіться на нашу спільноту [web app](https://firstcontributions.github.io#social-share).
|
||||
|
||||
Приєднуйтесь до нашої Slack-групи, якщо у вас виникли питання або потрібна допомога: [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
### [Додаткові матеріали](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Інструкції для інших інструментів
|
||||
|
||||
[Повернутись на головну сторінку](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
|
||||
@@ -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/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
|
||||
এই প্ৰকল্পই আৰম্ভণকাৰীসকলৰ বাবে প্ৰথম অৱদানটো সহজ আৰু পোষকভাৱে কৰিবলৈ সহায় কৰে। যদি আপুনি আপোনাৰ প্রথম অৱদানটো কৰিবলৈ বিচাৰে, তলত দিয়া পদক্ষেপসমূহ অনুসৰণ কৰক।
|
||||
|
||||
যদি আপুনি command lineৰ সৈতে আৰামদায়ক নোহোৱাঁ, GUI tools ব্যৱহাৰ কৰি ইয়াত tutorial আছে।
|
||||
যদি আপুনি command lineৰ সৈতে আৰামদায়ক নোহোৱাঁ, GUI tools ব্যৱহাৰ কৰি ইয়াত টিউট’ৰিয়েল আছে।
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
|
||||
@@ -5,126 +5,122 @@
|
||||
|
||||
# Mga Unang Kontribusyon
|
||||
|
||||
Nilalayon ng proyektong ito na gawing simple at gabayan ang paraan ng paggawa ng mga nagsisimula sa kanilang unang kontribusyon. Kung gusto mong gawin ang iyong unang kontribusyon, sundin ang mga hakbang sa ibaba.
|
||||
Makakatulong ang proyektong ito na gawing mas simple at magsilbing gabay sa paggawa ng mga gustong magbigay ng kanilang unang kontribusyon. Kung gusto magkaroon ng unang kontribusyon, sundin ang mga hakbang sa ibaba.
|
||||
|
||||
_Kung hindi ka komportable sa command line, [narito ang mga tutorial gamit ang GUI tool.](#tutorials-using-other-tools)_
|
||||
_Kung hindi ka komportable sa paggamit ng command line, [narito ang mga tutorial gamit ang GUI tool.](#tutorials-using-other-tools)_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
||||
|
||||
#### Kung wala kang git sa iyong makina, [i-install ito](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
#### Kung wala kang Git sa iyong computer, [i-install ito](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
## I-fork ang repositoryong ito
|
||||
## I-fork ang repository ito
|
||||
|
||||
I-fork ang repository na ito sa pamamagitan ng pag-click sa fork button sa tuktok ng page na ito.
|
||||
Gagawa ito ng kopya ng repositoryong ito sa iyong account.
|
||||
I-fork ang repository na ito sa pamamagitan ng pag-click sa _fork button_ sa kanang itaas ng page na ito.
|
||||
Gagawa ito ng kopya ng _repository_ sa iyong _account_.
|
||||
|
||||
## I-clone ang repositoryo
|
||||
## I-clone ang _repository_
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
|
||||
Ngayon i-clone ang forked repository sa iyong makina. Pumunta sa iyong GitHub account, buksan ang forked repository, i-click ang code button at pagkatapos ay i-click ang _copy to clipboard_ icon.
|
||||
Ngayon, i-clone ang _forked repository_ sa iyong _computer_. Pumunta sa iyong _GitHub account_, buksan ang _forked repository_, i-click ang _code button_ at pagkatapos ay i-click ang _copy to clipboard_ icon.
|
||||
|
||||
Magbukas ng terminal at patakbuhin ang sumusunod na git command:
|
||||
|
||||
```
|
||||
git clone "url na kinopya mo lang"
|
||||
git clone "url na kakakopya mo lang"
|
||||
```
|
||||
|
||||
kung saan ang "url na kinopya mo lang" (nang walang mga panipi) ay ang url sa repositoryong ito (ang iyong tinidor ng proyektong ito). Tingnan ang mga nakaraang hakbang para makuha ang url.
|
||||
ang "url na kakakopya mo lang" (tanggalin ang "") ay ang url ng iyong _forked repository_.Tingnan ang mga nakaraang hakbang para makuha ang url.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Halimbawa:
|
||||
|
||||
```
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
git clone https://github.com/username/first-contributions.git
|
||||
```
|
||||
|
||||
kung saan ang `this-is-you` ay ang iyong GitHub username. Dito mo kinokopya ang mga nilalaman ng repositoryo ng mga unang kontribusyon sa GitHub sa iyong computer.
|
||||
ang `username` ay ang iyong GitHub username. Dito mo napunta ang mga laman ng kinopya mong _repository_ ng mga unang kontribusyon sa GitHub sa iyong _computer_.
|
||||
|
||||
## Gumawa ng sangay
|
||||
## Gumawa ng _branch_
|
||||
|
||||
Baguhin sa direktoryo ng repositoryo sa iyong computer (kung wala ka pa roon):
|
||||
Pumunta sa _directory_ ng _repository_ sa iyong _computer_ (kung wala ka pa roon, i-type ito sa _terminal_):
|
||||
|
||||
```
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Ngayon lumikha ng isang sangay gamit ang utos na `git switch`:
|
||||
Ngayon, gumawa ng isang _branch_ gamit ang _command_ na `git switch`:
|
||||
|
||||
```
|
||||
git switch -c your-new-branch-name
|
||||
git switch -c pangalan-ng-branch
|
||||
```
|
||||
|
||||
Halimbawa:
|
||||
|
||||
```
|
||||
git switch -c add-alonzo-church
|
||||
git switch -c add-juan-delacruz
|
||||
```
|
||||
|
||||
## Gumawa ng mga kinakailangang pagbabago at gawin ang mga pagbabagong iyon
|
||||
## Ilagay ang mga gusto mong baguhin sa _repository_
|
||||
|
||||
Ngayon buksan ang `Contributors.md` file sa isang text editor, idagdag ang iyong pangalan dito. Huwag idagdag ito sa simula o dulo ng file. Ilagay ito kahit saan sa pagitan. Ngayon, i-save ang file.
|
||||
Ngayon, buksan ang `Contributors.md` _file_ sa isang _text editor_ at idagdag ang iyong pangalan (maaari mong gayahin na lang ang gawa ng iba). Iwasang ilagay ito sa pinaka-simula o dulo ng _file_. Ilagay ito kahit saan sa gitna ng _file_. I-save ang _file_ kapag nailagay na.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Kung pupunta ka sa direktoryo ng proyekto at isagawa ang command na `git status`, makikita mong may mga pagbabago.
|
||||
Kung pupunta ka sa _directory_ ng proyekto at i-type ang _command_ na `git status`, makikita mo yung mga nabago mo sa `Contributors.md`.
|
||||
|
||||
Idagdag ang mga pagbabagong iyon sa sangay na nilikha mo lamang gamit ang utos na `git add`:
|
||||
Idagdag ang mga _file_ na nabago mo sa _branch_ na ginawa mo kanina gamit ang _command_ na `git add`:
|
||||
|
||||
```
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Ngayon gawin ang mga pagbabagong iyon gamit ang utos na `git commit`:
|
||||
I-commit ang mga _files_ na iyon gamit ang _command_ na `git commit`:
|
||||
|
||||
```
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
git commit -m "Add iyong-pangalan to Contributors list"
|
||||
```
|
||||
|
||||
Ngayon gawin ang mga pagbabagong iyon gamit ang utos na `git commit`:
|
||||
## I-push ang mga _files_ na _nabago_ sa GitHub
|
||||
|
||||
## I-push ang mga pagbabago sa GitHub
|
||||
|
||||
Itulak ang iyong mga pagbabago gamit ang command na `git push`:
|
||||
I-push ang mga nabago mong _files_ gamit ang command na `git push`:
|
||||
|
||||
```
|
||||
git push -u origin your-branch-name
|
||||
git push -u origin pangalan-ng-branch
|
||||
```
|
||||
|
||||
pinapalitan ang `your-branch-name` ng pangalan ng branch na ginawa mo kanina.
|
||||
Ang `pangalan-ng-branch` ay pangalan ng branch na ginawa mo kanina.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Kung nakakakuha ka ng anumang mga error habang nagtutulak, mag-click dito: </strong> </summary>
|
||||
<summary> <strong>Kung nagkaroon ng error habang nag-pupush, i-click ito: </strong> </summary>
|
||||
|
||||
- ### Error sa Pagpapatunay
|
||||
<pre>remote: Inalis ang suporta para sa pagpapatotoo ng password noong Agosto 13, 2021. Mangyaring gumamit na lang ng personal na access token.
|
||||
remote: Pakitingnan ang https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ para sa karagdagang impormasyon.
|
||||
nakamamatay: Nabigo ang pagpapatotoo para sa 'https://github.com/<your-username>/first-contributions.git/'</pre>
|
||||
Pumunta sa [tutorial ng GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) sa pagbuo at pag-configure ng SSH key sa iyong account.
|
||||
<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//first-contributions.git/'</pre>
|
||||
Pumunta sa [tutorial ng GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) sa paggawa at pag-configure ng SSH key sa iyong account.
|
||||
</details>
|
||||
|
||||
## Isumite ang iyong mga pagbabago para sa pagsusuri
|
||||
## I-submit ang mga binago mo para mareview
|
||||
|
||||
Kung pupunta ka sa iyong repository sa GitHub, makakakita ka ng button na `Ihambing at hilahin ang kahilingan. I-click ang button na iyon.
|
||||
Kung pupunta ka sa iyong _forked repository_ sa GitHub, makikita mo yung button na `Compare & pull request`. I-click mo iyon.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Ngayon isumite ang kahilingan sa paghila.
|
||||
Ngayon, baguhin ang ilang _checkboxes_ sa _description textarea_, at i-submit ang _pull request_.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Sa lalong madaling panahon, pagsasamahin ko ang lahat ng iyong mga pagbabago sa pangunahing sangay ng proyektong ito. Makakatanggap ka ng email ng notification kapag napagsama na ang mga pagbabago.
|
||||
Ime-merge ko ang lahat ng mga nabago mo sa _main branch_ ng proyektong ito. Makakatanggap ka ng _email notification_ kapag na-merge ko na ito.
|
||||
|
||||
## Saan pupunta mula dito?
|
||||
## Saan na pagkatapos?
|
||||
|
||||
Congrats! Nakumpleto mo lang ang karaniwang _fork -> clone -> edit -> pull request_ workflow na madalas mong makaharap bilang isang contributor!
|
||||
Congrats! Nakumpleto mo lang ang karaniwang _fork -> clone -> edit -> pull request_ workflow na madalas mong gagamitin bilang isang _contributor_!
|
||||
|
||||
Ipagdiwang ang iyong kontribusyon at ibahagi ito sa iyong mga kaibigan at tagasubaybay sa pamamagitan ng pagpunta sa [web app](https://firstcontributions.github.io/#social-share).
|
||||
Ipakita ang iyong kontribusyon sa iyong mga kaibigan at tagasubaybay at magpunta sa [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Maaari kang sumali sa aming slack team kung kailangan mo ng anumang tulong o may anumang mga katanungan. [Sumali sa slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Ngayon simulan na natin ang pag-aambag sa iba pang mga proyekto. Nag-compile kami ng isang listahan ng mga proyekto na may mga madaling isyu na maaari mong simulan. Tingnan ang [listahan ng mga proyekto sa web app](https://firstcontributions.github.io/#project-list).
|
||||
Ngayon, pwede ka nang gumawa ng kontribusyon sa iba pang mga proyekto! Gumawa kami ng isang listahan ng mga proyekto na may mga madadaling gawing _issues_ na pwede mong gawin. Tingnan ang [listahan ng mga proyekto sa web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Karagdagang materyal](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
|
||||
@@ -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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
[](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)
|
||||
|
||||
@@ -109,4 +108,3 @@ Axiña mesturarei os teus cambios (facendo *merge*) na master branch deste proxe
|
||||
|
||||
## Onde ir dende aquí?
|
||||
|
||||
Tamén poderías unirte á nosa *equipa* en Slack no caso de que necesites axuda ou teñas algunha pregunta. [Únete ó noso Slack](https://firstcontributors.slack.com/join/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY)
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -125,9 +124,6 @@ git push origin <add-your-name>
|
||||
|
||||
Γιορτάστε και μοιραστείτε την συνεισφορά σας με τους φίλους και τους ακόλουθους σας πηγαίνοντας στο [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Μπορείτε να συμμετέχετε στην ομάδα μας στο slack σε περίπτωση που θέλετε κάποια βοήθεια ή έχετε κάποια ερώτηση.
|
||||
[Η ομάδα μας στο slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Τώρα μπορείτε να ξεκινήσετε να συνεισφέρετε και σε άλλα project. Έχουμε φτιάξει μια λίστα από project με εύκολα προβλήματα για να ξεκινήσετε. Δείτε εδώ [τη λίστα με τα project](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Επιπρόσθετο υλικό](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
@@ -136,4 +132,4 @@ git push origin <add-your-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/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) |
|
||||
@@ -114,7 +114,7 @@ git push origin <अपनी-शाखा-का-नाम-जोड़ें>
|
||||
|
||||
अपने पहले योगदान की खुशी में जश्न मनाएं तथा इसे [वेब एप्प](https://firstcontributions.github.io/#social-share) के जरिये अपने मित्रों के साथ शेयर करें।
|
||||
|
||||
आप हमारी स्लैक टीम को ज्वाइन कर सकते हैं यदि आपको कुछ मदद चाहिए या आपके कोई प्रश्न हों । [स्लैक पे ज्वाइन करें](https://join.slack.com/t/firstcontributors/shared_invite/zt-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
यदि आप अधिक अभ्यास करना चाहते हैं, तो हमारे । [कोड योगदान](https://github.com/roshanjossey/code-contributions)
|
||||
|
||||
अब आप अन्य प्रोजेक्ट्स पर योगदान कर सकते हैं, तो चलिए शुरू करते हैं! हमने आपके लिए एक प्रोजेक्ट्स की सूचि तैयार की है जहाँ सरल इश्यूज हैं । आप चाहें तो वहाँ से आरम्भ कर सकते हैं । [प्रोजेक्ट्स कि लिस्ट](https://firstcontributions.github.io/#project-list)
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -111,7 +110,6 @@ Nakon toga, vlasnik će spojiti promjene koje ste napravili sa master granom pro
|
||||
|
||||
Proslavite tako što ćete podjeliti svoj doprinos sa prijateljima i pratiocima otvaranjem [stranice](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Pridružite se i našem Slack timu u slučaju da vam je potrebna ikakva pomoć ili imate bilo kakvih pitanja. [Slack tim](https://join.slack.com/t/firstcontributors/shared_invite/zt-2vqegkew0-ZuzGM1LO33C6Ts4nZyat1Q).
|
||||
|
||||
Sada možemo početi sa doprinosima drugim projektima. Napravili smo popis projekata sa jednostavnim problemima na kojima možete početi raditi. Posjetite [listu projekata na naštoj stranici](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
[](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,11 +1,10 @@
|
||||
[](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)
|
||||
|
||||
# Kontribusi Pertama
|
||||
|
||||
Proyek ini bertujuan untuk menyederhanakan dan membimbing perjalanan seorang pemula berkontribusi di Github untuk pertama kali. Pertahatikan langkah - langkah berikut untuk memulai:
|
||||
Proyek ini bertujuan untuk menyederhanakan dan membimbing perjalanan seorang pemula berkontribusi di Github untuk pertama kali. Perhatikan langkah-langkah berikut untuk memulai:
|
||||
|
||||
#### _Jika Anda tidak terbiasa dengan baris perintah(command line), [di sini ada tutorial untuk menggunakan GUI(antarmuka bergrafis).](#Tutorial-Menggunakan-Alat-Lain)_
|
||||
|
||||
@@ -146,7 +145,6 @@ Selamat! Anda baru saja menyelesaikan standar _fork_ -> _clone_ -> _edit_ -> _pu
|
||||
|
||||
Rayakan kontribusi Anda dan bagikan dengan teman-teman dan pengikut Anda dengan membuka [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Anda dapat bergabung dengan tim Slack kami jika Anda membutuhkan bantuan atau memiliki pertanyaan. [Bergabung dengan tim Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Sekarang mari kita mulai dengan berkontribusi di proyek lain. Kami sudah menyusun daftar proyek dengan isu yang mudah dikerjakan sehingga Anda dapat segera memulai. Cek di [daftar proyek web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -115,8 +114,6 @@ Ekele! Naanị ị gụchara ihe nkesa -> mmepụta oyiri -> dezie -> Bọpụ
|
||||
|
||||
Nalee onyinye gị ma soro ndị enyi gị na ụmụazụ gị kerịta ya site na ịga na [ngwa weebụ](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Ị nwere ike isonyere ndị ọrụ anyị na-adịghị mma na ikpe ịchọrọ enyemaka ọ bụla ma ọ bụ nwee ajụjụ ọ bụla. [Jikọọ slack otu](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Ugbu a, ka anyị malite site na inye onyinye maka ọrụ ndị ọzọ. Anyị ejikọtawo ndepụta nke oru na okwu dị mfe ị nwere ike ịmalite. Lelee [ndepụta nke oru na ngwa weebụ ](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Ihe ndi ozo](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
@@ -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/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)
|
||||
|
||||
|
||||
@@ -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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
|
||||
@@ -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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
@@ -203,8 +202,6 @@ Pîroz be! We çerxa _fork -> clone -> edit -> pull request_ a standard ku hûn
|
||||
|
||||
Beşdariya xwe pîroz bikin û bi hevalên xwe û şopînerên xwe re parve bikin bi çûyîna [sepana webê](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Heke we hewceyî alîkariyê heye an jî pirsên we hene hûn dikarin beşdarî tîma me ya slack bibin. [Beşdarî tîma slack bibin](https://firstcontributors.slack.com/join/shared_invite/zt-29qhyr9lt-Bi7WLbgGIFqV7aCEG_grvg#/shared-invite/email).
|
||||
|
||||
Niha em dest bi beşdariya we di projeyên din de bikin. Me lîsteyek ji projeyan bi mijarên hêsan amade kiriye ku hûn dikarin pê dest pê bikin. [Lîsteya projeyan di sepana webê de kontrol bikin](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Materyalên zêde](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
@@ -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)
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -105,8 +104,6 @@ git push origin <ຊື່ branch ຂອງທ່ານ>
|
||||
ຍິນດີນຳ, ທ່ານໄດ້ປະຕິບັດຂັ້ນຕອນຂອງການເຮັດ contribute ຄື fork -> clone -> edit -> pull request ເຊິ່ງຂັ້ນຕອນຕ່າງໆເຫຼົ່ານີ້ເປັນສິ່ງທີ່ທ່ານຕອງໄດ້ພົບເມື່ອທ່ານເປັນ contributor
|
||||
ສະເຫຼີມສະຫຼອງໃຫ້ແກ່ການມີສ່ວນຮ່ວມຂອງທ່ານ, ຢ່າລືມແບ່ງປະສົບການທີ່ທ່ານໄດ້ຮັບໃຫ້ແກ່ໝູ່ເພື່ອນຂອງທ່ານ ໂດຍໄປທີ່ [ເວັບໄຊນີ້](https://firstcontributions.github.io/#social-share)
|
||||
|
||||
ຫຼືຈະມີສ່ວນຮ່ວມກັບເຮົາຜ່ານ Slack ໃນກໍລະນີທີ່ທ່ານຕ້ອງການຄວາມຊ່ວຍເຫຼືອ ຫຼື ມີຂໍ້ສົງໄສໃດໆ [ເຂົ້າຮ່ວມ slack ກັບພວກເຮົາ](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
|
||||
ຈາກນີ້ທ່ານສາມາດ contribute ໃຫ້ໂປຣເຈັກອື່ນໆໄດ້, ໂດຍທາງເຮົາໄດ້ເຮັດລາຍການໂປຣເຈັກທີ່ງ່າຍຕໍ່ການເລີ່ມຕົ້ນບາງສ່ວນໄວ້ໃຫ້ [ລາຍຊື່ໂປຣເຈັກທີ່ໜ້າສົນໃຈ](https://firstcontributions.github.io/#project-list)
|
||||
|
||||
### [ຂໍ້ມູນອື່ນໆເພີ່ມເຕີມ](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
@@ -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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
@@ -111,8 +110,6 @@ Ki ekirungi! Onoowuziza ku ttendekero lya _fork -> clone -> edit -> pull request
|
||||
|
||||
Jaguza ekyo ky'oyongeddeko era ogikwase mikwano gyo n'abagoberera nga oyita ku [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Osobola okuyingira ku team ya slack bw'oba oyagala obuyambi obulala oba olina ebibuuzo. [Yingira team ya slack.](https://firstcontributors.slack.com/join/shared_invite/zt-29qhyr9lt-Bi7WLbgGIFqV7aCEG_grvg#/shared-invite/email).
|
||||
|
||||
Kati ka tutandikire okukola ku kintu ekirala. Tundese olukalala lwa project ezirina ebizibu ebitalina y'oyinza okutandika n'okukola. Kebera [olukalala lwa project mu web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Ebirala ebisobola okukuyamba](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -109,8 +108,6 @@ Apsveicam! Tu tikko pabeidzi standarta _fork -> clone -> edit -> PR_ darbplūs
|
||||
|
||||
Pastāsti par savu devumu saviem draugiem un sekotājiem, izmantojot [mūsu vietni](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Tu vari pievienoties arī mūsu slack komandai, ja tev nepieciešama palīdzība vai ir kādi jautājumi. [Pievienojies slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Tagad tu vari līdzdarboties arī citos projektos. Mēs esam sastādījuši sarakstu ar projektiem, kuros ir vienkāršas problēmas, ar kurām tu varētu sākt. Izpēti [projektu sarakstu mūsu vietnē](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Papildu materiāli](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
[<img align="right" width="150" src="assets/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)
|
||||
|
||||
@@ -14,7 +13,6 @@ _Ako nijeste navikli da koristite komandnu liniju, [evo tutorijala koji koristi
|
||||
#### Ako nemate git na svojoj mašini, [instalirajte ga ovdje](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
## Napravite kopiju repozitorijuma
|
||||
|
||||
Napravite kopiju _(fork)_ ovog repozitorijuma tako što ćete kliknuti na dugme **fork** na vrhu stranice.
|
||||
|
||||
Ovo će kreirati kopiju ovog repozitorijuma na vašem nalogu.
|
||||
@@ -116,8 +114,6 @@ Uskoro, ja ću spojiti promjene koje ste napravili sa master granom repozitoriju
|
||||
|
||||
Proslavite vaš doprinos i podijelite ga sa prijateljima i pratiocima kroz [stranicu](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Ukoliko vam je potrebna pomoć ili imate neka pitanja, možete da se priključite našem [Slack timu](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
Sada možete početi da doprinosite i drugim projektima. Sastavili smo listu projekata sa jednostavim problemima na kojima možete početi da radite. Pogledajte [listu projekata na stranici](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Dodatni materijali](additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
@@ -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)
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
|
||||
@@ -1,162 +1,147 @@
|
||||
[](https://github.com/firstcontributions/open-source-badges)
|
||||
|
||||
[](https://github.com/ellerbrock/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).
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="энэ репог салаалж авах" />
|
||||
|
||||
## Энэ рэпог форклох
|
||||
Хэрэв таны машин дээр git байхгүй бол [суулгана уу](https://help.github.com/articles/set-up-git/).
|
||||
|
||||
Та энэ хуудасны дээд хэсэгт орших fork товчийг дарснаар энэ рэпоны хуулбар таны хаягт үүсэх юм.
|
||||
## Репог салаалж авах (Fork)
|
||||
|
||||
## Энэ рэпог хувилах
|
||||
Энэ репогийн хуудасны дээд талд байрлах **Fork** товчийг дарна уу.
|
||||
Ингэснээр таны GitHub бүртгэл дээр тус репогийн хуулбар үүснэ.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
||||
## Репог клон хийх (Clone)
|
||||
|
||||
Форк хийчихсэн рэпогоо компьютер дээрээ суулгахын тулд хлээд Гитхаб хаяг дээрээ очоод, форклосон рэпогоо олоод, code гэсэн товчин даар дараад, SSH хэсэг дээр дарж, _хуулах_ товчлуур дээр дарах хэрэгтэй.
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="энэ репог клон хийх" />
|
||||
|
||||
Дараа нь, терминалаа нээгээд доорх үйлдлийг хийнэ:
|
||||
Одоо энэ репог өөрийн компьютер дээрээ клон хийж авна. GitHub бүртгэл рүүгээ орж, **Clone** товчийг дараад дараа нь *copy to clipboard* тэмдгийг дарна.
|
||||
|
||||
Терминал нээгээд дараах командыг ажиллуулна:
|
||||
|
||||
```bash
|
||||
git clone "саяны хуулсан линк"
|
||||
```
|
||||
|
||||
"саяны хуулсан линк" хэсгийн оронд эхний алхам дээр хуулсан линкээ наана.
|
||||
git clone "та хуулсан url"
|
||||
|
||||
<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
|
||||
```
|
||||
|
||||
`таны-гитхаб-хаяг` гэсний оронд Гитхабын хэрэглэгчийн нэрээ бичнэ. Ингэснээр та өөрийн хаяг дээрээ үүсгэсэн энэхүү рэпоны хуулбарыг өөрийн компьютер дээрээ хувилан авч чадлаа.
|
||||
Энд `"та хуулсан url"` гэдэг нь энэ төслийн таны салаалсан хувилбарын URL юм.
|
||||
|
||||
## Шинэ бранч үүсгэх
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="URL хуулах" />
|
||||
|
||||
Дараа нь, хувилсан рэпоныхоо фолдер луу шилжинэ:
|
||||
Жишээ нь:
|
||||
|
||||
```
|
||||
|
||||
git clone [https://github.com/taniin-ner/first-contributions.git](https://github.com/taniin-ner/first-contributions.git)
|
||||
|
||||
```
|
||||
|
||||
Энд `taniin-ner` гэдэг нь таны GitHub-н хэрэглэгчийн нэр.
|
||||
|
||||
## Салбар (Branch) үүсгэх
|
||||
|
||||
Компьютер дээрээ тухайн репо руу орно:
|
||||
|
||||
```
|
||||
|
||||
```bash
|
||||
cd first-contributions
|
||||
|
||||
```
|
||||
|
||||
`git switch` үйлдлийг ашиглан шинэ бранч үүсгэнэ:
|
||||
Шинэ салбар үүсгэнэ:
|
||||
|
||||
```bash
|
||||
git switch -c шинэ-бранчийн-нэр
|
||||
```
|
||||
|
||||
Жишээ нь:
|
||||
git checkout -b <shine-salbar-ner>
|
||||
|
||||
```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>
|
||||
git checkout -b add-luke-oliff
|
||||
|
||||
## Код баазад өөрчлөлт хийгээд өөрчлөлтөө коммит хийх
|
||||
```
|
||||
|
||||
`Contributors.md` файлыг дурын текст эдитор дээр нээгээд өөрийн нэрээ нэмээрэй. Файлын эхэнд болон сүүлд нэмэхгүй л байхад болно.
|
||||
(*Салбарын нэр заавал `add` гэж эхлэх албагүй, гэхдээ өөрийн нэрээ нэмэх зорилготой тул ингэж нэрлэх нь ойлгомжтой.*)
|
||||
|
||||
## Өөрчлөлт хийх ба commit хийх
|
||||
|
||||
`Contributors.md` файлыг текст засварлагчаар нээгээд өөрийн нэрээ нэмнэ. Эхлэл эсвэл төгсгөлд бүү нэмээрэй, хаа нэгтээ дунд хэсэгт нь хийнэ. Дараа нь файлаа хадгална.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Дараа нь, үндсэн фолдер луу шилжээд `git status` үйдлийг хийвэл танд таны өөрчилсөн файлууд харагдана.
|
||||
Дараа нь терминалдаа `git status` ажиллуулбал өөрчлөлт гарсныг харуулна.
|
||||
|
||||
Харагдаж буй өөрчлөлтүүдээ эхлээд бранчдаа `git add` үйлдлийг ашиглан нэмнэ:
|
||||
Өөрчлөлтөө салбартаа нэмнэ:
|
||||
|
||||
```
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
|
||||
```
|
||||
|
||||
Дараа нь `git commit` үйлдлийг ашиглан коммит хийнэ (`your-name` гэснийг нэмсэн нэрээрээ солихоо мартуузай):
|
||||
Commit хийж хадгална:
|
||||
|
||||
```bash
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
## Гитхаб руу пушлэх
|
||||
git commit -m "Add <tanii-ner> to Contributors list"
|
||||
|
||||
Дараа нь, `git push` үйлдлийг ашиглан саяны коммитоо пушлэнэ (`your-branch-name` гэснийг үүсгэсэн бранчийнхаа нэрээр солихоо мартуузай):
|
||||
|
||||
```bash
|
||||
git push -u origin your-branch-name
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary> <strong>Пушлэх үйлдэл дээр ямар нэгэн алдаа заавал энд дарж харах:</strong> </summary>
|
||||
## Өөрчлөлтөө GitHub руу push хийх
|
||||
|
||||
- ### Нэвтрэх эрхийн алдаа
|
||||
<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).
|
||||
Дараах командаар өөрчлөлтөө push хийнэ:
|
||||
|
||||
Мөн, аль рэпотой холбогдсон байгаагаа '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>
|
||||
```
|
||||
|
||||
## Нэгтгэх хүсэлт илгээх
|
||||
git push origin <salbar-ner>
|
||||
|
||||
Гитхаб дээрх рэпо руу очмогц `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" />
|
||||
`<salbar-ner>` хэсэгт та өмнө үүсгэсэн салбарын нэрээ оруулна.
|
||||
|
||||
Дараа нь нэгтгэх хүсэлтээ илгээнэ.
|
||||
## Pull Request илгээх
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
GitHub дээр өөрийн репод ормогцоо **Compare & pull request** товчийг дарна.
|
||||
|
||||
Таны хүсэлтийг бид хүлээн аваад автоматаар код бааздаа нэгтгэсэн байх болно. Энэ талаар бүртгэлтэй и-мейл хаяг дээр чинь мэдэгдэл ирнэ.
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="pull request үүсгэх" />
|
||||
|
||||
## Одоо яг яах билээ?
|
||||
Дараа нь pull request-ээ илгээнэ.
|
||||
|
||||
Нээлттэй эх код баазад өөрийн нэмрээ оруулахын тулд ерөнхийд нь мөрдөх ёстой _fork -> clone -> edit -> pull request_ гэсэн дарааллыг та одоо мэддэг боллоо.
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="pull request илгээх" />
|
||||
|
||||
Нээлттэй эхэд нэмэр оруулж эхлэх анхны алхамаа хийсэн талаараа [энд дарж](https://firstcontributions.github.io/#social-share) нөхөдтэйгөө хуваалцана уу.
|
||||
Тун удалгүй таны өөрчлөлтүүд гол (master) салбарт нэгтгэгдэх бөгөөд танд мэдэгдэл ирнэ.
|
||||
|
||||
Өшөө дасгал ажиллахын тулд [энд дар](https://github.com/roshanjossey/code-contributions).
|
||||
## Цааш хаашаа явах вэ?
|
||||
|
||||
Нээлттэй эх код баазтай янз бүрийн төслүүдийн жагсаалтыг [энд дарж харна уу](https://firstcontributions.github.io/#project-list).
|
||||
Баяр хүргэе! Та _fork -> clone -> edit -> PR_ гэсэн стандарт ажлын урсгалыг амжилттай хийж дуусгалаа.
|
||||
|
||||
### [Нэмэлт материал](docs/additional-material/git_workflow_scenarios/additional-material.md)
|
||||
Хувь нэмрээ хийсэндээ баярлаад найзууд, дагагчидтайгаа [энэ вэб апп](https://firstcontributions.github.io/#social-share)-аар дамжуулан хуваалцаарай.
|
||||
|
||||
## Өөр програмууд ашигласан хичээлүүд
|
||||
Мөн бид анхлан суралцагчдад зориулсан хялбар асуудлуудтай төслүүдийн жагсаалтыг цуглуулсан байгаа. [Энэ вэб апп доторх төслийн жагсаалтыг](https://firstcontributions.github.io/#project-list) шалгаарай.
|
||||
|
||||
### [Нэмэлт материал](../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> |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| [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="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)
|
||||
|
||||
|
||||
@@ -201,7 +201,8 @@ git push -u origin add-ram-regmi
|
||||
|
||||
तपाईंले योगदान(contribution) दिनु भएकोमा खुशी मनाउनुहोस् र [web app](https://firstcontributions.github.io/#social-share) मा गएर आफ्नो friends and follower हरूमा पनि शेयर गर्नुहोस् ।
|
||||
|
||||
तपाइँलाई कुनै पनि मद्दत चाहिन्छ वा कुनै प्रश्न छ भने तपाइँ हाम्रो slack team मा सामेल हुन सक्नुहुनेछ। [join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
यदि तपाईंलाई थप अभ्यास चाहियो भने, [कोड योगदानहरू](https://github.com/roshanjossey/code-contributions) हेर्नुहोस्।
|
||||
|
||||
|
||||
अब तपाईले अन्य प्रोजेक्टहरूमा योगदान दिन सुरु गर्नुहोस्। हामीले तपाईंले गर्न सक्नुहुने सजिलो समस्याहरू(issues)को साथमा प्रोजेक्टहरूको सूची संकलन गरेका छौ हेर्नुहोस् ।. [list of projects in the web app](https://firstcontributions.github.io/#project-list)।
|
||||
|
||||
|
||||
@@ -31,7 +31,7 @@ Klona repot till din dator. Gå till ditt GitHub-konto och klicka på clone-knap
|
||||
|
||||
Öppna en terminal och kör följande kommando:
|
||||
|
||||
```
|
||||
```bash
|
||||
git clone "url you just copied"
|
||||
```
|
||||
där "url you just copied" (utan citat-tecken) är URL:en för detta repo (din fork för detta projekt). Se föregående steg för att hitta URL:en.
|
||||
@@ -39,7 +39,7 @@ där "url you just copied" (utan citat-tecken) är URL:en för detta repo (din f
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
|
||||
Till exempel:
|
||||
```
|
||||
```bash
|
||||
git clone https://github.com/this-is-you/first-contributions.git
|
||||
```
|
||||
där `this-is-you` är ditt användarnamn på GitHub. På detta sätt kopierar du innehållet i repot till din dator.
|
||||
@@ -48,17 +48,17 @@ där `this-is-you` är ditt användarnamn på GitHub. På detta sätt kopierar d
|
||||
|
||||
Gå till repo-katalogen på din dator (om du inte redan står i den katalogen):
|
||||
|
||||
```
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
Nu skapar du en branch genom att använda `git checkout`-kommandot:
|
||||
```
|
||||
Nu skapar du en branch genom att använda kommandot `git checkout`:
|
||||
```bash
|
||||
git checkout -b <lägg till ditt branch-namn>
|
||||
```
|
||||
|
||||
Till exempel:
|
||||
```
|
||||
```bash
|
||||
git checkout -b mitt-tillag
|
||||
```
|
||||
|
||||
@@ -68,17 +68,17 @@ Nu öppnar du `Contributors.md` i en text-editor och lägger till ditt namn. Lä
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Ge kommando `git status` i projektkatalogen för att se de ändringar du gjort.
|
||||
Mata in kommandot `git status` i projektkatalogen för att se de ändringar du gjort.
|
||||
|
||||
|
||||
Lägg till dina ändringar genom att använda kommando `git add -A`:
|
||||
Lägg till dina ändringar genom att använda kommando `git add`:
|
||||
|
||||
```
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Commita dina ändringar genom att använda `git commit`:
|
||||
```
|
||||
```bash
|
||||
git commit -m "Add <your-name> to Contributors list"
|
||||
```
|
||||
ersätt `<your-name>` med ditt namn.
|
||||
@@ -86,7 +86,7 @@ ersätt `<your-name>` med ditt namn.
|
||||
## Pusha ändringar till GitHub
|
||||
|
||||
Pusha dina ändringar genom att använda kommando `git push`:
|
||||
```
|
||||
```bash
|
||||
git push origin <add-your-branch-name>
|
||||
```
|
||||
ersätt `<add-your-branch-name>` med det branch-namn du använt tidigare.
|
||||
|
||||
@@ -3,126 +3,136 @@
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# පළමු දායකත්වය
|
||||
# පළමු දායකත්වය (First Contribution)
|
||||
|
||||
ආරම්භකයින්ගේ පළමු දායකත්වය ලබා දෙන ආකාරය සරල කිරීම සහ මඟ පෙන්වීම මෙම ව්යාපෘතියේ අරමුණයි. ඔබ ඔබේ පළමු දායකත්වය ලබා දීමට බලාපොරොත්තු වන්නේ නම්, පහත පියවර අනුගමනය කරන්න.
|
||||
මේ project එකේ අරමුණ, open-source වලට අලුත් අයට, ඒ අයගේ පළමු දායකත්වය (contribution) ලබාදෙන එක සරල කරලා, ඒකට මග පෙන්වීමක් ලබා දෙන එකයි. ඔයත් ඔයාගේ පළමු contribution එක කරන්න බලාගෙන ඉන්නවා නම්, මේ පියවර අනුගමනය කරන්න.
|
||||
|
||||
#### *ඔබ විධාන රේඛාව (command line) සමඟ අපහසු නම්, [GUI මෙවලම් භාවිතා කරන නිබන්ධන මෙන්න.](#tutorials-using-other-tools)*
|
||||
#### *Command line (terminal) එක භාවිතා කරලා මේ දේවල් කරන එක අමාරුයි වගේ නම්, [GUI මෙවලම් පාවිච්චි කරන මේ tutorials බලන්න.](#වෙනත්-මෙවලම්-සඳහා-වන-මාර්ගෝපදේශ)*
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="මෙම ගබඩාව fork කරන්න" />
|
||||
**සටහන:** ඔයාගේ computer එකේ git install කරලා නැත්නම්, මුලින්ම [මේ link එකෙන් ගිහින් install කරගන්න](https://docs.github.com/en/get-started/quickstart/set-up-git).
|
||||
|
||||
ඔබේ පරිගණකයේ git නොමැති නම්, [ස්ථාපනය කරන්න](https://help.github.com/articles/set-up-git/).
|
||||
## 1. මේ Repository එක Fork කරගන්න
|
||||
|
||||
## මෙම ගබඩාව fork කිරීම
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="මෙම repository එක fork කරන්න" />
|
||||
|
||||
පිටුවේ ඉහළින් ඇති fork බොත්තම ක්ලික් කිරීමෙන් මෙය කළ හැකිය. මෙය ඔබගේ ගිණුමේ
|
||||
පිටපතක් සාදනු ඇත.
|
||||
මේ පිටුවේ උඩ දකුණු පැත්තේ තියෙන 'Fork' button එක click කරන්න. එතකොට මේ repository එකේ copy එකක් ඔයාගේ GitHub ගිණුමේ හැදෙයි.
|
||||
## 2. Fork කරගත්තු Repository එක Clone කරගන්න
|
||||
|
||||
## මෙම ගබඩාව clone කරන්න
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="මෙම repository එක clone කරන්න" />
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="මෙම ගබඩාව clone කරන්න" />
|
||||
දැන් ඔයා fork කරගත්ත repository එක ඔයාගේ computer එකට clone කරගන්න ඕන. ඒකට, ඔයාගේ GitHub ගිණුමට යන්න. Fork කරගත්ත repository එක open කරලා, 'Code' button එක click කරලා, එන URL එක copy කරගන්න.
|
||||
|
||||
දැන් ඔබේ පරිගණකට fork කරපු repository ය ක්ලෝන කරන්න. ඔබට ඔබගේ GitHub ගිණුමට ගොස් fork කරපු repository විවෘත කර clone බොත්තම ක්ලික් කර එය පසුරු පුවරුවට (clipboard) පිටපත් කිරීමෙන් මෙය කළ හැක.
|
||||
දැන් ඔබේ පරිගණකට fork කරපු repository ය ක්ලෝන කරන්න. ඔබට ඔබගේ GitHub ගිණුමට ගොස් fork කරපු repository විවෘත කර code බොත්තම ක්ලික් කර,පසුව SSH ටැබය මත ක්ලික් කිරීමෙන් ලැබෙන url එක පසුරු පුවරුවට (clipboard) පිටපත් කිරීමෙන් මෙය කළ හැක.
|
||||
|
||||
*terminal* හෝ *command prompt* විවෘත කර පහත git විධානය ක්රියාත්මක කරන්න:
|
||||
දැන් ඔයාගේ computer එකේ terminal (command prompt) එක open කරලා, මේ git command එක run කරන්න:
|
||||
|
||||
```
|
||||
git clone "ඔබ පිටපත් කළ url එක"
|
||||
```bash
|
||||
git clone "ඔයා දැන් copy කරගත්තු url එක"
|
||||
```
|
||||
|
||||
මෙහි "ඔබ පිටපත් කළ url එක" (උපුටා දැක්වීම් ලකුණු නොමැතිව) මෙම ගබඩාවේ url එක වේ (මෙම ව්යාපෘතියේ ඔබේ දෙබල (fork) ). url එක ලබා ගැනීමට පෙර පියවර බලන්න.
|
||||
"ඔයා දැන් copy කරගත්තු url එක" කියන තැනට (කමාන්ඩ් එකේදී උඩු කොමා දාන්නේ නැතුව) ඔයාගේ forked repository එකේ URL එක දාන්න.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />
|
||||
උදාහරණයක් විදියට:
|
||||
|
||||
|
||||
උදාහරණ වශයෙන්:
|
||||
|
||||
```
|
||||
git clone https://github.com/මෙය-ඔබයි/first-contributions.git
|
||||
```bash
|
||||
git clone git@github.com:this-is-you/first-contributions.git
|
||||
```
|
||||
|
||||
මෙහි `මෙය ඔබයි` යනු GitHub පරිශීලක නාමයයි. මෙය ඔබගේ GitHub ගිණුමේ first-contributions repository පිටපතක් සෑදීමට ඔබට ඉඩ සලසයි.
|
||||
`this-is-you` කියන තැනට ඔයාගේ GitHub username එක එන්න ඕන. මේ command එකෙන් කරන්නේ, *first-contributions repository* එකේ අන්තර්ගතය ඔයාගේ computer එකට copy කරන එකයි.
|
||||
|
||||
## ශාඛාවක් නිර්මාණය කිරීම
|
||||
## 3. අලුත් Branch එකක් හදන්න
|
||||
|
||||
ඔබේ පරිගණකයේ ගබඩා නාමාවලියට වෙනස් කරන්න (ඔබ දැනටමත් එහි නොමැති නම්):
|
||||
Terminal එකේ ඉඳන් ඔයා දැන් clone කරගත්ත repository එකේ folder එකට යන්න (ඔයා දැනටමත් ඒක ඇතුලේ නෙවෙයි නම්):
|
||||
|
||||
```
|
||||
```bash
|
||||
cd first-contributions
|
||||
```
|
||||
|
||||
දැන්, ඔයාගේ වෙනස්කම් ටික කරන්න අලුත් branch එකක් හදන්න `git switch` command එක run කරන්න:
|
||||
|
||||
දැන් `git checkout` විධානය භාවිතා කරමින් ශාඛාවක් සාදන්න:
|
||||
|
||||
```
|
||||
git checkout -b <ඔබගේ-නව-ශාඛාවේ-නම>
|
||||
```bash
|
||||
git switch -c ඔයාගේ-අලුත්-branch-එකේ-නම
|
||||
```
|
||||
|
||||
උදාහරණ වශයෙන්:
|
||||
උදාහරණයක් විදියට:
|
||||
|
||||
```
|
||||
git checkout -b add-luke-oliff
|
||||
```bash
|
||||
git switch -c add-kasun-perera
|
||||
```
|
||||
|
||||
(ශාඛාවේ නමට *add* එකතු කිරීම අවශ්ය නොවේ, නමුත් එය සාධාරණ දෙයකි, මන්ද මෙම ශාඛාවේ අරමුණ ඔබේ නම ලැයිස්තුවකට එකතු කිරීමයි.)
|
||||
<details>
|
||||
<summary> <strong>git switch භාවිතා කරන විට error එකක් ආවොත්, මෙතන click කරන්න:</strong> </summary>
|
||||
|
||||
## අවශ්ය වෙනස්කම් සිදු කර commit කරන්න
|
||||
"Git: `switch` is not a git command. See `git –help`" වගේ error පණිවිඩයක් ආවොත්, ඒකට හේතුව වෙන්න පුළුවන් ඔයා git වල පරණ version එකක් use කරන එක.
|
||||
|
||||
දැන් Contributors.md ගොනුව පෙළ සංස්කාරකයක විවෘත කරන්න, එයට ඔබේ නම එක් කරන්න. ගොනුවේ ආරම්භයේ හෝ අවසානයේ එය එකතු නොකරන්න. එය අතර මැද ඕනෑම තැනකට එකතු කරන්න. දැන්, ගොනුව save කරන්න.
|
||||
ඒ වගේ වෙලාවක, `git switch` වෙනුවට `git checkout` command එක use කරලා බලන්න:
|
||||
|
||||
```bash
|
||||
git checkout -b your-new-branch-name
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
|
||||
*(Branch එකේ නමට `add-` වගේ කෑල්ලක් එකතු කරන එක අනිවාර්ය නැහැ. ඒත්, අපි මේ branch එකෙන් කරන්නේ නමක් එකතු කරන එක නිසා, ඒ වගේ නමක් දාන එක හොඳ පුරුද්දක්.)*
|
||||
|
||||
## 4. අවශ්ය වෙනස්කම් කරලා Commit කරන්න
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
ඔබ ව්යාපෘති නාමාවලිය වෙත ගොස් git status විධානය ක්රියාත්මක කළහොත්, වෙනස්කම් ඇති බව ඔබට පෙනෙනු ඇත.
|
||||
දැන් `Contributors.md` file එක ඔයා කැමති text editor එකකින් (උදා: VS Code, Notepad) open කරලා, ඔයාගේ නම ඒකට එකතු කරන්න. File එකේ මුලටම හරි අගටම හරි නම දාන්න එපා. මැද හරියට කොතනට හරි දාන්න. දැන් file එක save කරන්න.
|
||||
|
||||
`git add` විධානය භාවිතයෙන් ඔබ දැන් නිර්මාණය කළ ශාඛාවට එම වෙනස්කම් එක් කරන්න:
|
||||
ඔයා project folder එකේ terminal එකට ගිහින් `git status` කියලා type කලොත්, ඔයා කරපු වෙනස්කම් ටික පෙන්නයි.
|
||||
|
||||
```
|
||||
ඒ වෙනස්කම් ටික ඔයා හදපු අලුත් branch එකට add කරන්න `git add` command එක run කරන්න:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
දැන් `git commit` විධානය භාවිතා කර එම වෙනස්කම් සිදු කරන්න:
|
||||
දැන්, `git commit` command එකෙන් මේ වෙනස්කම් ටික commit කරන්න:
|
||||
|
||||
```
|
||||
git commit -m "Add <ඔයාගේ_නම> to Contributors list"
|
||||
```bash
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
`<ඔබේ_නම>` වෙනුවට ඔබේ නම ඇතුල් කරන්න.
|
||||
your-name` කියන තැනට ඔයාගේ නම දාන්න.
|
||||
|
||||
## GitHub වෙත වෙනස්කම් තල්ලු කරන්න
|
||||
## 5. වෙනස්කම් ටික GitHub වලට Push කරන්න
|
||||
|
||||
`git push` විධානය භාවිතයෙන් ඔබගේ වෙනස්කම් තල්ලු කරන්න:
|
||||
```
|
||||
git push origin -u <ඔබගේ-නව-ශාඛාවේ-නම>
|
||||
ඔයා කරපු වෙනස්කම් ටික GitHub එකට push (upload) කරන්න `git push` command එක run කරන්න:
|
||||
|
||||
```bash
|
||||
git push -u origin ඔයාගේ-branch-එකේ-නම
|
||||
```
|
||||
|
||||
`<ඔබගේ-නව-ශාඛාවේ-නම>` ඔබ කලින් නිර්මාණය කළ නම සමඟ ශාඛාව ප්රතිස්ථාපනය කරන්න.
|
||||
ඔයාගේ-branch-එකේ-නම` කියන තැනට ඔයා කලින් හදපු branch එකේ නම දාන්න.
|
||||
|
||||
## සමාලෝචනය සඳහා ඔබේ වෙනස්කම් ඉදිරිපත් කරන්න
|
||||
## 6. ඔයාගේ වෙනස්කම් Pull Request එකක් ලෙස යවන්න
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="pull request එකක් හදන්න" />
|
||||
|
||||
ඔබ GitHub හි ඔබගේ ගබඩාවට ගියහොත්, ඔබට `Compare & pull request` බොත්තමක් පෙනෙනු ඇත. එම බොත්තම මත ක්ලික් කරන්න.
|
||||
ඔයාගේ GitHub ගිණුමේ තියෙන repository එකට ගියාම, ඔයාට `'Compare & pull request'` කියලා button එකක් පෙනෙයි. ඒක click කරන්න.
|
||||
|
||||
<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="pull request එක submit කරන්න" />
|
||||
|
||||
දැන් pull request ඉදිරිපත් කරන්න.
|
||||
දැන් ඔයාගේ pull request එක submit කරන්න.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
මම ළඟදීම ඔබේ සියලු වෙනස්කම් මෙම ව්යාපෘතියේ ප්රධාන ශාඛාවට ඒකාබද්ධ කරමි. වෙනස්කම් ඒකාබද්ධ කළ පසු ඔබට දැනුම්දීමේ Email පණිවිඩයක් ලැබෙනු ඇත.
|
||||
ඉක්මනින්ම මම ඔයාගේ වෙනස්කම් ටික මේ project එකේ ප්රධාන (main) branch එකට merge කරන්නම්. ඒක merge කරාට පස්සේ ඔයාට notification email එකක් එයි.
|
||||
|
||||
## මෙතැන් සිට කොහේ යන්නද?
|
||||
|
||||
සුභ පැතුම්! ඔබ දායකයෙකු ලෙස සම්මත 'fork -> clone -> edit -> pull request' කාර්ය ප්රවාහය ඔබ සම්පුර්ණ කර ඇත!
|
||||
සුභ පැතුම්! Open-source contributor කෙනෙක් විදියට ඔයා නිතරම භාවිතා කරන **fork -> clone -> edit -> pull request** කියන සම්පූර්ණ ක්රියාවලියම ඔයා දැන් සාර්ථකව අවසන් කරලා තියෙන්නේ!
|
||||
|
||||
ඔබේ දායකත්වය සහ ඔබේ මිතුරන් සහ අනුගාමිකයින් සමඟ සමරන්න [web app](https://firstcontributions.github.io/#social-share) ගිහින් share කරන්න.
|
||||
ඔයාගේ මේ පළමු දායකත්වය සමරන්න, ඒ වගේම යාළුවොත් එක්ක share කරගන්න [web app](https://firstcontributions.github.io/#social-share) එකට යන්න.
|
||||
|
||||
ඔබට කිසියම් උදව්වක් අවශ්ය නම් හෝ කිසියම් ප්රශ්නයක් ඇත්නම් ඔබට අපගේ slack කණ්ඩායමට සම්බන්ධ විය හැකිය. [අපගේ slack කණ්ඩායමට එක්වන්න](https://join.slack.com/t/firstcontributors/shared_invite/zt-kpbyrmkk-JDkRtchcvRvQ0qK4iPmyvA)..
|
||||
තවත් පුහුණුවක් ලබන්න කැමති නම්, [code contributions](https://github.com/roshanjossey/code-contributions) බලන්න.
|
||||
|
||||
දැන් අපි ඔබට වෙනත් ව්යාපෘති සඳහා දායක වීම ආරම්භ කරමු. ඔබට ආරම්භ කළ හැකි පහසු ගැටළු සහිත ව්යාපෘති ලැයිස්තුවක් අපි සම්පාදනය කර ඇත්තෙමු. පරීක්ෂා කරන්න [web app ව්යාපෘති ලැයිස්තුව](https://firstcontributions.github.io/#project-list).
|
||||
දැන් ඔයාට වෙනත් projects වලටත් contribute කරන්න පටන්ගන්න උදව් කරමු. අපි ඔයාට පටන් ගන්නම ලේසි issues (ගැටළු) තියෙන projects ලැයිස්තුවක් හදලා තියෙනවා. [Web app එකෙන් ඒ projects ලැයිස්තුව බලන්න](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [අතිරේක සම්පත්](../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> |
|
||||
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
|
||||
# Birinchi hissalar
|
||||
|
||||
Ushbu loyiha yangi boshlanuvchilarning birinchi hissasini qo'shish usullarini soddalashtirish va yo'naltirishga qaratilgan. Agar siz birinchi hissangizni qo'shmoqchi bo'lsangiz, quyidagi amallarni bajaring.
|
||||
Ushbu loyiha yangi boshlanuvchilarning birinchi hissasini(Contribution) qo'shish usullarini soddalashtirish va yo'naltirishga qaratilgan. Agar siz birinchi hissangizni qo'shmoqchi bo'lsangiz, quyidagi amallarni bajaring.
|
||||
|
||||
_Agar buyruq satri sizga mos bo'lmasa, [Bu erda GUI vositalaridan foydalanib amalga oshirishga oid darsliklari mavjud](#boshqa-vositalardan-foydalanish-uchun-qollanmalar)_
|
||||
|
||||
@@ -17,7 +17,7 @@ _Agar buyruq satri sizga mos bo'lmasa, [Bu erda GUI vositalaridan foydalanib ama
|
||||
## Bu repositoryni fork qilib oling
|
||||
|
||||
Bu repositoryni ushbu sahifaning yuqorisidagi fork tugmasini bosish orqali fork qilib oling.
|
||||
Bu akkountingizda ushbu repositoryning nusxasini yaratadi.
|
||||
Bu hisobingizda ushbu repositoryning nusxasini yaratadi.
|
||||
|
||||
## Bu repositoryni klon qilib oling
|
||||
|
||||
@@ -28,10 +28,10 @@ Endi fork qilingan repositoryni kompyuteringizga klon qiling. GitHub akkountingi
|
||||
Terminalni oching va quyidagi git buyruqlarini yurg'izing:
|
||||
|
||||
```bash
|
||||
git clone "siz horizgina ko'chirib olgan url"
|
||||
git clone "siz hozirgina ko'chirib olgan url"
|
||||
```
|
||||
|
||||
bu yerda "siz horizgina ko'chirib olgan url" (qo'shtirnoqlarsiz) ushbu repositoryning (siz fork qilingan proyekt) 'URL'idir. URLni olish uchun oldingi bosqichlarni ko'ring.
|
||||
bu yerda "siz hozirgina ko'chirib olgan url" (qo'shtirnoqlarsiz) ushbu repositoryning (siz fork qilingan proyekt) 'URL'idir. URLni olish uchun oldingi bosqichlarni ko'ring.
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="urlni klipboardga ko'chiring" />
|
||||
|
||||
@@ -41,7 +41,7 @@ Misol uchun:
|
||||
git clone https://github.com/bu-siz/first-contributions.git
|
||||
```
|
||||
|
||||
bu yerdagi `bu-siz` sizning Github akkount nomingiz (username). Bu yerda Githubdagi first-contributions repositorysining kontentlarini kompyuteringizga
|
||||
bu yerdagi `bu-siz` sizning Github hisobingiz nomi (username). Bu yerda Githubdagi first-contributions repositorysining kontentlarini kompyuteringizga
|
||||
ko'chiryapsiz.
|
||||
|
||||
## Branch yaratish
|
||||
@@ -61,16 +61,16 @@ git switch -c yangi-branch-nomingiz
|
||||
Misol uchun:
|
||||
|
||||
```bash
|
||||
git switch -c add-aliml92
|
||||
git switch -c new_branch # yangi branch
|
||||
```
|
||||
|
||||
## Kerakli o'zgarishlarni qiling va bu o'zgarishlarni commit qiling
|
||||
## O'zgartirishlar kiriting va commit yarating!
|
||||
|
||||
Endi matn muharririda `Contributors.md` faylini oching, unga ismingizni qo'shing. Uni faylning boshiga yoki oxiriga qo'shmang. Uni istalgan o'rta qismga qo'shing. Endi faylni saqlang.
|
||||
|
||||
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
||||
|
||||
Agar proyekt papkasiga o'tsangiz va `git status` buyrug'ini yurg'izsangiz, o'zgarishlar borligini ko'rasiz.
|
||||
Agar proyekt papkasiga o'tsangiz va `git status` buyrug'ini ishga tushirsangiz, o'zgarishlar borligini ko'rasiz.
|
||||
|
||||
`git add` buyrug'i yordamida hosil qilgan branchingizga o'zgarishlarni qo'shing:
|
||||
|
||||
@@ -81,7 +81,7 @@ git add Contributors.md
|
||||
Endi `git commit` buyrug'i yordamida bu o'zgarishlarni commit qiling:
|
||||
|
||||
```bash
|
||||
git commit -m "Contributors royxatiga ismingiz-ni kiritish"
|
||||
git commit -m "Contributors ro'yxatiga ismingiz-ni kiritish"
|
||||
```
|
||||
`ismingiz-` ni o'rniga o'zingizni ismingizni yozing.
|
||||
|
||||
@@ -90,11 +90,9 @@ git commit -m "Contributors royxatiga ismingiz-ni kiritish"
|
||||
`git push` buyrug'i bilan o'zgartishlaringizni push qiling:
|
||||
|
||||
```bash
|
||||
git push origin -u yangi-branch-nomingiz
|
||||
git push origin -u new_branch # siz yaratgan yangi branch
|
||||
```
|
||||
|
||||
albatta, `yangi-branch-nomingiz` ni biroz oldin yaratgan branch nomiga almashtirgan holda.
|
||||
|
||||
<details>
|
||||
<summary> <strong>Push qilish vaqtida biror xatolarni ko'rsangiz, bu yerni bosing</strong> </summary>
|
||||
|
||||
@@ -111,11 +109,11 @@ Akkountingizga SSH kalit yaratish va konfiguratsiya qilish uchun [GitHub qo'llan
|
||||
|
||||
## O'zgartirishlaringizni ko'rib chiqilishi uchun topshirish
|
||||
|
||||
Agar Githubdagi repositoryingizga o'tsangiz, `Compare & pull request` tugmasini ko'rasiz. O'sha tugmani bosing.
|
||||
Agar Githubdagi repositoryingizga o'tsangiz, `Compare & pull request` tugmasini ko'rasiz. Shu tugma ustiga bosing!.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="pull request hosil qilish" />
|
||||
|
||||
Endi pull requestni submit qiling.
|
||||
Endi Pull Requestni submit qiling.
|
||||
|
||||
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="pull request submit qilish" />
|
||||
|
||||
@@ -123,7 +121,7 @@ Tez orada men sizning barcha o'zgarishlaringizni ushbu proyektning main branchig
|
||||
|
||||
## Bu yerdan qayerga borish?
|
||||
|
||||
Tabriklayman! Siz horizgina contributor sifatida tez-tez uchraydigan standard ish ketma-ketligi ya'ni _fork -> clone -> edit -> pull request_ ni tamonladingiz.
|
||||
Tabriklayman! Siz hozirgina contributor sifatida tez-tez uchraydigan standard ish ketma-ketligi ya'ni _fork -> clone -> edit -> pull request_ ni tamonladingiz.
|
||||
|
||||
Hissangizni nishonlang va [web app](https://firstcontributions.github.io/#social-share)ga o'tish orqali do'stlaringizga va ergashuvchilaringizga ulashing.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user