mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-13 17:21:50 +00:00
Merge branch 'main' into add-ukrainian-translationgit-bash-windows-tutorial
This commit is contained in:
Roshan Jossy
@@ -1,140 +0,0 @@
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-old-version-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# First Contributions
|
||||
|
||||
| <img alt="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> | Git Bash Edition |
|
||||
| ------------------------------------------------------------------------------------------------------------------ | ---------------- |
|
||||
|
||||
It's hard. It's always hard the first time you do something. Especially when you are collaborating, making mistakes isn't a comfortable thing. But open source is all about collaboration & working together. We wanted to simplify the way new open-source contributors learn & contribute for the first time.
|
||||
|
||||
Reading articles & watching tutorials can help, but what comes better than actually doing the stuff without messing up anything. This project aims at providing guidance & simplifying the way rookies make their first contribution. Remember the more relaxed you are the better you learn. If you are looking for making your first contribution just follow the simple steps below. We promise you, it will be fun.
|
||||
|
||||
If you don't have Git Bash on your windows machine, [install it](https://git-scm.com/download/win).
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt="fork this repository" />
|
||||
|
||||
## Fork this repository
|
||||
|
||||
Fork this repo by clicking on the fork button on the top right of this page.
|
||||
This will create a copy of this repository in your account.
|
||||
|
||||
## Clone the repository
|
||||
|
||||
Now clone this repo to your machine.
|
||||
|
||||
IMPORTANT: DO NOT CLONE THE ORIGINAL REPO. Go to your fork and clone it.
|
||||
|
||||
To clone the repo, click on "Code" and then copy the string down below.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copy string" />
|
||||
|
||||
Open the git bash application you just downloaded. It should look like the image down below if it's on a windows machine.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="open git bash terminal" />
|
||||
|
||||
Go to the folder that you want to save this project on by using this command
|
||||
|
||||
```bash
|
||||
cd <folder>
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-2.png" alt="cd into a folder" />
|
||||
|
||||
Use the string you copied in the step above to clone the repository using this command
|
||||
|
||||
```bash
|
||||
git clone <repo-url>
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-2.png" alt="clone the repository" />
|
||||
|
||||
Go to the directory where the repo is and open it up on vs code to make your changes.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-3.png" alt="cd into the newly cloned repo" />
|
||||
|
||||
## Create a branch
|
||||
|
||||
Now create a branch by using this simple command. This command not only creates a branch for you but also lets you switch to that branch.
|
||||
|
||||
```bash
|
||||
git checkout -b <branch-name>
|
||||
```
|
||||
|
||||
Name your branch `<add-your-name>`. For example, "add-james-smith"
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-branch.png" alt="create a branch" />
|
||||
|
||||
## Make necessary changes and commit those changes
|
||||
|
||||
Now open `Contributors.md` file in a text editor, scroll to the bottom of the page and add your name to it, then save the file.
|
||||
|
||||
Example: If your name is James Smith, It should look like this.
|
||||
|
||||
\[James Smith](https://github.com/jamessmith)
|
||||
|
||||
You can see that there are changes to Contributors.md by simply running this command
|
||||
|
||||
```bash
|
||||
git status
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="check the status" />
|
||||
|
||||
Now commit those changes:
|
||||
|
||||
First add the change you made to the staging area by using
|
||||
|
||||
```bash
|
||||
git add file-name
|
||||
```
|
||||
|
||||
Then write a commit message by sing this command
|
||||
|
||||
```bash
|
||||
git commit -m "Add your-name to Contributors list"
|
||||
```
|
||||
|
||||
Replace `<your-name>` with your name.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit changes" />
|
||||
|
||||
To see if your commit has been made you can run a simple `git log --oneline` command.
|
||||
|
||||
## Push changes to github
|
||||
|
||||
Once you are done with the above steps you can push your changes by using this command
|
||||
|
||||
```bash
|
||||
git push origin <branch-name>
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-push.png" alt="push changes" />
|
||||
|
||||
## Submit your changes for review
|
||||
|
||||
If you go to your repository on github, you'll see `Compare & pull request` button. click on that button.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="create a pull request" />
|
||||
|
||||
Now submit the pull request.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="submit pull request" />
|
||||
|
||||
Soon I'll be merging all your changes into the master branch of this project. You will get a notification email once the changes have been merged.
|
||||
|
||||
## Where to go from here?
|
||||
|
||||
Congrats! You just completed the standard _fork -> clone -> edit -> PR_ workflow that you'll encounter often as a contributor!
|
||||
|
||||
Celebrate your contribution and share it with your friends and followers by going to [web app](https://firstcontributions.github.io#social-share).
|
||||
|
||||
You can join our slack team in case you need any help or have any questions. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
||||
|
||||
### [Additional material](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Tutorials Using Other Tools
|
||||
|
||||
[Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
|
||||
@@ -0,0 +1,124 @@
|
||||
[](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)
|
||||
|
||||
# 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 Command Line Interface (CLI) |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
|
||||
|
||||
To jest przewodnik dla nas, geeków terminala, którzy chcą robić wszystko w terminalu. Dzięki [Github-CLI](https://cli.github.com/), możemy to osiągnąć, pamiętając, że Twoja pierwsza kontrybucja powinna być przyjemna, satysfakcjonująca i motywować do dalszego działania\!
|
||||
|
||||
Ten przewodnik jest nieco trudniejszy, ponieważ w ogóle nie używamy żadnego interfejsu graficznego, ale nadal jest naprawdę fajny i na pewno możesz za nim podążać\!
|
||||
|
||||
Pierwszymi wymaganiami jest posiadanie:
|
||||
|
||||
- zainstalowanego Git (jak zainstalować [git](https://git-scm.com/downloads))
|
||||
- konta Github
|
||||
|
||||
Teraz musimy zainstalować narzędzie `github-cli` w naszym systemie, postępując zgodnie z [oficjalną dokumentacją](https://github.com/cli/cli#installation).
|
||||
|
||||
Następnie musimy zalogować się w CLI, więc wprowadź to polecenie:
|
||||
|
||||
```bash
|
||||
gh auth login
|
||||
```
|
||||
|
||||
Postępuj zgodnie z instrukcjami i gotowe\!
|
||||
|
||||
-----
|
||||
|
||||
# Fork this repository
|
||||
|
||||
To jest tak proste, jak uruchomienie tego polecenia:
|
||||
|
||||
```bash
|
||||
gh repo fork firstcontributions/first-contributions
|
||||
```
|
||||
|
||||
**Ważne: Zostaniesz zapytany, czy chcesz również sklonować, wybierz opcję "yes".**
|
||||
|
||||
-----
|
||||
|
||||
# Create your branch
|
||||
|
||||
Ten krok wykonamy za pomocą git, więc wprowadź to polecenie, zastępując `name` swoim imieniem, na przykład:
|
||||
|
||||
```bash
|
||||
git switch -c add-john-doe
|
||||
```
|
||||
|
||||
-----
|
||||
|
||||
# Make necessary changes and commit those changes
|
||||
|
||||
Teraz możesz otworzyć plik `Contributors.md` w edytorze tekstu i dodać do niego swoje imię. Wstaw swoje imię w dowolnym miejscu między początkiem a końcem, a następnie zapisz plik.
|
||||
|
||||
W katalogu projektu wykonaj `git status`, a zobaczysz zmiany.
|
||||
\<img align="right" width="450" src="[https://firstcontributions.github.io/assets/Readme/git-status.png](https://firstcontributions.github.io/assets/Readme/git-status.png)" alt="git status" /\>
|
||||
|
||||
Dodaj te zmiany do właśnie utworzonej gałęzi za pomocą polecenia `git add`:
|
||||
`git add Contributors.md`
|
||||
|
||||
Teraz zatwierdź te zmiany za pomocą polecenia `git commit`:
|
||||
`git commit -m "Add your-name to Contributors list"`
|
||||
zastępując `your-name` swoim imieniem.
|
||||
|
||||
-----
|
||||
|
||||
# Push changes to github
|
||||
|
||||
Wypchnij swoje zmiany za pomocą polecenia `git push`:
|
||||
|
||||
```
|
||||
git push origin -u your-branch-name
|
||||
```
|
||||
|
||||
zastępując `your-branch-name` nazwą gałęzi, którą utworzyłeś wcześniej.
|
||||
|
||||
\<details\>
|
||||
\<summary\> \<strong\>Jeśli podczas wypychania wystąpią błędy, kliknij tutaj:\</strong\> \</summary\>
|
||||
|
||||
- ### Authentication Error
|
||||
|
||||
\<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/](https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/) for more information.
|
||||
fatal: Authentication failed for '[https://github.com/](https://github.com/)\<your-username\>/first-contributions.git/'\</pre\>
|
||||
Przejdź do [tutoriala GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) dotyczącego generowania i konfigurowania klucza SSH na swoim koncie.
|
||||
|
||||
\</details\>
|
||||
|
||||
-----
|
||||
|
||||
# Submit your changes for review
|
||||
|
||||
Teraz, uruchamiając to polecenie w katalogu naszego repozytorium, możemy utworzyć pull request do przeglądu:
|
||||
|
||||
```bash
|
||||
gh pr create --repo firstcontributions/first-contributions
|
||||
```
|
||||
|
||||
Następnie wyślij pull request.
|
||||
|
||||
Możesz użyć polecenia `gh status`, aby zobaczyć swój pull request w akcji.
|
||||
|
||||
-----
|
||||
|
||||
## Where to go from here?
|
||||
|
||||
Gratulacje\! Właśnie ukończyłeś standardowy cykl pracy *fork -\> clone -\> edit -\> pull request*, który często napotkasz jako kontrybutor\!
|
||||
|
||||
Uczcij swój wkład i podziel się nim ze znajomymi i obserwującymi, przechodząc do [web app](https://firstcontributions.github.io/#social-share).
|
||||
|
||||
Możesz dołączyć do naszego zespołu na Slacku, jeśli potrzebujesz pomocy lub masz pytania. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA).
|
||||
|
||||
Teraz zacznijmy kontrybuować do innych projektów. Zebraliśmy listę projektów z prostymi problemami, od których możesz zacząć. Sprawdź [the list of projects in the web app](https://firstcontributions.github.io/#project-list).
|
||||
|
||||
### [Additional material](https://www.google.com/search?q=additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
-----
|
||||
|
||||
## Tutorials Using Other Tools
|
||||
|
||||
[Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
|
||||
@@ -0,0 +1,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,96 @@
|
||||
|
||||
|
||||
|
||||
|
||||
[](https://github.com/ellerbrock/open-source-badges/)
|
||||
[<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://www.codetriage.com/roshanjossey/first-contributions)
|
||||
|
||||
# ആദ്യ സംഭാവനകൾ
|
||||
|
||||
\| <img alt="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> | Git Bash പതിപ്പ് |
|
||||
\| ------------------------------------------------- ------------------------------------------------- ------------- | ---------------- |
|
||||
|
||||
ആദ്യമായി എന്തെങ്കിലും ചെയ്യുമ്പോൾ എല്ലായ്പ്പോഴും അത് കഠിനമായി തോന്നും. പ്രത്യേകിച്ച് സഹകരിച്ച് പ്രവർത്തിക്കുമ്പോൾ തെറ്റുകൾ ചെയ്യുന്നത് ആരും ഇഷ്ടപ്പെടില്ല. പക്ഷേ **ഓപ്പൺ സോഴ്സ്** സഹകരണവും കൂട്ടായ പ്രവർത്തനവുമാണ്. പുതിയ സംഭാവനക്കാർക്ക് അവരുടെ **ആദ്യ സംഭാവന** നൽകുന്നത് എളുപ്പമാക്കാൻ ഞങ്ങൾ ആഗ്രഹിക്കുന്നു.
|
||||
|
||||
ലേഖനങ്ങൾ വായിക്കുകയോ ട്യൂട്ടോറിയലുകൾ കാണുകയോ ചെയ്യുന്നത് സഹായകരമാണ്, പക്ഷേ നേരിട്ട് ചെയ്യുന്നതിന് പകരമൊന്നുമില്ല.
|
||||
ഈ പ്രോജക്റ്റ് പുതിയവർക്ക് അവരുടെ ആദ്യ സംഭാവന നൽകുന്നത് ലളിതമാക്കുകയാണ് ലക്ഷ്യം.
|
||||
ഒരുപക്ഷേ നിങ്ങൾക്ക് ശാന്തമായിരുന്നാൽ നിങ്ങൾ കൂടുതൽ മികച്ച രീതിയിൽ പഠിക്കും.
|
||||
|
||||
നിങ്ങൾ നിങ്ങളുടെ ആദ്യ സംഭാവന നൽകാൻ ആഗ്രഹിക്കുന്നുവെങ്കിൽ, താഴെ കാണുന്ന ലളിതമായ ഘട്ടങ്ങൾ പിന്തുടരുക.
|
||||
|
||||
നിങ്ങളുടെ **Windows കമ്പ്യൂട്ടറിൽ Git Bash ഇല്ലെങ്കിൽ**, [ഇവിടെ നിന്ന് ഇൻസ്റ്റാൾ ചെയ്യുക](https://git-scm.com/download/win).
|
||||
|
||||
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt="ഈ റീപോസിറ്ററി Fork ചെയ്യുക" />
|
||||
|
||||
## ഈ റീപോസിറ്ററി Fork ചെയ്യുക
|
||||
|
||||
ഈ പേജിന്റെ മുകളിലെ വലത് വശത്ത് കാണുന്ന **Fork** ബട്ടൺ അമർത്തി ഈ റീപോയെ Fork ചെയ്യുക.
|
||||
ഇത് നിങ്ങളുടെ GitHub അക്കൗണ്ടിൽ ഒരു പകർപ്പ് സൃഷ്ടിക്കും.
|
||||
|
||||
## റീപോസിറ്ററി Clone ചെയ്യുക
|
||||
|
||||
ഇപ്പോൾ നിങ്ങളുടെ **Fork ചെയ്ത റീപോ** നിങ്ങളുടെ കമ്പ്യൂട്ടറിലേക്ക് Clone ചെയ്യുക.
|
||||
|
||||
പ്രധാനമാണ്: **ഒറിജിനൽ റീപോ** Clone ചെയ്യരുത്. നിങ്ങളുടെ Fork ചെയ്തത് മാത്രം Clone ചെയ്യുക.
|
||||
|
||||
Clone ചെയ്യാൻ “Code” അമർത്തി, താഴെ കാണുന്ന URL copy ചെയ്യുക.
|
||||
|
||||
```bash
|
||||
git clone <repo-url>
|
||||
```
|
||||
|
||||
പിന്നീട് നിങ്ങൾ Clone ചെയ്ത റീപോ തുറക്കാൻ git bash (അല്ലെങ്കിൽ VS Code) ഉപയോഗിക്കുക.
|
||||
|
||||
## ഒരു ബ്രാഞ്ച് സൃഷ്ടിക്കുക
|
||||
|
||||
ഒരു പുതിയ ബ്രാഞ്ച് സൃഷ്ടിക്കാൻ:
|
||||
|
||||
```bash
|
||||
git checkout -b <branch-name>
|
||||
```
|
||||
|
||||
ഉദാഹരണം: `add-your-name`
|
||||
|
||||
## ആവശ്യമായ മാറ്റങ്ങൾ വരുത്തുക
|
||||
|
||||
ഇപ്പോൾ `Contributors.md` ഫയൽ തുറന്ന്, ഏറ്റവും അവസാനം നിങ്ങളുടെ പേര് ചേർത്ത് **save** ചെയ്യുക.
|
||||
|
||||
ഉദാഹരണം:
|
||||
|
||||
```
|
||||
[ജിതിൻ പി](https://github.com/jithin-dotcom)
|
||||
```
|
||||
|
||||
ഫയൽ മാറ്റം വന്നിട്ടുണ്ടോ എന്ന് പരിശോധിക്കാൻ:
|
||||
|
||||
```bash
|
||||
git status
|
||||
```
|
||||
|
||||
## മാറ്റങ്ങൾ Commit ചെയ്യുക
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
git commit -m "നിങ്ങളുടെ പേര് Contributors പട്ടികയിൽ ചേർത്തു"
|
||||
```
|
||||
|
||||
Commit വിജയമായോ എന്ന് അറിയാൻ:
|
||||
|
||||
```bash
|
||||
git log --oneline
|
||||
```
|
||||
|
||||
## മാറ്റങ്ങൾ GitHub-ലേക്ക് Push ചെയ്യുക
|
||||
|
||||
```bash
|
||||
git push origin <branch-name>
|
||||
```
|
||||
|
||||
ഇതിന് ശേഷം, GitHub-ൽ നിങ്ങളുടെ Fork തുറക്കുമ്പോൾ **Compare & pull request** ബട്ടൺ കാണും.
|
||||
അത് അമർത്തി **Pull Request** തുറക്കുക. 🎉
|
||||
|
||||
---
|
||||
|
||||
വേണോ ഞാൻ മുഴുവൻ ഗൈഡും (പിന്നിലെ pull request ഭാഗം വരെ) മലയാളത്തിലേക്ക് convert ചെയ്ത് തരട്ടേ?
|
||||
@@ -0,0 +1,137 @@
|
||||
[](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)
|
||||
|
||||
# Primeras Contribuciones
|
||||
|
||||
| <img alt="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> | Versión de Git Bash |
|
||||
| ------------------------------------------------------------------------------------------------------------------ | --------------------- |
|
||||
|
||||
Es difícil. Siempre es difícil la primera vez que haces algo. Especialmente cuando colaboras, cometer errores puede ser incómodo. Pero el código abierto trata precisamente de colaboración y trabajo en conjunto. Queríamos simplificar el proceso mediante el cual nuevos colaboradores aprenden y hacen su primera contribución.
|
||||
|
||||
Leer artículos y ver tutoriales en video puede ayudar, pero no hay nada como aprender haciendo sin temor a equivocarte. Este proyecto busca proporcionar una guía clara y sencilla para que principiantes hagan su primera contribución. Recuerda, cuanto más relajado estés, mejor aprenderás. Si estás buscando hacer tu primera contribución, simplemente sigue estos pasos. Te prometemos que será divertido.
|
||||
|
||||
Si aún no tienes Git Bash en tu computadora con Windows, [descárgalo aquí](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="haz un fork de este repositorio" />
|
||||
|
||||
## Haz un fork de este repositorio
|
||||
|
||||
Haz clic en el botón "Fork" en la esquina superior derecha de esta página para crear una copia de este repositorio en tu cuenta.
|
||||
|
||||
## Clona tu repositorio
|
||||
|
||||
Ahora clona ese repositorio en tu computadora.
|
||||
|
||||
⚠️ IMPORTANTE: NO clones el repositorio original.
|
||||
|
||||
Ve a tu fork y clónalo.
|
||||
|
||||
Para hacerlo, haz clic en "Code" y copia el enlace.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copiar enlace" />
|
||||
|
||||
Abre la aplicación Git Bash que acabas de instalar. Debería lucir como la siguiente imagen si estás en Windows:
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="abrir terminal de git bash" />
|
||||
|
||||
Ve a la carpeta donde quieres guardar este proyecto usando el comando:
|
||||
|
||||
`cd <carpeta>`
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-2.png" alt="entrar a la carpeta deseada" />
|
||||
|
||||
Usa el enlace copiado anteriormente para clonar tu repositorio:
|
||||
|
||||
`git clone <url-del-repositorio>`
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-2.png" alt="clonar repositorio" />
|
||||
|
||||
Ve al directorio recién clonado y ábrelo en Visual Studio Code para hacer tus cambios.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-3.png" alt="entrar al repo clonado" />
|
||||
|
||||
## Crear una rama
|
||||
|
||||
Ahora crea una nueva rama usando este comando:
|
||||
|
||||
```
|
||||
git checkout -b <nombre-de-tu-rama>
|
||||
```
|
||||
|
||||
Ejemplo: `add-james-smith`
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-branch.png" alt="crear rama" />
|
||||
|
||||
## Realiza los cambios necesarios
|
||||
|
||||
Abre el archivo `Contributors.md` en tu editor, ve al final del archivo y agrega tu nombre.
|
||||
|
||||
Ejemplo:
|
||||
```md
|
||||
[James Smith](https://github.com/jamessmith)
|
||||
```
|
||||
|
||||
Para verificar los cambios:
|
||||
|
||||
```bash
|
||||
git status
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="ver estado" />
|
||||
|
||||
Ahora haz commit de los cambios:
|
||||
|
||||
Primero agrega el archivo:
|
||||
|
||||
```bash
|
||||
git add Contributors.md
|
||||
```
|
||||
|
||||
Después crea el commit:
|
||||
|
||||
```bash
|
||||
git commit -m "Agrego mi nombre a la lista de contribuidores"
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit de cambios" />
|
||||
|
||||
Para verificar el commit:
|
||||
|
||||
```bash
|
||||
git log --oneline
|
||||
```
|
||||
|
||||
## Sube tus cambios a GitHub
|
||||
|
||||
```bash
|
||||
git push origin <nombre-de-tu-rama>
|
||||
```
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-push.png" alt="hacer push" />
|
||||
|
||||
## Envía tu Pull Request
|
||||
|
||||
Ve a tu repositorio en GitHub. Verás un botón que dice “Compare & pull request”. Haz clic allí.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="crear pull request" />
|
||||
|
||||
Completa el formulario y envía el Pull Request.
|
||||
|
||||
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="enviar PR" />
|
||||
|
||||
Pronto tus cambios serán revisados e integrados al repositorio principal. Recibirás una notificación por correo.
|
||||
|
||||
## ¿Y ahora qué?
|
||||
|
||||
¡Felicidades! Has completado el flujo de trabajo clásico _fork → clone → editar → pull request_ que es común en el mundo del open source.
|
||||
|
||||
Celebra tu contribución compartiéndola con tus amigos o en redes. También puedes unirte al equipo en Slack para resolver dudas:
|
||||
👉 [Únete al Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
|
||||
|
||||
### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md)
|
||||
|
||||
## Guías para otras herramientas
|
||||
|
||||
[Volver a la página principal](https://github.com/firstcontributions/first-contributions/blob/main/translations/README.es.md#material-de-apoyo-para-otras-herramientas)
|
||||
Reference in New Issue
Block a user