mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-14 09:06:41 +00:00
122 lines
12 KiB
Markdown
122 lines
12 KiB
Markdown
[](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)
|
|
|
|
# рдкрд╣рд┐рд▓реЛ рдпреЛрдЧрджрд╛рди(Contribution)
|
|
|
|
| <img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="200"> | GitHub Desktop Edition |
|
|
| ----------------------------------------------------------------------------------------------- | ---------------------- |
|
|
|
|
рдУрдкрди рд╕реЛрд░реНрд╕(open source) рднрдиреЗрдХреЛ рд╕рд╣рдХрд╛рд░реНрдп рд░ рд╕рдБрдЧреИ рдХрд╛рдо рдЧрд░реНрдиреБ рд╣реЛ ред рд╣рд╛рдореА рдирдпрд╛рдБ рдЦреБрд▓рд╛ рд╕реНрд░реЛрдд(open source) рдпреЛрдЧрджрд╛рдирдХрд░реНрддрд╛рд╣рд░реВ(contributors )рд▓реЗ рд╕рд┐рдХреНрдиреЗ рд░ рдкрд╣рд┐рд▓реЛ рдкрдЯрдХ рдпреЛрдЧрджрд╛рди рдЧрд░реНрдиреЗ рддрд░рд┐рдХрд╛рд▓рд╛рдИ рд╕рд░рд▓ рдмрдирд╛рдЙрди рдЪрд╛рд╣рдиреНрдереНрдпреМрдВред
|
|
|
|
рд▓реЗрдЦрд╣рд░реВ(Articles) рдкрдвреНрдиреЗ рд░ рдЯреНрдпреВрдЯреЛрд░рд┐рдпрд▓рд╣рд░реВ(Tutorials) рд╣реЗрд░реНрдиреЗ рдмрд╛рдиреАрд▓реЗ рдорджреНрджрдд рдЧрд░реНрди рд╕рдХреНрдЫ, рддрд░ рд╡рд╛рд╕реНрддрд╡рдорд╛ рдХреБрдиреИ рдкрдирд┐ рдЧрдбрдмрдб рдирдЧрд░реА рдпреЛрдЧрджрд╛рди рдЧрд░реНрдиреБ рдд рдЭрдиреИ рд░рд╛рдореНрд░реЛ ред рдпрд╕ рдкрд░рд┐рдпреЛрдЬрдирд╛рдХреЛ рдЙрджреНрджреЗрд╢реНрдп рдорд╛рд░реНрдЧрдирд┐рд░реНрджреЗрд╢рди рдкреНрд░рджрд╛рди рдЧрд░реНрдиреЗ рд░ рд╕реБрд░реБрд╡рд╛рддрдХрд░реНрддрд╛рд╣рд░реВрд▓реЗ рдЖрдлреНрдиреЛ рдкрд╣рд┐рд▓реЛ рдпреЛрдЧрджрд╛рди(contribution) рдЧрд░реНрдиреЗ рддрд░рд┐рдХрд╛рд▓рд╛рдИ рд╕рд░рд▓ рдмрдирд╛рдЙрдиреЗ рд╣реЛред рдпрд╛рдж рдЧрд░реНрдиреБрд╣реЛрд╕реН рдХрд┐ рддрдкрд╛рдИ рдЬрддрд┐ рдзреЗрд░реИ рдЖрд░рд╛рдо рдЧрд░реНрдиреБрд╣реБрдиреНрдЫ рддрдкрд╛рдИрд▓реЗ рд░рд╛рдореНрд░реЛрд╕рдБрдЧ рд╕рд┐рдХреНрдиреБ рд╣реБрдиреНрдЫред рдпрджрд┐ рддрдкрд╛рдИрдВ рдЖрдлреНрдиреЛ рдкрд╣рд┐рд▓реЛ рдпреЛрдЧрджрд╛рди(contribution) рдЧрд░реНрди рдЦреЛрдЬреНрджреИ рд╣реБрдиреБрд╣реБрдиреНрдЫ рднрдиреЗ рддрд▓рдХрд╛ рд╕рд░рд▓ рдЪрд░рдгрд╣рд░реВ рдкрд╛рд▓рдирд╛ рдЧрд░реНрдиреБрд╣реЛрд╕реНред
|
|
|
|
We promise you, it will be fun.
|
|
|
|
рдпрджрд┐ рддрдкрд╛рдЗрдБрд╕рдБрдЧ рддрдкрд╛рдЗрдБрдХреЛ рдХрдореНрдкреНрдпреБрдЯрд░рдорд╛ GitHub Desktop рдЫреИрди рднрдиреЗ, [рдпрд╣рд╛рдБ рдмрд╛рдЯ install рдЧрд░реНрдиреБрд╣реЛрд╕реН ](https://desktop.github.com/).
|
|
|
|
рдпрджрд┐ рддрдкрд╛рдЗрдБ 1.0 рднрдиреНрджрд╛ рдкрд╣рд┐рд▓реЗ GitHub desktop рдХреЛ рд╕рдВрд╕реНрдХрд░рдг(version) рдкреНрд░рдпреЛрдЧ рдЧрд░реНрджреИ рд╣реБрдиреБрд╣реБрдиреНрдЫ рднрдиреЗ, [рдпреЛ tutorial рд╣реЗрд░реНрдиреБрд╣реЛрд╕реН](github-desktop-old-version-tutorial.md).
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt="fork this repository" />
|
|
|
|
## Repository рд▓рд╛рдИ Fork рдЧрд░реНрдиреБрд╣реЛрд╕реН
|
|
|
|
рдпрд╕ repository page рдХреЛ Top рдорд╛ рд░рд╣реЗрдХреЛ `Fork` рдмрдЯрдирдорд╛ рдХреНрд▓рд┐рдХ рдЧрд░реЗрд░ рдпреЛ repository рд▓рд╛рдИ Fork рдЧрд░реНрдиреБрд╣реЛрд╕ред рдпрд╕рд▓реЗ рддрдкрд╛рдИрдВрдХреЛ GitHub account рдорд╛ рдпрд╕ repository рдкреНрд░рддрд┐рд▓рд┐рдкрд┐ (copy) рдмрдирд╛рдЙрджрдЫ ред
|
|
|
|
## Repository рд▓рд╛рдИ Clone рдЧрд░реНрдиреБрд╣реЛрд╕реН
|
|
|
|
рдЕрдм Fork рдЧрд░реЗрдХреЛ repository рд▓рд╛рдИ рдЖрдлреНрдиреЛ рдХрдореНрдкреНрдпреБрдЯрд░рдорд╛ Clone рдЧрд░реНрдиреБрд╣реЛрд╕реНред
|
|
|
|
IMPORTANT: ORIGINAL REPO рд▓рд╛рдИ clone рдирдЧрд░реНрдиреБрд╣реЛрд▓рд╛ред рдЖрдлреНрдиреЛ fork рдЧрд░реЗрдХреЛ REPO рдорд╛ рдЧрдПрд░ clone рдЧрд░реНрдиреБрд╣реЛрд▓рд╛ред
|
|
|
|
repo рд▓рд╛рдИ clone рдЧрд░реНрди, "Clone or Download" рдорд╛ рдХреНрд▓рд┐рдХ рдЧрд░реНрдиреБрд╣реЛрд╕реН рд░ рддреНрдпрд╕рдкрдЫрд┐ "Open in Desktop" рдорд╛ рдХреНрд▓рд┐рдХ рдЧрд░реНрдиреБрд╣реЛрд╕реНред
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-clonetodesktop.png" alt="clone this repository" />
|
|
|
|
рдПрдЙрдЯрд╛ pop up window рдЦреБрд▓реНрдЫ рддреНрдпрд╕рдорд╛ "Open GitHubDesktop.exe" рдорд╛ рдХреНрд▓рд┐рдХ рдЧрд░реНрдиреБрд╣реЛрд╕реНред
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-open-githubdesktop.png" alt="clone this repository" />
|
|
|
|
"Open GitHubDesktop.exe" рдорд╛ рдХреНрд▓рд┐рдХ рдЧрд░реЗрдкрдЫрд┐ repo рдХреЛ content рд╣рд░реБ рдХрдореНрдкреНрдпреБрдЯрд░рдорд╛ download рд╣реБрдиреНрдЫред
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-downloaded.png" alt="clone this repository" />
|
|
|
|
рдЕрдм repo рдХреЛ content рдХрдореНрдкреНрдпреБрдЯрд░рдорд╛ copy рдЧрд░реЗрдкрдЫрд┐ `first-contributions` рдирд╛рдордХреЛ _repository_ GitHubDesktop рдорд╛ рджреЗрдЦрд┐рдиреНрдЫред
|
|
|
|
## Repository рдорд╛ рдПрдЙрдЯрд╛ branch рдмрдирд╛рдЙрдиреБрд╣реЛрд╕реН
|
|
|
|
рдЕрдм рдорд╛рдерд┐рдХреЛ "Current branch" рдЖрдЗрдХрдирдорд╛ рдХреНрд▓рд┐рдХ рдЧрд░реЗрд░ рд╢рд╛рдЦрд╛(branch) рдмрдирд╛рдЙрдиреБрд╣реЛрд╕реН рд░ рддреНрдпрд╕рдкрдЫрд┐ "New branch" рдорд╛ рдХреНрд▓рд┐рдХ рдЧрд░реНрдиреБрд╣реЛрд╕реН:
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch.png" alt="make a branch" />
|
|
|
|
рдЕрдм branch рдХреЛ рдирд╛рдо рджрд┐рдиреБрд╣реЛрд╕реН <add-your-name>. For example, "add-ram-regmi"
|
|
(рдмреНрд░рд╛рдиреНрдЪрдХреЛ рдирд╛рдордорд╛ add рд╢рдмреНрджрдХреЛ рдЖрд╡рд╢реНрдпрдХрддрд╛ рдЫреИрди, рддрд░ рдпрд╕рдорд╛ add рд╕рдорд╛рд╡реЗрд╢ рдЧрд░реНрди рдЙрдЪрд┐рдд рдЫ рдХрд┐рдирднрдиреЗ рдпрд╕ branch рдХреЛ рдЙрджреНрджреЗрд╢реНрдп рддрдкрд╛рдИрдВрдХреЛ рдирд╛рдорд▓рд╛рдИ contributors рдХреЛ рд╕реВрдЪреА(list)рдорд╛ рдердкреНрдиреЗ рд╣реЛред)
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch-name.png" alt="name your branch" />
|
|
|
|
`Create branch`рдорд╛ рдХреНрд▓рд┐рдХ рдЧрд░реНрдиреБрд╣реЛрд╕реНред
|
|
|
|
## рдЖрд╡рд╢реНрдпрдХ рдкрд░рд┐рд╡рд░реНрддрдирд╣рд░реВ рдЧрд░реНрдиреБрд╣реЛрд╕реН рд░ рддреА рдкрд░рд┐рд╡рд░реНрддрдирд╣рд░реВрд▓рд╛рдИ commit рдЧрд░реНрдиреБрд╣реЛрд╕реН
|
|
|
|
рдЕрдм, history tab рдорд╛ рдЬрд╛рдиреБрд╣реЛрд╕реН рд░ right click рдЧрд░реЗрд░ рдкрд╛рда рд╕рдореНрдкрд╛рджрдХ(text editor)рдорд╛ `Contributors.md` рдлрд╛рдЗрд▓ рдЦреЛрд▓реНрдиреБрд╣реЛрд╕реНред рдкреГрд╖реНрдардХреЛ рддрд▓ рд╕реНрдХреНрд░реЛрд▓ (Scroll) рдЧрд░реНрдиреБрд╣реЛрд╕реН рд░ рдпрд╕рдорд╛ рдЖрдлреНрдиреЛ рдирд╛рдо рдердкреНрдиреБрд╣реЛрд╕реН, рддреНрдпрд╕рдкрдЫрд┐ рдлрд╛рдЗрд▓ save рдЧрд░реНрдиреБрд╣реЛрд╕реНред
|
|
|
|
рдЙрджрд╛рд╣рд░рдг: рдпрджрд┐ рддрдкрд╛рдИрдВрдХреЛ рдирд╛рдо Ram Regmi рд╣реЛ рд░ github рдХреЛ username regmiram рд╣реЛ рднрдиреЗ, рдердкреЗрдХреЛ рдирд╛рдо рдпрд╕реНрддреЛ рджреЗрдЦрд┐рдиреБ рдкрд░реНрдЫред
|
|
|
|
\[Ram Regmi](https://github.com/regmiram)
|
|
|
|
рддрдкрд╛рдИрдВрд▓реЗ Contributors.md рдорд╛ рдкрд░рд┐рд╡рд░реНрддрдирд╣рд░реВ рднрдПрдХреЛ рджреЗрдЦреНрди рд╕рдХреНрдиреБрд╣реБрдиреНрдЫ рд░ рддрд┐рдиреАрд╣рд░реВ Github Desktop рдорд╛ рдердкрд┐рдПрдХрд╛ рдЫрдиреНред
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-status.png" alt="check status" />
|
|
|
|
рдЕрдм рддреА рдкрд░рд┐рд╡рд░реНрддрдирд╣рд░реВ рдкреНрд░рддрд┐рдмрджреНрдз(commit) рдЧрд░реНрдиреБрд╣реЛрд╕реН:
|
|
|
|
_summary_ рдлрд┐рд▓реНрдбрдорд╛ "Add `<your-name>` to Contributors list" рд╕рдиреНрджреЗрд╢(commit message) рд▓реЗрдЦреНрдиреБрд╣реЛрд╕реНред
|
|
|
|
`<your-name>` рд▓рд╛рдИ рдЖрдлреНрдиреЛ рдирд╛рдорд▓реЗ рдмрджрд▓реНрдиреБрд╣реЛрд╕реНред
|
|
|
|
`Commit to add-your-name` рднрдиреНрдиреЗ рдмрдЯрдирдорд╛ рдХреНрд▓рд┐рдХ рдЧрд░реНрдиреБрд╣реЛрд╕реНред
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit1.png" alt="commit your changes" />
|
|
|
|
рддрд▓, рддрдкрд╛рдЗрдБ the commit has been created рднрдиреЗрд░ рджреЗрдЦреНрди рд╕рдХреНрдиреБрд╣реБрдиреНрдЫред
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit2.png" alt="commit your changes" />
|
|
|
|
## GitHub рдорд╛ рдкрд░рд┐рд╡рд░реНрддрдирд╣рд░реБрд▓рд╛рдИ push рдЧрд░реНрдиреБрд╣реЛрд╕ред
|
|
|
|
File->Options рдорд╛ рдХреНрд▓рд┐рдХ рдЧрд░реНрдиреБрд╣реЛрд╕реН рд░ рддрдкрд╛рдИрдВрдХреЛ Github username рд░ password рдЯрд╛рдЗрдк рдЧрд░рд┐ Github.com рдорд╛ рд╕рд╛рдЗрди рдЗрди рдЧрд░реНрдиреБрд╣реЛрд╕реНредред
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-sign-in.png" alt="log-in to Github" />
|
|
|
|
top right рднрдПрдХреЛ `Publish` button рдорд╛ рдХреНрд▓рд┐рдХ рдЧрд░реНрдиреБрд╣реЛрд╕реНред
|
|
|
|
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-publish1.png" alt="push your changes" />
|
|
|
|
## Review рдХреЛ рд▓рд╛рдЧрд┐ рддрдкрд╛рдИрдВрдХреЛ рдкрд░рд┐рд╡рд░реНрддрдирд╣рд░реВ рдкреЗрд╢ рдЧрд░реНрдиреБрд╣реЛрд╕реНред
|
|
|
|
рдпрджрд┐ рддрдкрд╛рдИрдВ рдЖрдлреНрдиреЛ рдЧрд┐рдЯрд╣рдм рд░рд┐рдкреЛрдЬрд┐рдЯреЛрд░реА ( GitHub Repository) рдорд╛ рдЬрд╛рдиреБрд╣реБрдиреНрдЫ рднрдиреЗ, рддрдкрд╛рдЗрдБрд▓реЗ `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 branch рдорд╛ рддрдкрд╛рдИрдХрд╛ рд╕рдмреИ рдкрд░рд┐рд╡рд░реНрддрдирд╣рд░реВ Merge рдЧрд░реНрдиреЗрдЫреБред рдкрд░рд┐рд╡рд░реНрддрдирд╣рд░реВ merge рднрдПрдкрдЫрд┐ рд╣рдЬреБрд░рд▓реЗ рдПрдХ notification рдЗрдореЗрд▓(email) рдкреНрд░рд╛рдкреНрдд рдЧрд░реНрдиреБрд╣реБрдиреЗрдЫред
|
|
|
|
## рдпрд╣рд╛рдБрдмрд╛рдЯ рдХрд╣рд╛рдБ рдЬрд╛рдиреЗ?
|
|
|
|
рдмрдзрд╛рдИ рдЫ! рддрдкрд╛рдИрд▓реЗ Fork -> Clone -> Edit -> Pull Request рдХрд╛рд░реНрдпрдкреНрд░рд╡рд╛рд╣(workflow) рдкреВрд░рд╛ рдЧрд░реНрдиреБрднрдпреЛ, рдЬреБрди рддрдкрд╛рдИ рдкреНрд░рд╛рдп: рдПрдХ рдпреЛрдЧрджрд╛рдирдХрд░реНрддрд╛(contributor)рдХреЛ рд░реВрдкрдорд╛ рдЧрд░реНрдиреБрд╣реБрдиреЗрдЫ!
|
|
|
|
рддрдкрд╛рдИрдВрд▓реЗ рдпреЛрдЧрджрд╛рди(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).
|
|
|
|
рдЕрдм рддрдкрд╛рдИрд▓реЗ рдЕрдиреНрдп рдкреНрд░реЛрдЬреЗрдХреНрдЯрд╣рд░реВрдорд╛ рдпреЛрдЧрджрд╛рди рджрд┐рди рд╕реБрд░реБ рдЧрд░реНрдиреБрд╣реЛрд╕реНред рд╣рд╛рдореАрд▓реЗ рддрдкрд╛рдИрдВрд▓реЗ рдЧрд░реНрди рд╕рдХреНрдиреБрд╣реБрдиреЗ рд╕рдЬрд┐рд▓реЛ рд╕рдорд╕реНрдпрд╛рд╣рд░реВ(issues)рдХреЛ рд╕рд╛рдердорд╛ рдкреНрд░реЛрдЬреЗрдХреНрдЯрд╣рд░реВрдХреЛ рд╕реВрдЪреА рд╕рдВрдХрд▓рди рдЧрд░реЗрдХрд╛ рдЫреМ рд╣реЗрд░реНрдиреБрд╣реЛрд╕реН ред. [list of projects in the web app](https://firstcontributions.github.io/#project-list)ред
|
|
|
|
### [рдердк рд╕рд╛рдордЧреНрд░реА](../additional-material/git_workflow_scenarios/additional-material.md)
|
|
|
|
## рдЕрдиреНрдп рдЙрдкрдХрд░рдгрд╣рд░реВ рдкреНрд░рдпреЛрдЧ рдЧрд░реНрдиреЗ tutorial рд╣рд░реБ
|
|
|
|
[Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
|