mirror of
https://github.com/Sosokker/first-contributions.git
synced 2025-12-19 13:14:05 +01:00
130 lines
9.4 KiB
Markdown
130 lines
9.4 KiB
Markdown
[](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)
|
|
|
|
|
|
# ⎎⟟⍀⌇⏁ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏⌇
|
|
|
|
⏁⊑⟟⌇ ⌿⍀⍜⟊⟒☊⏁ ⏃⟟⋔⌇ ⏁⍜ ⌇⟟⋔⌿⌰⟟⎎⊬ ⏃⋏⎅ ☌⎍⟟⎅⟒ ⏁⊑⟒ ⍙⏃⊬ ⏚⟒☌⟟⋏⋏⟒⍀⌇ ⋔⏃☍⟒ ⏁⊑⟒⟟⍀ ⎎⟟⍀⌇⏁ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏. ⟟⎎ ⊬⍜⎍ ⏃⍀⟒ ⌰⍜⍜☍⟟⋏☌ ⏁⍜ ⋔⏃☍⟒ ⊬⍜⎍⍀ ⎎⟟⍀⌇⏁ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏, ⎎⍜⌰⌰⍜⍙ ⏁⊑⟒ ⌇⏁⟒⌿⌇ ⏚⟒⌰⍜⍙.
|
|
|
|
_⟟⎎ ⊬⍜⎍'⍀⟒ ⋏⍜⏁ ☊⍜⋔⎎⍜⍀⏁⏃⏚⌰⟒ ⍙⟟⏁⊑ ☊⍜⋔⋔⏃⋏⎅ ⌰⟟⋏⟒, [⊑⟒⍀⟒ ⏃⍀⟒ ⏁⎍⏁⍜⍀⟟⏃⌰⌇ ⎍⌇⟟⋏☌ ☌⎍⟟ ⏁⍜⍜⌰⌇.](#tutorials-using-other-tools)_
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />
|
|
|
|
#### ⟟⎎ ⊬⍜⎍ ⎅⍜⋏'⏁ ⊑⏃⎐⟒ ☌⟟⏁ ⍜⋏ ⊬⍜⎍⍀ ⋔⏃☊⊑⟟⋏⟒, [⟟⋏⌇⏁⏃⌰⌰ ⟟⏁](https://help.github.com/articles/set-up-git/).
|
|
|
|
## ⎎⍜⍀☍ ⏁⊑⟟⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬
|
|
|
|
⎎⍜⍀☍ ⏁⊑⟟⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⏚⊬ ☊⌰⟟☊☍⟟⋏☌ ⍜⋏ ⏁⊑⟒ `fork` ⏚⎍⏁⏁⍜⋏ ⍜⋏ ⏁⊑⟒ ⏁⍜⌿ ⍜⎎ ⏁⊑⟟⌇ ⌿⏃☌⟒.
|
|
⏁⊑⟟⌇ ⍙⟟⌰⌰ ☊⍀⟒⏃⏁⟒ ⏃ ☊⍜⌿⊬ ⍜⎎ ⏁⊑⟟⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⟟⋏ ⊬⍜⎍⍀ ⏃☊☊⍜⎍⋏⏁.
|
|
|
|
## ☊⌰⍜⋏⟒ ⏁⊑⟒ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />
|
|
|
|
⋏⍜⍙ ☊⌰⍜⋏⟒ ⏁⊑⟒ ⎎⍜⍀☍⟒⎅ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⏁⍜ ⊬⍜⎍⍀ ⋔⏃☊⊑⟟⋏⟒. ☌⍜ ⏁⍜ ⊬⍜⎍⍀ ☌⟟⏁⊑⎍⏚ ⏃☊☊⍜⎍⋏⏁, ⍜⌿⟒⋏ ⏁⊑⟒ ⎎⍜⍀☍⟒⎅ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬, ☊⌰⟟☊☍ ⍜⋏ ⏁⊑⟒ ☊⍜⎅⟒ ⏚⎍⏁⏁⍜⋏ ⏃⋏⎅ ⏁⊑⟒⋏ ☊⌰⟟☊☍ ⏁⊑⟒ _copy to clipboard_ ⟟☊⍜⋏.
|
|
|
|
⍜⌿⟒⋏ ⏃ ⏁⟒⍀⋔⟟⋏⏃⌰ ⏃⋏⎅ ⍀⎍⋏ ⏁⊑⟒ ⎎⍜⌰⌰⍜⍙⟟⋏☌ `git` ☊⍜⋔⋔⏃⋏⎅:
|
|
|
|
```
|
|
git clone "url you just copied"
|
|
```
|
|
|
|
⍙⊑⟒⍀⟒ "url you just copied" (⍙⟟⏁⊑⍜⎍⏁ ⏁⊑⟒ ⍾⎍⍜⏁⏃⏁⟟⍜⋏ ⋔⏃⍀☍⌇) ⟟⌇ ⏁⊑⟒ ⎍⍀⌰ ⏁⍜ ⏁⊑⟟⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ (⊬⍜⎍⍀ ⎎⍜⍀☍ ⍜⎎ ⏁⊑⟟⌇ ⌿⍀⍜⟊⟒☊⏁). ⌇⟒⟒ ⏁⊑⟒ ⌿⍀⟒⎐⟟⍜⎍⌇ ⌇⏁⟒⌿⌇ ⏁⍜ ⍜⏚⏁⏃⟟⋏ ⏁⊑⟒ ⎍⍀⌰.
|
|
|
|
<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/this-is-you/first-contributions.git
|
|
```
|
|
|
|
⍙⊑⟒⍀⟒ `this-is-you` ⟟⌇ ⊬⍜⎍⍀ GitHub ⎍⌇⟒⍀⋏⏃⋔⟒. ⊑⟒⍀⟒ ⊬⍜⎍'⍀⟒ ☊⍜⌿⊬⟟⋏☌ ⏁⊑⟒ ☊⍜⋏⏁⟒⋏⏁⌇ ⍜⎎ ⏁⊑⟒ ⎎⟟⍀⌇⏁-☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⍜⋏ GitHub ⏁⍜ ⊬⍜⎍⍀ ☊⍜⋔⌿⎍⏁⟒⍀.
|
|
|
|
## ☊⍀⟒⏃⏁⟒ ⏃ ⏚⍀⏃⋏☊⊑
|
|
|
|
☊⊑⏃⋏☌⟒ ⏁⍜ ⏁⊑⟒ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⎅⟟⍀⟒☊⏁⍜⍀⊬ ⍜⋏ ⊬⍜⎍⍀ ☊⍜⋔⌿⎍⏁⟒⍀ (⟟⎎ ⊬⍜⎍ ⏃⍀⟒ ⋏⍜⏁ ⏃⌰⍀⟒⏃⎅⊬ ⏁⊑⟒⍀⟒):
|
|
|
|
```
|
|
cd first-contributions
|
|
```
|
|
|
|
⋏⍜⍙ ☊⍀⟒⏃⏁⟒ ⏃ ⏚⍀⏃⋏☊⊑ ⎍⌇⟟⋏☌ ⏁⊑⟒ `git checkout` ☊⍜⋔⋔⏃⋏⎅:
|
|
|
|
```
|
|
git checkout -b your-new-branch-name
|
|
```
|
|
|
|
⎎⍜⍀ ⟒⌖⏃⋔⌿⌰⟒:
|
|
|
|
```
|
|
git checkout -b add-alonzo-church
|
|
```
|
|
|
|
## ⋔⏃☍⟒ ⋏⟒☊⟒⌇⌇⏃⍀⊬ ☊⊑⏃⋏☌⟒⌇ ⏃⋏⎅ ☊⍜⋔⋔⟟⏁ ⏁⊑⍜⌇⟒ ☊⊑⏃⋏☌⟒⌇
|
|
|
|
⋏⍜⍙ ⍜⌿⟒⋏ `Contributors.md` ⎎⟟⌰⟒ ⟟⋏ ⏃ ⏁⟒⌖⏁ ⟒⎅⟟⏁⍜⍀, ⏃⎅⎅ ⊬⍜⎍⍀ ⋏⏃⋔⟒ ⏁⍜ ⟟⏁. ⎅⍜⋏'⏁ ⏃⎅⎅ ⟟⏁ ⏃⏁ ⏁⊑⟒ ⏚⟒☌⟟⋏⋏⟟⋏☌ ⍜⍀ ⟒⋏⎅ ⍜⎎ ⏁⊑⟒ ⎎⟟⌰⟒. ⌿⎍⏁ ⟟⏁ ⏃⋏⊬⍙⊑⟒⍀⟒ ⟟⋏ ⏚⟒⏁⍙⟒⟒⋏. ⋏⍜⍙, ⌇⏃⎐⟒ ⏁⊑⟒ ⎎⟟⌰⟒.
|
|
|
|
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />
|
|
|
|
⟟⎎ ⊬⍜⎍ ☌⍜ ⏁⍜ ⏁⊑⟒ ⌿⍀⍜⟊⟒☊⏁ ⎅⟟⍀⟒☊⏁⍜⍀⊬ ⏃⋏⎅ ⟒⌖⟒☊⎍⏁⟒ ⏁⊑⟒ ☊⍜⋔⋔⏃⋏⎅ `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 <add-your-branch-name>
|
|
```
|
|
|
|
⍀⟒⌿⌰⏃☊⟟⋏☌ `<add-your-branch-name>` ⍙⟟⏁⊑ ⏁⊑⟒ ⋏⏃⋔⟒ ⍜⎎ ⏁⊑⟒ ⏚⍀⏃⋏☊⊑ ⊬⍜⎍ ☊⍀⟒⏃⏁⟒⎅ ⟒⏃⍀⌰⟟⟒⍀.
|
|
|
|
<details>
|
|
<summary> <strong>⟟⎎ ⊬⍜⎍ ☌⟒⏁ ⏃⋏⊬ ⟒⍀⍀⍜⍀⌇ ⍙⊑⟟⌰⟒ ⌿⎍⌇⊑⟟⋏☌, ☊⌰⟟☊☍ ⊑⟒⍀⟒:</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>
|
|
☌⍜ ⏁⍜ [GitHub's ⏁⎍⏁⍜⍀⟟⏃⌰](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ⍜⋏ ☌⟒⋏⟒⍀⏃⏁⟟⋏☌ ⏃⋏⎅ ☊⍜⋏⎎⟟☌⎍⍀⟟⋏☌ ⏃⋏ ⌇⌇⊑ ☍⟒⊬ ⏁⍜ ⊬⍜⎍⍀ ⏃☊☊⍜⎍⋏⏁.
|
|
|
|
</details>
|
|
|
|
## ⌇⎍⏚⋔⟟⏁ ⊬⍜⎍⍀ ☊⊑⏃⋏☌⟒⌇ ⎎⍜⍀ ⍀⟒⎐⟟⟒⍙
|
|
|
|
⟟⎎ ⊬⍜⎍ ☌⍜ ⏁⍜ ⊬⍜⎍⍀ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⍜⋏ ☌⟟⏁⊑⎍⏚, ⊬⍜⎍'⌰⌰ ⌇⟒⟒ ⏃ `Compare & pull request` ⏚⎍⏁⏁⍜⋏. ☊⌰⟟☊☍ ⍜⋏ ⏁⊑⏃⏁ ⏚⎍⏁⏁⍜⋏.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
|
|
|
⋏⍜⍙ ⌇⎍⏚⋔⟟⏁ ⏁⊑⟒ `pull request`.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />
|
|
|
|
⌇⍜⍜⋏ ⟟'⌰⌰ ⏚⟒ ⋔⟒⍀☌⟟⋏☌ ⏃⌰⌰ ⊬⍜⎍⍀ ☊⊑⏃⋏☌⟒⌇ ⟟⋏⏁⍜ ⏁⊑⟒ ⋔⏃⌇⏁⟒⍀ ⏚⍀⏃⋏☊⊑ ⍜⎎ ⏁⊑⟟⌇ ⌿⍀⍜⟊⟒☊⏁. ⊬⍜⎍ ⍙⟟⌰⌰ ☌⟒⏁ ⏃ ⋏⍜⏁⟟⎎⟟☊⏃⏁⟟⍜⋏ ⟒⋔⏃⟟⌰ ⍜⋏☊⟒ ⏁⊑⟒ ☊⊑⏃⋏☌⟒⌇ ⊑⏃⎐⟒ ⏚⟒⟒⋏ ⋔⟒⍀☌⟒⎅.
|
|
|
|
## ⍙⊑⟒⍀⟒ ⏁⍜ ☌⍜ ⎎⍀⍜⋔ ⊑⟒⍀⟒?
|
|
|
|
☊⍜⋏☌⍀⏃⏁⌇! ⊬⍜⎍ ⟊⎍⌇⏁ ☊⍜⋔⌿⌰⟒⏁⟒⎅ ⏁⊑⟒ ⌇⏁⏃⋏⎅⏃⍀⎅ _fork -> clone -> edit -> pull request_ ⍙⍜⍀☍⎎⌰⍜⍙ ⏁⊑⏃⏁ ⊬⍜⎍'⌰⌰ ⟒⋏☊⍜⎍⋏⏁⟒⍀ ⍜⎎⏁⟒⋏ ⏃⌇ ⏃ ☊⍜⋏⏁⍀⟟⏚⎍⏁⍜⍀!
|
|
|
|
☊⟒⌰⟒⏚⍀⏃⏁⟒ ⊬⍜⎍⍀ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏ ⏃⋏⎅ ⌇⊑⏃⍀⟒ ⟟⏁ ⍙⟟⏁⊑ ⊬⍜⎍⍀ ⎎⍀⟟⟒⋏⎅⌇ ⏃⋏⎅ ⎎⍜⌰⌰⍜⍙⟒⍀⌇ ⏚⊬ ☌⍜⟟⋏☌ ⏁⍜ [⍙⟒⏚ ⏃⌿⌿](https://firstcontributions.github.io/#social-share).
|
|
|
|
⊬⍜⎍ ☊⍜⎍⌰⎅ ⟊⍜⟟⋏ ⍜⎍⍀ slack ⏁⟒⏃⋔ ⟟⋏ ☊⏃⌇⟒ ⊬⍜⎍ ⋏⟒⟒⎅ ⏃⋏⊬ ⊑⟒⌰⌿ ⍜⍀ ⊑⏃⎐⟒ ⏃⋏⊬ ⍾⎍⟒⌇⏁⟟⍜⋏⌇. [⟊⍜⟟⋏ slack ⏁⟒⏃⋔](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
|
|
|
|
⋏⍜⍙ ⌰⟒⏁'⌇ ☌⟒⏁ ⊬⍜⎍ ⌇⏁⏃⍀⏁⟒⎅ ⍙⟟⏁⊑ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⋏☌ ⏁⍜ ⍜⏁⊑⟒⍀ ⌿⍀⍜⟊⟒☊⏁⌇. ⍙⟒'⎐⟒ ☊⍜⋔⌿⟟⌰⟒⎅ ⏃ ⌰⟟⌇⏁ ⍜⎎ ⌿⍀⍜⟊⟒☊⏁⌇ ⍙⟟⏁⊑ ⟒⏃⌇⊬ ⟟⌇⌇⎍⟒⌇ ⊬⍜⎍ ☊⏃⋏ ☌⟒⏁ ⌇⏁⏃⍀⏁⟒⎅ ⍜⋏. ☊⊑⟒☊☍ ⍜⎍⏁ [⏁⊑⟒ ⌰⟟⌇⏁ ⍜⎎ ⌿⍀⍜⟊⟒☊⏁⌇ ⟟⋏ ⏁⊑⟒ ⍙⟒⏚ ⏃⌿⌿](https://firstcontributions.github.io/#project-list).
|