mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-14 01:31:50 +00:00
103 lines
9.2 KiB
Markdown
103 lines
9.2 KiB
Markdown
# first
|
|
|
|
[](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 Command Line Interface (CLI) |
|
|
| ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
|
|
|
|
рдпрд╣ рд╣рдорд╛рд░реЗ рд▓рд┐рдП рдПрдХ рдЧрд╛рдЗрдб рд╣реИ, рдЯрд░реНрдорд┐рдирд▓ рдирд░реНрдб, рдЬреЛ рдЯрд░реНрдорд┐рдирд▓ рдореЗрдВ рд╕рдм рдХреБрдЫ рдХрд░рдирд╛ рдЪрд╛рд╣рддреЗ рд╣реИрдВ, рдФрд░ рдЗрд╕рдХреЗ рд▓рд┐рдП рдзрдиреНрдпрд╡рд╛рдж [Github-CLI](https://cli.github.com/) рдЙрдирдХреЗ рдХрд╛рд░рдг рдЗрд╕реЗ рдкреНрд░рд╛рдкреНрдд рдХрд░ рд╕рдХрддреЗ рд╣реИрдВ, рдЖрдкрдХрд╛ рдкрд╣рд▓рд╛ рдпреЛрдЧрджрд╛рди рдпрд╛рдж рд░рдЦрдирд╛ рдордЬреЗрджрд╛рд░, рдкреБрд░рд╕реНрдХреГрдд рдФрд░ рдЖрдЧреЗ рдмрдврд╝рдиреЗ рдХреЗ рд▓рд┐рдП рдкреНрд░реЗрд░рдХ рд╣реЛрдирд╛ рдЪрд╛рд╣рд┐рдП!
|
|
|
|
рдпрд╣ рдорд╛рд░реНрдЧрджрд░реНрд╢рд┐рдХрд╛ рдереЛрдбрд╝реА рдЕрдзрд┐рдХ рдЪреБрдиреМрддреАрдкреВрд░реНрдг рд╣реИ рдХреНрдпреЛрдВрдХрд┐ рд╣рдо рдХрд┐рд╕реА рднреА рдЪрд┐рддреНрд░рд╛рддреНрдордХ рдЗрдВрдЯрд░рдлрд╝реЗрд╕ рдХрд╛ рдЙрдкрдпреЛрдЧ рдирд╣реАрдВ рдХрд░ рд░рд╣реЗ рд╣реИрдВ, рд▓реЗрдХрд┐рди рдпрд╣ рдЕрднреА рднреА рд╕рдЪрдореБрдЪ рдореЗрдВ рдордЬрд╝реЗрджрд╛рд░ рд╣реИ рдФрд░ рдЖрдк рдирд┐рд╢реНрдЪрд┐рдд рд░реВрдк рд╕реЗ рдЗрд╕рдХрд╛ рдЕрдиреБрд╕рд░рдг рдХрд░ рд╕рдХрддреЗ рд╣реИрдВ!
|
|
|
|
рдкрд╣рд▓реА рдЖрд╡рд╢реНрдпрдХрддрд╛ рд╣реИ:
|
|
|
|
- Git installed ([Git](https://git-scm.com/downloads) рдХреИрд╕реЗ рд╕реНрдерд╛рдкрд┐рдд рдХрд░реЗрдВ)
|
|
- Github рдЦрд╛рддрд╛
|
|
|
|
рдЕрдм рд╣рдореЗрдВ рдЖрдзрд┐рдХрд╛рд░рд┐рдХ рджрд╕реНрддрд╛рд╡реЗрдЬрд╝реАрдХрд░рдг рдХрд╛ рдкрд╛рд▓рди рдХрд░рдХреЗ рдЕрдкрдиреЗ рд╕рд┐рд╕реНрдЯрдо рдореЗрдВ `github-cli` рдЯреВрд▓ рдЗрдВрд╕реНрдЯреЙрд▓ рдХрд░рдирд╛ рд╣реЛрдЧрд╛
|
|
|
|
рдЙрд╕рдХреЗ рдмрд╛рдж, рд╣рдореЗрдВ CLI рдореЗрдВ рд▓реЙрдЧрд┐рди рдХрд░рдиреЗ рдХреА рдЖрд╡рд╢реНрдпрдХрддрд╛ рд╣реИ, рдЗрд╕рд▓рд┐рдП рдпрд╣ рдЖрджреЗрд╢ рджрд░реНрдЬ рдХрд░реЗрдВ:
|
|
|
|
```bash
|
|
gh auth login
|
|
```
|
|
|
|
рдирд┐рд░реНрджреЗрд╢реЛрдВ рдХрд╛ рдкрд╛рд▓рди рдХрд░реЗрдВ рдФрд░ рд╣рдо рддреИрдпрд╛рд░ рд╣реИрдВ!
|
|
|
|
# Fork this repository
|
|
|
|
рдЗрд╕ рдЖрджреЗрд╢ рдХреЛ рдЪрд▓рд╛рдирд╛ рдЙрддрдирд╛ рд╣реА рдЖрд╕рд╛рди рд╣реИ:
|
|
|
|
```bash
|
|
gh repo fork firstcontributions/first-contributions
|
|
```
|
|
|
|
**рдорд╣рддреНрд╡рдкреВрд░реНрдг: рдпрд╣ рдЖрдкрдХреЛ рд╕рдВрдХреЗрдд рджреЗрдЧрд╛ рдХрд┐ рдпрджрд┐ рдЖрдк рдЗрд╕реЗ рднреА рдХреНрд▓реЛрди рдХрд░рдирд╛ рдЪрд╛рд╣рддреЗ рд╣реИрдВ, рддреЛ "yes" рдЪреБрдиреЗрдВ**
|
|
|
|
# рдЕрдкрдиреА рд╢рд╛рдЦрд╛ рдмрдирд╛рдПрдБ
|
|
|
|
рд╣рдо рдЗрд╕ рдХрджрдо рдХреЛ `git` рдХреЗ рд╕рд╛рде рдХрд░реЗрдВрдЧреЗ, рдЗрд╕рд▓рд┐рдП рдЗрд╕ рдЖрджреЗрд╢ рдХреЛ рдЕрдкрдиреЗ рдирд╛рдо рдХреЗ рд╕рд╛рде рдирд╛рдо рдмрджрд▓рдХрд░ рджрд░реНрдЬ рдХрд░реЗрдВ, рдЙрджрд╛рд╣рд░рдг рдХреЗ рд▓рд┐рдП:
|
|
|
|
```bash
|
|
git switch -c add-рдЬреЙрди-рдбреВрдИ
|
|
```
|
|
|
|
# рдЖрд╡рд╢реНрдпрдХ рдмрджрд▓рдирд╛ рдХрд░реЗрдВ рдФрд░ рдЙрди рдмрджрд▓рдирд╛ рдХреЛ рдХрд░реЗрдВ `commit`
|
|
|
|
рдЕрдм рдЖрдк рдЯреЗрдХреНрд╕реНрдЯ рдПрдбрд┐рдЯрд░ рдореЗрдВ `Contributors.md` рдлрд╝рд╛рдЗрд▓ рдЦреЛрд▓ рд╕рдХрддреЗ рд╣реИрдВ рдФрд░ рдЙрд╕рдореЗрдВ рдЕрдкрдирд╛ рдирд╛рдо рдЬреЛрдбрд╝ рд╕рдХрддреЗ рд╣реИрдВред рд╢реБрд░реБрдЖрдд рдФрд░ рдЕрдВрдд рдХреЗ рдмреАрдЪ рдЕрдкрдирд╛ рдирд╛рдо рдХрд╣реАрдВ рднреА рд░рдЦреЗрдВ, рдлрд┐рд░ рдлрд╛рдЗрд▓ рдХреЛ рд╕реЗрд╡ рдХрд░реЗрдВред
|
|
|
|
рдкреНрд░реЛрдЬреЗрдХреНрдЯ рдбрд╛рдпрд░реЗрдХреНрдЯрд░реА рдореЗрдВ `git status` рдирд┐рд╖реНрдкрд╛рджрд┐рдд рдХрд░реЗрдВ рдФрд░ рдЖрдк рдкрд░рд┐рд╡рд░реНрддрди рджреЗрдЦреЗрдВрдЧреЗред
|
|

|
|
|
|
рдЙрди рдкрд░рд┐рд╡рд░реНрддрдиреЛрдВ рдХреЛ рдЙрд╕ рд╢рд╛рдЦрд╛ рдореЗрдВ рдЬреЛрдбрд╝реЗрдВ рдЬрд┐рд╕реЗ рдЖрдкрдиреЗ рдЕрднреА `git add` рдХрдорд╛рдВрдб рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░рдХреЗ рдмрдирд╛рдпрд╛ рд╣реИ:
|
|
`git add Contributors.md`
|
|
|
|
рдЕрдм `git commit` рдХрдорд╛рдВрдб рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░рдХреЗ рдЙрди рдкрд░рд┐рд╡рд░реНрддрдиреЛрдВ рдХреЛ рдХрд░реЗрдВ: `git commit -m "Add your-name to Contributors list` рдЕрдкрдиреЗ рдирд╛рдо рдХреЗ рд╕рд╛рде `your-name` рдмрджрд▓реЗрдВред
|
|
|
|
# Github рдореЗрдВ рдкрд░рд┐рд╡рд░реНрддрди рдкреБрд╢ рдХрд░реЗрдВ
|
|
|
|
`git push` рдХрдорд╛рдВрдб рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░рдХреЗ рдЕрдкрдиреЗ рдкрд░рд┐рд╡рд░реНрддрди рдкреБрд╢ рдХрд░реЗрдВ:
|
|
|
|
git push origin -u your-branch-name
|
|
|
|
`your-branch-name` рдЖрдкрдХреЗ рджреНрд╡рд╛рд░рд╛ рдкрд╣рд▓реЗ рдмрдирд╛рдИ рдЧрдИ рд╢рд╛рдЦрд╛ рдХреЗ рдирд╛рдо рд╕реЗ рдмрджрд▓рдХрд░ред
|
|
|
|
<details><summary> <strong>рдпрджрд┐ рдЖрдкрдХреЛ рдкреБрд╢ рдХрд░рддреЗ рд╕рдордп рдХреЛрдИ рддреНрд░реБрдЯрд┐ рдорд┐рд▓рддреА рд╣реИ, рддреЛ рдпрд╣рд╛рдВ рдХреНрд▓рд┐рдХ рдХрд░реЗрдВ:</strong></summary></details>
|
|
|
|
- ### рдкреНрд░рдорд╛рдгреАрдХрд░рдг рддреНрд░реБрдЯрд┐
|
|
рд░рд┐рдореЛрдЯ: 13 рдЕрдЧрд╕реНрдд, 2021 рдХреЛ рдкрд╛рд╕рд╡рд░реНрдб рдкреНрд░рдорд╛рдгреАрдХрд░рдг рдХреЗ рд▓рд┐рдП рд╕рдорд░реНрдерди рд╣рдЯрд╛ рджрд┐рдпрд╛ рдЧрдпрд╛ рдерд╛ред рдХреГрдкрдпрд╛ рдЗрд╕рдХреЗ рдмрдЬрд╛рдп рдПрдХ рд╡реНрдпрдХреНрддрд┐рдЧрдд рдПрдХреНрд╕реЗрд╕ рдЯреЛрдХрди рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░реЗрдВред рджреВрд░рд╕реНрде: рдЕрдзрд┐рдХ рдЬрд╛рдирдХрд╛рд░реА рдХреЗ рд▓рд┐рдП рдХреГрдкрдпрд╛ https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ рджреЗрдЦреЗрдВред рдШрд╛рддрдХ: 'https://github.com/' рдХреЗ рд▓рд┐рдП рдкреНрд░рдорд╛рдгреАрдХрд░рдг рд╡рд┐рдлрд▓ /рдкреНрд░рдердо-рдпреЛрдЧрджрд╛рди.рдЧрд┐рдЯ/'
|
|
рдЕрдкрдиреЗ рдЦрд╛рддреЗ рдореЗрдВ SSH рдХреБрдВрдЬреА рдмрдирд╛рдиреЗ рдФрд░ рдХреЙрдиреНрдлрд╝рд┐рдЧрд░ рдХрд░рдиреЗ рдХреЗ рд▓рд┐рдП [GitHub рдХреЗ рдЯреНрдпреВрдЯреЛрд░рд┐рдпрд▓](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) рдкрд░ рдЬрд╛рдПрдВред
|
|
|
|
# рд╕рдореАрдХреНрд╖рд╛ рдХреЗ рд▓рд┐рдП рдЕрдкрдиреЗ рдкрд░рд┐рд╡рд░реНрддрди рд╕рдмрдорд┐рдЯ рдХрд░реЗрдВ
|
|
|
|
рдЕрдм рдЗрд╕ рдЖрджреЗрд╢ рдХреЛ рд╣рдорд╛рд░реЗ рд░реЗрдкреЛ рдХреА рдирд┐рд░реНрджреЗрд╢рд┐рдХрд╛ рдореЗрдВ рдЪрд▓рд╛рдиреЗ рд╕реЗ рд╣рдо рд╕рдореАрдХреНрд╖рд╛ рдХреЗ рд▓рд┐рдП рдПрдХ рдкреБрд▓ рдЕрдиреБрд░реЛрдз рдмрдирд╛ рд╕рдХреЗрдВрдЧреЗ:
|
|
|
|
```bash
|
|
gh pr create --repo firstcontributions/first-contributions
|
|
```
|
|
|
|
рдЗрд╕рдХреЗ рдмрд╛рдж рдкреБрд▓ рд░рд┐рдХреНрд╡реЗрд╕реНрдЯ рд╕рдмрдорд┐рдЯ рдХрд░реЗрдВред
|
|
|
|
рдЕрдкрдиреЗ рдЙрд▓реНрд▓реЗрдЦрд┐рдд рдкреБрд▓ рдЕрдиреБрд░реЛрдз рдХреЛ рдХреНрд░рд┐рдпрд╛рд╢реАрд▓ рджреЗрдЦрдиреЗ рдХреЗ рд▓рд┐рдП рдЖрдк `gh status` рдХрдорд╛рдВрдб рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░ рд╕рдХрддреЗ рд╣реИрдВред
|
|
|
|
## рдпрд╣рд╛рдБ рд╕реЗ рдХрд╣рд╛рдБ рдЬрд╛рдПрдВ?
|
|
|
|
рдмрдзрд╛рдИ рд╣реЛ! рдЖрдкрдиреЗ рдЕрднреА-рдЕрднреА рдорд╛рдирдХ _рдХрд╛рдВрдЯрд╛ рдкреВрд░рд╛ рдХрд┐рдпрд╛ рд╣реИ -> рдХреНрд▓реЛрди -> рд╕рдВрдкрд╛рджрд┐рдд рдХрд░реЗрдВ -> рдкреБрд▓ рдЕрдиреБрд░реЛрдз_ рд╡рд░реНрдХрдлрд╝реНрд▓реЛ рдЬрд┐рд╕реЗ рдЖрдк рдЕрдХреНрд╕рд░ рдПрдХ рдпреЛрдЧрджрд╛рдирдХрд░реНрддрд╛ рдХреЗ рд░реВрдк рдореЗрдВ рд╕рд╛рдордирд╛ рдХрд░реЗрдВрдЧреЗ!
|
|
|
|
рдЕрдкрдиреЗ рдпреЛрдЧрджрд╛рди рдХрд╛ рдЬрд╢реНрди рдордирд╛рдПрдВ рдФрд░ рдЗрд╕реЗ [рд╡реЗрдм рдРрдк](https://firstcontributions.github.io/#social-share) рдкрд░ рдЬрд╛рдХрд░ рдЕрдкрдиреЗ рджреЛрд╕реНрддреЛрдВ рдФрд░ рдлреЙрд▓реЛрдЕрд░реНрд╕ рдХреЗ рд╕рд╛рде рд╕рд╛рдЭрд╛ рдХрд░реЗрдВред
|
|
|
|
рдЕрдЧрд░ рдЖрдкрдХреЛ рдХреЛрдИ рдорджрдж рдЪрд╛рд╣рд┐рдП рдпрд╛ рдХреЛрдИ рд╕рд╡рд╛рд▓ рд╣реИ рддреЛ рдЖрдк рд╣рдорд╛рд░реА рд╕реБрд╕реНрдд рдЯреАрдо рдореЗрдВ рд╢рд╛рдорд┐рд▓ рд╣реЛ рд╕рдХрддреЗ рд╣реИрдВред [рд╕реБрд╕реНрдд рдЯреАрдо рдореЗрдВ рд╢рд╛рдорд┐рд▓ рд╣реЛрдВ](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA) ред
|
|
|
|
рдЖрдЗрдП рдЕрдм рдЖрдкрдХреЛ рдЕрдиреНрдп рдкрд░рд┐рдпреЛрдЬрдирд╛рдУрдВ рдореЗрдВ рдпреЛрдЧрджрд╛рди рдХреЗ рд╕рд╛рде рдЖрд░рдВрдн рдХрд░рддреЗ рд╣реИрдВред рд╣рдордиреЗ рдЙрди рдЖрд╕рд╛рди рдореБрджреНрджреЛрдВ рдХреЗ рд╕рд╛рде рдкрд░рд┐рдпреЛрдЬрдирд╛рдУрдВ рдХреА рдПрдХ рд╕реВрдЪреА рддреИрдпрд╛рд░ рдХреА рд╣реИ рдЬрд┐рди рдкрд░ рдЖрдк рд╢реБрд░реБрдЖрдд рдХрд░ рд╕рдХрддреЗ рд╣реИрдВред [рд╡реЗрдм рдРрдк рдореЗрдВ рдкрд░рд┐рдпреЛрдЬрдирд╛рдУрдВ рдХреА рд╕реВрдЪреА](https://firstcontributions.github.io/#project-list) рджреЗрдЦреЗрдВред
|
|
|
|
### [рдЕрддрд┐рд░рд┐рдХреНрдд рд╕рд╛рдордЧреНрд░реА](additional-material/git_workflow_scenarios/additional-material.md)
|
|
|
|
## рдЯреНрдпреВрдЯреЛрд░рд┐рдпрд▓ рдЕрдиреНрдп рдЙрдкрдХрд░рдгреЛрдВ рдХрд╛ рдЙрдкрдпреЛрдЧ рдХрд░рдирд╛
|
|
|
|
[рдореБрдЦреНрдп рдкреГрд╖реНрда рдкрд░ рд╡рд╛рдкрд╕](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
|