mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-13 17:21:50 +00:00
132 lines
8.0 KiB
Markdown
132 lines
8.0 KiB
Markdown
|
|
<img align="right" width="150" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-old-version-tutorial/join-slack-team.png">
|
|
|
|
|
|
|
|
āĻĒā§āϰāĻĨāĻŽ āĻ
āĻŦāĻĻāĻžāύ (First Contribution)
|
|
<img alt="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> Git Bash āϏāĻāϏā§āĻāϰāĻŖ
|
|
|
|
āĻĒā§āϰāĻĨāĻŽāĻŦāĻžāϰ āĻāĻŋāĻā§ āĻāϰāϞ⧠āϏā§āĻāĻž āĻāĻ āĻŋāύ āĻŽāύ⧠āĻšāϝāĻŧāĨ¤ āĻŦāĻŋāĻļā§āώ āĻāϰ⧠āϝāĻāύ āϏāĻšāϝā§āĻāĻŋāϤāĻžāĻŽā§āϞāĻ āĻāĻžāĻ āĻšāϝāĻŧ, āϤāĻāύ āĻā§āϞ āĻāϰāĻžāϰ āĻāϝāĻŧ āĻĨāĻžāĻā§āĨ¤ āĻāĻŋāύā§āϤ⧠āĻāĻĒā§āύ āϏā§āϰā§āϏ āĻŽāĻžāύā§āĻ āϏāĻšāϝā§āĻāĻŋāϤāĻž â āĻāĻāϏāĻžāĻĨā§ āĻāĻžāĻ āĻāϰāĻžāĨ¤
|
|
|
|
āĻāĻŽāϰāĻž āĻā§āϝāĻŧā§āĻāĻŋ āύāϤā§āύ āĻāĻĒā§āύ āϏā§āϰā§āϏ āĻ
āĻŦāĻĻāĻžāύāĻāĻžāϰā§āĻĻā§āϰ āĻāύā§āϝ āĻļā§āĻāĻžāϰ āĻĒāĻĨ āϏāĻšāĻ āĻāϰāĻžāĨ¤ āĻļā§āϧ⧠āĻāĻŋāĻāĻā§āϰāĻŋāϝāĻŧāĻžāϞ āĻĒāĻĄāĻŧā§ āĻŦāĻž āĻāĻŋāĻĄāĻŋāĻ āĻĻā§āĻā§ āύāϝāĻŧ â āĻŦāϰāĻ āĻšāĻžāϤ⧠āĻāϞāĻŽā§ āĻĒā§āϰā§āϝāĻžāĻāĻāĻŋāϏ āĻāϰ⧠āĻļāĻŋāĻāϞ⧠āĻ
āύā§āĻ āĻĻā§āϰā§āϤ āĻŦā§āĻāĻž āϝāĻžāϝāĻŧāĨ¤ āĻāĻ āĻĒā§āϰā§āĻā§āĻā§āĻā§āϰ āĻāĻĻā§āĻĻā§āĻļā§āϝ āĻšāϞ⧠āύāϤā§āύāĻĻā§āϰ āĻāĻžāĻāĻĄ āĻāϰāĻž āĻāĻŦāĻ āϤāĻžāĻĻā§āϰ āĻĒā§āϰāĻĨāĻŽ āĻ
āĻŦāĻĻāĻžāύ āϰāĻžāĻāĻžāϰ āĻ
āĻāĻŋāĻā§āĻāϤāĻžāĻā§ āϏāĻšāĻ āĻāϰāĻžāĨ¤
|
|
|
|
āĻŽāύ⧠āϰāĻžāĻāĻŦā§āύ, āĻāĻĒāύāĻŋ āϝāϤ āĻŦā§āĻļāĻŋ āϏā§āĻŦāĻžāĻā§āĻāύā§āĻĻā§āϝāĻŦā§āϧ āĻāϰāĻŦā§āύ, āĻļā§āĻāĻžāĻ āϤāϤ āĻāĻžāϞ⧠āĻšāĻŦā§āĨ¤
|
|
|
|
āϝāĻĻāĻŋ āĻāĻĒāύāĻŋ āĻāĻāύā§āĻĄā§āĻ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻāϰā§āύ āĻāĻŦāĻ āĻāĻĒāύāĻžāϰ āĻāĻžāĻā§ Git Bash āύāĻž āĻĨāĻžāĻā§, āĻāĻāĻžāύ āĻĨā§āĻā§ āĻāύā§āϏāĻāϞ āĻāϰā§āύ
|
|
āĨ¤
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt="fork this repository" />
|
|
āĻāĻ āϰāĻŋāĻĒā§āĻāĻŋāĻāϰāĻŋāĻā§ Fork āĻāϰā§āύ
|
|
|
|
āĻāĻ āĻĒā§āĻā§āϰ āĻāĻĒāϰā§āϰ āĻĄāĻžāύ āĻĻāĻŋāĻā§ āĻĨāĻžāĻāĻž 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 āĻ
ā§āϝāĻžāĻĒā§āϞāĻŋāĻā§āĻļāύ āĻā§āϞā§āύāĨ¤ āĻāĻāύā§āĻĄā§āĻā§ āĻāĻāĻŋ āύāĻŋāĻā§āϰ āĻāĻŦāĻŋāϰ āĻŽāϤ⧠āĻĻā§āĻāĻžāĻŦā§:
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="open git bash terminal" />
|
|
|
|
ā§Š. āϏā§āĻ āĻĢā§āϞā§āĻĄāĻžāϰ⧠āϝāĻžāύ āϝā§āĻāĻžāύ⧠āĻāĻĒāύāĻŋ āĻĒā§āϰā§āĻā§āĻā§āĻāĻāĻŋ āϰāĻžāĻāϤ⧠āĻāĻžāύ:
|
|
|
|
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" />
|
|
|
|
ā§Ē. āĻāĻŦāĻžāϰ āϰāĻŋāĻĒā§āĻāĻŋāĻāϰāĻŋāĻāĻŋ āĻā§āϞā§āύ āĻāϰā§āύ:
|
|
|
|
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" />
|
|
|
|
ā§Ģ. āĻā§āϞā§āύ āĻāϰāĻž āĻĄāĻŋāϰā§āĻā§āĻāϰāĻŋāϤ⧠āϝāĻžāύ āĻāĻŦāĻ Visual Studio 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" />
|
|
āĻāĻāĻāĻŋ āύāϤā§āύ āĻŦā§āϰāĻžāĻā§āĻ āϤā§āϰāĻŋ āĻāϰā§āύ
|
|
|
|
āύāĻŋāĻā§āϰ āĻāĻŽāĻžāύā§āĻĄ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻāϰ⧠āĻāĻāĻāĻŋ āύāϤā§āύ āĻŦā§āϰāĻžāĻā§āĻ āϤā§āϰāĻŋ āĻāϰā§āύ āĻāĻŦāĻ āϏā§āĻ āĻŦā§āϰāĻžāĻā§āĻā§ āĻāϞ⧠āϝāĻžāύ:
|
|
|
|
git checkout -b <branch-name>
|
|
|
|
|
|
đ āĻāĻĒāύāĻžāϰ āĻŦā§āϰāĻžāĻā§āĻā§āϰ āύāĻžāĻŽ āĻĻāĻŋāύ <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](https://github.com/jamessmith)
|
|
|
|
|
|
āĻĒāϰāĻŋāĻŦāϰā§āϤāύ āĻšāϝāĻŧā§āĻā§ āĻāĻŋāύāĻž āĻĻā§āĻāϤā§:
|
|
|
|
git status
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="check the status" />
|
|
|
|
āĻĢāĻžāĻāϞ āϏā§āĻā§āĻ āĻāϰāϤā§:
|
|
|
|
git add file-name
|
|
|
|
|
|
āĻāĻŽāĻŋāĻ āĻāϰāϤā§:
|
|
|
|
git commit -m "Add your-name to Contributors list"
|
|
|
|
|
|
đ <your-name> āĻāϰ āĻāĻžāϝāĻŧāĻāĻžāϝāĻŧ āύāĻŋāĻā§āϰ āύāĻžāĻŽ āϞāĻŋāĻāĻŦā§āύāĨ¤
|
|
|
|
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit changes" />
|
|
|
|
āĻāĻŽāĻŋāĻ āĻā§āĻ āĻāϰāϤ⧠āĻāĻžāĻāϞā§:
|
|
|
|
git log --oneline
|
|
|
|
āĻĒāϰāĻŋāĻŦāϰā§āϤāύ GitHub āĻ Push āĻāϰā§āύ
|
|
|
|
āϏāĻŦ āϧāĻžāĻĒ āĻļā§āώ āĻšāϞ⧠āĻĒāϰāĻŋāĻŦāϰā§āϤāύāĻā§āϞ⧠GitHub āĻ āĻĒāĻžāĻ āĻžāϤ⧠āĻšāĻŦā§:
|
|
|
|
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" />
|
|
Pull Request āĻĒāĻžāĻ āĻžāύ
|
|
|
|
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" />
|
|
|
|
āĻļā§āĻā§āϰāĻ āĻāĻĒāύāĻžāϰ āĻĒāϰāĻŋāĻŦāϰā§āϤāύāĻā§āϞ⧠āĻŽā§āϞ āϰāĻŋāĻĒā§āĻāĻŋāĻāϰāĻŋāϰ master āĻŦā§āϰāĻžāĻā§āĻā§ āĻŽāĻžāϰā§āĻ āĻšāϝāĻŧā§ āϝāĻžāĻŦā§āĨ¤ āĻĒāϰāĻŋāĻŦāϰā§āϤāύ āĻŽāĻžāϰā§āĻ āĻšāϞ⧠āĻāĻŽā§āĻāϞ⧠āύā§āĻāĻŋāĻĢāĻŋāĻā§āĻļāύ āĻĒāĻžāĻŦā§āύāĨ¤
|
|
|
|
āĻāϰāĻĒāϰ āĻā§ āĻāϰāĻŦā§āύ?
|
|
|
|
āĻ
āĻāĻŋāύāύā§āĻĻāύ đ āĻāĻĒāύāĻŋ āĻāĻāύāĻ āϏāĻžāϧāĻžāϰāĻŖ fork â clone â edit â PR āĻāϝāĻŧāĻžāϰā§āĻāĻĢā§āϞ⧠āϏāĻŽā§āĻĒāύā§āύ āĻāϰāϞā§āύ, āϝāĻž āĻāĻāĻāύ āĻ
āĻŦāĻĻāĻžāύāĻāĻžāϰ⧠āĻšāĻŋāϏā§āĻŦā§ āĻŦāĻžāϰāĻŦāĻžāϰ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻāϰāϤ⧠āĻšāĻŦā§āĨ¤
|
|
|
|
đ āĻāĻĒāύāĻžāϰ āĻ
āĻŦāĻĻāĻžāύ āĻāĻĻāϝāĻžāĻĒāύ āĻāϰā§āύ āĻāĻŦāĻ āĻāϝāĻŧā§āĻŦ āĻ
ā§āϝāĻžāĻĒ
|
|
āĻĨā§āĻā§ āĻŦāύā§āϧā§āĻĻā§āϰ āϏāĻžāĻĨā§ āĻļā§āϝāĻŧāĻžāϰ āĻāϰā§āύāĨ¤
|
|
|
|
đ āĻā§āύ⧠āĻĒā§āϰāĻļā§āύ āĻĨāĻžāĻāϞ⧠āĻŦāĻž āϏāĻžāĻšāĻžāϝā§āϝā§āϰ āĻĒā§āϰāϝāĻŧā§āĻāύ āĻšāϞ⧠āĻāĻŽāĻžāĻĻā§āϰ Slack āĻāĻŋāĻŽā§ āϝā§āĻ āĻĻāĻŋāϤ⧠āĻĒāĻžāϰā§āύ: āϏā§āϞā§āϝāĻžāĻ āĻāĻŋāĻŽā§ āϝā§āĻ āĻĻāĻŋāύ
|
|
āĨ¤
|
|
|
|
āĻ
āϤāĻŋāϰāĻŋāĻā§āϤ āĻāĻĒāĻāϰāĻŖ
|
|
āĻ
āύā§āϝ āĻā§āϞ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻāϰ⧠āĻāĻŋāĻāĻā§āϰāĻŋāϝāĻŧāĻžāϞ
|
|
|
|
āĻŽā§āϞ āĻĒāĻžāϤāĻžāϝāĻŧ āĻĢāĻŋāϰ⧠āϝāĻžāύ |