Repository: firstcontributions/first-contributions Branch: main Commit: 0d392cdbef6b Files: 412 Total size: 2.3 MB Directory structure: gitextract_kg8z99bl/ ├── .github/ │ ├── CODE_OF_CONDUCT.md │ ├── CONTRIBUTING.md │ ├── FUNDING.yml │ ├── ISSUE_TEMPLATE/ │ │ └── issue-template.md │ ├── ISSUE_TEMPLATE.md │ ├── PULL_REQUEST_TEMPLATE.md │ ├── SECURITY.md │ ├── funding.json │ └── workflows/ │ └── auto-pr-merge.yml ├── .gitignore ├── Contributors.md ├── LICENSE ├── README.md └── docs/ ├── additional-material/ │ ├── Things a Non programmer can do.tam.md │ ├── Things a non Programmer can do.ar.md │ ├── Things a non Programmer can do.ja.md │ ├── Things a non Programmer can do.md │ ├── git_workflow_scenarios/ │ │ ├── Useful-links-for-further-learning.md │ │ ├── additional-material.md │ │ ├── amending-a-commit.md │ │ ├── check-commit-log.md │ │ ├── configuring-git.md │ │ ├── creating-a-gitignore-file.md │ │ ├── delete-branch-locally.md │ │ ├── gitflow.md │ │ ├── installing-git-arch.md │ │ ├── installing-git-ubuntu.md │ │ ├── keeping-your-fork-synced-with-this-repository.md │ │ ├── moving-a-commit-to-a-different-branch.md │ │ ├── rebase-vs-merge.md │ │ ├── removing-a-file.md │ │ ├── removing-branch-from-your-repository.md │ │ ├── resetting-a-branch.md │ │ ├── resetting-a-commit.md │ │ ├── resolving-merge-conflicts.md │ │ ├── reverting-a-commit.md │ │ ├── squashing-commits.md │ │ ├── stashing-a-file.md │ │ ├── storing-credentials.md │ │ ├── undoing-a-commit.md │ │ └── why-using-branches.md │ └── translations/ │ ├── Belarusian/ │ │ ├── Useful-links-for-further-learning.by.md │ │ ├── additional-material.by.md │ │ ├── amending-a-commit.by.md │ │ ├── configuring-git.by.md │ │ ├── keeping-your-fork-synced-with-this-repository.by.md │ │ ├── moving-a-commit-to-a-different-branch.by.md │ │ ├── removing-a-file.by.md │ │ ├── removing-branch-from-your-repository.by.md │ │ ├── resolving-merge-conflicts.by.md │ │ ├── reverting-a-commit.by.md │ │ ├── squashing-commits.by.md │ │ ├── stashing-a-file.by.md │ │ └── undoing-a-commit.by.md │ ├── Bengali/ │ │ ├── add-file.bn.md │ │ ├── additional-material.be.md │ │ ├── check-commit-log-bn.md │ │ ├── configuration-in-bn-github.md │ │ ├── creating-gitignore-file-bn.md │ │ ├── fix-git-permission-error-bn.md │ │ ├── gitflow-bn.md │ │ ├── merge-conflict.md │ │ └── things-a-non-programmer-can-do-bn.md │ ├── Chinese/ │ │ ├── Things a non Programmer can do.zh-cn.md │ │ ├── Useful-links-for-further-learning.zh-cn.md │ │ ├── additional-material.zh-cn.md │ │ ├── addtional-material.cht.md │ │ ├── amending-a-commit.zh-cn.md │ │ ├── check-commit-log.zh-cn.md │ │ ├── configuring-git.zh-cn.md │ │ ├── creating-a-gitignore-file.zh-cn.md │ │ ├── delete-branch-locally.zh-cn.md │ │ ├── gitflow.zh-cn.md │ │ ├── installing-git-arch.zh-cn.md │ │ ├── installing-git-ubuntu.zh-cn.md │ │ ├── keeping-your-fork-synced-with-this-repository.zh-cn.md │ │ ├── moving-a-commit-to-a-different-branch.zh-cn.md │ │ ├── removing-a-file.zh-cn.md │ │ ├── removing-branch-from-your-repository.zh-cn.md │ │ ├── resetting-a-branch.zh-cn.md │ │ ├── resetting-a-commit.zh-cn.md │ │ ├── resolving-merge-conflicts.zh-cn.md │ │ ├── reverting-a-commit.zh-cn.md │ │ ├── squashing-commits.zh-cn.md │ │ ├── stashing-a-file.zh-cn.md │ │ ├── storing-credentials.zh-cn.md │ │ ├── undoing-a-commit.zh-cn.md │ │ └── why-using-branches.zh-cn.md │ ├── Egyptian/ │ │ └── Things a non Programmer can do.eg.md │ ├── Farsi/ │ │ ├── amending-a-commit.fa.md │ │ ├── delete-branch-locally.fa.md │ │ └── moving-a-commit-to-a-different-branch.fa.md │ ├── French/ │ │ ├── Things a non Programmer can do.fr.md │ │ ├── additional-material.fr.md │ │ ├── amending-a-commit.fr.md │ │ └── check-commit-log.fr.md │ ├── Germany │ ├── Greek/ │ │ └── git_workflow_scenarios/ │ │ ├── additional-material.gr.md │ │ ├── amending-a-commit.gr.md │ │ ├── check-commit-log.gr.md │ │ ├── configuring-git.gr.md │ │ ├── creating-a-gitignore-file.gr.md │ │ ├── delete-branch-locally.gr.md │ │ └── gitflow.gr.md │ ├── Hindi/ │ │ ├── Amending a Commit │ │ ├── Things a non Programmer can do │ │ ├── Useful-links-for-further-learning.hi.md │ │ ├── add-file.hi.md │ │ ├── moving-a-commit-to-a-different-branch.hi.md │ │ ├── removing-a-file.hi.md │ │ ├── removing-branch-from-your-repository.hi.md │ │ ├── resetting-a-branch.hi.md │ │ └── resetting-a-commit.hi.md │ ├── Indonesian/ │ │ ├── Things a non Programmer can do.id.md │ │ ├── Useful-links-for-further-learning.id.md │ │ ├── additional-material.id.md │ │ ├── removing-a-file.id.md │ │ ├── removing-branch-from-your-repository.id.md │ │ └── resetting-a-commit.id.md │ ├── Italian/ │ │ ├── removing-a-file.it.md │ │ └── reverting-a-commit.it.md │ ├── Japanese/ │ │ └── Things a non Programmer can do.ja.md │ ├── Kannada/ │ │ ├── Things a non programmer can do.ka.md │ │ ├── additional-material.ka.md │ │ ├── amending-a-commit.ka.md │ │ ├── configuring-git.ka.md │ │ ├── how-to-contribute-open-source-projects-kannada.md │ │ ├── keeping-your-fork-synced-with-this-repo.ka.md │ │ ├── moving-a-commit-to-a-different-branch.ka.md │ │ ├── removing-a-file.ka.md │ │ └── removing-branch-from-your-repo.ka.md │ ├── Korean/ │ │ ├── Things a non Programmer can do.kr.md │ │ ├── additional-material.ko.md │ │ ├── amending-a-commit.ko.md │ │ ├── check-commit-log.ko.md │ │ ├── delete-branch-locally.ko.md │ │ ├── keeping-your-fork-synced-with-this-repository.ko.md │ │ ├── moving-a-commit-to-a-different-branch.ko.md │ │ ├── removing-branch-from-your-repository.ko.md │ │ ├── resolving-merge-conflicts.ko.md │ │ ├── reverting-a-commit.ko.md │ │ └── undoing-a-commit.ko.md │ ├── Malayalam/ │ │ └── Things-a-non-programmer-can-do.ml.md │ ├── Marathi/ │ │ ├── Removing-a-file.ma.md │ │ └── additional-material.ma.md │ ├── Nepali/ │ │ ├── additional-material.np.md │ │ ├── amending-a-commit.np.md │ │ └── configuring-git.np.md │ ├── Portugues/ │ │ ├── Things a non Programmer can do.pt-br.md │ │ ├── additional-material.pt_br.md │ │ ├── amending-a-commit.pt_br.md │ │ ├── confinguring-git.pt-br.md │ │ ├── keeping-your-fork-synced-with-this-repository.pt_br.md │ │ ├── moving-a-commit-to-a-different-branch.pt_br.md │ │ ├── removing-a-file.pt_br.md │ │ └── removing-branch-from-your-repository.pt_br.md │ ├── Romanian/ │ │ └── how-to-contribute-to-open-source-projects.ro.md │ ├── Russian/ │ │ ├── additional-material.ru.md │ │ ├── amending-a-commit.ru.md │ │ ├── configuring-git.ru.md │ │ ├── moving-a-commit-to-a-different-branch.ru.md │ │ └── removing-a-file.ru.md │ ├── Serbian/ │ │ ├── Cyrillic/ │ │ │ └── delete-branch-locally.sr-Cyrl.md │ │ └── Latin/ │ │ └── delete-branch-locally.sr-Latn.md │ ├── Sinhala/ │ │ ├── amending-a-commit.md │ │ └── removing-a-file.sin.md │ ├── Slovenian/ │ │ ├── additional-material.sl.md │ │ ├── amending-a-commit.sl.md │ │ ├── configuring-git.sl.md │ │ ├── keeping-your-fork-synced-with-this-repository.sl.md │ │ ├── moving-a-commit-to-a-different-branch.sl.md │ │ ├── removing-a-file.sl.md │ │ ├── removing-branch-from-your-repository.sl.md │ │ ├── resolving-merge-conflicts.sl.md │ │ ├── reverting-a-commit.sl.md │ │ ├── squashing-commits.sl.md │ │ ├── stashing-a-file.sl.md │ │ └── undoing-a-commit.sl.md │ ├── Spanish/ │ │ ├── Things a non Programmer can do.es.md │ │ ├── additional-material.es.md │ │ ├── additional-material.sp_mx.md │ │ ├── amending-a-commit.es.md │ │ ├── amending-a-commit.sp_mx.md │ │ ├── configuring-git.sp_mx.md │ │ ├── creating-a-gitignore-file.md │ │ └── delete-branch-locally.md │ ├── Tamil/ │ │ ├── Things a non Programmer can do.ta.md │ │ ├── additional-material.ta.md │ │ └── how-to-contribute-to-open-source-projects-tamil.md │ ├── Telugu/ │ │ ├── how-to-contribute-to-open-source-projects-telugu.md │ │ └── ప్రోగ్రామింగ్ తెలియని వ్యక్తి చేయగల పనులు.md │ ├── Thai/ │ │ └── Things a non Programmer can do.th.md │ ├── Things a non Programmer can do.ar.md │ ├── Turkish/ │ │ ├── Things a non Programmer can do.tr.md │ │ ├── Useful-links-for-further-learning.tr.md │ │ ├── additional-material.tr.md │ │ ├── amending-a-commit.tr.md │ │ ├── configuring-git.tr.md │ │ ├── keeping-your-fork-synced-with-this-repository.tr.md │ │ ├── moving-a-commit-to-a-different-branch.tr.md │ │ ├── removing-a-file.tr.md │ │ ├── removing-branch-from-your-repository.tr.md │ │ ├── resolving-merge-conflicts.tr.md │ │ ├── reverting-a-commit.tr.md │ │ ├── squashing-commits.tr.md │ │ ├── stashing-a-file.tr.md │ │ └── undoing-a-commit.tr.md │ ├── Twi/ │ │ ├── additional-matrial-twi.md │ │ └── amending-a-commit-twi.md │ ├── Ukrainian/ │ │ └── removing-a-file.ua.md │ ├── Urdu/ │ │ ├── additional-material.ur.md │ │ └── amending-a-commit.ur.md │ └── Vietnamese/ │ ├── moving-a-commit-to-a-different-branch.vi.md │ └── resolving-merge-conflicts.vi.md ├── cli-tool-tutorials/ │ ├── git-cli-tutorial-PL.md │ ├── git-cli-tutorial-bengali.md │ ├── git-cli-tutorial-kannada.md │ ├── github-cli-tutorial-Hindi.md │ ├── github-cli-tutorial-Urdu.md │ ├── github-cli-tutorial-german.md │ ├── github-cli-tutorial-gujarati.md │ ├── github-cli-tutorial-id.md │ ├── github-cli-tutorial-ko.md │ ├── github-cli-tutorial-malayalam.md │ ├── github-cli-tutorial-pt-br.md │ ├── github-cli-tutorial-sinhala.md │ ├── github-cli-tutorial-tamil.md │ ├── github-cli-tutorial.md │ ├── github-cli-tutorials-arabic.md │ ├── github-cli-tutorials-francais.md │ └── translations/ │ ├── Bengali/ │ │ ├── git-bash-windows-tutorial-bn.md │ │ └── git-cli-tutorial-bn.md │ ├── Chinese/ │ │ ├── git-bash-windows-tutorial.zh-cn.md │ │ └── github-cli-tutorial.zh-cn.md │ ├── Greek/ │ │ ├── git-bash-windows-tutorial.gr.md │ │ └── github-cli-tutorial.gr.md │ ├── Marathi/ │ │ └── github-cli-tutorial.marathi.md │ ├── Spanish/ │ │ ├── git-bash-windows-tutorial.es.md │ │ └── github-cli-tutorial.es.md │ ├── Ukrainian/ │ │ ├── git-bash-windows-tutorial.ua.md │ │ └── github-cli-tutorial.ua.md │ ├── github-cli-tutorial-malayalam.md │ ├── github-cli-tutorial-te.md │ └── github-cli-tutorial.hi.md ├── gui-tool-tutorials/ │ ├── github-desktop-old-version-tutorial.md │ ├── github-desktop-tutorial.md │ ├── github-windows-intellij-tutorial.md │ ├── github-windows-intellij-tutorial.zh-cn.md │ ├── github-windows-vs-code-tutorial.md │ ├── github-windows-vs2017-tutorial.md │ ├── gitkraken-tutorial.md │ ├── sourcetree-macos-tutorial.md │ ├── sublime-merge-tutorial.hi.md │ ├── sublime-merge-tutorial.md │ └── translations/ │ ├── Amharic/ │ │ └── github-desktop-tutorial.am.md │ ├── Bengali/ │ │ └── github-windows-vscode-tutorial-bn.md │ ├── Chinese/ │ │ ├── github-desktop-tutorial.zh-cn.md │ │ └── gitkraken-tutorial-zh-cn.md │ ├── German/ │ │ └── github-windows-vs-code-tutorial.de.md │ ├── Greek/ │ │ ├── github-desktop-old-version-tutorial.gr.md │ │ ├── github-desktop-tutorial.gr.md │ │ ├── github-windows-intellij-tutorial.gr.md │ │ ├── github-windows-vs-code-tutorial.gr.md │ │ ├── github-windows-vs2017-tutorial.gr.md │ │ ├── gitkraken-tutorial.gr.md │ │ ├── sourcetree-macos-tutorial.gr.md │ │ └── sublime-merge-tutorial.gr.md │ ├── Hebrew/ │ │ └── github-desktop-tutorial-heb.md │ ├── Hindi/ │ │ ├── github-windows-vs-code-tutorial-hi.md │ │ └── sublime-merge-tutorial.hi.md │ ├── Indonesian/ │ │ └── github-windows-vs-code-tutorial_id.md │ ├── Marathi/ │ │ └── github-windows-vs-code-tutorial-hi.md │ ├── Persian/ │ │ ├── github-desktop-tutorial.fa.md │ │ ├── gitkraken-tutorial-fa.md │ │ └── sublime-merge-tutorial-fa.md │ ├── Portuguese/ │ │ ├── github-desktop-tutorial.pt_br.md │ │ ├── github-windows-intellij-tutorial.pt_br.md │ │ ├── github-windows-vs-code-tutorial.pt_br.md │ │ ├── github-windows-vs-code-tutorial_pt_br.md │ │ ├── github-windows-vs2017-tutorial.pt_br.md │ │ └── gitkraken-tutorial.pt-br.md │ ├── Spanish/ │ │ └── gitkraken-tutorial-es.md │ ├── Tamil/ │ │ └── githiub-desktop-tutorial-tamil.md │ ├── Urdu/ │ │ └── github-desktop-urdu.md │ ├── Yoruba/ │ │ └── github-desktop-tutorial.ng_yo.md │ ├── github-desktop-tutorial-np.md │ ├── github-desktop-tutorial.cn.md │ ├── github-desktop-tutorial.ng_yr.md │ ├── github-desktop-tutorial.pt_br.md │ ├── github-desktop-tutorial.th.md │ ├── github-desktop-tutorial.vn.md │ ├── github-windows-intellij-tutorial.pt_br.md │ ├── github-windows-vs-code-tutorial-hi.md │ ├── github-windows-vs-code-tutorial.ml.md │ ├── github-windows-vs-code-tutorial.pt_br.md │ ├── github-windows-vs-code-tutorial_id.md │ ├── github-windows-vs-code-tutorial_pt_br.md │ ├── github-windows-vs2017-tutorial.pt_br.md │ ├── gitkraken-tutorial-es.md │ ├── gitkraken-tutorial-fr.md │ ├── gitkraken-tutorial.pt-br.md │ └── malayalam/ │ └── githiub-desktop-tutorial-ml.md ├── how-to-contribute-to-open-source-projects.md └── translations/ ├── README.afk.md ├── README.al.md ├── README.am.md ├── README.ar.md ├── README.arm.md ├── README.assamese.md ├── README.aze.md ├── README.bg.md ├── README.bih.md ├── README.bn.md ├── README.by.md ├── README.ca.md ├── README.col.md ├── README.cs.md ├── README.da.md ├── README.de.md ├── README.dz.md ├── README.ec.md ├── README.eg.md ├── README.en-pirate.md ├── README.eo.md ├── README.es.md ├── README.ewe.md ├── README.fa.md ├── README.fi.md ├── README.fil.md ├── README.fr.md ├── README.ga.md ├── README.ge.md ├── README.gh.md ├── README.gl.md ├── README.gr.md ├── README.guj.md ├── README.hau.md ├── README.hb.md ├── README.hi.md ├── README.hne.md ├── README.hr.md ├── README.hu.md ├── README.hy.md ├── README.id.md ├── README.igb.md ├── README.is.md ├── README.it.md ├── README.ja.md ├── README.jv.md ├── README.ka.md ├── README.kh.md ├── README.ko.md ├── README.kr.md ├── README.kws.md ├── README.ky.md ├── README.kz.md ├── README.la.md ├── README.ln.md ├── README.lt.md ├── README.lug.md ├── README.lv.md ├── README.ma.md ├── README.me.md ├── README.mg.md ├── README.mk.md ├── README.ml.md ├── README.mli.md ├── README.mm_unicode.md ├── README.mn.md ├── README.mr.md ├── README.mx.md ├── README.my.md ├── README.nl.md ├── README.no.md ├── README.np.md ├── README.od.md ├── README.pb.md ├── README.pcm.md ├── README.pl.md ├── README.ps.md ├── README.pt-ao.md ├── README.pt-pt.md ├── README.pt_br.md ├── README.ro.md ├── README.ru.md ├── README.se.md ├── README.si.md ├── README.sindhi.md ├── README.sk.md ├── README.sl.md ├── README.slk.md ├── README.so.md ├── README.sr-Cyrl.md ├── README.sr-Latn.md ├── README.sw.md ├── README.ta.md ├── README.te.md ├── README.th.md ├── README.tl.md ├── README.tm.md ├── README.tn.md ├── README.tr.md ├── README.ua.md ├── README.un-aln.md ├── README.ur.md ├── README.uz.md ├── README.vn.md ├── README.yor.md ├── README.zh-cn.md ├── README.zh-tw.md ├── README.zul.md └── Translations.md ================================================ FILE CONTENTS ================================================ ================================================ FILE: .github/CODE_OF_CONDUCT.md ================================================ # Contributor Covenant Code of Conduct ## Our Pledge We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation. We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community. ## Our Standards Examples of behavior that contributes to a positive environment for our community include: * Demonstrating empathy and kindness toward other people * Being respectful of differing opinions, viewpoints, and experiences * Giving and gracefully accepting constructive feedback * Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience * Focusing on what is best not just for us as individuals, but for the overall community Examples of unacceptable behavior include: * The use of sexualized language or imagery, and sexual attention or advances of any kind * Trolling, insulting or derogatory comments, and personal or political attacks * Public or private harassment * Publishing others' private information, such as a physical or email address, without their explicit permission * Other conduct which could reasonably be considered inappropriate in a professional setting ## Enforcement Responsibilities Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful. Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate. ## Scope This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. ## Enforcement Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at firstcontributions@gmail.com. All complaints will be reviewed and investigated promptly and fairly. All community leaders are obligated to respect the privacy and security of the reporter of any incident. ## Enforcement Guidelines Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct: ### 1. Correction **Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community. **Consequence**: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested. ### 2. Warning **Community Impact**: A violation through a single incident or series of actions. **Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban. ### 3. Temporary Ban **Community Impact**: A serious violation of community standards, including sustained inappropriate behavior. **Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban. ### 4. Permanent Ban **Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals. **Consequence**: A permanent ban from any sort of public interaction within the community. ## Attribution This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.1, available at [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1]. Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder][Mozilla CoC]. For answers to common questions about this code of conduct, see the FAQ at [https://www.contributor-covenant.org/faq][FAQ]. Translations are available at [https://www.contributor-covenant.org/translations][translations]. [homepage]: https://www.contributor-covenant.org [v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html [Mozilla CoC]: https://github.com/mozilla/diversity [FAQ]: https://www.contributor-covenant.org/faq [translations]: https://www.contributor-covenant.org/translations ================================================ FILE: .github/CONTRIBUTING.md ================================================ # Contribution guide We appreciate your thought to contribute to open source. :heart: If you'd like to suggest a change in the tutorials or the workflow, please [raise an issue](https://github.com/firstcontributions/first-contributions/issues/new). We can have a discussion to better understand the problem, get more people involved and make a collective decision. If you're making changes to a translation, please request a review from our previous contributors who has translated to the respective translation. Our goal is for all translations to have the same content as the English one (`Readme.md`) (Except for links to other translations. We realised that it doesn't add much value) ### Our reviewers :sparkles: | Language Name | Name in English | Reviewers| |---|---|---| | Afrikaans | [Afrikaans](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.afk.md) | [@zecollokaris](https://github.com/zecollokaris) | | Albanian | [Albanian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.al.md) | [RronKurtishi](https://github.com/RronKurtishi) [RronKurtishi](https://github.com/auronvila) | | العربية | [Arabic](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ar.md) | [OsaidAlhomedy](https://github.com/OsaidAlhomedy) [AlaaYlula](https://github.com/AlaaYlula) [Laith-Alayassa](https://github.com/Laith-Alayassa) | | Azerbaijani | [Azerbaijani](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.aze.md) | [@isakurbanov744](https://github.com/isakurbanov744) [@Ahm3tJ4f](https://github.com/Ahm3tJ4f) | | Bulgarian | [Bulgarian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.bg.md) | []() | | Bosnian | [Bosnian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.bih.md) | []() | | বাংলা | [Bengali](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.bn.md) | [@cse031sust02](https://github.com/cse031sust02) | | Belarusian | [Belarusian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.by.md) | []() | | Català | [Catalan](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ca.md) | [@Sergih28](https://github.com/Sergih28) | | čeština | [Czech](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.cs.md) | []() | | Danish | [Danish](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.da.md) | [@7013145](https://github.com/7013145) | | Deutsch | [German](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.de.md) | [@lkreimann](https://github.com/lkreimann) | | المصرية | [Egyptian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.eg.md) | [@MichaelKMalak](https://github.com/MichaelKMalak) | | English (Pirate) | [English (Pirate)](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.en-pirate.md) | [@lukeoliff](https://github.com/lukeoliff) | | Español | [Spanish](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.es.md) | [@yirini](https://github.com/yirini) [@aaossa](https://github.com/aaossa) | | فارسی | [Persian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.fa.md) | [@ThirdScript](https://github.com/ThirdScript) | | Finnish | [Finnish](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.fi.md) | []() | | Français | [French](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.fr.md) | [@LePetitRenard](https://github.com/LePetitRenard) | | ქართული | [Georgian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ka.md) | [@iko1133](https://github.com/iko1133) | | Galego | [Galician](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.gl.md) | [@siderio2](https://github.com/siderio2) | | Greek | [Greek](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.gr.md) | [@adreaskar](https://github.com/adreaskar) [@porfanid](https://github.com/porfanid) | | ગુજરાતી | [Gujarati](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.guj.md) | [@smitgajjar](https://github.com/smitgajjar) [@kaushalgosaliya5](https://github.com/kaushalgosaliya5/) [@rushit-kakadiya](https://github.com/rushit-kakadiya/)| | Hausa | [Hausa](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.hau.md) | []() | | עברית | [Hebrew](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.hb.md) | [@TomerPacific](https://github.com/TomerPacific) | | हिन्दी | [Hindi](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.hi.md) | [@arshadkazmi42](https://github.com/arshadkazmi42) [@sara-02](https://github.com/sara-02) [shrut1996](https://github.com/shrut1996) | | Chhattisgarhi | [Chhattisgarhi](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.hne.md) | [@pradyyadav](https://github.com/pradyyadav) | | Magyar | [Hungarian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.hu.md) | []() | | Armenian | [Armenian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.hy.md) | []() | | Indonesian | [Indonesian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.id.md) | [@hahn](https://github.com/hahn) | | Igbo | [Igbo](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.igb.md) | [@zecollokaris](https://github.com/zecollokaris) []() | | Italiano | [Italian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.it.md) | [@platipo](https://github.com/platipo) | | 日本語 | [Japanese](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ja.md) | [@cbondurant](https://github.com/cbondurant) | | ಕನ್ನಡ | [Kannada](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ka.md) | []() | | 한국어 | [Korean](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ko.md) | [@espozbob](https://github.com/espozbob) | | Kiswahili | [Kiswahili](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.kws.md) |[@zecollokaris](https://github.com/zecollokaris) []() | | Kazakh | [Kazakh](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.kz.md) | [@kurshakuz](https://github.com/kurshakuz) | | Lietuvių kalba | [Lithuanian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.lt.md) | [@neone35](https://github.com/neone35) | | Latviešu valoda | [Latvian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.lv.md) | []() | | Crnogorski | [Montenegrin](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.me.md) | [@neone35]() | | Македонски | [Macedonian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.mk.md) | []() | | മലയാളം | [Malayalam](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ml.md) | [@yedhukrishnan](https://github.com/yedhukrishnan) | | Burmese | [Burmese](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.mm_unicode.md) | [@lwinkyawmyat](https://github.com/lwinkyawmyat) | | मराठी | [Marathi](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.mr.md) | [@bantya](https://github.com/bantya) | | Español de México | [Spanish of Mexico](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.mx.md) | []() | | Bahasa Melayu | [Malay](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.my.md) | []() | | Nederlandse | [Dutch](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.nl.md) | [@MJMajoor](https://github.com/MJMajoor) | | Norsk | [Norwegian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.no.md) | [Islandstone89 on Github](https://github.com/Islandstone89) | | नेपाली | [Nepali](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.np.md) | [@milap-neupane](https://github.com/milap-neupane) | | ਪੰਜਾਬੀ | [Punjabi](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.pb.md) | []() | | Polski | [Polish](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.pl.md) | [@P1X3L0V4](https://github.com/P1X3L0V4) [@mikowhy](https://github.com/mikowhy) | | Português | [Portugues (Portugal)](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.pt-pt.md) | [@RamosCSV](https://github.com/RamosCSV) | | Português do Brasil | [Portugues (Brazil)](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.pt_br.md) | [@OtacilioN](https://github.com/OtacilioN) [@gabrielsanttana](https://github.com/gabrielsanttana)| | Română | [Romanian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ro.md) | [ @dp97](https://github.com/dp97) | | Русский | [Russian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ru.md) | [@ayanovsk](https://github.com/ayanovsk) | | Svenska | [Swedish](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.se.md) | [@jcer](https://github.com/jcer) | | Sinhala | [Sinhala](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.si.md) | []() | | Sindhi | [Sindhi](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.sindhi.md) | []() | | Slovenčina | [Slovak](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.sk.md) | [@CoderKlemen](https://github.com/CoderKlemen) | | Slovenščina | [Slovenian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.slk.md) | [@hercegtomas](https://github.com/hercegtomas) | | Српски | [Serbian (Cyrillic)](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.sr-Cyrl.md) | [@rammba](https://github.com/rammba) | | Srpski | [Serbian (Latin)](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.sr-Latn.md) | [@Mateja3m](https://github.com/Mateja3m) [@rammba](https://github.com/rammba) | | தமிழ் | [Tamil](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ta.md) | [@sathishkumar-manogaran](https://github.com/sathishkumar-manogaran) | | తెలుగు | [Telugu](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.te.md) | []() | | ไทย | [Thai](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.th.md) | [@AimeTPGM](https://github.com/AimeTPGM) | | Tagalog | [Tagalog](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.tl.md) | []() | | Türkçe | [Turkish](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.tr.md) | [@yamac-kurtulus](https://github.com/yamac-kurtulus) | | Українська | [Ukrainian](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ua.md) | [@yamac-kurtulus](https://github.com/666f78) | | Universal Alien | [Universal Alien](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.un-aln.md) | [@debjit-bw]() | | اردو | [Urdu](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ur.md) | [@Shhzdmrz](https://github.com/Shhzdmrz) | | Tiếng Việt | [Vietnamese](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.vn.md) | [@tranlyvu](https://github.com/tranlyvu) | | Yorùbá | [Yorùbá](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.yor.md) | []() | | 中文 | [Chinese (Simplified)](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.zh-cn.md) | [@yuzhoujr](https://github.com/yuzhoujr) | | 中文 | [Chinese (Traditional)](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.zh-tw.md) | [@WeiChienHsu](https://github.com/WeiChienHsu) [@Sharl0tteIsTaken](https://github.com/Sharl0tteIsTaken) | | Zulu | [Zulu](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.zul.md) | [@zecollokaris](https://github.com/zecollokaris) []() | | Lingala | [Lingala](https://github.com/firstcontributions/first-contributions/blob/main/docs/translations/README.ln.md) | [@Emmanuelbinen](https://github.com/Emmanuelbinen) | ================================================ FILE: .github/FUNDING.yml ================================================ # These are supported funding model platforms github: [firstcontributions] open_collective: [firstcontributions] ko_fi: # Replace with a single Ko-fi username tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry liberapay: # Replace with a single Liberapay username issuehunt: # Replace with a single IssueHunt username otechie: # Replace with a single Otechie username lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2'] ================================================ FILE: .github/ISSUE_TEMPLATE/issue-template.md ================================================ --- name: Suggest changes about: If you want to report a bug or suggest improvements, please open an issue. title: '' labels: discussion, question assignees: Roshanjossey --- 🐞 **Problem** 🎯 **Goal** 💡 **Possible solutions** 📋 **Steps to solve the problem** * Comment below about what you've started working on. * Add, commit, push your changes. * Submit a pull request and add this in comments - `Addresses #` * Ask for reviews in comments section of pull request. * Celebrate your contribution to this project. 🎉 ================================================ FILE: .github/ISSUE_TEMPLATE.md ================================================ 🐞 **Problem** 🎯 **Goal** 💡 **Possible solutions** 📋 **Steps to solve the problem** * Comment below about what you've started working on. * Add, commit, push your changes. * Submit a pull request and add this in comments - `Addresses #` * Ask for reviews in comments section of pull request. * Celebrate your contribution to this project. 🎉 ================================================ FILE: .github/PULL_REQUEST_TEMPLATE.md ================================================ Before submitting this pull request, check the changes to see it's only the changes you made intentionally If there are changes to other lines you didn't make deliberately, it's possible that your IDE made the changes with a utility like prettier. Next time, make sure that you only add your changes by using `git add -p` and rather than `git add Contributors.md` If you're doing something in the checklist below, put an `x` inside `[ ]` so that `- [ ]` becomes `- [x]` - [ ] I had fun going through this tutorial (ノ^o^)ノ and learned on the way ٩(＾◡＾)۶ - [ ] There are some things I'd like to improve in this tutorial. I have written them below. - [ ] There were steps where I had errors while following this tutorial. I have written them below. ================================================ FILE: .github/SECURITY.md ================================================ # Security Policy ## Reporting a Vulnerability In order for vulnerability reports to reach maintainers as soon as possible, the preferred method is to use the "Report a vulnerability" button under the "Security" tab of the associated GitHub project. This creates a private communication channel between the reporter and the maintainers. If you cannot or prefer not to use GitHub's vulnerability reporting workflow, please reach out to the team by emailing firstcontributions@gmail.com. ================================================ FILE: .github/funding.json ================================================ { "version": "v1.0.0", "entity": { "type": "organisation", "role": "owner", "name": "firstcontributions", "email": "firstcontributions@gmail.com", "phone": "", "description": "Improve accessibility with enhanced documentation tailored for beginners and create opportunities for first-time contributors to get involved. Focus on building great software while inspiring a thriving, collaborative community around open source projects.", "webpageUrl": { "url": "https://github.com/firstcontributions/first-contributions" } }, "projects": [ { "guid": "first-contributions", "name": "First contributions", "description": "Help beginners learn how to contribute to open-source projects. It provides a simple and beginner-friendly way for users to understand the contribution workflow using Git and GitHub. We've had over 90,000 users since we started in 2016", "webpageUrl": { "url": "https://github.com/firstcontributions/first-contributions" }, "repositoryUrl": { "url": "https://github.com/firstcontributions/first-contributions" }, "licenses": [ "spdx:MIT" ], "tags": [ "tutorial", "beginner", "open-source", "contribution" ] } ], "funding": { "channels": [ { "guid": "opencollective", "type": "payment-provider", "address": "https://opencollective.com/firstcontributions", "description": "Fiscal host is Open Source Collective. Payment methods can be found in https://docs.opencollective.com/help/financial-contributors/payments#select-a-payment-method" }, { "guid": "github-sponsors", "type": "payment-provider", "address": "https://github.com/sponsors/firstcontributions", "description": "Uses open collective" } ], "plans": [ { "guid": "maintainer-time", "status": "active", "name": "Maintainer compensation", "description": "This will compensate the effort of one maintainer working part-time on the projects.", "amount": 30000, "currency": "USD", "frequency": "yearly", "channels": [ "opencollective", "github-sponsors" ] }, { "guid": "hosting-monthly", "status": "active", "name": "Hosting support", "description": "This will cover the monthly server hosting costs for the projects.", "amount": 30, "currency": "USD", "frequency": "monthly", "channels": [ "opencollective", "github-sponsors" ] } ], "history": [ { "year": 2024, "income": 3, "expenses": 0, "taxes": 0, "currency": "USD", "description": "" }, { "year": 2023, "income": 5, "expenses": 0, "taxes": 0, "currency": "USD", "description": "" } ] } } ================================================ FILE: .github/workflows/auto-pr-merge.yml ================================================ name: Auto-merge PRs on: pull_request_target: types: [opened, synchronize] paths: - 'Contributors.md' # <- only run if only contributors file changed jobs: auto-merge: runs-on: ubuntu-latest permissions: contents: write pull-requests: write issues: write steps: # Check out the repository code - name: Checkout code uses: actions/checkout@v4 with: ref: ${{ github.event.pull_request.head.sha }} fetch-depth: 2 - name: Check if PR only modifies Contributors.md id: is_only_contributors_file_changed run: | # Get a list of files changed in the pull request PR_FILES=$(curl -s -H "Authorization: Bearer ${{ secrets.GITHUB_TOKEN }}" \ "https://api.github.com/repos/${{ github.repository }}/pulls/${{ github.event.pull_request.number }}/files" | \ jq -r '.[].filename') FILES_CHANGED=$(echo $PR_FILES | tr '\n' ' ') echo "files_changed=$FILES_CHANGED" >> $GITHUB_ENV if [[ "${FILES_CHANGED// /}" == "Contributors.md" ]]; then echo "only_contributors=true" >> $GITHUB_ENV else echo "only_contributors=false" >> $GITHUB_ENV fi - name: Check if PR has only one line change run: | ADDITIONS=${{ github.event.pull_request.additions }} DELETIONS=${{ github.event.pull_request.deletions }} echo "additions=$ADDITIONS" >> $GITHUB_ENV echo "deletions=$DELETIONS" >> $GITHUB_ENV if [[ $ADDITIONS == 1 && $DELETIONS == 0 ]]; then echo "one_line_change=true" >> $GITHUB_ENV elif [[ $ADDITIONS == 2 && $DELETIONS == 1 ]]; then echo "one_line_change=true" >> $GITHUB_ENV else echo "one_line_change=false" >> $GITHUB_ENV fi # Merge the pull request if it only modifies the Contributors.md file or if it fail to do then drop failure message as post - name: Merge PR id: merge_pr if: env.only_contributors == 'true' && env.one_line_change == 'true' uses: actions/github-script@v6 with: github-token: ${{ secrets.GITHUB_TOKEN }} script: | try { // Attempt to merge the pull request using the squash method const response = await github.rest.pulls.merge({ owner: context.repo.owner, repo: context.repo.repo, pull_number: context.issue.number, merge_method: "squash" }) // Check if the merge was successful by checking the status code of the response if (response.status === 200) { const celebrationGifs = [ 'https://c.tenor.com/ZCq4SwgCfxAAAAAC/snoopy-peanuts.gif', 'https://c.tenor.com/Z0ojZS2kpO0AAAAC/milk-and-mocha-happy.gif', 'https://c.tenor.com/LffD4a8ET9AAAAAC/heart-celebrate.gif', 'https://c.tenor.com/HJ0iSKwIG28AAAAC/yes-baby.gif', 'https://c.tenor.com/4blWuIh5MIYAAAAC/baby-yoda.gif', 'https://c.tenor.com/B_zYdea4l-4AAAAC/yay-minions.gif', 'https://media1.giphy.com/media/artj92V8o75VPL7AeQ/giphy.gif', 'https://media2.giphy.com/media/IwAZ6dvvvaTtdI8SD5/giphy.gif', 'https://media0.giphy.com/media/z8gtBVdZVrH20/giphy.gif', 'https://media2.giphy.com/media/26gN16cJ6gy4LzZSw/giphy.gif', 'https://media1.giphy.com/media/LZElUsjl1Bu6c/giphy.gif', 'https://media1.giphy.com/media/gHnwTttExPf4nwOWm7/giphy.gif', ] const getRandomGif = () => celebrationGifs[Math.floor(Math.random() * celebrationGifs.length)] // social media links const web_url = 'https://firstcontributions.github.io'; const codeContributionsLink = 'https://github.com/roshanjossey/code-contributions' const fb_share_link = 'https://www.facebook.com/sharer/sharer.php?u=https://roshanjossey.github.io/first-contributions"e=Yay%21%20I%20just%20made%20my%20first%20open%20source%20contribution%20with%20First%20Contributions.%20You%20can%20too,%20by%20following%20a%20simple%20tutorial%20at%20https%3A//goo.gl/66Axwe&hashtag=%23OpenSource' const reddit_link = 'https://www.reddit.com/submit?url=https%3A%2F%2Fgithub.com%2Ffirstcontributions%2Ffirst-contributions&title=Learn%20how%20to%20contribute%20to%20open%20source%20projects%20in%205%20minutes' const linkedin_share_link = 'https://www.linkedin.com/sharing/share-offsite/?url=https://github.com/firstcontributions/first-contributions'; const dev_share_link = "https://dev.to/new?prefill=---%0Atitle%3A%20First%20Contributions%3A%20learn%20how%20to%20contribute%20to%20open%20source%20projects%0Apublished%3A%20true%0Atags%3A%20opensource%2C%20beginners%2C%20tutorial%0A---%0A%0AI%20followed%20the%20hands-on%20tutorial%20in%20the%20Readme%20of%20first%20contributions%20and%20made%20my%20first%20pull%20request%20to%20the%20same%20repo.%0A%0A%0A%7B%25%20embed%20https%3A%2F%2Fgithub.com%2Ffirstcontributions%2Ffirst-contributions%20%25%7D"; const hackernews_share_link = 'https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fgithub.com%2Ffirstcontributions%2Ffirst-contributions&t=Show%20HN%3A%20Hands%20on%20tutorial%20for%20open%20source%20contribution' const bluesky_share_link = 'https://bsky.app/intent/compose?text=Yay%21%20I%20just%20made%20my%20first%20open%20source%20contribution%20with%20%40FirstContributions.%20You%20can%20too%20by%20following%20a%20simple%20tutorial%20at%20https%3A%2F%2Fgoo.gl%2F66Axwe%20%23OpenSource%20%23FirstContribution%20%23Coding%20%23DevCommunity%20%23GitHub%20%23LearnToCode'; // social logo const repo_logo = "https://avatars0.githubusercontent.com/u/65761570?s=88&u=640f39b808c75c6b86460aa907dd030bcca2f3c7&v=4" const fb_logo = "https://edent.github.io/SuperTinyIcons/images/svg/facebook.svg" const reddit_logo = "https://edent.github.io/SuperTinyIcons/images/svg/reddit.svg" const linkedin_logo = "https://edent.github.io/SuperTinyIcons/images/svg/linkedin.svg"; const dev_logo = "https://edent.github.io/SuperTinyIcons/images/svg/dev_to.svg"; const hackernews_logo = "https://edent.github.io/SuperTinyIcons/images/svg/hackernews.svg"; const bluesky_logo = "https://edent.github.io/SuperTinyIcons/images/svg/bluesky.svg"; const getMergeMessage = (username) => { const greeting = `Hello @${username}, congratulations! You've successfully submitted a pull request. 🎉`; const starRepoMessage = `If you liked the tutorial, please star this repo by clicking the star button on the top right of this page. star screenshot`; const nextSteps = `# Next steps \n - Continue contributing: If you're looking for projects to contribute to, checkout our [ webapp](${web_url}). \n - If you want more practice checkout [code contributions](${codeContributionsLink}). \n - Share on social media: You can share this content to help more people.\n - [bluesky Post on Bluesky](${bluesky_share_link}).\n - [facebook share](${fb_share_link}).\n - [ reddit share](${reddit_link}).\n - [linkedin post](${linkedin_share_link}).\n - [devio publish](${dev_share_link}).\n - [ Post on HackerNews](${hackernews_share_link}).`; const feedbackMessage = `We'd love to hear your thoughts about this project. Let us know how we can improve by commenting or opening an issue here.`; const gif = `![celebration gif](${getRandomGif()})`; return `${greeting}\n\n${starRepoMessage}\n\n${nextSteps}\n\n${feedbackMessage}\n\n${gif}`; } // Generate the merge message using the getMergeMessage function const message = getMergeMessage(context.payload.pull_request.user.login); // post a comment await github.rest.issues.createComment({ owner: context.repo.owner, repo: context.repo.repo, issue_number: context.issue.number, body: message }) } else { // Post a comment on the pull request using the createComment method await github.rest.issues.createComment({ owner: context.repo.owner, repo: context.repo.repo, issue_number: context.issue.number, body: "Something went wrong while attempting to merge this pull request. Please check the GitHub Actions log for more information." }) } } catch (error) { let errMsg = ""; console.error("Error merging pull request:", error.message); // Handle specific error cases based on status code if (error.status === 405 && error.response.data.message === "Pull Request is not mergeable") { errMsg = `Hello @${context.payload.pull_request.user.login}, thank you for your pull request. We appreciate your contribution to the project. However, before we can merge it, there is a merge conflict with the target branch. \n\n No worries! You can follow [this guide](https://github.com/firstcontributions/first-contributions/blob/main/docs/additional-material/git_workflow_scenarios/resolving-merge-conflicts.md) on resolving merge conflicts. Once you've fixed the conflicts and pushed your changes, the repository will check the changes you made and proceed with the merge if everything looks good. \n\n If you have any questions or need further assistance, don't hesitate to reach out. We're here to help!` } else if (error.status === 409) { console.error("The pull request has conflicts with the target branch. Resolve the conflicts before merging."); errMsg = "The pull request has conflicts with the target branch. Resolve the conflicts before merging."; } else { console.error("Something went wrong while merging the pull request."); errMsg = "Something went wrong while merging the pull request."; } // Post a comment on the pull request using the createComment method await github.rest.issues.createComment({ owner: context.repo.owner, repo: context.repo.repo, issue_number: context.issue.number, body: errMsg }) // Set GitHub Action as failed core.setFailed(error.message); } # Post a comment on the pull request if it was not merged automatically - name: Post comment on PR if not merged automatically # Check if the pull request only modifies the CONTRIBUTORS.md file if: env.only_contributors != 'true' uses: actions/github-script@v6 with: script: | // get the existing comments. const {data: comments} = await github.rest.issues.listComments({ owner: context.repo.owner, repo: context.repo.repo, issue_number: context.payload.number, }) // find any comment already made by the bot. const botComment = comments.find(comment => comment.user.login === 'github-actions[bot]') const body = `Thank you for your pull request. This pull request contains changes in files which requires review. The following files were changed:\n\n ${process.env.files_changed.trim() ? `\n\n${process.env.files_changed.trim().split(' ').map(file => `- ${file}`).join('\n')}` : ''}` if (botComment) { await github.rest.issues.updateComment({ owner: context.repo.owner, repo: context.repo.repo, comment_id: botComment.id, body: body }) } else { await github.rest.issues.createComment({ owner: context.repo.owner, repo: context.repo.repo, issue_number: context.issue.number, body: body }); } github-token: ${{ secrets.GITHUB_TOKEN }} ================================================ FILE: .gitignore ================================================ .DS_Store; .idea/ .vs .vscode .env # User-specific files *.rsuser *.suo *.user *.userosscache *.sln.docstates *.swp # User-specific files (MonoDevelop/Xamarin Studio) *.userprefs # Mono auto generated files mono_crash.* # Build results [Dd]ebug/ [Dd]ebugPublic/ [Rr]elease/ [Rr]eleases/ x64/ x86/ [Ww][Ii][Nn]32/ [Aa][Rr][Mm]/ [Aa][Rr][Mm]64/ bld/ [Bb]in/ [Oo]bj/ [Ll]og/ [Ll]ogs/ # Visual Studio 2015/2017 cache/options directory .vs/ # Uncomment if you have tasks that create the project's static files in wwwroot #wwwroot/ # Visual Studio 2017 auto generated files Generated\ Files/ # MSTest test Results [Tt]est[Rr]esult*/ [Bb]uild[Ll]og.* # NUnit *.VisualState.xml TestResult.xml nunit-*.xml # Build Results of an ATL Project [Dd]ebugPS/ [Rr]eleasePS/ dlldata.c # Benchmark Results BenchmarkDotNet.Artifacts/ # .NET Core project.lock.json project.fragment.lock.json artifacts/ # ASP.NET Scaffolding ScaffoldingReadMe.txt # StyleCop StyleCopReport.xml # Files built by Visual Studio *_i.c *_p.c *_h.h *.ilk *.meta *.obj *.iobj *.pch *.pdb *.ipdb *.pgc *.pgd *.rsp *.sbr *.tlb *.tli *.tlh *.tmp *.tmp_proj *_wpftmp.csproj *.log *.tlog *.vspscc *.vssscc .builds *.pidb *.svclog *.scc # Chutzpah Test files _Chutzpah* # Visual C++ cache files ipch/ *.aps *.ncb *.opendb *.opensdf *.sdf *.cachefile *.VC.db *.VC.VC.opendb # Visual Studio profiler *.psess *.vsp *.vspx *.sap # Visual Studio Trace Files *.e2e # TFS 2012 Local Workspace $tf/ # Guidance Automation Toolkit *.gpState # ReSharper is a .NET coding add-in _ReSharper*/ *.[Rr]e[Ss]harper *.DotSettings.user # TeamCity is a build add-in _TeamCity* # DotCover is a Code Coverage Tool *.dotCover # AxoCover is a Code Coverage Tool .axoCover/* !.axoCover/settings.json # Coverlet is a free, cross platform Code Coverage Tool coverage*.json coverage*.xml coverage*.info # Visual Studio code coverage results *.coverage *.coveragexml # NCrunch _NCrunch_* .*crunch*.local.xml nCrunchTemp_* # MightyMoose *.mm.* AutoTest.Net/ # Web workbench (sass) .sass-cache/ # Installshield output folder [Ee]xpress/ # DocProject is a documentation generator add-in DocProject/buildhelp/ DocProject/Help/*.HxT DocProject/Help/*.HxC DocProject/Help/*.hhc DocProject/Help/*.hhk DocProject/Help/*.hhp DocProject/Help/Html2 DocProject/Help/html # Click-Once directory publish/ # Publish Web Output *.[Pp]ublish.xml *.azurePubxml # Note: Comment the next line if you want to checkin your web deploy settings, # but database connection strings (with potential passwords) will be unencrypted *.pubxml *.publishproj # Microsoft Azure Web App publish settings. Comment the next line if you want to # checkin your Azure Web App publish settings, but sensitive information contained # in these scripts will be unencrypted PublishScripts/ # NuGet Packages *.nupkg # NuGet Symbol Packages *.snupkg # The packages folder can be ignored because of Package Restore **/[Pp]ackages/* # except build/, which is used as an MSBuild target. !**/[Pp]ackages/build/ # Uncomment if necessary however generally it will be regenerated when needed #!**/[Pp]ackages/repositories.config # NuGet v3's project.json files produces more ignorable files *.nuget.props *.nuget.targets # Nuget personal access tokens and Credentials nuget.config # Microsoft Azure Build Output csx/ *.build.csdef # Microsoft Azure Emulator ecf/ rcf/ # Windows Store app package directories and files AppPackages/ BundleArtifacts/ Package.StoreAssociation.xml _pkginfo.txt *.appx *.appxbundle *.appxupload # Visual Studio cache files # files ending in .cache can be ignored *.[Cc]ache # but keep track of directories ending in .cache !?*.[Cc]ache/ # Others ClientBin/ ~$* *~ *.dbmdl *.dbproj.schemaview *.jfm *.pfx *.publishsettings orleans.codegen.cs # Including strong name files can present a security risk # (https://github.com/github/gitignore/pull/2483#issue-259490424) #*.snk # Since there are multiple workflows, uncomment next line to ignore bower_components # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622) #bower_components/ # RIA/Silverlight projects Generated_Code/ # Backup & report files from converting an old project file # to a newer Visual Studio version. Backup files are not needed, # because we have git ;-) _UpgradeReport_Files/ Backup*/ UpgradeLog*.XML UpgradeLog*.htm ServiceFabricBackup/ *.rptproj.bak # SQL Server files *.mdf *.ldf *.ndf # Business Intelligence projects *.rdl.data *.bim.layout *.bim_*.settings *.rptproj.rsuser *- [Bb]ackup.rdl *- [Bb]ackup ([0-9]).rdl *- [Bb]ackup ([0-9][0-9]).rdl # Microsoft Fakes FakesAssemblies/ # GhostDoc plugin setting file *.GhostDoc.xml # Node.js Tools for Visual Studio .ntvs_analysis.dat node_modules/ # Visual Studio 6 build log *.plg # Visual Studio 6 workspace options file *.opt # Visual Studio 6 auto-generated workspace file (contains which files were open etc.) *.vbw # Visual Studio LightSwitch build output **/*.HTMLClient/GeneratedArtifacts **/*.DesktopClient/GeneratedArtifacts **/*.DesktopClient/ModelManifest.xml **/*.Server/GeneratedArtifacts **/*.Server/ModelManifest.xml _Pvt_Extensions # Paket dependency manager .paket/paket.exe paket-files/ # FAKE - F# Make .fake/ # CodeRush personal settings .cr/personal # Python Tools for Visual Studio (PTVS) __pycache__/ *.pyc # Cake - Uncomment if you are using it # tools/** # !tools/packages.config # Tabs Studio *.tss # Telerik's JustMock configuration file *.jmconfig # BizTalk build output *.btp.cs *.btm.cs *.odx.cs *.xsd.cs # OpenCover UI analysis results OpenCover/ # Azure Stream Analytics local run output ASALocalRun/ # MSBuild Binary and Structured Log *.binlog # NVidia Nsight GPU debugger configuration file *.nvuser # MFractors (Xamarin productivity tool) working folder .mfractor/ # Local History for Visual Studio .localhistory/ # BeatPulse healthcheck temp database healthchecksdb # Backup folder for Package Reference Convert tool in Visual Studio 2017 MigrationBackup/ # Ionide (cross platform F# VS Code tools) working folder .ionide/ # Fody - auto-generated XML schema FodyWeavers.xsd # VS Code files for those working on multiple tools .vscode/* !.vscode/settings.json !.vscode/tasks.json !.vscode/launch.json !.vscode/extensions.json *.code-workspace # Local History for Visual Studio Code .history/ # Windows Installer files from build outputs *.cab *.msi *.msix *.msm *.msp # JetBrains Rider .idea/ *.sln.iml .vscode/settings.json .DS_Store # Desktop.ini (Google Drive info file) desktop.ini .codegpt .qodo ================================================ FILE: Contributors.md ================================================ # Contributors hello ji - [M. Fajal](https://github.com/Mfaj-cod) -[Neha Dubey](https://github.com/Nehainit) - [Satyanshi Singh](https://github.com/23f3004132) - [Thecapstone Mogbolu](https://github.com/Thecapstone) - [Pankaj vishwakarma](https://github.com/pk-arma) - [Yashi Chaudhary](https://github.com/Yashee05) - [Thecapstone Mogbolu](https://github.com/Thecapstone) [- k-mirembe-mercy] [Likitha Tummapudi](https://github.com/LikithaTummapudi) - [Aya Driouche](https://github.com/aya119119) - [Gloria Iseghehi](https://github.com/Glowriaose) - [Jitendra Kumar](https://github.com/23f1000704) - [Bhumit Solanki](https://github.com/Bhumit0922) - [Nishi Mandhana](https://github.com/nmandhana) - [Yashwant Nayak](https://github.com/Yashwant990) - [Prithviraj Tandel](https://github.com/NSKY0808) - [Julian Andres](https://github.com/julianandresdev) - [REH](https://github.com/RODRIGO-ENH/) - [Nikhil More](https://github.com/Khiladi-786) - [Santiago Moncayo](https://github.com/Smoncayo24) - [Rajkumar senapati](https://github.com/Rajkumargit61) - [Elisio Augusto](https://github.com/elisio-tech) - [olive](https://github.com/Olive1017) - [Mohan Pawar](https://github.com/MOHANX-0001) - [Imad Rahhali](https://github.com/ImadRahhali) - [Charul Bhanarkar](https://github.com/charull44) - [Yash Kewte](https://github.com/yashkewte) - [Jyotula Siva Preetham](https://github.com/MooN4002) - [Adaji Gideon](https://github.com/gidosharpman) - [Varshith Reddy](https://github.com/VarshithReddy2006) - [Jeet Gupta](https://github.com/JeetG-AlphaDev) - [Arnav Amrit](https://github.com/ArnavAmrit) - [Htoo Eant Linn](https://github.com/htooeantlinn) - [Shanmuga Sundaram Natarajan](https://github.com/shanmuga-sundaram-n) - [Ashka Pathak](https://github.com/AshkaPathak) - [Vadim Cebanu](https://github.com/vadim-cebanu) - [Saket Kumar Sinha](https://github.com/SaketSinha2005) - [forkcommit](https://github.com/forkcommit) - [saudademjj](https://github.com/saudademjj) - [Danielle Lyles](https://github.com/Danielle-Lyles) - [Ankur Mallick](https://github.com/AnkurMal) - [Abhay Patange](https://github.com/AbhayPatange) - [Riyyan Khan](https://github.com/riyyankhan007) [Jason Zinn](https://github.com/jasonzinndal) [Isly NN] - [Victor Almeida](https://github.com/vma5) - [CP2] - [Muhsil NR](https://github.com/mhlohh) - [Anika](https://github.com/MsAnika) - [skntrl] (https://github.com/skntrl) - [Paul Duthu](https://github.com/PaulDuthu) - [Piyush Kanti Chanda] (https://github.com/piyushka-ally) - [Khalil Khamassi](https://github.com/khalilkhamassi62-oss) - [Sai Hruday Reddy N](https://github.com/EpicCoder1234) - [Atul Pandey](https://github.com/atulpandey9) - [Gayathri R](https://github.com/Gayathri17Ramesh) - [Daffa Kaisha Pratama Chandra](https://github.com/daff00) - [mycoderisyad](https://github.com/mycoderisyad) - [AMAN KUSHWAHA] (https://github.com/MaxCoder07) - [Confidence Monday] (https://github.com/Confidence-Monday) - [Jules Cinc] (https://https://github.com/JulesCinc) - [Vishwajeet_Kanase](https://github.com/vishwajeetkanase) - [Shiva Kumar](https://github.com/shiva-kumar04) - [vamshi kiran](https://github.com/vamshikiran065-jpg) - [itzharshini](https://github.com/itzharshini) - [Sahilarora83](https://github.com/Sahilarora83) - [Toluwanimi](https://github.com/DevTolu79) - [Gayatri Yadkikar](https://github.com/yadkikargayatri) - [Ifeanyi](https://github.com/kevinify) [Ijeoma] (https://github.com/graciElla001/graciElla001) - [Jamiu](https://github.com/RushNet01) [Pedro_Vieira] (https://github.com/PedroVieira226) - [onasanya sarah](https://github.com/onasanyasarah17-bit) - [Aditya Raj](https://github.com/iamadityaraj04) - [lonely_white](https://github.com/lonelywhite233) - [primemorti8-netizen](https://github.com/primemorti8-netizen) [Adedamola Aina](https://github.com/Adedamola007) - [Ankush Gulia](https://github.com/ankushkgulia) - [Boussaid Louai](https://github.com/lou-bou) - [CP2] - [Archiii] - [Ishwinder] [Kenil Gorasiya](https://github.com/Kenildev007) - [Vinesh nayak] (https://github.com/Vineshnayak) - [Maurice Carroll] (https://github.com/nwbikedude) - [Ton Lin] - [SimarLar] - [KSH] - [Rouan Laporal](https://github.com/RouanLaporal) - [MiaByte-ctrl] - [Komal Godara](https://github.com/meow8080) - [Shivani-Padia](https://github.com/shivanipadia01-cyber) - [Saqib Anjum Masoodi](https://github.com/SaqibMasoodi) - [Robert Mongold](https://github.com/rtmongold) - [Chidera Okere] (https://github.com/okerescm) - [Naim Muaz](https://github.com/naimmuaz) - [Phillip F](https://github.com/pfurpass) - [Justin Thomas](https://github.com/justinthomas11) - [Jayanti Deb] - [Luis Henrique] (https://github.com/Passarin1) - [Ibrahim_Abbas] (https://github.com/IbrahimAbbas-spec) - [Tariq Menla](https://github.com/Tariq-Menla) - [MeowWow520](https://meowwow520.cn/) - [Odo Kingsley Uchenna] (https://github.com/RealKingHubs) - [Nolan Berg] (https://github.com/NolanBerg) - [Aman Jha] ([23f2003233](https://github.com/23f2003233)) - [Eduardo Nunes] (https://github.com/eduardonunesfvm) - [Xiaochun Bai](https://github.com/Bingtagui404) - [M_Rizwan](https://github.com/rizwan749) - [Ankur Gupta](https://github.com/7007259Ankur) - [Daerian] (https://github.com/Daerian) - [Y Bhavana](https://github.com/yalalabhavana17-cmyk) - [Manuel Pérez] (https://github.com/Manuu77) - [Zoraz](https://github.com/Zoraz01) - [Feizo](https://github.com/Felix-Kebaki) [Specturr] (https://github.com/Specturr) - [BKaur20] (https://github.com/BKaur20/) - [z0ryn](github.com/z0ryn) - [Kaushal Prakash](github.com/kaushal-Prakash) - [Paras Rawat](https://github.com/paras941) - [Han](https://github.com/vy088473) - [Md. Kamran Alam](https://github.com/mdkamranalam) - [jjipper] (https://github.com/jjipper) - [Abhay Agnihotri](https://github.com/Abhay-Agnihotri01/) - [Yeswa Preetam Reddy](https://github.com/24f3003935) - [vencentDebug](https://github.com/vencentDebug/first-contributions) - [saumyadhote](https://github.com/saumyadhote) - [SSkalas](https://github.com/SSkalas) - [ankitongithb](https://github.com/ankitongithb) - [sivakkumar21](https://github.com/sivakkumar21) - [Bishwa7](https://github.com/Bishwa7) - [Aaryan Pandey](https://github.com/aaryanpandey29) - [yjh7979-12](https://github.com/yjh7979-12/) - [24f2008014](https://github.com/24f2008014) - [kumsb](https://github.com/24f2008015) - [Patrick Jove](https://github.com/iamkcirtap) - [sbp828](https://github.com/sbp828) - [Waffo Taffo](https://github.com/WaffoTaffo) - [PrincejiCoder](https://github.com/PrincejiCoder) - [Thien Nguyen](https://github.com/th13nnh) - [Mohammad Yasir Khan](https://github.com/myasir-khan) - [Ammar Tafoiki](https://github.com/ammar116/) - [Buyi](https://github.com/buyicoder) - [Hamad Ullah](https://github.com/hammadaiy/) - [Saqib](https://github.com/saq12) - [Sahil Hossain](https://github.com/Sahil-Hossain-1429) - [D7mnCh](http://github.com/D7mnCh) - [SJ](http://github.com/saaicasm) - [maria isabel solis](https://github.com/Maisa2006) - [Blessing Izee](https://github.com/Blessing-Imoukhede) - [Kamipantsu0](https://github.com/Kamipantsu0) - [Jack Johnson](https://github.com/norvest06) - [Sindhu Reddy](https://github.com/prodduturisindhurdy) - [Sai Srikar](https://github.com/saisrikarbommisetty) - [Keerthan](https://github.com/keerthan0803) - [Ibrahim Ibn Tanweer Almadani](https://github.com/24f1001980) - [TheLoneBandana](https://github.com/TheLoneBandana) - [Abdelhamid Ellab](https://github.com/Abdelhamid04) - [Alice-Chxn](https://github.com/alicechan-dev) [Vishal Rathod](https://github.com/theboogyman15) - [Shyam Chavda](https://github.com/ShyamChavda005) - [JN Gonzales](https://github.com/jngonzales) - [Aman Jha](https://github.com/ajha19) - [Djora](https://github.com/GiggityGGit) - [Prathyusha Marri](https://github.com/Prathyusha-hub-M) - [Tejas Srivastava](https://github.com/tejassri11) - [Saket Anand](https://www.saketanand.com) - [Scott Boudreaux (Elyan Labs)](https://github.com/Scottcjn) - [Kokkirigedda Lohit](https://github.com/lohit3050) - [Avuram Chandra Mohan Reddy](https://github.com/chandramohan385) - [Prashant Kumar Tuhania](https://github.com/prashantkumar342) - [Mrrrrrrt](https://github.com/Mrrrrrrt) - [Henrique](https://github.com/roberto0906) - [Justin Morphosis](https://github.com/justinmorphosis) - [Isaac Keninger](https://github.com/IsaacKeninger) - [Bhavesh Gajengi](https://github.com/BhaveshGajengi1) - [Abdul Muqeet K B](https://github.com/muqeet-27) - [Anand Mani](https://github.com/astromani721) - [Bhautik Jani](https://github.com/BhautikJani11) - [midikaif](https://github.com/midikaif) - [yjh7979](https://github.com/yjh7979) - [kevingao25](https://github.com/kevingao25) - [VipulBhattt](https://github.com/VipulBhattt) - [Yogesh Jindal](https://github.com/yogeshJindal1) - Max - [Mahefoz Sowad](https://github.com/Mahefoz-Sowad) - [Roland Steiner] - [reboyu](https://github.com/rezhboyu) - Sean Butt - [Mohammad Rushaan](https://github.com/MohammadRushaan) - [ZhangHao] - daniel1876-zhuo - Gonzalo (https://github.com/GonzaloAleo) - 23f3000487@ds.study.iitm.ac.in -[alejandro soto martinez](https://github.com/Alexsoto042) - [shweta yadav](https://github.com/shwetayadav16/) - Arpan (https://github.com/arpan-v/) -[Jppat](https://github.com/Jppat/) - [Suhayb Faysal](https://github.com/DrZiMo) - [Deepak Sriram](https://github.com/sriram15112001) -[arpit tharkar ](https://github.com/ArpitTharkar/first-contributions) -[shiv bhajan akela ](https://github.com/akela007/first-contributions) - [1828](https://github.com/18-28) - [RobertMarc19] (https://github.com/RobertMarc19) - [Tanmay Raj](https://github.com/Tanmayraj31) - [Arnab Kumar Behera](https://github.com/Arnabkbehera) - [BabaYaga-RU](https://github.com/BabaYaga-RU) - [Baseer Afridi](https://github.com/baseergroot) - [Shravani Devakar](https://github.com/shravani-devakar) - [1ESA1](https://github.com/1ESA1) - [Gabriele Ferrero](https://github.com/devgfe) - [Manisha Dhankhar](https://github.com/ManishaDhankhar) - [2003myriam](https://github.com/2003myriam) - [mananjp](https://github.com/mananjp) - [Noob] (https://github.com/ConfusedPod042) - [wengsnow] (https://github.com/wengsnow/) - Komalpreet Kaur (https://github.com/Komalpreetkaur-GH) - [24f3003274-RISHABH](https://github.com/24f3003274-RISHABH) - [@Zakiahsan-arch](https://github.com/Zakiahsan-arch) - [Sanchana](https://github.com/Sanchana05) - [A Szpatowski](https://github.com/aszpatowski) - [AC](https://github.com/FortKnoxWasTaken) [Prashant Raj][https://github.com/prashantraj4105] - [RandomAimXD](https://github.com/RandomAimXD) - [RibelAI](https://github.com/RibelAI) - [AJ Gyro](https://github.com/AJGyro) - [Leon](https://github.com/Leonels12) - [JosecalderonGIT10](https://github.com/JosecalderonGIT10) - [Akshat Singhai](https://github.com/akshatsinghai6682-sketch) - [AKANKSHA JADHAV](https://github.com/Akankshaa1213) - [Aditya Zala](https://github.com/AdityaZala3919) - [APC](https://github.com/achamberlain04) - [AP3008](https://github.com/AP3008) - [ARCHANA_GURUSAMY](https://github.com/ARCHANA-SENGUNTHAR) - [Jatin](https://github.com/Lord-Jastannum) - [HIMANSHU_AGRAWAL](https://github.com/Himanshuagrawal2003) - abubakar -[Tommmy] -[yayme] - [sancer](https://github.com/SantCer/first-contributions.git) - [Senadeera-NK](https://github.com/Senadeera-NK) - [lopes061](https://github.com/lopes061) - [saulagus] (https://github.com/saulagus) - [Kavyanshu] - [Prince Parmar] - [Aman Parganiha](https://github.com/amanparganiha) - [nullora](https://github.com/Nullora) - [ARES](https://github.com/phoenixcodeforces-blip) - [Agrim Gupta](https://github.com/AgrimGupta195) - [ASaHi Chin](https://github.com/Cxlyq) - [Aakash Chauhan](https://github.com/akashinedon) - [Aakash Chauhan](https://github.com/akashinedon) - [Aaliyah Raheem](https://github.com/aaliot) - [KadenTheHero](https://github.com/KadenTheHero) - [Aaqib Javaid](https://github.com/aaqib605) - [Aamir](https://github.com/AamirMNAamir) - [Aayush Patel](https://github.com/Aayush1302)s - [Aaqib Patel](https://github.com/aaqibp) - [Abhishek Jaiswal](https://github.com/Abhijais4896) - [Abdelrahman Moubarak](https://github.com/amoub-arak2608) - [Md. Ashraful Islam] (https://github.com/ashrafulislambd) - [Shresth Raj](https://github.com/Shresth-013) - [Ananya](https://github.com/an-42-an) - [Abdessamad-Mechouahi](https://github.com/abdessamad-26) - [Sabina Jashir](https://github.com/sabinaljashir) - [Abdoulaye](https://github.com/elhadjdiab) - [favour-ai](https://github.com/Favour-ai) - [Abdullahil Baki](https://github.com/abdullahilbaki) - [Abhas Gaur](https://github.com/Abhas009) - [Abhijit-Gautam](github.com/Abhijit-Gautam) - [Abhinand B](https://github.com/abhinand2511) - Navdeep - [Abhinav Dwivedi](https://github.com/abhinavdwivedi05) - [Abhishek bhatt](https://github.com/abhirbhatt) - [Trinath Swain](https://github.com/Trinathswain45) - [Abinesh Sundar](https://github.com/Abinesh-Sundar/a-open-source) - [Abusaeed Shuvo](https://github.com/abusaeed-shuvo) - [Achan Sai Pranay](https://github.com/Achan-Sai-pranay) 　[IIIHHH40](https://github.com/IIIHHH40) - [Achintha Gamage](https://github.com/AKGamage) - [Miwa Miwa](https://github.com/miwadharod) - [Parth Chauhan](https://github.com/parthc2905) - [Adarsh84](https://github.com/adarshM84) - [Adi Singh](https://github.com/adisingh0824) - [Aditi KC](https://github.com/Swiperrr) - [Aditi Kumari](https://github.com/Aditik081) - [Anukriti Thapa](https://github.com/Anukriti62) - [Aditya Das](https://github.com/AdityaDas496) - [Aditya Karan](https://github.com/Karan2805-glitch) - [Aditya Nautiyal](https://github.com/AdityaNautiyal908) - [Aditya Rahmad](https://github.com/AdityaZxxx) - [Aditya Verma](https://github.com/adityaverma9777) - [Aditya kumar](https://github.com/Aditya754194) - [Aditya-Rawat](https://github.com/RwtAditya) - [Aditya](https://github.com/thisadityasoni) - [Adnan Aftab](https://github.com/AdnanAftab1/) - [Lavika Singla](https://github.com/lavika17) - [Nishant Jha] (https://github.com/jhanishant658) - [Adrian PC M](https://github.com/AdrianPCM) - [Afham Irfan](https://github.com/auth-Afham) - [Rahul Meena](https://github.com/RahulM0912) - [Muhammed Aflah](https://github.com/muhammedaflahm) - [Ahmad Bilal](https://github.com/AhmadBilal-WebDev) - [AhmadObeid](https://github.com/AhmadObeid) - [AyorindeAdunse](https://github.com/ayorindeadunse) - [Ahmed Elshwil](https://github.com/elshwilahmed) - [Ahmed Yasir](https://github.com/ahmedyasir779) - [Aiman](https://github.com/PX201) - [Aissatou Mbaye](https://github.com/AissatouMbaye19) - [Akash Dhamane](https://github.com/explore) - [Akashi Shogo](https://github.com/AkashiShogo) - [Akhil R](https://github.com/A-Rjs) - [Alakh Awasthi](https://github.com/Awasthi577) - [Alanronald2001](https://github.com/Alanronald2001) - [Alanto Manu](https://github.com/alantomanu) - [Aleena Yogindar](https://github.com/Aleena-Y) - [Alejandro Aceituno](https://github.com/clement-zentz) - [Alexander](https://github.com/azuaje1982) - [Alfred Sjögren](https://github.com/4lfman) - [Ali Nasser](https://github.com/AliNasser05) - [Alka Gupta](https://github.com/AlkaGupta6800) - [Allamelol](https://github.com/Allamelol) - [Alnoor](https://github.com/Alnoormahmoud) - [Aloof Apple](https://github.com/AloofApple) - [Altan-Od Munkhsukh](https://github.com/AltanOdMunkhsukh) - [Amal Nourin](https://github.com/amalnourin) - [Amalraj MP](https://github.com/AmalRajMP) - [Aman Bangera](https://github.com/amanbangeraa) - [Aman Bhangre](https://github.com/AmanBhangre) - [fathahM](https://github.com/fathahM) - [Aman Singh](https://github.com/Amankumarsingh23) - [AmarnathV](https://github.com/amar1009) - [AnkitVerma](https://github.com/novakit7) - [Ambar Singh](https://github.com/ambar-singh) - [Aryan Mehrotra](https://github.com/aryanmehrotra) Chris Ashwin RLeish -[kedarnath](https://github.com/kedarnath) - [Santosh M Savalgi](https://github.com/Santosh-M-Savalgi) - [Ameer Ali](https://github.com/Ameeeerr) - [Amin abdolahi](https://github.com/Amin-Abdolahi) - [Amit Kumar Patra](https://github.com/amitkumarpatra99) - [Ammar Adnew](https://github.com/AmmarAdnew) - [Amrutha Ponduri](https://github.com/amrutha-ponduri) - [Amsapriya Krishnamoorthy](https://github.com/AmsapriyaKrishnamoorthy) - [Anand Raj](https://github.com/anandraj095) - [Anandajith S](https://github.com/AnandajithS) - [Wuzu11517](https://github.com/Wuzu11517) - [Anandb71](https://github.com/Anandb71) - [Anay](https://github.com/Anay-Patil) - [Anaïs Gatard](https://github.com/AnaisG14) - [Andrew Nathan Situmorang](https://github.com/andrwsitumorang) - [Andrew Park](https://github.com/AndePark) - [Archi Lodha](https://github.com/ARCHILODHA) - [Archita Jain](https://github.com/archi829) - [Andyple](https://github.com/andyple) - [Angad Bhalla](https://github.com/Anga205) - [Angel Sara](https://github.com/Angelishere) - [Anidu](https://github.com/Anidu07) - [Anirudh Panigrahi](https://github.com/Anirudh-020505) - [Anish Banda](https://github.con/anishbanda) - [Anish Dharu](https://github.com/AnishDharu) - [Anjesh Ranjan Dash ](https://github.com/AnjeshDash) - [Praveen Agrawal](https://github.com/agrawalpraveen12) - [Ankit Ghosal](https://github.com/ankitghosal82) - [Ankit Singh](https://github.com/ANKITsingh-git2) - [Pooja K H](https://github.com/pooja-kh-26) - [Ankit](https://www.youtube.com/watch?v=u3y1MqX4egE) - [Ankush Singh](https://github.com/whyankush07) - [Anshul Bhardwaj](https://github.com/Anshul-Bhardwaj-21) - [Maitra Prajapati](https://github.com/maitra-prajapati) - [Anshik] (https://github.com/Anshikn) - Wangxiaohuide - [AntonioIonica](https://github.com/AntonioIonica) - [Anurag Banerjee](https://github.com/Banerjee2027) - [Federico Amato](https://github.com/fedesss98) - [Anushka Aggarwal](https://github.com/anushka146) - [Sumit Sourabh](https://github.com/Sumit-sourabh45) - [Mohammad Kashan](https://github.com/23f2003821) - [Rafael Ghiorzi](https://github.com/rafaelghiorzi) - [Anushree](https://github.com/Anushree) - [Anushtha Mishra](https://github.com/Anushtha-Mishra) - [AoJacke](https://github.com/AoJackie) - [Archit Ojha](https://github.com/Archit1606) - [Argha Saha](https://github.com/arg387) - [Ariel Miele](https://github.com/arielmiele) - [Arisa Abiko](https://github.com/arisaabiko) - [Javier Garcia](https://github.com/jgarciacardoso) - [Arnav Saraswat](https://github.com/arnavs-uol) - [Arti Shelar](https://github.com/shelararti) - [Arumugam N](https://github.com/blackwolf2902) - [Aryan Jha](https://github.com/aryankumarjha1441-debug) - [Aryan Rathore](https://github.com/javawithaaryan) - [Ash Ibarra](https://github.com/ashthewildfox) - [Ashen-Hirushan](https://github.com/Ashen-Hirushan) - [Ashigaraj](https://github.com/ashigaraj) - [Ashiq](https://github.com/devopashiq) - [Ashutosh Jha](https://github.com/ashutoshh-jhaa) - [Atharva Goel](https://github.com/AtharvaATL2011) - [Ashwin Raj](https://github.com/ashwinraj8090) - [Ashwith Godishala](https://github.com/GodishalaAshwith) - [Ashzad Kamal](https://github.com/ashzad123) - [Asiya Mujawar](https://github.com/asiyamujawar) - [Assaf Lewin](https://github.com/Assaf1713) - [Assamee](https://github.com/Assamee) - [Astros Aradottir](https://github.com/AstrosAradottir) - [Athanasios Daratzikis](https://github.com/ics25026) - [Atharv Jadhav](https://github.com/atharv5167) - [Atharv Khare](https://github.com/1mystic8u) - [Neha Gautam] (https://github.com/nehagtm) - [Abdul Majid](https://github.com/abdulmajid124) - [Vlad M](https://github.com/mgnzee) - [Athulkrishna](https://github.com/AthulKrishna-736) - [AvAdiii](https://github.com/AvAdiii) - [Ava16](https://github.com/Ava16) - [Avatar](https://github.com/ayush1944) - [Ayananth](https://github.com/Ayananth) - [Ayisha Nasreen N](https://github.com/ayishanasreen828-sketch) - [Ayush Basak](https://github.com/AyushBasak001) - [Ayush Bundela](https://github.com/heyush79) - [Ayush Maurya](https://github.com/ayush3739) - [Ayush Sonone](https://github.com/TheCodingAyush) - [Babrah Ekele](https://github.com/bclaire92) - [Baha Odeh](https://github.com/StilettoDagger) - [Bahadir Kocabas](https://github.com/bahadirkoko) - [Balu Sunkavalli](https://github.com/BaluSunkavalli) - [Barath B](https://github.com/barathb2007) - [Barnavo Dey](https://github.com/barnavo05) - [Basma BT](https://github.com/Boutaib-Basma) - [Bastian Ibañez](https://github.com/bastianibanez) - [Behlool](https://github.com/BehloolKhan) Ben - [Ben Huotari](https://github.com/benhuotari) - [BennyJang](https://github.com/BennyJang) - [Bethu Sathwika](https://github.com/sathwikabethu) - [Bhagyalatha k](https://github.com/Bhagyalatha-k) - [Bhavesh Desale](https://github.com/bhaveshdesale) - [Bhavna Jain](https://github.com/bhavnajain1997) - [Bhupesh](https://github.com/Bhupi1306) - [Bibek Baram](https://portfolio.bibekbaram.com.np) - [Bill Lin](https://github.com/SeafoodproMax) - [Bird Dog](https://github.com/acuhlian) - [Bishal Paul](https://github.com/Bishal13102003) - [Blas Sanchez](https://github.com/xbsanpan855-boop) - [Bluefox192](https://github.com/Bluefox192) - [Bobrikus Smith](https://github.com/fairhair9) - [Bradley Leventhal](https://github.com/btleventhal) - [Brahmpreet Singh](https://github.com/Brahmpreett) - [Brandon B Bolivar](https://github.com/AvoBolivar) - [Brian Griffin](https://github.com/SolidUmbrella) - [Brian Luporini](https://github.com/bluporini) - [Bruno Costa](https://github.com/brunocosta-devlab) - [BuggyJames](https://github.com/u0-a19B) - [botken](https://github.com/botken) - [Balogun Toyeeb] (https://github.com/toyeeb3) - [C. Yin](https://github.com/cy-Yin) - [Caleb Rollf](https://github.com/lemonsloth) - [Cam](https://github.com/cameron-knowles) - [Capri Caviedes](https://github.com/caprivm) - [CaraMcG](https://github.com/caraMcG) - [Carburio](https://github.com/Carburio) - [Carina Mach](https://github.com/carinamach) - [Carlos FH](https://github.com/carlosfhz13) - [Cecex](https://github.com/Cecex-git) - [Vemmie] - [Begali] - [Chaimae](https://github.com/GRICHChaimae) - [Chamith Dilshan Tharuka](https://github.com/ChamithDilshanTharuka) - [Chamudika Yagabamunu](https://github.com/Chamudika31) - [Chandan Bhirud](https://github.com/chandanb778) - [Chang Liu](https://github.com/canyonliu8-code) - [Chemini Newanma](https://github.com/chemini244) - [Chen](https://github.com/flasheddy) - [Chenghou Si](https://github.com/ChenghouSi) - [Chethan harivansh]( https://github.com/chethuhari) - [Chirag Bimali](https://github.com/chirag-bimali) - [Chitla Jashwanth](https://github.com/jashwanth1128) - [Chitvan Singh](https://github.com/chitvan11) - [Choi Doyoun](https://github.com/justjs4evr) - [Chuzzwazza](https://github.com/chuzzwazza) - [Clara](https://github.com/Jayanthiclaretdevaraj) - [Claudio Muroni](https://github.com/claudio-muroni) - [ColorCode](https://github.com/benjaAguilar) - [Conor James](https://github.com/ConorsGitHub) - [CoreDumpNotCrash](https://github.com/CoreDumpNotCrash) - [CoventinaLachesis](github.com/CoventinaLachesis) - [Charul Nampalliwar](https://github.com/Charul2304) - [D.Nandi](https://github.com/Debraj2024) - [DHANUSH KUMAR A](https://github.com/dhansuhkumar) - [Daiwiik Harihar](https://github.com/daiv09) - [Daksh Gour](https://github.com/dakshgour) - [Dallin Hogenson](https://github.com/dhogenson) - [Dan Qiu](https://github.com/danqiu-dev) - [Danielynx](https://github.com/danielynx) - [Daniel Guo](https://github.com/DiiGii) - [Daniel Peralta](https://github.com/DDalta) - [Danilo Lanzi](https://github.com/danlanzi) - [Dante Perez](https://github.com/dapperdante) - [Danuja](https://github.com/DanujaNirodhana2003) - [Dao Duy Tin](https://github.com/duytin095) - [Dave Herr](https://github.com/dave-herr) - [Deekshith](https://github.com/Deekshith2485) - [Deep Timbaliya](https://github.com/deeptimbaliya) - [Demuliere Lucas](https://github.com/6zaille) - [Dev Goel](https://github.com/404Dev-notFound) - [Dev Goyal](https://github.com/DevGoyal9238) - [Devanshu](https://github.com/devanshu23bcs030) - [EndriuK](https://github.com/EndriuK) - [Devashish Gupta](https://github.com/sudo-verse) - [Devendra](https://github.com/devendrajadhav2470) - [Devesh Jain](https://github.com/jaindevesh144) - [Devi Patil](https://github.com/Devipatil) - [Devika Menon](https://github.com/DevikaaMenon) - [Dewanshu Sharma](https://github.com/dewanshu0311) - [Dhakshith S](https://github.com/Dhakshith) - [Dhanshree Patangrao](https://github.com/Dhanshree019) - [Dhanush M](https://github.com/Dhanush27m) - [Dhanush Shetty](https://github.com/dhanush-shetty1) - [Dhanush](https://github.com/imdhanukulkarni) - [Dharmin028](https://github.com/Dharmin028) - [Dhayanithi s r](https://github.com/its-dhaya) - [DhritiTS](https://github.com/DhritiTS) - [Dhruv Bansal](https://github.com/dhruvbansalup) - [Dhurv](https://github.com/DhruvMarulkar) - [Dhwaj Gupta](https://github.com/DG15062002) - [Kunal jaiswal](https://github.com/Kunall7890) - [Dhwanit Patel](https://github.com/dhwanit10) - [Dileep Munji](https://github.com/DileepMunji) - [DilekaSadaruwan](https://github.com/DilekaSadaruwan) - [Dimal Alagiyawanna](https://github.com/dimal-alagiyawanna) - [DimondO20](https://github.com/DimondO20) - [Dinith Kariyawasam](https://github.com/dinithrk) - [Will](https://github.com/CrimsonKarma44) - [Dinithi Gunathilake](https://github.com/Dinithi-Gunathilake) - [Disha520](https://github.com/Disha520) - [Divyam Pariyar](https://github.com/div-html) - [Divyom Srivastava](https://github.com/DivyomSrivastava) - [Diya Dharmendra](https://github.com/DiyaDSV) - [Diya Saharma](https://github.com/DiyadotSaha) - [Dogukan Aysan](https://github.com/dogukan-aysan) - [Dojeman1234](https://github.com/Dojeman123) - [Domenico Vecchio](https://github.com/domenico-vecchio) - [Dominic](https://github.com/mozz37) - [Dorcas Adebayor](https://github.com/dokipure) - [Douae Bousnane](https://github.com/douaebousnane13-del) - [Duo](https://github.com/NamingRacksMyBrain) - [Durai Mohandoss](https://github.com/22f1000821) - [Durjoy Kumar](https://github.com/DurjoyKumar177) - [Dustin Ober](https://github.com/dustinober1) - [Dzmitry Mukhin](https://github.com/divmone) - [EagleStrike33](https://github.com/EagleStrike33) - [Dylan Moore](https://github.com/dylanm3) - [EB](https://github.com/boranj) - [EM KalpaniEkanayake](https://github.com/Kalpiekanayake) - [EdVKu](https://github.com/EdVKu) Steve - [Edgar Justus](https://github.com/edgarjustus) - [Eduardo](https://github.com/Edd17369) - [EduBroilo](https://github.com/EduBroilo) - [Elías Hernández Rodríguez](https://github.com/EliasHdzR) - [Elif Ş.](https://github.com/elifsz) - [Elijah Weiss](https://github.com/eweiss4) - [Elijah](https://github.com/Elijah647) - [Elliooot](https://github.com/Elliooot) - [Emanuel Abou Samra](https://github.com/Mannolis) - [Emil Piesik](https://github.com/piesikot) - [Emrah Isović](https://github.com/EmrahIso) - [Erik-Heinzle00](https://github.com/Erik-Heinzle00) - [Erkan](https://github.com/erkcet) - [Esraa Kandil](https://github.com/esraa-k) - [Esteban Cortés Mora](https://github.com/eacortesm) - [Esther David](https://github.com/Esther484) - [Esi Abrokwa](https://github.com/Petrichor1204) - [ETAModder](https://github.com/ETAModder) - [Ettore Ciolli](https://github.com/ettoreciolli1) - [Evan Rhea](https://github.com/MegaSF) - [Ezra K](https://github.com/EzraKL) - [Farmata Kane](https://github.com/miiswom) - [Fathima Manal](https://github.com/FathimaManal) - [Farida Khaled](https://github.com/faridakhaled05) - [Fawaz Bello](https://github.com/Phawazz) - [Fedor Kupryakov](https://github.com/divohub) - [Fei Sun](https://github.com/Fei-Sun-1996) - [Felipe](https://github.com/Fredericrypto) - [Felipe Augusto](https://github.com/felipeaugustoap) - [Felipe](https://github.com/felipemv13) - [FloraPetit](https://github.com/PetitFlora) - [Forksxxs](https://github.com/Forksxxs) - [Frederick2313072](https://github.com/Frederick2313072) - [Fuad](https://github.com/code-fuad) - [Furkan Can](https://github.com/Furkancan2) - [GVE06](https://github.com/GVE06) - [Gabriel Augusto](https://github.com/gabrielaugusto23) - [Gabriel José](https://github.com/GabrielJnn) - [Gabriel McKay](https://github.com/Gobrielm) - [Gajji Chandu Yadav](https://github.com/AnandajithS) - [Galen Wang](https://github.com/galenhwang) - [Gali Alon](https://github.com/gali-alon) - [Ganesh karanam](https://github.com/Ganesh-Karanam) - [Gangireddy pavan](https://github.com/Gangireddypavan) - [Gaurang Dhanuka](https://github.com/Gaurang-101) - [Gaurav Mishra](https://github.com/gauravm03) - [Gaurav Singh](https://github.com/gauravsinghcodes) - [Geofou](https://github.com/geofou) - [Georgia Pennington](https://github.com/gpenn4) - [Gopinath S](https://github.com/Gopinath-2787) - [Gotchumon](https://github.com/Gotchumon) - [Gourav Pal](https://github.com/gouravp11) - [Gourav soni](https://github.com/mrgaurav81) - [Gui Jingzhao](https://github.com/PersianCat-tech) - [Guilherme Gomes](https://github.com/guilhermeGH900) - [Guna ](https://github.com/gunavardhan11) - [Gxelol](https://github.com/Gxelol) - [Gyan Prakash](https://github.com/Gyanprakash136) - [Gyanam Bhalgat](https://github.com/Gyanam1310) - [Harish Wargad](https://github.com/harishwargad) - [Haddadi Houcine](https://github.com/Houcine0x7) - [Hafsa Irfan](https://github.com/hafxa) - [HaidarAbbas](https://github.com/Haidarabbas731) - [Hamza Qureshi](https://github.com/hamzaq453) - [Hannan Nasim](https://github.com/Hannan-Nasim) - [Hanna Lozano](https://github.com/hannalozano) - [Hareen-Liyanage](https://github.com/Hareen-Liyanage) - [Harinee12](https://github.com/Harinee12) - [Harish Kumbar](https://github.com/river-bridge) - [Harsh Radadiya](https://github.com/Harsh0R) - [Harsh Verma](https://github.com/hv0911) - [Harsh Verma](https://github.com/twilight-debugger) - [Harsh-Langalia](https://github.com/harshlangalia007) - [Harsha](https://github.com/Harsha1849) - [Harshajith Dhahammina](https://github.com/harshajith04) - [Harshit Chauhan](https://github.com/harshitchauhann) - [Hahaysh](https://github.com/hahaysh) - [Hemaksh Sharma](https://github.com/Hemaksh69) - [Hemanth Kumar](https://github.com/h3manth-kumar) - [Hemendar](https://github.com/hemendar1) - [HemuTheReddy](https://github.com/HemuTheReddy) - [HieuThu16](https://github.com/HieuThu16) - [HiParham](https://github.com/hiparham) - Hgitdasl - [Yashvardhan](https://github.com/yashvardhancse) - [Hichem5](https://github.com/Hichem5) - [Hima](https://github.com/sasisathsarani5) - [Himanshu Kapure](https://github.com/Himanshu25kapure) - [Himanshu](https://github.com/Hima1234gh/) - [Hisham](https://github.com/sikehish) - [Hisu Kim](https://github.com/BGlifee) - [Hitesh Bhat](https://github.com/Bhat31/) - [Hmanaya](https://github.com/manayah199) - [HolmesMurillo](https://github.com/HolmesMurillo) - [Hugo](https://github.com/v4k3n) - [Husein](https://github.com/Husain206) - [Hyreen Matara](https://github.com/hyreen-web) - [I Kanapathipillai](https://github.com/KI-5/) - [IRONMAN DEV](https://github.com/IROTECHLAB/) - [Itay Ben Daniel](https://github.com/ItayBenDaniel) - [ITSMijaiL](https://github.com/ITSMijaiL) - [Aditi Thakare](https://github.com/aditithakare2004) - [Yau-20070205](https://github.com/Yau-20070205) - [Iam Pranav Yadav](https://github.com/pranav50227) - [Satish Yadav](https://github.com/Satish-yadav01) - [Ibrahim Oloyede](https://github.com/Mista-Log) - [Imanol57864](https://github.com/Imanol57864) - [Isaachbt](https://github.com/Isaachbt) - [Isha Singh](https://github.com/singhisha40) - [Ishaan C](https://github.com/Ishaan-C) - [Ishika Gupta](https://github.com/Ishika-guptaa25) - [isikoro1](https://github.com/isikoro1) - [Indu R](https://github.com/Indu34569) - [Ishita](https://github.com/elekish) - [Ivanich0](https://github.com/Ivanich0) - [Iweisc](https://github.com/Iweisc) - [Iyed Rabia](https://github.com/Iyed-Rb) - [Varshitha](https://github.com/dobbydobap) - [Jinnarajin] (https://github.com/jinnarajin) - [JASP-R](https://github.com/JASP-R) - [JBetz-Dev](https://github.com/JBetz-Dev) - [JJFJ](https://github.com/PugKing22) - [Jaanvi Chouhan](https://github.com/Jaanvichouhan34) - Janis J - [Jackie](https://github.com/PyXMR2025) - [Jackson Bichard](https://github.com/JacksonBichard) - [Jaideep Kalagara](https://github.com/jaideep-kalagara) - [Jake Aringo](https://github.com/kalix-pdf) - [James Athanasopoulos](https://github.com/athje001) - [James Fan](https://github.com/JamesXuFan) - [Jan Michael Sibug](https://github.com/akushilan) - [Janvi Chetan Patel](https://github.com/JanviChetanPatel) - [Jason Wang](https://github.com/Jiachenw399) - [Jason Wiggs](https://github.com/wiggs30) - [Jason Lee](https://github.com/DS-J-L) - [Jagjit Singh] (https://github.com/Jagjit790) - [Jasper Münzer](https://github.com/JasperKasp) - [Jayaditya Sahu](https://github.com/Jayadityas) - [Jayanth](https://github.com/MUNJETIJAYANTHKRISHNA) - [Jayesh Patil](https://github.com/JayeshPatil163) - [Jeeva m](https://github.com/jeevamahadevan16-igtm) - [Jeevan Raju](https://github.com/Jeevan-WPA) - [Jeevika R](https://github.com/jeevikar14) - [Jenish Dangol](https://github.com/Jenis980) - [Jennica Zheng](https://github.com/MikoJZ) - [Jeremiah Isaacson](https://github.com/jeremiahjordanisaacson) - [JeremiahyHenry3](https://github.com/JeremiahyHenry3) - [Jeremy Aguillon](https://github.com/jagui1) - [Jeremy Hodge](https://github.com/jdhodge88) - [Jeremy Matina](https://github.com/JeremyM07) - [JeshwanthILU31](https://github.com/JeshwanthILU31) - [Jesus Rey Gonzalez](https://github.com/jesusthecreator017) - [Jesús Martín](https://github.com/jesmarver) - [Jewel Geea George](https://github.com/) - [Jiaqi Fan](https://github.com/jiaqifan42) - [Jingyi Lu](https://github.com/lulu61000) - [Joaquin D](https://github.com/Joaco273) - [Joe Rawnsley](https://github.com/joerawnsley) - [Juan Espinosa](https://github.com/juanEspinosa-design) - [Joel Singh](https:/github.com/Joel-Singh) - [Joey Grengs](https://github.com/papajpg) - [Johan](https://github.com/Johan621) - [Arjun](https://github.com/WALKMAN303) - [Johanna Mihi](https://github.com/23f2004058) - [Miruthul N V](https://github.com/23f2002007) - [John Dennehy] (https://github.com/JohnDennehy101) - [Vitali K](https://github.com/captainvita) - [John Maar](https://github.com/JTylM) - [John Mixon](https://github.com/mixdev2112) - [Johnathon Sperandio](https://github.com/Johnathon-Sperandio) - [Jonatan Rosali](https://github.com/JonatanRosali) - [Jordan Wels](https://github.com/Jwels1) - [Jorge Araya](https://github.com/jorgearayac) - [Josafat Duarte - JD1975](https://github.com/JD1975) - [Jose Rios](https://github.com/josel006) - [Jose Soto](https://github.com/jossotriv) - [Joshna Jojo](https://github.com/joshnajojo12) - [Joshua Hans](https://github.com/joshhans21) - [José Kahl](https://github.com/jskahl) - [Jothika Aravindhan](https://github.com/jothikaaravindhan) - [João Otávio Schonarth](https://github.com/joschonarth) - [Jp Shively](https://github.com/jpshively0) - [Juan Botha](https://github.com/jbotha-sketch) - [Juan Torres](https://github.com/JuanTorres93) - [Juanes](https://github.com/juanes20027) - [Indranil Roy](https://github.com/nilreflects) - [KARUNYA](https://github.com/BonitoFlakes-afk) - [KG](https://github.com/kgoel9899) - [KHAWAJA BABAR NASEER](https://github.com/khawajaacode) - [KMSDINESH](https://github.com/KMSDINESH) - [Kaitlyn](https://github.com/KaitlynShort) - [Kai Krah](https://github.com/KaiKrah79) - [Kaito15](https://github.com/Kaito387) - [Kajal Ahirwar](https://github.com/Kajal-Ahirwar) - [Kallappa Kabboor](https://github.com/Kallappa2005) - [Kalpana Rajyam](https://github.com/Kalpana1234-ui) - [Kamakshi](https://github.com/kamakshipal1-tech) - [Kamalakannan Srinivasan](https://github.com/kamalbalaji83) - [Kamran Kausher]( https://github.com/kamrankausher) - [Kamba-netizen](https://github.com/Kamba-netizen) - [Kapil Kumar](https://github.com/kapilkumar05991) - [Karim_Mohamed](https://github.com/KarimAlkabily) - [Karri Saiphani Reddy](https://github.com/Saiphani1022) - [Kartik Yadav](https://github.com/kartik912) - [Karthik Sai](https://github.com/KarthikSai08) - [Karuna Gawai](https://github.com/zero-one1) - [Kassahun F](https://github.com/Kas1398) - [katicyan](https://github.com/katicyan) - [Kaushal Vaid](https://github.com/Kaushal00Vaid) - [Kaustubh Chaturvedi](https://github.com/Kaus-16) - [Kaustubh Singh](https://github.com/KaustubhSingh9000) - [Kavana Ganesh](https://github.com/KavanaGanesh-dev) - [Kandepu Naga Venkata Manideep](https://github.com/manideep-777) - [Kannan Ramaswamy](https://github.com/lkannan) - [Kang Chenghua](https://github.com/chenghuakang) - [KavindiD](https://github.com/KavindiD) - [Kavish Pal Singh](https://github.com/23f2005144) Rongxin Zhang - [Rio](https://github.com/PhoNoodles) - [Kavoshnik](https://github.com/kavoshnik) - [Kavya Vadla](https://github.com/kvadla06) - [Kayla Cox](https://github.com/RenWoman) - [Keepas3](https://github.com/Keepas3) - [Keerthana-R](https://github.com/Kee1112) - [Keith Kaplan](https://github.com/darthkeith) - [Kevin Kimathi](https://github.com/muneneee) - [Kevin Wang](https://github.com/KevinWangHP) - [Kento Akiyama](https://github.com/Kento103) - [Khushhal Singh](https://github.com/Meatix) - [Kingsley Sarkodie](https://github.com/JoeBuydemDips) - [Kishita Deotale](https://github.com/kishitadeotale24) - [Kjohnbaba](https://github.com/kjohnbaba) - [Kondaka Bhargavi](https://github.com/bhargavikondaka) - [KrimPast](https://github.com/KrimPast) - [Krishan Kumar Singh](https://github.com/Krishan131) - [Krishna-Raj](https://github.com/krishna-stone) - [Kumar Sujal](https://github.com/SuperiorSU) - [Kushal Chavan](https://github.com/Kushalchavan) - [Kushal Obroy](https://github.com/Kushalobroy) - [Kushal V Achar](https://github.com/kushalvachar2006) - [Kyle Boo](https://github.com/bookang869) - [kir-an-n](https://github.com/kir-an-n) - [Lakan](https://github.com/Jayadityas) - [Lakshigan Jeyanth](https://github.com/Jeyanth3) - [Lalit Mahajan](https://github.com/lalitmahajn) - [Lam Tung Dang](https://github.com/BitOfForest) - [Larson](https://github.com/lixianphy) - [Laura Vazquez](https://github.com/lauravazquezp) - [Lavanya B Y](https://github.com/lavanya23-8) - [Leo Xu](https://github.com/LeoXu8) - [Likhith S Gowda](https://github.com/Likhi2005) - [Lily](https://github.com/lilypandey) - [Liquuid1](https://github.com/Liquuid1) - [LiuSam](https://www.youtube.com/CommitKU) - [Loey](https://github.com/loey1923) - [Lohith Arcot](https://github.com/LohithArcot) - [Lohith Sai](https://github.com/lohith11) - [Loic Hounyovi](https://github.com/mechakc) - [LokashakthivelSP](https://github.com/lokashakthivel-sp) - [LoongSir-ME](https://github.com/LoongSir-ME) - [laumaxim](https://github.com/laumaxim) - [LostChyld](https://github.com/dragonsewist/) - [Lottie Judge](https://github.com/lottiejudge-source) - [Louwrens Költzow](https://github.com/KoltzowLJ) - [Loyd Ngei](https://github.com/LoydNgei) - [Luan Lessa](https://github.com/LuanLessa) - [Lucas Couso Antunes](https://github.com/Rulyns) - [Lucas Verissimo](https://github.com/LucasVer17) - [Lucas-Hayes](https://github.com/hayeslucas128-cmyk) - [LuckyGautam](https://github.com/LuckyG05) - [Luigi Moro Turina](https://github.com/LuigiMTurina) - [Luiz Augusto](https://github.com/Luizxdas) - [Luisa Rincon](https://github.com/lufe089) - [Luka](https://github.com/LukachuPro88) - [Luke Eades](https://github.com/LukeEades) - [LLLmml](https://github.com/lllmml) - [M. Umasree](https://www.linkedin.com/in/umasree-mandla-231862349) - [M. Valentino](https://github.com/MarinoValentino) - [MACantara](https://github.com/MACantara) - [MC_CLINT](https://github.com/MC-CLINT) - [maaz](https://github.com/syed-mohammed-maaz) - [Madhav Singh](https://github.com/maddy710) - [Madhusudhanan](https://github.com/Madhu192005) - [Muhammad Faisal](https://github.com/Muhammad-Faisal-FTA) - [Magonborn](https://github.com/MagonBorn) - [Mahanthesh S](https://github.com/Mahi2708) - [Mahdi Es](https://github.com/xNIGMAx) - [Mahesh M](https://github.com/chlorophyllus) - [Mahip Kaushal](https://github.com/Mahipkaushal) - [Mahmud Yusifli](https://github.com/mahmudyusifli) - [Majit Mambetzhumayev](https://github.com/majitmambetzhumayev) - [Malu Paes](https://github.com/MaaLuu21) - [Malvin-sehmaluva-Machingura](https://github.com/sehmaluva) - [Manjeet Singh](https://github.com/manjeetsingh78) - [Manny Lazalde](https://github.com/mannylazalde) - [Manohara](https://github.com/Manohara-Ai) - [Manvith Kumar Ullal](https://github.com/Manvith-kumar16) - [Marcel Nguemnin](https://github.com/mnguemnin) - [Marco Biaggi](https://github.com/mafpbiaggi) - [Mario Sanchez](https://github.com/mcn22) - [Mariusz Jasko](https://github.com/Marjo185) - [Mariusz Sobczak](https://github.com/SmoQ) - [Mark](https://github.com/markferritto) - [Marko Radojevic](https://github.com/Marko3764) - [Marlene Davids](https://github.com/marls79) - [Marta Maia](https://github.com/martadmaia) - [Martin Chen](https://github.com/Shiyuan-Chen-17) - [Marton Otvos](https://github.com/MartonOtvos) - [Maruthi S](https://github.com/JSMaruthi) - [Mary Lavanitha](https://github.com/lavanitha) - [Masalt0](https://github.com/Masalto5835) - [Mauro Coria](https://github.com/Oolazile) - [Max](https://github.com/max1ab) - [Mayank Ghildiyal](https://github.com/mayank2699) - [Mayur H. Marvaniya](https://github.com/Mayur6720) - [MayurHedau](https://github.com/mayurdweek) - [Mayuresh Thorve](https://github.com/Mayurroro) - [Md Abdullah Al Amin Khan](https://github.com/mdabdullahalaminkhan) - [Md Najrul Ansari](https://github.com/najru01) - [Md. Mehadi Hassan](https://github.com/Mehadii-Hassan) - [Meg Hiatt](https://github.com/hiatt8649) - [Mehdi Yanat](https://github.com/Mehdi-Yanat) - [Mehedi Hasan Hridoy](https://github.com/mehedi-hridoy) - [Menschenkind](https://github.com/menschenkind) - [Merlin Dust](https://github.com/DustMerlin) - [Mesh Bright](https://github.com/MeshBright) - [Michael B.](https://github.com/mbyrd3) - [Michael Baker](https://github.com/promptmike) - [Michael](https://github.com/LucidWinter) - [Midhun Ramesh](https://github.com/midhun-1717) - [Midlaj](https://github.com/midlajdev) - [Miguel Hernandez](https://github.com/mangel-mhdez) - [Mika](https://github.com/mihirK5) - [Joshua Chikosha](https://github.com/joshuachikosha) - [Milhane](https://github.com/chmilhane) - [Minlish-Git](https://github.com/Minlish-Git) - [Mithielesh N](https://github.com/mithielesh05) - [Mithun Mohandas(https://github.com/mithunmohandas) - [Mithun Srinivas](https://github.com/MithunSrinivas28) - [Miwa Dharod](https://github.com/miwadharod17) - [Mizaan Ur Rehman](https://github.com/miz2) * [Oleksandr Perian](https://github.com/oleksandrperian-commits) - [Mohamed Anes](https://github.com/Mohamed-Anes) - [Mohamed Salih](https://github.com/mohamedsalihva) - [Mohamed](https://github.com/momo70139) - [Mohammad Ali](https://github.com/md-ali-0) - [Mohammed Munaaf](https://github.com/MohammedMunaaf) - [Mohammed Saqib Rehaman Namzi](https://github.com/md-saqib001) - [Mohd Rayyan Lulaniya](https://github.com/Rayyan-101) - [Moiie](https://github.cim/Moiie) - [Monika R](https://github.com/monika-r9363) - [Momina Fatima](https://github.com/mominaaa0) - [Moulidhar](https://github.com/MoulidharC) - [Mradanshi Sahu](https://github.com/mradanshi) - [Mridul Narain](https://github.com/narainmridul) - [Mrityunjay Sahani](https://github.com/mritunjaysahani) - [Mrunal Jadhav](https://github.com/mrunaljadhav) - [Jeet Jawale](https://github.com/jeetjawale) - [Mudipelly Shiva](https://github.com/shivamudipelly) - [Muhammad Ali](https://github.com/Sudo-Ali-Dev) - [Muhammad Ayyub](https://github.com/devmab24) - [Muhammad P](https://github.com/mopy7) - [Muhammad Raza](https://github.com/RazaJavaid2004) - [Muhammad Taha Nadeem](https://github.com/Taha-Nadeem-7) - [Muhammad Zakaria](https://github.com/zakk616) - [Muhammed Shareef](https://github.com/shareefmx) - [Nishk Mistry](https://github.com/nishkmistry) - [Vansh Agarwal](https://github.com/vansh-agarwal) - [Mumin](https://github.com/m6min) - [Muntazir-Sayed](https://github.com/Muntazir-sd) - [Mushfiqur Rahman](https://github.com/Mushfiqur719) - [Muttu Bhjantri](https://github.com/muttuhb98-n) - [Mwiza Sichinga](https://github.com/Munyuam/) - [NIKHIL GAJULA](https://github.com/nikhil07g) - [NabilMch](https://github.com/NabilMch) - [Rohan Darandale](https://github.com/rohandarandale1144) - [Nabil Mutawakkil Qisthi](https://github.com/NabilMQ) - [Nacho](https://github.com/100550759-commits) - [Naga Teja](https://github.com/invariantfields) - [Nagaraj](https://github.com/Nagaraj335) - [Nandita Chakka](https://github.com/nanditachk) - [Naoto Abe](https://github.com/otoaneba) - [Narra-Jaswanth](https://github.com/Narra-Jaswanth) - [Hikhil Thomas](https://github.com/hikhilthomas) - [Nasrul](https://github.com/nnayz) - [NathanES](https://github.com/nathanES) - [Natpu Enean](https://github.com/NatpuEnean) - [Naveen C](https://github.com/naveench98) - [Naveen Kumar](https://github.com/naveenkumarr1812) - [Nayonika Agarwal](https://github.com/nayonika04) - [Neel Kumar](https://github.com/neelkumar01) - [Neha Bajaj](https://github.com/bajajneha27) - [Newton Yetsedaw](https://github.com/NewtonY-dev) - [Ngamize Philbert](https://github.com/nik-p12) - [Nguyễn Duy Bảo](https://github.com/nguyenduybao1) - [Nicolas Betancur](https://github.com/nicobe20) - [Nicolas Lizarazo](https://github.com/nicolas-lizarazo) - [Nicolas Cuastumal](https://github.com/NicolasCuastumalCordoba) - [NihadVeliyev](https://github.com/NihadVeliyev) - [Nihindu Dinujaya](https://github.com/nihindu05) - [Nikhil](https://github.com/NikhilKummari) - [Nikhil](https://github.com/Nothinormuch) - [Nimisha](https://github.com/codehusler14) - [Ningegowda](https://github.com/ningegowda) - [Niraj Mahajan](https://github.com/niraj-mx07) - [Nirbhay Bawankule](https://github.com/NirbhayBawankule) - [Nischal Binil](https://github.com/cinnamonMuffin) - [Nishant Tiwari](https://github.com/Nishant-2608) - [Nishant K Joshyabhatla](https://github.com/nishantkj911) - [Nishant khatri](https://github.com/nishant-khatri17) - [Nishant kumar](https://github.com/nishantraj06) - [Nithika Bandara](https://github.com/NithikaNB) - [Nithin.B](https://github.com/NITHIN-2006) - [Nitin Kumar](https://github.com/nitin-kumar-code) - [Nn Morishita](https://github.com/nn-morishita) - [NoMathematician1729](https://github.com/noMathematician1729) - [Vijaya Nandana](https://github.com/vijayanandana25) - [Noah Kim](https://github.com/gratisreise) - [Nowshin Arony](https://github.com/nowshinarony) - [Nur Islam](https://github.com/nurislam243) - [Nyoman Kusuma](https://github.com/knyoman) - [Vijay Joshi](https://github.com/VijayJoshi17) - [OCHWO DAVID](https://github.com/DaveOch-sudo) - [OTTOGALLI Tristan](https://github.com/ottogalli-tristan) - [Olapu Ajay](https://github.com/olapuajay) - [Olga Torok](https://github.com/OlgaTorok) - [Oliyad Zelalem](https://github.com/ozimmortal) - [Om Bukkawar](https://github.com/omBukkawar) - [Omar Mostafa](https://github.com/omarkamola) - [Omkar Ala](https://github.com/omkarala) - [Omkar Gurav](https://github.com/OmkarGurav1) - [OmkarS](https://github.com/omkar402) - [Omm Prakash Nayak](https://github.com/bithal2006) - [Ong TX](https://github.com/AlexanderXI0904) - [OsamaShabih](https://github.com/osamashabih6960) - [Osinachi Chukwujama](https://github.com/vicradon) - [Osman Kaplan](https://github.com/kplnosmn94-droid) - [Ossama Nahle](https://github.com/ossamanahle) - [Otavio Góes](https://github.com/ogoess1999) - [Ozan Kenan Güngör](https://github.com/ozankenangungor) - [Paanipoorie](https://github.com/paanipoorie) - [P-nishant](https://github.com/P-nishant) - [Pablo Hermun](https://github.com/PabloHermun) - [Pablo Souza](https://github.com/pablohsouza09) - [Paige Li](https://github.com/itspaigenli) - [PanBurz](https://github.com/PanBurz) - [Panagiotis Tsomp](https://github.com/PanosTsomp) - [Panos L](https://github.com/PLCodingStuff) - [Pantkartik](https://github.com/Pantkartik) - [Paras Parte](https://github.com/parasparte12) - [Paras](https://github.com/ParasSalonia) - [Patrick Araujo](https://github.com/PkLavc) - [Patrick Poon](https://github.com/PatrickPoon-dev) - [Paula Amorim](https://github.com/paulamori) - [Paul Henry Atienza](https://github.com/phatienza/) - [Sprtschk](https://github.com/sprt-schk/) - [Pavan kuppili](https://github.com/PavanKuppili) - [Pavani Ganti](https://github.com/Pavani23ios) - [Pavani](https://github.com/pavani42) - [Pavel Shegay](https://github.com/pavelshegay3) - [Pedro Chame](https://github.com/pedrochame) - [pessimismandvinegar](https://github.com/pessimismandvinegar) - Rohinish Ram - [Peter Imoh Victor](https://github.com/peterimoh) - [Pia Yeah](https://github.com/piagildehaus) - [Piotr Wrzosek](https://github.com/pwrzosek) - [Pooja](https://github.com/poojasounder) - [Oleksandr Perian](https://github.com/oleksandrperian-cpu)s - [Pouya Esfahani](https://github.com/Pooyash1998) - [Prabveer Bakshi](https://github.com/prabneer08) - [Prachi Pandey](https://github.com/prachi-pandey-13) - [Pradeep Reddy](https://github.com/Pradeep0997) - [Pragati Priya](https://github.com/pragati-2004) - [Prajaka Jagdale](https://github.com/Hermione28) - [Prakhar Tripathi](https://github.com/prakhart07) - [Prakkhar](https://github.com/prktypes) - [Pramod Dhungana](https://github.com/dhunganapramod9) - [Pranav Anandarao](https://github.com/pranandarao) - [Pranjali Dhere](https://github.com/Pranjali2005) - [Prarthana D](https://github.com/prarthana711) - [Prasann62](https://github.com/Prasann62) - [Prashant Singh](https://github.com/prashantsingh1122) - [Prasiddhi](https://github.com/Prasiddhi26) - [Pratham Chavhan](https://github.com/prathamchavhan) - [Pratham Debnath](https://github.com/isthatpratham) - [Pratham Muley](https://github.com/Pratham19106) - [Prathamesh Kulkarni](https://github.com/prathamk11) - [Praveen Gupta](https://github.com/Praveen-0k9) - [Praveen Kayala](https://github.com/Praveen6-kms) - [Preethika R](https://github.com/Preethika-rj) - [Praveer Ranjan Singh](https://github.com/PRAVEERRANJANSINGH) - [Pravien Powel](https://github.com/PravienPowel) - [Prisha Jaiswal](https://github.com/prishajaiswal75) - [Priya Shah](https://github.com/priiyoCoding) - [Priyam Manna](https://github.com/priyam-that) - [Priyanka Mali](https://github.com/priyanka1885) - [Priyansh Verma](https://github.com/PriyanshV10) - [Priyanshu Kumar Pandey](https://github.com/chefcookscode) - [Priyabrata Senapati](https://github.com/ranaiiest) - [Pro Kumar](https://github.com/pkumar2143) - [Purushothaman R](https://github.com/purushothaman-web) - [Pygame17](https://github.com/Pygame17) - [pzb5471](https://github.com/pzb5471) - [Qilong Zhang](https://github.com/hrtdream) - [QingKong996](https://github.com/QingKong996) - [Quisim Bryant](https://github.com/quisimbryant) - [Rajeswari Rongali](https://github.com/rajeswarirongali23) - [Ram](https://github.com/ratech-dev) - [Rossen Lin](https://github.com/Rossen27) - [R.M.S.S.Kumara](https://github.com/SajithK203) - [RISHAD ROSHAN](https://github.com/rishadroshanpt) - [RSM Harsha](https://github.com/rsmharsha) - [Rachel Hart](https://github.com/rachelmayhart/) - [Rafael Hernandez](https://github.com/rafawashere) - [Rafael Rodrigues](https://github.com/rafaelrodrigues-dev) - [Rafael Veloso](https://github.com/Rafaellinos) - [Raghav](https://github.com/Raghav9871) - [Rahul Keswani](https://github.com/rahulkeswani010) - [Rahul Kulasooriya](https://github.com/rahul-kenula) - [Rahul.knprdy](https://github.com/Rahulab-ux) - [RahulKrishna145](https://github.com/RahulKrishna145) - [Rahul Varadaraju](https://github.com/Rahulv024) - [Karunakar kalvala](https://github.com/karnnaa) - [Rajasri Kuchana](https://github.com/Rajasrikuchana) - [Ralph Merhi](https://github.com/ralph1233) - [Ram S](https://github.com/RamSamudrala05) - [Raman Nazarov](https://github.com/PAUSED8826) - [Nicholas Sobchak](https://github.com/NicholasSobchak) - [Ramesh Mummina](https://github.com/rameshmummina7) - [RanZhang](https://github.com/rannnnn037) - [Rashmi Apagundi](https://github.com/Rashmi-apagundi) - [Raunak katiyar2](https://github.com/raunak-bigdp) - [Raunak katiyar](https://github.com/raunak-bigdp) - [Ravi Raj Choudhary](https://github.com/ravirajchoudhary03) - [Razano](https://github.com/Razano26/) - [Rein Ding](https://github.com/ReinDing) - [Reynhard](https://github.com/reybui) - [Sebastian Delgado](https://github.com/sdelgado08) - [Ricardo Pinto](https://github.com/ricardobigote) - [Ricardo Takara](https://github.com/tiedmud) - [Richard Ochola](https://github.com/ochola-rich) - [Riddhima Biswas](https://github.com/RiddhimaBiswas) - [Rinushan ](https://github.com/2003Rinushan) - [Rishika](https://github.com/RISHIKA-A-S) - [Rishitha Pachigolla](https://github.com/Rishithamanasa) - [Rithik Puthiyedath](https://github.com/Rithik149) - [Ritika Garg](https://github.com/ritikagarg0326) - [RitwikReddy](https://github.com/RitwikReddyAerla) - [Rizky-Amand](https://github.com/rzky21amanda-prog) - [Robert Davis](https://github.com/robertdavis) - [Robiya](https://github.com/rhakim24) - [Rohit Sharma](https://github.com/rohitt-sharma96) - [Rollins Sean](https://github.com/Skaffloc) - [Ronak](https://github.com/roonakyadav) - [Ronik Kumbhar](https://github.com/ronik62) - [Roshan Jha](https://github.com/rosh-py) - [Roshan Kumar](https://github.com/roshan-zest) - [RubenDev25](https://github.com/RubenDev25) - [Ruben Garcia](https://github.com/rgarcr) - [Rudra](https://github.com/Rudra-cryptx) - [Ruti](https://github.com/rutibergs) - [Ryan Fernando](https://github.com/RyanJFM) - [Ryan Gapp](https://github.com/ryan-gapp) - [Ryan M](https://github.com/rmoylan2201) - [Ryan McHenry](https://github.com/rzhalsa) - [RyukR1](https://github.com/RyukR1) - [S Hajare](https://github.com/swapnil-s-h) - [S-Dedeepya](https://github.com/S-Dedeepya) - [SImarjeet Singh Johar](https://github.comSimarjeeSinghJohar) - [SWanHK](https://github.com/swanhk) - [Saksham Tyagi](https://github.com/iam-saksham-tyagi) - [sachin](https://github.com/sachin) - [Sachin vk](https://github.com/sachindasvk) - [Kyrillos Hamdy Nassif Hunein](https://github.com/KyrillosHamdy) - [Sachin](https://github.com/sachinkashi21) - [Sagar Tayde](https://github.com/sagartaydedev) - [Sahar Mahmoudi](https://github.com/saharmahmoudi) - [Sahil Ghag](https://github.com/Sahilghagg) - [Sahil Sharma](https://github.com/sahil-me) -[Sathyashreekv] (https://github.com/sathyashreekv) - [Said Berk](https://github.com/saidberk27) - [Saideepthi](https://github.com/Saideepthi04) - [Saif Kayyali](https://github.com/Skayyali3) - [Sal Adrian](https://github.com/Sal-Adrian) - [Samia-sh](https://github.com/samia-code0) - [Samuel Wright](samw46) - [Samuel Rodriguez Solarte](https://github.com/samrodri911) - [Sanal Kumar](https://github.com/sanalkr) - [Sandeep Kumar](https://github.com/sandeep-sk) - [Sandeepa Induwara Samaranayake](https://github.com/SandeepaInduwaraSamaranayake) - [Sandeep s](https://github.com/SandeeepS) - [Sandhya R](https://github.com/sandhya13r) - [Sandun](https://github.com/sandun-kodi) - [Sangini Tripathi](https://github.com/Sangini-spec) - [Sanjana J Athreya](https://github.com/sanjanajathreya/) - [Sanskar Agarwal](https://github.com/sanskaragarwal001) - [Santosh Chakradhar](https://github.com/santoshchakradhar1) - [Sanuthi Liyasika](https://github.com/Sanuthi50) - [Saqlain Sultan](https://github.com/saqlain991) - [Saron Pal](https://github.com/Saronpal) - [Sarvesh](https://github.com/Sarvesh668) - [Satheem Muwaffaq](https://github.com/satheem) - [Sathsarani](https://github.com/SathsaraniJA) - [Satish Chawali](https://github.com/satishchawali) - [Saurav Sharma](https://github.com/saurav0369) - [Savindya Thathsarani](https://github.com/Savindya322) - [Sebastián Armas](https://github.com/Sebas-Armas) - [Sejal Mukane](https://github.com/SejalMukane) - [SelvaMiru](https://github.com/SelvaMiru) - [Seok-jun Kang](https://github.com/KSJ27) - [Seth Chamola](https://github.com/Mystic-Chamola) - [Seul](https://github.com/seulahn) - [ShahabKiyani](https://github.com/shahabKiyani) - [Shahar Yosef](https://github.com/shaharyosef) - [Shahid Malik](https://github.com/SHAHID-glitch) - [ShaiQ Shah](https://github.com/shahshaiq) - [Shaj2311](https://github.com/Shaj2311) - [Shakthi Lakshmanan V](https://github.com/Shakthi-lakshmanan-2006) - [Shalu Tiwari](https://github.com/tshalu63) - [Shamil T P](https://github.com/shamil-tp) - [Shantanu Dhane](https://github.com/Dev-Santo44) - [Shanyu](https://github.com/shanyuin) - [Sharad vyas](https://github.com/sharadvyas123) - [Sharath Chandhan](https://github.com/sharath0x) - [Sharienne] (https://github.com/Sharienn-e) - [Shariq Naseem](https://github.com/muhammadshariq0007) - [Sharyu Patil](http://github.com/Sharyupatil01) - [Shaswat Raj](https://github.com/sh20raj) - [Sheeba S](https://github.com/SheebaSalaman) - [Sheldon Fam](https://github.com/SheldonFam) - [Sherrinford](https://github.com/Sherlinford) - [Sherry](https://github.com/zsylllike-sketch) - [Shiv Raj Singh](https://github.com/imuniqueshiv) - [Shiva](https://github.com/sh1vananda) [sizi.blue](https://github.com/simiz13) - [Shivam](https://github.com/ShivamJhaXXIII) - [Shivansh Gupta](https://github.com/Krish1022sona) - [Shlok Gupta](https://github.com/LogicHymn) - [Shozab Ali Nasir](https://github.com/shozabali06) - [Shreecharana](https://github.com/Shreecharana24) - [Shrinivas Narhare](https://github.com/shrinivas9606) - [Shriram Selvam](https://github.com/ShriramSelvam) - [Shriya Mohanty](https://github.com/shriya5752) - [Shruti Chadda](https://github.com/Shruti-chadda) - [Shubham Gaingade](https://github.com/shubham-gaingade) - [Shubham Prasad](https://github.com/prsdx) - [ShubhamK](https://github.com/Shubham91999) - [Sid-5137](https://github.com/Sid-5137) - [Siddharth Pandey](https://github.com/siddharthpandey2211) - [Siddu-samuel](https://github.com/Siddu-samuel) - [Simon Duke](https://github.com/spsdrocks) - [Siriuswyc](https://github.com/Siriuswyc) - [SisterMorphine](https://github.com/SisterMorphine) - [Sivani Kumar](https://github.com/Sivani-kn) - [Slreyes](https://github.com/slreyes0120) - [Smesi36](https://github.com/smesi36) - [Sohail](https://github.com/sohail78692) - [Soham Das](https://github.com/SohamDas1502) - [Soham Patil](https://github.com/Soham-1616) - [Solomon-Prem-Sinai](https://github.com/solomon-2105) - [SpaceNinja-007](https://github.com/SpaceNinja-007) - [Sfisnb Yu](https://github.com/Sfisnb) - [Sourabh Gupta](https://github.com/srb1998) - [Spencer Irving](https://github.com/spencerirving) - [Srajan Gupta](https://github.com/srajang1805) - [Sridhar S](https://github.com/sridhar-sri-s) - [Sridhar-EEE](https://github.com/sridhar-eee/) - [Sriram Chowdary Vundavalli](https://github.com/sriramchow) - [Sriteja01](https://github.com/Sriteja01) - [Stephen Ng](https://github.com/snust) - [Steve Coghill](https://github.com/BriarSMC) - [Subhajit Sarkar](https://github.com/Subhajit281) - [Subin Kumar](https://github.com/Subinkumar077) - [Suchi Shukla](https://github.com/Suchi1905) - [Suchit](https://github.com/suchit-hirani-python-ak) - [Sudarshan Dongre](https://github.com/SudWasatch) - [Sudi Williams](https://github.com/sudi-W) - [Sujal](https://github.com/sujaldarji) - [Sujanprasad](https://github.com/Sujanprasad) - [Sully](https://github.com/iamsully) - [Sumaiya Akter Runa](https://www.linkedin.com/in/sumaiya-akter-runa-69b8b624a/) - [Sumer](https://github.com/SumerSabharwal) - [Sumit Mishra](https://github.com/SumitM01) - [Sunil](https://github.com/Sunil0620) - [SungHo.You](https://github.com/hahaysh) - [Suraj Kumar Singh Tamni san](https://github.com/sono-mono) - [Sushit Lal Pakrashy](https://github.com/Sushit-prog) - [Sushka_s_makom](https://github.com/Sushka_s_makom) - [Sushmitha](https://github.com/Sushmigit) - [SutripatNew](https://github.com/SutripatNew) - [Suvani Basnet](https://github.com/suvani-ctrl) - [Swapna S](https://github.com/swapcodes) - [Swati Pandey](https://github.com/gr8swati) - [Syed Rahil Hussain](https://github.com/Syed-srh) - [Sylvain L](https://github.com/sylvain-lec) - [Syam Jalla](https://github.com/SyamJalla) - [Joshua Peter](https://github.com/joshuapetertolu) - [TAHER EL Mehdi](https://github.com/taher-el-mehdi) - [Dhanush Kumar M](https://github.com/Dhanush-max) - [TOK7O](https://github.com/TOK7O) - [Tabrez Ahamed](https://github.com/Tabrezz3) - [Takashi.Takehana](https://github.com/FRAGILE-8460) - [Talaptan Alikhan](https://github.com/alihnwx) - [Tamal Majumdar](https://github.com/Tom-1508) - [Tangang Mc Bride](https://github.com/TangangMcBride) - [Tanmai Thakre](https://github.com/Tanmai-Thakre) - [Tanush Bhootra](https://github.com/Tanush576) - [Tanveer Pasha S](https://github.com/TanveerpashaS) - [Teena Goyal](https://github.com/teenagoyal21) - [Tej M Bhat](https://github.com/TejBhat) - Salma - [Teja Chalikanti](https://github.com/tchalikanti1705) - [Tejas Jogdand](https://github.com/Tejas-Jogdand) - [Temhemc](https://github.com/temhemc) - [Teng-Hui Huang](https://github.com/hui811116) - [That1LinuxGuy](https://github.com/That1LinuxGuy) - [TheKerbonaut](https://github.com/thekerbonaut) - [Theertha](https://github.com/23f3003994) - [Thejus Kannoth](https://github.com/ThejusKannoth) - [Thisum Dantdhanarayana](https://github.com/thisum-dev) - [Thoka Harini](https://github.com/thokaharini24) - [Thomas Kim](https://github.com/thwmskm) - [Tiago Lima](https://github.com/TiagooLima) - [Tiancheng Xing](https://github.com/JackXing875) - [Titus Tarcsai](https://github.com/Titusz87) - [Tongdaoxiaye](https://github.com/Tongdaoxiaye) - [Tony Wong](https://github.com/tony31913) - [Tracey Dingman](https://github.com/tdingman422) - [Trevor Tippery](https://github.com/trevortippery) - [Trishna](https://github.com/trishna2105) - [Tai Fong](https://github.com/taifong) - [Trần Huỳnh Đăng Khôi](https://github.com/KhoiTarn) - [Tushar Balakrishnan](https://github.com/iamtusharbala) - [Tushar Moolya](https://github.com/tushiar) - [Tushar Qwerty](https://github.com/tushar743-ui) - [Tushar Vimalbhai Patel](https://github.com/tushar-patel28) - [Tushar Rampurkar](https://github.com/Gitnerd77) - [Tyler Westbrook](https://github.com/Iisyourdad) - - [RashiBista](https://github.com/RashiBista) - [U Shivakumar](https://github.com/Shivakumarsullagaddi) - [Umed Kumar](https://github.com/UmedKumar) - [Unigmos](https://github.com/Unigmos) - [UsrRed](https://github.com/UsrRed) - [Utkarsh Doras](https://github.com/UtkarshKD) - [Utkarsh Gupta](https://github.com/utkarshgupta188) - [Utkrist](https://github.com/CloudFlamedev) - [Vaidehi Patel](https://github.com/Vaidehi106) - [V K Suvetha](https://github.com/vksuvetha) - [Vaibhav Hample](https://github.com/Vaibhav-rgb45) - [Vaibhav Verma](https://github.com/joinvaibhav) - [Vaibhaw Kumar Parashar](https://github.com/TheVaibhaw) - [Vaishnavi KN](https://github.com/Vaishnavi-KN) - [Vaishnavi Kumbhar](https://github.com/kumbharvaishnavi31) - [Vaishnavi Parodkar](https://github.com/vaishnavi-parodkar) - [Vaishnavi Yerram](https://github.com/YVaishnavi23) - [Vaishnavi](https://github.com/Vaishnavi10706) - [Varad Kottawar](https://github.com/Varad02) - [Varsha Gitty](https://github.com/vgg1459) - [Varshini](https://github.com/Varshini131) - [Varshith Varma](https://github.com/varshith-uppalapati) -[Rakshak Patel V](https://github.com/rakshak2005) - [Varun Kumar](https://github.com/kukutapuvarun) - [Vasiliki Zagoraiou](https://github.com/vasilikiz5) - [Vasya Taburetkin] - [Vedant S](https://github.com/1vedantshinde) - [Vedika Gupta](https://github.com/VedikaGupt) - [Vesmorian Xavier](https://github.com/vaibhavsss) - [Victor Krassovsky](github.com/victorkrassovsky) - [VidanyaE23](https://github.com/VidanyaE23) - [VijayVenkatraman](https://github.com/vijayomatic2-ops) - [Vikas Pundir](https://github.com/Vikaspundir24) - [VikramMahajan](https://github.com/vikramm0907) - [Vinh D Tran](https://github.com/s3500659) - [Vinit Patel](https://github.com/Vinit3116) - [Virabhadra Khobare](https://github.com/VirabhadraKhobare) - [Viraj Hudlikar](https://github.com/vhudlikar) - [Vishakha](https://github.com/Vishakha61) - [Vishnupriya Shisode](https://github.com/vishnupriya-shisode) - [Vito Bondanese](https://github.com/VBVB99) - [Vivek S](https://github.com/VivekSarvaiya) - [Vivek Soni](https://github.com/vivek-s-soni) - [Loveyash Singh](https://github.com/Cyber-Py-Coder) - [Vivek](https://github.com/Vivek290100) - [VizzScript](https://github.com/vizzscript) - [Vuk Topalovic](https://github.com/vukkt) - [WHA](https://github.com/wynehtetaung) - [Waltteri Riihimäki](https://github.com/waltterir) - [Whrisper](https://github.com/SChrisper) - [Wikosac](https://github.com/wikosac) - [William Dellinger](https://github.com/Willd231) - [Wirt Salthouse](https://github.com/Wirt4) - [SingularWind](https://github.com/SingularWind979) - [Xingyeee Li](https://github.com/xingyeee-L) - [Xuqiang Qin](https:/github.com/qinxuqiang) - [Zeleni](https://github.com/ZelenovicA) - [Yuzhirua](https:/github.com/Yuzhirua) - [YFJ](https://github.com/YCJG) - [Yadnyesh](https://github.com/Yadnyesh-patil) - [Yaseen VM](https://github.com/yaseen-vm) - [Yaser-Sellami](https://github.com/Yaser-Sellami) - [Yash Chigullapally](https://github.com/yashtech-hub) - [Yash Jain](https://github.com/Yashjain9425) - [Yash Patel](https://github.com/WildTrio) - [Yasir Khan](https://github.com/itsyasirkhandev) - [Yasiru Liyanage](https://github.com/yasiruliyanage17) - [Ye Marn Aung/Jared Aung](https://github.com/JaredAung) - [Yijanho](https://github.com/jho951) - [yiming564](https://example.com) - [Yitong Zhou](https://github.com/ZzzZzz-670) - [Youssef Hamdy](https://github.com/Empty002) - [Yukesh D](https://github.com/Yukesh-30) - [Yulhui Kim](https://github.com/dbfgml2000) - [Yuval Tzur](https://github.com/yuvtz) - [Yuvaraj K](https://github.com/22f3002987-UserYuv) - [Yuvraj Chirag](https://github.com/YuvrajChirag) - [Zahid-hussain19](https://github.com/Zahid-hussain19) - [Zaid Rasul](https://github.com/ZaidRasul) - [Zammad Nasir](https://github.com/ZammadNasir) - [Zander Gouws](https://github.com/MyFokFrikkie) - [Zara](https:github.com/zaracoder-stack) - [Zeina Obeid](https://github.com/zho00) - [Ziemniakus17](https://github.com/ziemniakus17) - [Zilu Wang](https://github.com/wanzy147) - [Ziyu](https://github.com/szyu345) - [DragonFlyersx](https://github.com/DragonFlyersx) - [Zoe Reed](https://github.com/zoereedviz) - [ZulaikhaAshiq](https://github.com/zulaikhamir) - [adeoja](https://github.com/adeoja) - [adriancll](https://github.com/adriancll) - [ajithrao](my first contribution) - [allanm](https://github.com) - [amelia](https://github.com/amy-jd) - [amoorali](https://github.com/amoorali) - [anesmeftah](https://github.com/anesmeftah) - [arthisathish](https://github.com/Arthi-asd/) - [as6200](https://github.com/as6200) - [asart90](https://github.com/asart9O) - [asikrshoudo](https://github.com/asikrshoudo) - [askerino](https://github.com/askerino) - [auditive-tokyo](https://github.com/auditive-tokyo) - [azhank391](https://github.com.azhank391) - [baldlow](https://github.com/baldlow) - [barkinke](https://github.com/barkinke) - [benHitt](https://github.com/benHitt123) - [bereamk](https://github.com/bereamk) - [bivekk51](https://github.com/bivekk51) - [callme-kvj](https://github.com/kvj-harsha) - [casa-code](https://github.com/casa-code) - [charitha-369](https://github.com/charitha-369) - [conlusive](https://github.com/conlusive) - [contribution](https://github.com/MSAKWA-officer) - [cpescato](https://github.com/cpescato) - [curtainsamll](https://github.com/curtainsamll) - [daniil-gi](https://github.com/daniil-gi) - [davos](https://github.com/davos9002) - [deep9x](https://github.com/deep9x) - [devoceon](https://github.com/emy3) - [devycx](https://github.com/devycx) - [dibaya-jyoti](https://github.com/dibaya07) - [dinesh](https://github.com/dineshv97) - [diya](https://github.com/diyaj14) - [djyun](https://github.com/dongjooyun) - [elijah](https://github.com/elijahladdie) - [eloi-web](https://github.com/eloi-web) - [enguy-hub](https://github.com/enguy-hub) - [evneis](https://github.com/evneis) - [fedxemilio](https://github.com/fedxemilio) - [ffqwe](https://github.com/ffqwe) - [fibi-daudi](https://github.com/fibi-daudi) - [fikrirazor](https://github.com/fikrirazor) - [Shubham Kumar Jha](https://github.com/Shubham12222089) - [fishleaf](https://github.com/fishleaf) - [fistAttempt](https://github.com/nikhiltumma/first-contributions) - [fligbix](https://github.com/Fligbix) - [fovisio](https://github.com/fovisio) - [fusionAMAN](https://github.com/fusionAMAN) - [fuutot](https://github.com/fuutot) - [gatura](https://github.com/gatura-source) - [gary](https://github.com/callmegary-dev) - [gkrishna247](https://github.com/gkrishna247) - [granada1_lnrs](https://github.com/granad1_lnrs) - [Kavyasree Nunna](https://github.com/Kavyasree) - [guerrasz](https://github.com/guerrasz) - [kenHarris0](https://github.com/kenHarris0) - [happypepii](https://github.com/happypepii) - [hezk](https://github.com/hezhikui) - [hills-i](https://github.com/hills-i) - [hridyam04](https://github.com/hridyam04) - [huangyikun11](https://github.com/huangyikun11) - [hun-cloud](https://github.com/hun-cloud) - [huzaifa-cyberzeff](https://github.com/cyber-zeff) - [Cat-Div7](https://github.com/Cat-Div7) - [ikimathi](https://github.com/ikimathi) - [imshota1009](https://github.com/imshota1009) - [ironinter](https://github.com/ironinter) - [itxe-del](https://github.com/itxe-del) - [jennifer j](https://github.com/jenniferjayaraj19-ops) - [jennifer jayaraj](https://github.com/jenniferjayaraj19-ops) - [Jaya Krishna Miriyam](https://github.com/jayakrishna-miriyam) - [jhc4318](https://github.com/jhc4318) - [jsutCodes](https://github.com/jsutCodes) - [jy-kong](https://github.com/jy-kong) - [kaka](https://github.com/KK5241) - [kachomsky](https://github.com/kachomsky) - [kamal ahmed](https://github.com/KamalA7med) - [kevinmj12](https://github.com/kevinmj12) - [kirichanmo](https://github.com/kirichanmo) - [koolkosmos](https://github.com/koolkosmos) - [lamKKe](https://github.com/lamKKe) - [laura-beja](https://github.com/laura-beja) - [law880](https://github.com/law880) - [lennyhurni](https://github.com/lennyhurni) - [lepickel](https://github.com/lepickel) - [levo](https://github.com/LeVo011) - [liplip](https://github.com/liplip358) - [mazza-the-dev](https://github.com/mazza-the-dev) - [meagantroot](https://github.com/meagantroot) - [medali213](https://github.com/medali213) - [mheavey](https://github.com/mheavey2) - [midhun](https://github.com/3idhun) - [Tase](https://github.com/Tasesho) - [midikaif](https://github.com/midikaif) - [mohnish](https://github.com/Mohnish27-dev) - [sg20](https://github.com/ismasg20) - [nintrees](https://github.com/nintreesssss) - [notchkxge](https://github.com/notchkxge) - [notnimna](https://github.com/Not-Nimna) - [nulone](https://github.com/nulone) - [oogway-x3t](https://github.com/oogway-x3t) - [oona34](https://github.com/oona34) - [oscar](https://github.com/olp0678/first-contributions) - [eniyanyosuva](https://github.com/Eniyanyosuva) - [payal rawat](https://github.com/payalrawat369) - [peanut-butter-wafer-lover](https://github.com/peanut-butter-wafer-lover) - [pomv](https://github.com/pomv) - [prem kumar grk](https://github.com/premkumargrk) - [raftxo](https://github.com/Raftxo) - [raining-night](https://github.com/raining-night) - [raro212](https://github.com/raro212) - [rasmuskn44](https://github.com/rasmuskn44) - [reihori](https://github.com/reihori) - [rodrigoquerobim](https://github.com/RodrigoQuerobim1) - [rohansalunkhe](https://github.com/THEROHAN01) - [ronaldmirabal](https://github.com/ronaldmirabal) - [sachu samuel](https://github.com/zacc-tech) - [sachzindu](https://github.com/sachzindu) - [sai krupali konda](https://github.com/saikrupalikonda) - [saiteja-better](https://github.com/saiteja11407-cmd) - [sadaanbaksh](https://github.com/23f3002209) - [samuelitoo01](https://github.com/samuelitoo01) - [santhosh teja](https://github.com/santhosh-7777) - [sarana023](https://github.com/sarana023) - [sasha4ka](https://github.com/sasha4ka) - [sasvi123](https://github.com/sasvi123) - [sathvikkv](https://github.com/sathvikkv556) - [shreyanth-sureshkrishnaa](https://github.com/shreyanth-sureshkrishnaa) - [Mohit Kumar](https://github.com/mohitk23) - [shwetasharma](https://github.com/ShwetaSharmaDev) - [snopstor](https://github.com/snopstor) - [socks5-sniffer](https://github.com/socks5-sniffer) - [accayo](https://github.com/Accayo14) - [sony](https://github.com/sony77697) - [srsxnsh](https://github.com/srsxnsh) - [stackashu](https://github.com/Stackashu) - [stanxz](https://github.com/stanxz) - [stella](https://github.com/Janb05) - [subramanya T N](https://github.com/subramanya-44) - [sudhakarpappu](https://github.com/sudhakarpappu) - [sunjie](https://github.com/sj2902732578) - [Burchmire](https://github.com/Burchmire) - [Braydon Pettit](https://github.com/bray2sick) - [BuffyCode](https://github.com/BuffyCode) - [swaraj reddy](https://github.com/swarajreddy10) - [sxpar](https://github.com/sxpar) - [table106](https://github.com/table106) - [aiphru](https://github.com/Aiphru) - [td2thinh](https://github.com/td2thinh) - [tember8003](https://github.com/tember8003) - [terror-akshat](https://github.com/terror-akshat) - [tharsika](https://github.com/Tharsika21) - [umesh reddy](https://github.com/T-UmeshReddy) - [uzuraDev](https://github.com/uzuraDev) -[lawal_temitope] - [Valerie Marmolejo Molina] (https://github.com/valemm13) - [valentinfazenda](https://github.com/valentinfazenda) - [vivel-blenderlab](https://github.com/vivek-blenderlab) - [vivi214](https://github.com/vivi214) - [vondar](https://github.com/vondar) - [webmastervetea](https://github.com/webmastervetea) - [Phenyo Morulane](https://github.com/spoja-10) - [wllzhang](https://github.com/wllzhang) - [wonathan](https://github.com/threestuff) - [wospunt](https://github.com/wospunt) - [wp](https://github.com/wpfdxl) - [xRookieFight](https://github.com/xRookieFight) - [xyslqy](https://github.com/xyslqy) - [Physxia] (https://github.com/Physxia) - [yaeth](https://github.com/yaeth) - [yashasvi Lamba ](https://github.com/Yashasvi767) - [yashpr349](https://github.com/yashpr349) - [youssefelganini](https://github.com/youssefelganini) - [zaka](https://github.com/oraichezakariyae) - [Zakariye Mohamed](https://github.com/zakiscoding) - [Donaldo Zoubery](https://github.com/donaldozoubery) - [zs1981](https://github.com/zs1981) - [zxc-lucky](https://github.com/zxc-lucky) - [Åke Gauffin](https://github.com/Ake-Gauffin) - [Đặng Hoàng Phúc](https://github.com/phuc220793-cpu) - [İsaməddin Qurbanov](https://github.com/isameddin35) - [张喜昌](https://github.com/ZhangXiChang) - [zmj](https://github.com/ACM202309060114) - [원세영](https://github.com/seyoung5744) - [Kaison Liu](https://github.com/capton586) - [🔗 Armaan Singh Klair](https://github.com/ArmaanSinghKlair) - [Abdelrahman_Mohye](https://github.com/aboda-0100011) - [Madhav Choudhry](https://github.com/madhavchoudhry23) - [Rayhan Islam Rabby](https://github.com/rayhanislamrabby) - Omnia Hussein - [Vafly3](https://github.com/Vafly3) - [Federico Pilato] (https://github.com/fedepilato) -[HemawarshiniMahendran](https://github.com/Hemamahe07) -[renya peter](https://github.com/renyapeter) - [jangjohn](https://github.com/jangjohn) [Zhiyu1723](https://github.com/Zhiyu1723/) [sai krupali konda](https://github.com/saikrupalikonda) - [MeraNavaneetha](https://github.com/MeraNavaneethaa) - [seronly](https://github.com/seronly) - [lvmxn](https://github.com/lvmxn) - [Yhyh](https://github.com/YHc-ode) - -[Samaran S](https://github.com/iam-samzz) - [Monika kumari](https://github.com/monika-2906-git) - [Esther Okon-Paul](https://github.com/esthercodes-dev) - [Sagar Gupta](https://github.com/Sagargupta16) - [eric](https://github.com/Eric-Code09) - [Vivek Kumar Mali](https://github.com/24f2002719) - [Zhou Guangde](https://github.com/Zm-112) - [graah-lhuu](https://github.com/graah-lhuu) - [Swarnali Saha](https://github.com/swarnalism) - [Zack](https://github.com/acger-acmer) -[George](https://github.com/amazephoenix-bit) - [Furkan Yilmaz](https://github.com/coderfeye13) - [dimentr](https://github.com/Dimonstraci) - [Jose-Vilca](https://github.com/vilca-join) - [linil00](https://github.com/medk24) - [Jeevan M](https://github.com/Jeevanm2004) - [Mateusz Miszuta](https://github.com/MrRecu) - [Anthony Cubillas](https://github.com/atthatonedude) - [Hypernova-Developer](https://github.com/hypernova-developer) - [Rola Hadidy](https://github.com/rolahadidy44) - [UserAmuser909](https://github.com/UserAmuser909) - [Enrique Carrillo](https://github.com/kikecv) - [Lakshmi Priya](https://github.com/priya1503) - [Omar Ahmed](https://github.com/omarnaldo) - [Zaid Ahmed](https://github.com/Md-Zaid-Ahmed) - [Ebo](https://github.com/ebokoo) - [Jovial David](https://github.com/jovialdavidd238-ui) - [TwoTATI](https://github.com/TwoTATI) - [Mohit](https://github.com/mohitsingh34) - [nush1729](https://github.com/nush1729) - [Moh](https://github.com/mohmohwin2010) - [Rezwan Mahmud](https://github.com/rezwan0x01) - [Zakwan Dadabhai](https://github.com/ZakwanCodes) - [asmaey](https://github.com/asmaey) - [Imane](https://github.com/kimaneeee00-gif) - [OwlUniversal](https://github.com/OwlUniversal) - [Vedansh Singhal](https://github.com/vedanshh16) - [Bruno Figueiredo](https://github.com/BrunollFigueiredo) - [Samiya Kazi](https://github.com/samiyamalikkazi) - [Aaditri Kumari Yadav](https://github.com/caetty01) - [s-kyli](https://github.com/s-kyli) - [Shreya](https://github.com/shre9244) - [Nanki-nn](https://github.com/Nanki-nn) - [Anna Chong](https://github.com/DsharpMaj7) - [Mithilesh lohar](https://github.com/mithlohar144) - [OSoufian](https://github.com/OSoufian) -[Shanwanth](https://github.com/Shanwanth-16) - [Aza145](https://github.com/aza145) - [alok-ranjan](https://github.com/alokranjan89) -[Shivani Srivastava](https://github.com/Kiwi-Supreme) -[rays27-web](https://github.com/rays27-web) -[Vivek Raj](https://github.com/vivekraj3456) -[OneByTheSide](https://github.com/OneByTheSide) - [Facu B](https://github.com/berFacundo) - [Joe Shawky](https://github.com/joeshawky) - [Bruno Buss](https://github.com/bussbruno) - [Ammar Hassan] (https://github.com/ammarhassan6) - [Herald Fortunato](https://github.com/Fortunato-Herald) -[Shadan Rashid](https://github.com/Rashid-123) -[Nisitha](https://github.com/Nisitha076) - [Luqman Cassim](https://github.com/luqmanshaqiq2) - [PinkSkya](https://github.com/PinkSkya) - [Sneha Singh](https://github.com/23f2004826) - [Elakkiya](https://github.com/Elakkiya2469) - [Aditya-Talikoti](https://github.com/AdityaTalikoti) - [Elakkiya](https://github.com/dhineshdd) -[Gagan rajput](https://github.com/gagansokhal-coder) -[Connecto Shivam](https://github.com/connectoshivam) -[Dylan Haskell](https://github.com/dyl242) - [BaofishKStorm](https://github.com/BaofishKStorm) - [priyanshuanubis](https://github.com/priyanshuanubis) - [Cindy Orangis](https://github.com/cindyorangis) - [Sapavat Anji](https://github.com/Sapavat-A) Vijaya Pranav - [Abhinav Sharma](https://github.com/AbhinavSharma123-O) - [Prem Prajapat] (https://github.com/prem941) -[Nikita Rani] - [GauravKumar1301](https://github.com/GauravKumar1301) - [Mohit Jaryal](https://github.com/mohitjaryal) - [Ihsanullah Lemar](https://github.com/ihsanlemar-blip) - [Rainy Sharma](https://github.com/rainyyyyshrrr12) - [Suryanshu Singh](https://github.com/Suryanshu-Singh-cyber) - [Pandaaa Hu](https://github.com/XiuXiuHu) - [Akhilesh Pachnanda](https://github.com/AkhileshPachnanda) - [Nithin Khammampati](https://github.com/NITHIN-3112) - [Not-muzzyy](https://github.com/Not-muzzyy) - [Anurag](https://github.com/anuraggit6212) - [Aditi Srivastava](https://github.com/aditisrivastava14) - [MD Noorain](https://github.com/engineermdnoorain-dev-l) - [LuKun-Zhang](https://github.com/LuKun-Zhang) - [Chenglong](https://github.com/baidd1011) - [Saibag Sayyad Kolar](https://github.com/SaiForge) - [Aditya Singh](https://github.com/adityasingh-dev-in) - Yash Baghel - [Yaswanth Kumar Bandela](https://github.com/yaswanthbandela) - Shruti Jodwal - [yumuysl](https:github.com/yumuysl) - [Yogesh Sharma](https:github.com/yogeshbamola554) - pomitan - [Joyalpreet Kaur](https://github.com/07joyal) - [Siqi Zhong](https://github.com/Maikizzz) - [Gustavo Marin](https://github.com/sr-gus) - [Nikhil Raj] (https://github.com/NIKHIL-RAJ-2024) - - [dmatiason09](https://github.com/dmatiason09) - [Ryo Satriagung Hidayat](https://github.com/ryosatria2105) - [Linda Marika](https://github.com/LindaMarika) - [GordonGGKGG](https://github.com/GordonGGKGG) - [fengtaowu](https://github.com/fengtaowu) - [Manav Pal](https://github.com/manavpal-dev) - [Motus](https://github.com/xuzihao0226) - [Squidpan Eleven](https://github.com/squidpan) -Sriram - [Fabirizio Raffaelli](https://github.com/Fabro23) - [kanikshaar](https://github.com/kanikshaar-1204) - [Pranjal Patil](https://github.com/pranjalp31) - (This line is added to show that auto-pr-merge workflow has bug allow any single line change) - - [Harshit Gupta](https://github.com/Ashusf90) - [Ekansh] (https://github.com/EkanshWadhwa39) - [Kabiraj Khatri](https://github.com/kabiraj) (First contribute1) - [Krishna Sahithi](https://github.com/sahithi-prog-ops) - [Nikhil Kinikar](https://github.com/nikhilk001) - [Scott Rector] (https://github.com/scottrector60/first-contributions-sdr) - [Nishkarsh] (https://github.com/Nishkarshgupt) - [Yashveer Singh](https://github.com/yashveerniat) - [Tanishka Chopadkar](https://github.com/chopadkartanishka) - [nathan Carter] (https://github.com/Nathanbc82) - [Hemesh Saini](https://github.com/hsavthegreat) -[Daniele](https://github.com/DanieleNTCentral) -[Yubi](https://github.com/yubi00) Merjen Amanmuradova [siperman12](https://github.com/siperman12) -[Frozen Fried](https://github.com/Frozen-Fried) - [Samrah Inayat](https:/github.com/scamzy) - [Kozzontherun] (https://github.com/KozzOnTheRun) - [Adicondro] (https://github.com/adicondro) - [Shank] (https://github.com/ShashankTiwari1801) - [Nidhi Parate] (https://github.com/n1dhiparate) - [fzgma] (https://github.com/fzgma) - [Pragya Mandal] (github.com/pragyamandal) - [Nour] (https://github.com/Nour-ad) - [Nícolas Marinho](https://github.com/nicolasmarinhoo) -[sog](https://github.com/jtystart) -[ytnma](https://github.com/ytnma) - [Ritesh Kundara](https://github.com/23f2002447) - [JaeBeom Park](https://github.com/recrime) - [Yuhan Zhang](https://github.com/Qinrayn) - [Adesina-Olajumoke-H](https://github.com/OlajumokeAdesina) - [sangjinnnggg](https://github.com/sangjinnnggg) - [Kejimi-data] (https://github.com/Kejimi-data) - [Ishola-Tosin-G](https://github.com/Ishola-Tosin-G) - [GiannisLinardos07](https://github.com/GiannisLinardos07) -[funmilola Ayinde]_(https://github.com/funmilolajanet) - [Merna Adel Abdelrahman Ibrahim](https://github.com/merna112) - [Nelli Bhasker](https://github.com/bhaskern55) - [aloha](https://github.com/666-yanzhi) * [Shashwajan Akinapelly](https://github.com/coderwrexx) - [Revati Natu](https://github.com/Revati-N) - [muharyman](https://github.com/muharyman) - [Sumit Kumar](https://github.com/stevedav131207-cell) - [Jocelyna_liu](https://github.com/jocelynaaaaaa-boop) - [Marlon Nunez](https://github.com/MagusMar) - [QXiaoLingShang](https://github.com/QXiaoLingShang) - [xup6wei718](https://github.com/xup6wei718) - [Dharshini](https://github.com/dharshini1316) - [kinglongwu2](https://github.com/KingLongWu2) - [uuudemo](https://github.com/UUUdemo) - [V Rohith](https://github.com/Rohith15119) - [Abhishek](https://github.com/Abhishek-Prajapati442) - [S Rice](https://github.com/cyberrhyc) - [TheTeodora22](https://github.com/TheTeodora22) - [tempoo04](https://github.com/tempoo04) - [fruite999](https://github.com/fruite999) - [maochuanjun](https://github.com/maochuanjun) - [BW3](https://github.com/brandonwilliams33) - [Noushidh](https://github.com/Noushidh) - [Deepanshu Maliyan](https://github.com/deepanshu-maliyan) -[G. M. Rashidul Islam Rahat ](https://github.com/rahat1517) -[yuanlin] #### [Aniket Gautam](https://github.com/aniketgit-hub101) -[Anjali yadav] (https://github.com/anjliy784-ship-it) - [raghvandrasingh111-sys](https://github.com/raghvandrasingh111-sys) - Muhammad Fardan Naheem(https://github.com/fardu6288) - [Prewal Fredlin Fernandes](https://github.com/Prewal137) - [GangSQuadUA](https://github.com/GangSquadUA) - [Vishal Singh](https://github.com/VISHAL55UIET) - [Ram Pravesh Singh](https://github.com/rampravesh19-96) - Luis Dan - [Aziz Oguntade] (https://github.com/azizoguntade-learning) - [NaveenKumar M](https://github.com/naveenkumar-rm) -[Yacine Mebarki](https://github.com/yacinemebarki) - [Avani J C](https://github.com/Avani24-byte) - [Sachin Singh](https://github.com/sachin844123) [Suhani Maurya](https://github.com/suhanimaurya05) - [Komil Kodirov](https://github.com/Komil-goat) -[frecklysledge0](https://github.com/frecklysledge0) - [Matthew Wong](https://github.com/richmanpoorman) - [Noah Schroeder](https://github.com/nrschroeder) - [Ishani Basu](https://github.com/Ishani1024) - [Jargavi Jadeja](https://github.com/JargaviJadeja) - [Sandhya Adhikari](https://github.com/Sandhya-ad) - [Alina Nair](https://github.com/NairAlina) - [Booker Ochieng Okumu](https://github.com/KOKUMUbooker) - [Apurva Singh](https://github.com/Apurva-1610) - [elegentLIFER](https://github.com/elegentLIFER) - [Rowan](https://github.com/Rowan-hhh) - - Srasti Jain(https://github.com/Srasti527) - [Ashitha T](https://github.com/Ashi-tha) - [germainelry](https://github.com/germainelry) - [Yanshu Varshney](https://github.com/YanshuVars) - [Sujata Patel](https://github.com/sujatapatel7827-maker) - [Nithish Kumar](https://github.com/nithishkumar-dev-10) - [Sree](https://github.com/sree-iitm-bs) - [Abdul] (https://github.com/B-M-0) - [Xingchen Yan](https://github.com/crosseax) - [Iker Aramendi](https://github.com/IkerAramendi) - [Leandro R](http://github.com/leandrortavano) - [Gia Miminoshvili](https://github.com/giamimino) - [xql](https://github.com/kirobotdev) - [Collins Kipkosgei - Kenya] (https://github.com/KipCollo) - [Rodrigo Provoste](https://github.com/RgoPro) - [Anand G] (https://github.com/anandgsaga) - [Lvyizhuo](https://lvyizhuo.github.io) - [dsk-dev-ai](https://github.com/dsk-dev-ai) - [Utkarsh Johari](https://github.com/utkarshjoharii21) -[BRakshitha2003](https://github.com/BRakshitha2003) - [Rishitha Vadde](https://github.com/Rishitha-Vadde) - [Navya Sahithi]-(https://github.com/NavyaSahithiPadilam) - #### [PressmenX](https://github.com/PressmenX) - [Beckett Wen](https://github.com/BeckettWen) - [170joeychua](https://github.com/170joeychua) - [KadamPrasad01](https://github.com/KadamPrasad01) - [Nandalal Shukla](https://github.com/nandalalshukla) - [Bikram Pal](https://github.com/Bikram-pal) -[Mayira Sharif](https://github.com/mayirasharif) - [Anton Vusatyi](https://github.com/vusatui) - [Nazish Ahmed](https://github.com/nazish16) [Banu A] https://github.com/banua - [Tunan Pan](https//github.com/tunan-pan) - [Abdul Azeez](https://github.com/Syedabdulazeez-021) - [ILLU510N](https://github.com/ILLU510N) - [Arjun Dholakiya](https://github.com/arjun-dholakiya) - [Shyam Prakash Sah](https://github.com/23f3000828) - [Deepika](https://github.com/deepikagithub-07) - [tun43p](https://github.com/tun43p) - [bingzangda](https://github.com/Anyoneself) - [Kasis Goenka](https://github.com/KasisGoenka15) - [wangxiaoxiang](https://github.com/wangxiaoxiang5599) - [Witheast](https://github.com/Witheast) - [Tidenflow](https://github.com/Tidenflow) - [Tahleel](https://github.com/Tahleels) - [LianHarman](https://github.com/LienThuan04)s - [Sushma](https://github.com/Sushma-0179) - [Skyler Warren](https://github.com/skylerwarren1985-ui) - [x](https://github.com/kirobotdev) - [Rafael ISTE](https://github.com/RafaelIste) - [Rithika](https://github.com/Rithika0718) - [Venkata Ganapathi Subramanian](https://github.com/venkata0803) - [Michaelangelo Labrador](https://github.com/labram13) - [Arismonx](https://github.com/Arismonx) - [Vítor Hugo](https://github.com/vitorhugo8899o-lgtm) - [dev patel](https://github.com/Devpatel954) - [Vansh Virmani](https://github.com/vansh-virmani) - [Jan Puig](https://github.com/janpc) - [Rabbiya Riaz](https://github.com/rabbiyariaz) - [Jack](https://github.com/rabbiyariaz) - [Nadif] (https://github.com/Nadif77) - Abhiram Sakha - Jaanu(https://github.com/jahnavichalla19-Jaanu) - [Souka2](https://github.com/Souka2) - [Hitisha Soni](https://github.com/Hitisha-Soni) - [Prem Shenoy](https://github.com/prs241) - [Paawan Garg](https://github.com/Paawangarg1084) - [Swati Chaudhari](https://github.com/ChaudhariSwati) - [Ishita Singh](https://github.com/codeishitech) - ### [amd1.7](https://github.com/amd1-7) - [Jyoti Sahani] (https://github.com/Jyoti9529) - [Matt Shih] (https://github.com/Matt940624) - Brenden Letsatsi -[qitao2023](https://github.com/qitao2023) - [xql.dev](https://github.com/kirobotdev) -.[Rohan Gupta](https://github.com/thatsrohan). ================================================ FILE: LICENSE ================================================ MIT License Copyright (c) 2016 - present Roshan Jossey Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ================================================ FILE: README.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) #### _Read this in [other languages](docs/translations/Translations.md)._ [Shqip](docs/translations/README.al.md) [Armenian](docs/translations/README.arm.md) [Uzbek language](docs/translations/README.uz.md) [Azərbaycan dili](docs/translations/README.aze.md) [বাংলা](docs/translations/README.bn.md) [Bulgarian](docs/translations/README.bg.md) [Português (Brasil)](docs/translations/README.pt_br.md) [Català](docs/translations/README.ca.md) [中文 (Simplified)](docs/translations/README.zh-cn.md) [Czech](docs/translations/README.cs.md) [Deutsch](docs/translations/README.de.md) [Dansk](docs/translations/README.da.md) [المصرية](docs/translations/README.eg.md) [Dezéiriya](docs/translations/README.dz.md) [Español de España](docs/translations/README.es.md) [Française](docs/translations/README.fr.md) [Gaeilge](docs/translations/README.ga.md) [Galego](docs/translations/README.gl.md) [Ελληνικά](docs/translations/README.gr.md) [ქართული](docs/translations/README.ge.md) [Magyar](docs/translations/README.hu.md) [Bahasa Indonesia](docs/translations/README.id.md) [עִברִית](docs/translations/README.hb.md) [ગુજરાતી / हिन्दी / मराठी / മലയാളം / ಕನ್ನಡ / తెలుగు / ଓଡିଆ / छत्तीसगढ़ी / ਪੰਜਾਬੀ](docs/translations/Translations.md) [தமிழ்](docs/translations/README.ta.md) [فارسی](docs/translations/README.fa.md) [Italiano](docs/translations/README.it.md) [日本語](docs/translations/README.ja.md) [සිංහල](docs/translations/README.si.md) [Kiswahili (Kenya)](docs/translations/README.kws.md) [한국어](docs/translations/README.ko.md) [Lietuvių kalba](docs/translations/README.lt.md) [Limba Română Limba Română](docs/translations/README.ro.md) [မြန်မာ](docs/translations/README.mm_unicode.md) [Македонски](docs/translations/README.mk.md) [Español de México](docs/translations/README.mx.md) [Bahasa Melayu / بهاس ملايو‎ / Malay](docs/translations/README.my.md) [Dutch](docs/translations/README.nl.md) [Norsk](docs/translations/README.no.md) [नेपाली](docs/translations/README.np.md) [Wikang Filipino](docs/translations/README.fil.md) [English (Pirate)](docs/translations/README.en-pirate.md) [اردو](docs/translations/README.ur.md) [Twi (Ghana)](docs/translations/README.gh.md) [Polski](docs/translations/README.pl.md) [Português (Portugal)](docs/translations/README.pt-pt.md) [Русский язык](docs/translations/README.ru.md) [العربية](docs/translations/README.ar.md) [Svenska](docs/translations/README.se.md) [Slovenčina](docs/translations/README.slk.md) [Slovenščina](docs/translations/README.sl.md) [ภาษาไทย](docs/translations/README.th.md) [Türkçe](docs/translations/README.tr.md) [中文(Traditional)](docs/translations/README.zh-tw.md) [Українська](docs/translations/README.ua.md) [Tiếng Việt](docs/translations/README.vn.md) [Swahili language](docs/translations/README.sw.md) [Zulu (South Africa)](docs/translations/README.zul.md) [Afrikaans (South Africa)](docs/translations/README.afk.md) [Igbo (Nigeria)](docs/translations/README.igb.md) [Bambara (Mali)](docs/translations/README.mli.md) [Hausa (Nigeria)](docs/translations/README.hau.md) [Yoruba (Nigeria)](docs/translations/README.yor.md) [Latvia](docs/translations/README.lv.md) [Suomeksi](docs/translations/README.fi.md) [Беларуская мова](docs/translations/README.by.md) [Српски](docs/translations/README.sr-Cyrl.md) [Srpski](docs/translations/README.sr-Latn.md) [Қазақша](docs/translations/README.kz.md) [Bosanski](docs/translations/README.bih.md) [Hrvatski](docs/translations/README.hr.md) [پښتو](docs/translations/README.ps.md) [Somalia](docs/translations/README.so.md) [Ecuador](docs/translations/README.ec.md) [Luganda (Uganda)](docs/translations/README.lug.md) [Turkmen language](docs/translations/README.tm.md) [Ewe (TOGO)](docs/translations/README.ewe.md) [አማርኛ](docs/translations/README.am.md) [Kurdî](docs/translations/README.kr.md) [Malagasy](docs/translations/README.mg.md) [ភាសាខ្មែរ](docs/translations/README.kh.md) [Moroccan Darija](docs/translations/README.ma.md) [Mongolian](docs/translations/README.mn.md) [Tounsi](docs/translations/README.tn.md) [Lingala](docs/translations/README.ln.md) # First Contributions This project aims to simplify and guide the way beginners make their first contribution. If you are looking to make your first contribution, follow the steps below. _If you're not comfortable with command line, [here are tutorials using GUI tools.](#tutorials-using-other-tools)_ fork the repository #### If you don't have git on your machine, [install it](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Fork this repository Fork this repository by clicking on the fork button on the top of this page. This will create a copy of this repository in your account. ## Clone the repository clone the repository Now clone the forked repository to your machine. Go to your GitHub account, open the forked repository, click on the code button, then on SSH tab and then click the _copy url to clipboard_ icon. Open a terminal and run the following git command: ```bash git clone "url you just copied" ``` where "url you just copied" (without the quotation marks) is the url to this repository (your fork of this project). See the previous steps to obtain the url. copy URL to clipboard For example: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` where `this-is-you` is your GitHub username. Here you're copying the contents of the first-contributions repository on GitHub to your computer. ## Create a branch Change to the repository directory on your computer (if you are not already there): ```bash cd first-contributions ``` Now create a branch using the `git switch` command: ```bash git switch -c your-new-branch-name ``` For example: ```bash git switch -c add-alonzo-church ```
If you get any errors using git switch, click here: If the error message "Git: `switch` is not a git command. See `git –help`" appears, it's likely because you're using an older version of git. In this case, try to use `git checkout` instead: ```bash git checkout -b your-new-branch-name ```
## Make necessary changes and commit those changes Now open `Contributors.md` file in a text editor, add your name to it. Don't add it at the beginning or end of the file. Put it anywhere in between. Now, save the file. git status If you go to the project directory and execute the command `git status`, you'll see there are changes. Add those changes to the branch you just created using the `git add` command: ```bash git add Contributors.md ``` Now commit those changes using the `git commit` command: ```bash git commit -m "Add your-name to Contributors list" ``` replacing `your-name` with your name. ## Push changes to GitHub Push your changes using the command `git push`: ```bash git push -u origin your-branch-name ``` replacing `your-branch-name` with the name of the branch you created earlier.
If you get any errors while pushing, click here: - ### Authentication Error 
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/'
Go to [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account. Also, you might want to run 'git remote -v' to check your remote address. If it looks anything like this: 
origin	https://github.com/your-username/your_repo.git (fetch)
  origin	https://github.com/your-username/your_repo.git (push)
change it using this command: ```bash git remote set-url origin git@github.com:your-username/your_repo.git ``` Otherwise you'll still get prompted for username and password and get authentication error.
## Submit your changes for review If you go to your repository on GitHub, you'll see a `Compare & pull request` button. Click on that button. compare and create pull request Now submit the pull request. submit pull request Soon I'll be merging all your changes into the main 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 -> pull request_ workflow that you'll often encounter 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). If you'd like more practice, checkout [code contributions](https://github.com/roshanjossey/code-contributions). Now let's get you started with contributing to other projects. We've compiled a list of projects with easy issues you can get started on. Check out [the list of projects in the web app](https://firstcontributions.github.io/#project-list). ### [Additional material](docs/additional-material/git_workflow_scenarios/additional-material.md) ## Tutorials Using Other Tools | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](docs/gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](docs/gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](docs/gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](docs/gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/additional-material/Things a Non programmer can do.tam.md ================================================ ##ஒரு நிரலாளர் அல்லாதவர் செய்யக்கூடியவை ##கேட்க தொடங்குங்கள் (Start Listening) திறந்த மூல (open source) திட்டங்கள் அனைத்தும் மக்களைச் சுற்றியே சுற்றுகின்றன. நீங்கள் ஒரு குழுவில் சேர விரும்புகிறீர்கள், அதற்காக அந்த சமூகத்தைப் புரிந்து கொள்ள வேண்டும். ஒரு திட்டத்துக்குள் சென்று “இது இவ்விதம் இருக்க வேண்டும்” என்று சொல்வது பொதுவாக நல்லதாக எடுத்துக்கொள்ளப்படுவதில்லை. சில திட்டங்கள் அதை வரவேற்கலாம், ஆனால் திட்டம் நீண்ட காலமாக இயங்கிவந்தால், அந்த அணுகுமுறை ஏற்றுக்கொள்ளப்படுவதற்கான வாய்ப்பு குறைவு. கேட்பது தான் திட்டத்தின் தேவைகளை அறிய சிறந்த வழி. மெயில் பட்டியலில் சேருங்கள்: பல திறந்த மூலத் திட்டங்களில் தகவல்தொடர்பு மெயில் பட்டியல்கள் மூலமாக நடைபெறும். பெரிய திட்டங்களில் பல்வேறு வகைப்பட்ட பட்டியல்கள் இருக்கும். உதாரணமாக, PostgreSQL திட்டத்தில் 12 பயனர் பட்டியல்கள் மற்றும் 6 டெவலப்பர் பட்டியல்கள் உள்ளன. முதலில் முக்கிய பயனர் பட்டியலையும், பின் டெவலப்பர் பட்டியலையும் பின்பற்றலாம். ப்லாக் (Blog) பின்பற்றுங்கள்: முக்கிய டெவலப்பர்கள் எழுதும் ப்லாக்களில் எதிர்கால வெளியீடுகள் பற்றிய தகவல்கள் கிடைக்கும். “planet.gnome.org” அல்லது “planet.mysql.com” போன்ற “planet” தளங்களில் பல ப்லாக்கள் ஒரே இடத்தில் சேர்க்கப்பட்டிருக்கும். IRC சேனலில் இணைக: பல திறந்தமூலத் திட்டங்களில் உரையாடல் நடக்கும் IRC சேனல்கள் இருக்கும். அங்குள்ள இயக்குநர்கள் மற்றும் பயனர்கள் சிக்கல் மற்றும் அபிவிருத்தி குறித்து பேசுவார்கள். டிக்கெட்டுகளுடன் (Tickets) வேலை செய்யுங்கள் நிரல் (code) ஒரு திட்டத்தின் மையம் என்றாலும், கோடை மட்டுமே பங்களிப்பு செய்யும் வழி அல்ல. பயனர் குறைகள், பிழைகள் மற்றும் அப்டேட்களை பராமரிப்பதும் முக்கிய பணி. பிழையை கண்டறிதல்: பிழைகள் பல நேரங்களில் சரியாக அறிக்கையிடப்படாது. ஒரு பயனர் “என் கணினியில் X செய்வது வேலை செய்யவில்லை” என்றால், அந்த பிழையை மீண்டும் உருவாக்கி அதன் காரணத்தை கண்டறியுங்கள். பிறகு அந்த தகவலை டிக்கெட்டில் புதுப்பிக்கவும். உறுதியான பிழைகள் மூடல்: சில டிக்கெட்டுகள் ஏற்கனவே சரிசெய்யப்பட்டும், மூடப்படாமல் இருக்கும். சில ஆண்டுகளாக பழைய டிக்கெட்டுகளைப் பரிசோதித்து புதிய பதிப்பில் பிழை நீங்கியுள்ளதா என்பதை உறுதி செய்து மூடலாம். நிரலுடன் (Code) வேலை செய்க அனைத்து அனுபவ நிலைகளிலும் இருக்கும் நிரலாளர்கள் பங்களிக்கலாம். கோடிங் நடைமுறையைப் பின்பற்றுங்கள்: ஒரு திட்டத்தின் சொந்த வழிமுறைகளை (workflow) கேட்டு புரிந்து கொள்ளுங்கள். GitHub பயன்படுத்தும் திட்டங்கள் Pull Request முறையைப் பின்பற்றலாம். பீட்டா சோதனை (Beta testing): வெளியீட்டிற்கும் முன் வரும் பீட்டா அல்லது ரிலீஸ் கேண்டிடேட் பதிப்புகளை சோதித்து பல்வேறு பிளாட்ஃபாரங்களில் பரிசோதிக்கலாம். பிழையைச் சரிசெய்தல் (Fix a bug): டிக்கெட்டிங் அமைப்பிலுள்ள பிழையைத் தேர்ந்தெடுத்து சரிசெய்து அதற்கான டெஸ்ட் சேர்க்கலாம். குறிப்புரை சேர்த்தல்: கோடு குழப்பமாக இருந்தால் விளக்கக் குறிப்புகளை சேர்க்கலாம். ஆவணங்களுடன் (Documentation) வேலை செய்க அறிக்கைகள் மற்றும் வழிகாட்டிகள் எப்போதும் முன்னுரிமை பெறுவதில்லை. ஒரு திட்டத்தை அறியாதவர்களின் நோக்கில் புதியவர்கள் எழுதும் ஆவணங்கள் மிகவும் பயனுள்ளவை. எடுத்துக்காட்டுகள் எழுதுங்கள்: APIs, லைப்ரரிகள் அல்லது டூல்கள் பற்றிய “செய்முறைகள்” அல்லது “எப்படி பயன்படுத்துவது” போன்ற எடுத்துக்காட்டுகளை உருவாக்கலாம். திரைபிடிப்பு உருவாக்குங்கள்: பயன்பாட்டை நிறுவுவது அல்லது ஒரு அம்சத்தைப் பயன்படுத்துவது போன்றவற்றை காட்டும் வீடியோக்கள் உருவாக்கலாம். சமூகத்துடன் (Community) பணியாற்றுங்கள் திறந்த மூலத்தின் இதயம் சமூகமே. வினாவுக்கு பதிலளிக்கவும்: புதியவர்களுக்கு உதவுவது சமூக வளர்ச்சிக்கு முக்கியம். ப்லாக் பதிவு எழுதுங்கள்: உங்கள் அனுபவங்கள், சந்தித்த சிக்கல்கள், தீர்வுகள் பற்றி எழுதுங்கள். இது மற்ற பயனர்களுக்கும் உதவும். இணையதளத்தை மேம்படுத்துங்கள்: உங்களுக்கு வடிவமைப்பு திறன் இருந்தால் தளத்தின் தோற்றத்தையும், அதிலுள்ள தகவல்களையும் மேம்படுத்துங்கள். தொழில்நுட்ப ஆவணங்கள் எழுதுங்கள்: இலக்கண ரீதியாக சரியான, எளிய ஆங்கிலத்தில் எழுதப்பட்ட ஆவணங்கள் திட்டத்திற்கு பெரும் பலன் தரும். ##மற்ற பங்களிப்புகள் அணுகலை (Accessibility) மேம்படுத்துங்கள்: படங்களுக்கு Alt Text சேர்க்கவும், ஸ்கிரீன் ரீடர் இணக்கம் പരിശോധிக்கவும், நிற வேறுபாடு சரிசெய்க. சமூக நிகழ்வுகளை ஏற்பாடு செய்யுங்கள்: ஆன்லைன் மீட்டப்கள், ஹேக்கத்தான்கள், AMA நிகழ்வுகள், அரட்டை கண்காணிப்பு. வளங்கள் தொகுக்கவும்: “Awesome [Project Name]” பட்டியல், கையேடுகள், வீடியோக்கள், FAQ தொகுப்புகள் உருவாக்குங்கள். சமூக ஊடகம்: திட்டத்தின் ட்விட்டர்/லிங்க்டின் கணக்குகள் மூலம் புதுப்பிப்புகள் பகிருங்கள், புதியவர்களுக்கு வழிகாட்டும் THREADS எழுதுங்கள். மொழிபெயர்ப்பு: UI மற்றும் ஆவணங்களை மொழிபெயர்ப்பதன் மூலம் பரவலாக்கலாம். UX கருத்துக்கள்: வடிவமைப்பு பரிந்துரைகள், UI சிக்கல்கள் குறித்து கருத்து பகிருங்கள். நிதி திரட்டல்: GitHub Sponsors போன்ற திட்டங்களுக்கு விண்ணப்பித்து உதவிகளைப் பெறலாம். ##முக்கிய கருத்து: அனைவரிடமும் கவனமாய் கேளுங்கள். திட்டத்தின் தேவைகள் எங்கே உள்ளன என்பதை உணருங்கள். சில சமயங்களில் சிறிய உதவிகள் பெரிய தாக்கத்தை ஏற்படுத்தும் — உதாரணமாக, ஒரு பழைய டிக்கெட் அமைப்பை GitHub-க்கு மாற்றும் ஸ்கிரிப்ட் எழுதுவது போன்றவை. இவ்வாறு செய்பவர்களால் சமூகத்துக்கு பெரும் பலன் கிடைக்கும். ================================================ FILE: docs/additional-material/Things a non Programmer can do.ar.md ================================================ # ما يمكن لغير المبرمج القيام به ## كن متأنيًا في مجال البرمجيات مفتوحة المصدر، كل خطوة، سواء كانت برمجة أو جوانب أخرى، تتطلب مساهمة وتفاعل من الآخرين. الانضمام إلى فريق مفتوح المصدر يعني فهم ديناميكيات المجتمع وطريقة عمله. بدلاً من الوصول إلى مشروع والقول فورًا "هذا ما أعتقد أن المشروع يجب أن يفعله"، من الأفضل غالبًا اتباع نهج أكثر انتباهًا. بعض المشاريع قد ترحب بهذا النهج، لكن إذا كان المشروع قائمًا منذ فترة، فإن احتمالية قبول هذا السلوك تكون منخفضة. الاستماع هو أفضل طريقة لمعرفة ما يحتاجه المشروع. 1. **الاشتراك في قائمة بريدية**: بالنسبة للعديد من المشاريع، تكون القائمة البريدية هي الوسيلة الرئيسية للتواصل حول تطوير المشروع. في المشاريع الكبيرة، توجد قوائم بريدية متعددة. على سبيل المثال، يحتوي مشروع PostgreSQL على 12 قائمة موجهة للمستخدمين و6 قوائم للمطورين. يُنصح بالبدء بالاشتراك في القائمة الرئيسية للمستخدمين والقائمة الرئيسية للمطورين للاستماع أولًا. 2. **متابعة مدونة**: المدونات التي يديرها المطورون الرئيسيون غالبًا ما توفر معلومات عن الإصدارات القادمة والخطوات اللازمة. مواقع مثل "planet" تجمع أخبارًا ومقالات من مصادر متعددة متعلقة بالمشروع، مثل planet.gnome.org أو planet.mysql.com. 3. **الانضمام إلى قناة IRC**: العديد من المشاريع لديها قنوات IRC (الدردشة عبر الإنترنت) حيث يجتمع المطورون والمستخدمون لمناقشة المشاكل والتطوير. تحقق من موقع المشروع لمعرفة اسم القناة والشبكة. 4. **العمل مع التذاكر (tickets)**: البرمجة ليست الطريقة الوحيدة للمساهمة. صيانة الشيفرة والأنظمة المحيطة بها غالبًا ما تكون مهملة، وهذه فرصة سهلة للمشاركة. معظم المشاريع لديها نظام تذاكر يمكن الوصول إليه من الجميع. الحفاظ على تحديث التذاكر طريقة ممتازة للمساعدة. 5. **تشخيص الأخطاء**: في كثير من الأحيان يتم الإبلاغ عن الأخطاء بشكل غير واضح. تشخيص الأخطاء ومراجعتها يساعد المطورين على فهم المشكلة بسرعة. حتى لو لم تعرف سبب المشكلة، فإن جهودك لتقليل الظروف تساعد الآخرين على حلها بسهولة. 6. **إغلاق الأخطاء المصححة**: أحيانًا يتم تصحيح الأخطاء في الشيفرة لكن التذاكر المتعلقة بها لا تُغلق. مراجعة هذه التذاكر مهمة جدًا. ابدأ بالتأكد من التذاكر القديمة وقم بإغلاق ما تم حله. 7. **اختبار إصدار تجريبي أو مرشح للإصدار**: يمكن أن تواجه المشاريع مشاكل توافق على منصات مختلفة. اختبار الإصدارات التجريبية يساعد المشروع على التأكد من جودة الإصدار النهائي. 8. **تصحيح خطأ**: عادة ما يبدأ المساهمون بحل الأخطاء. حدد خطأً وحاول تصحيحه، وأضف اختبارات إذا لزم الأمر. 9. **كتابة اختبار (Test)**: معظم المشاريع لديها اختبارات، لكن هناك دائمًا مجال لإضافة اختبارات جديدة لتغطية أجزاء لم تُختبر بعد. 10. **إخفاء تحذيرات المترجم (compiler warnings)**: في المشاريع بلغة C أو غيرها، قد تظهر تحذيرات لا تشير إلى خطأ حقيقي. إزالة هذه التحذيرات يحسن وضوح عملية البناء. 11. **إضافة تعليق (Comment)**: عند قراءة الشيفرة، إذا وجدت جزءًا مربكًا، أضف تعليقًا لتوضيحه للآخرين. 12. **إنشاء مثال**: لا يوجد مشروع يمكن أن يحتوي على أمثلة كثيرة جدًا. إنشاء مثال عملي يوضح طريقة استخدام البرنامج يساعد المستخدمين الجدد. 13. **التفاعل مع المجتمع**: الرد على أسئلة الآخرين، خاصة المبتدئين، يساعد المشروع على النمو ويجعل المجتمع نشطًا. 14. **كتابة تدوينة (Blog Post)**: مشاركة تجاربك مع المشروع تساعد الآخرين وتوثق خبرتك. 15. **تحسين موقع الويب**: إذا كانت لديك مهارات تصميم، يمكنك تحسين موقع المشروع أو الشعارات، مما يعزز صورة المشروع. 16. **كتابة وثائق تقنية**: كتابة توثيق عن المشروع مفيد، حتى لو لم تكن مبرمجًا، لتسهيل استخدام المشروع على الآخرين. 17. **التعليم ومساعدة الآخرين**: أفضل طريقة لتعلم شيء جديد هي محاولة تعليمه للآخرين، فالتدريس يعزز فهمك ومهاراتك. ================================================ FILE: docs/additional-material/Things a non Programmer can do.ja.md ================================================ # プログラマーでない人ができること ## 聞くことから始める オープンソースに関わる全てのことは、他の人との関わりを伴います。 あなたはチームに参加しようとしているわけで、それはコミュニティやその仕組みを理解することを意味します。 プロジェクトに入って「こんにちは、このプロジェクトはこうあるべきだと思います」といきなり言うのは、通常あまり歓迎されません。 もちろん、そういうアプローチを歓迎するプロジェクトもありますが、プロジェクトがある程度運営されている場合、その態度が受け入れられる可能性は低いです。 **聞くことこそ、プロジェクトが本当に必要としていることを知る最良の方法です。** 1. **メーリングリストに参加する**: 多くのプロジェクトでは、メーリングリストがプロジェクト開発に関する主なコミュニケーション手段です。 大規模なプロジェクトでは、選択できるメーリングリストが複数あります。 例えば、PostgreSQLプロジェクトでは、ユーザー向けリストが12件以上、開発者向けリストが6件も存在します。 まずはメインのユーザー向けリストとコア開発者向けリストをフォローして、内容を追ってみることから始めることをお勧めします。 2. **ブログをフォローする**: コア開発者が運営するブログは、今後のリリースで何が起こるのか、そしてそこに至るまでに何が必要だったかを教えてくれます。 「Planetサイト」は、プロジェクトに関連する様々なニュースやブログ記事を集約しています。 もし planet.gnome.org や planet.mysql.com のような Planet サイトがあれば、まずそこから始めましょう。 Googleで「planet 」と検索するだけでも見つかります。 3. **IRCチャンネルに参加する**: 多くのオープンソースプロジェクトには、開発者やユーザーが集まって問題や開発について話し合う専用のIRCチャンネルがあります。 プロジェクトのウェブサイトで、チャンネル名やどのIRCネットワークにあるかを確認してください。 ## チケットを扱う コードはオープンソースプロジェクトの中心ですが、コードを書くことだけが貢献方法ではありません。 コードやコード周辺のシステムのメンテナンスは、新機能の作成やバグ修正の急ぎでおろそかにされがちです。 こうした領域は、プロジェクトに足を踏み入れる簡単な方法となります。 ほとんどのプロジェクトには、プロジェクトのウェブサイトのトップページやドキュメントにリンクされた公開チケットシステムがあります。 それはユーザーと開発者の間の主要なコミュニケーション手段です。最新の状態を維持することは、プロジェクトを助ける優れた方法です。 チケットシステムで特別な権限が必要になる場合がありますが、ほとんどのプロジェクトリーダーは「チケットを整理して手伝いたい」と言えば喜んで権限を与えてくれます。 4. **バグを診断する**: バグ報告はしばしば不十分です。 バグを診断し、優先順位を付けることで、開発者が問題の詳細を把握する手間を省くことができます。ユーザーが「Xをしたらソフトが動かない」と報告した場合、その問題を引き起こす具体的な条件を時間をかけて特定してみましょう。再現性はあるか？問題を繰り返し起こる手順を作れるか？特定のブラウザでのみ発生する、あるいは特定のディストリビューションでのみ起こるなど、問題を絞り込めるか？原因が分からなくても、条件を絞り込む努力は、誰かが修正する際に役立ちます。 発見したことはすべてチケットに記録して、他の人も参照できるようにしましょう。 5. **修正済みバグを閉じる**: バグはコード上で修正されても、チケットシステムで更新されないことがあります。こうした未整理のチケットを整理するのは時間がかかりますが、プロジェクト全体にとって価値があります。まずはチケットシステムで1年以上前のチケットを検索し、そのバグがまだ存在するか確認します。プロジェクトのリリース変更ログをチェックして、バグが修正され閉じられるべきか確認します。修正済みであれば、チケットにバージョン番号を記載して閉じます。 最新バージョンのソフトウェアでバグを再現できるか試してください。再現できなければ、チケットにその旨を記録して閉じます。まだ存在する場合は、そのこともチケットに記録して、開いたままにします。 ## コードに取り組む あらゆる経験レベルのプログラマーは、プロジェクトのコードに貢献できます。 自分が好きなプロジェクトに本当に貢献するために、コーディングの天才である必要はありません。 コードを修正する場合、プロジェクトが採用している、コントリビューターからコードを取得する方法を調べましょう。 各プロジェクトには独自のワークフローがあるため、コードを提出する前に確認することが重要です。 例えば、PostgreSQLプロジェクトでは非常に厳密なプロセスがあり、コード修正はパッチ形式でメーリングリストに送られ、コア開発者が変更のすべてを精査します。 一方、Parrotのようにコードベースへのコミット権限を簡単に得られるプロジェクトもあります。 プロジェクトがGitHubを使っている場合、GitHubのプルリクエスト機能を使ったワークフローがあるかもしれません。 プロジェクトごとに方法は異なります。 コードを修正するときは、コミュニティの責任あるメンバーとして行動し、コードスタイルを既存のコードベースに合わせましょう。 追加・修正するコードは既存コードと同じように見えるべきです。 中括弧のスタイルやインデントのスペースの扱いが好みでなくても、既存の標準に合わないコード変更を提出するのは失礼です。 「自分のスタイルが正しい」と押し付けることと同じです。 6. **ベータ版やリリース候補をテストする**: 複数のプラットフォームで動作するプロジェクトは、移植性に関する様々な問題を抱える可能性があります。 リリースが近づき、ベータ版やリリース候補が公開されたら、多くの人にテストしてもらうことがプロジェクトリーダーの望みです。 あなたもその一人として、自分の環境で動作を確認し、貢献できます。通常はソフトウェアをダウンロードしてビルドし、テストするだけで十分ですが、珍しいディストリビューションやハードウェアでのテスト結果は非常に価値があります。 ビルドやテストが成功したことを報告するだけでも、リリースが安定しているかどうかの判断材料になります。 7. **バグを修正する**: コードに取り組みたい貢献者は通常ここから始めます。 やることはシンプルです: チケットシステムで興味のあるバグを見つけ、コードで修正を試みます。 修正内容は適宜コード内に文書化しましょう。 修正箇所をテストスイートに追加してテストするのも良い考えです。 プロジェクトによっては、バグ修正にはテスト追加が必須の場合があります。 初めて触れるコードベースを調べながらメモを取りましょう。 バグを修正できなくても、修正試行の過程で分かったことをチケットに記録すれば、後から来る人に役立ちます。 8. **テストを書く**: ほとんどのプロジェクトにはコードをテストするテストスイートがありますが、さらにテストを追加できる箇所は常に存在します。 Cならgcov、PerlならDevel::Coverなどのカバレッジツールを使って、テストスイートでカバーされていない箇所を特定し、テストを追加します。 9. **コンパイラ警告を消す**: 多くのCベースのプロジェクトでは、ビルド時に奇妙なコンパイラ警告が表示されます。 これらの警告は通常問題の兆候ではありませんが、そう見えることがあります。。 警告が多すぎると、コンパイラが「狼が来た」と叫んでいるように見えます。 コードが本当にバグを隠していないか確認し、問題がなければ警告を消す修正を加えることで、誤検知を減らせます。 10. **コメントを追加する**: コードを調べていると、理解しづらい箇所が見つかることがあります。 もしあなたが混乱したなら、他の人も混乱する可能性が高いです。 コードにコメントを追加して、パッチとして提出しましょう。 ## ドキュメントに取り組む コードを調べていると、分かりにくい部分を見つけることがあります。 あなたが混乱したなら、他の人も同様に混乱する可能性が高いです。コードにドキュメントを追加し、パッチを提出してください。 ドキュメントとの連携 ドキュメントは、プロジェクトの要素の中でも最も軽視されがちな部分です。 また、プロジェクトに精通した人の視点から書かれたため、初めて触れる人の視点から見た場合、理解しにくい場合があります。 「このマニュアルは、私がすでにパッケージの使い方を理解していることを前提にしているようだ」と感じたことがあるなら、私の言っていることがわかるでしょう。 プロジェクトに深く関わっている人々が気づかないドキュメントの欠点を、新鮮な視点を持つ人が指摘できることがあります。 11. **サンプルを作る**: どのプロジェクトも、使い方の具体例は多いに越したことはありません。 ウェブAPI、ライブラリ、GUIアプリ（Gimpなど）、コマンドラインツール、いずれでも、適切な使い方の例は長いドキュメントよりもわかりやすく説明できます。 APIやライブラリなら、ツールを使ったサンプルプログラムを作成します。 既存のコードから必要最低限に切り出すだけでも構いません。 ツールなら、日常生活でどのように使っているかを実例として示します。 視覚的に理解したい場合は、重要なプロセス（アプリのインストール手順など）のスクリーンキャプチャも有効です。 ## コミュニティに取り組む オープンソースはコードだけでなく、コミュニティがあって初めて機能します。 コミュニティを育てる方法はいくつもあります。 12. **質問に答える**: コミュニティを育てる最良の方法は、他の人を助けることです。 特に初めての人の質問に答えることは、プロジェクトの成長と活性化に重要です。 初心者を助ける時間は、将来的に活発なコミュニティメンバーを生む投資です。 誰もがどこかから始める必要があり、プロジェクトは常に新しい人材の流入を必要としています。 13. **ブログ記事を書く**: 自分のブログがあるなら、プロジェクトの使用体験について書きましょう。 ソフトウェア使用中に直面した問題とその解決方法について書きます。 これにより、他の人にもプロジェクトを意識させ、同じ問題に直面した人が将来検索した際に役立つ情報を提供できます。 （技術的冒険のブログは、次に仕事で同じソフトウェアを使うときの実務経験を示すのにも役立ちます） 14. **ウェブサイトを改善する**: ウェブデザインのスキルがある場合、プロジェクトのウェブサイトや公開イメージの改善に貢献できます。 プロジェクトのグラフィックを刷新したり、ロゴを作成したりすることも価値があります。 コミュニティ内でこうしたスキルを持つ人は少ないことが多く、非常に歓迎されます。 15. **技術ドキュメントを書く**: アプリケーションやソフトウェアの動作について書けるなら、技術ドキュメントを作成できます。 特にオープンソースで、一般向けに更新・拡張・作成が必要なドキュメントに最適です。 平易な英語で書けば書くほど良いです。プログラマーでなくても技術ドキュメントは書けます。 最も重要なのは、周囲の人々が何を話しているかに耳を傾けることです。 差し迫ったニーズに気づけるかどうかを探してみましょう。 例えば、最近Parrotの開発者向けメールリストでは、古いTracシステムを廃止して、GitHubをトラブルチケット管理システムとして使用することが決まりました。 一部の人は反対でした。というのも、既存のチケットをGitHubに移行する方法がなかったからです。 1日の議論のやり取りの後、私は「コンバータを作ってみたらどうですか？」と提案しました。 人々はそのアイデアに大喜び。私は450件以上のチケットを変換するプログラムを作成し、チケット履歴を一切失うことなく移行に成功しました。 これは大きな成功でした。私も貢献でき、コア開発者たちはParrotの開発業務に集中できたのです。 16. **教え、他者を助ける**: あるトピックについてより深く学ぶ最良の方法は、それを教えてみることです。 最高の教師は、複雑なことをシンプルな例で説明できる人です。 そのため、最高の学習者であり、プログラミングの世界で最高であるためには、まず最高の教師になろうとする必要があります。 他者に教えることで、自分自身の理解も深まり、スキルや知識も向上します。 誰かから助けを得たとき、それを自分だけに留めず、他の人と共有してください。 そうすることで、世界はより良い場所になります。 ================================================ FILE: docs/additional-material/Things a non Programmer can do.md ================================================ # Things a non Programmer can do ## Start listening Everything in open source involves other people. You're looking to join a team, and that means understanding the community and how it works. Walking in to a project and saying "Hi, here's what I think this project should be doing" is usually not taken as a good thing. Some projects may welcome that sort of approach, but if the project has been running a while, the chances of that attitude being embraced are small. **Listening is the best way to know what the project needs.** 1. **Join a mailing list**: For many projects, the mailing list is the main conduit of communication about the development of the project. On large projects, there are many mailing lists to choose from. For example, the PostgreSQL project has no fewer than 12 user-oriented lists and six developer lists on its mailing list page. I suggest you follow the main user-oriented list and the core developer list in which to start listening. 2. **Follow a blog**: Blogs maintained by core developers often give information about what's coming up in future releases, and what it's taken to get there. A planet site aggregates news and blog entries from many sources related to the project. If there is a planet site, like planet.gnome.org or planet.mysql.com, start there. Just search Google for "planet ." 3. **Join an IRC channel**: Many open source projects have dedicated Internet relay chat (IRC) channels where developers and users hang out to discuss problems and development. Check the project's website for the details of what the channel is called and what IRC network it's found on. **Work with Tickets** Code is the heart of any open source project, but don't think that writing code is the only way to contribute. Maintenance of code and the systems surrounding the code often are neglected in the rush to create new features and to fix bugs. Look to these areas as an easy way to get your foot into a project. Most projects have a publicly visible trouble ticket system, linked from the front page of the project's website and included in the documentation. It's the primary conduit of communication between the users and the developers. Keeping it current is a great way to help the project. You may need to get special permissions in the ticketing system, which most project leaders will be glad to give you when you say you want to help clean up the tickets. 4. **Diagnose a bug**: Bugs are often poorly reported. Diagnosing and triaging a bug can help save the developers time with the legwork of figuring out the specifics of the problem. If a user reported, "The software doesn't work when I do X," spend some time to figure out the specifics of what goes into that problem. Is it repeatable? Can you create a set of steps to cause the problem repeatedly? Can you narrow down the problem, such as only happening on one browser but not another, or one distro but not another? Even if you don't know what causes the problem, the effort you put into narrowing down the circumstances makes it easier for someone else to fix it. Whatever you discover, add it to the ticket in the bug system for all to see. 5. **Close fixed bugs**: Often bugs are fixed in the codebase but tickets reported about them don’t get updated in the ticketing system. Cleaning up this cruft can be time-consuming, but it's valuable to the whole project. Start by querying the ticket system for tickets older than a year and see if the bug still exists. Check the project's release change log to see if the bug was fixed and can be closed. If it's known to be fixed, note the version number in the ticket and close it. Try to recreate the bug with the latest version of the software. If it can't be recreated with the latest version, note that in the ticket and close it. If it still exists, note that in the ticket as well and leave it open. Working with Code Programmers of all experience levels can help with the code in the project. Don't think that you have to be a coding genius to make real contributions to your favorite project. If your work involves modification to the code, investigate the method that the project uses for getting code from contributors. Each project has its own workflow, so ask about how to do it before you set out to submit code. For example, the PostgreSQL project is very rigorous in its process: Code modifications are sent in patch form to a mailing list where core developers scrutinize every aspect of the change. On the other end is a project like Parrot where it's easy to get commit privileges to the codebase. If the project uses GitHub, there may be a workflow that uses the pull request feature of GitHub. No two projects are the same. Whenever you modify code, make sure that you act as a responsible member of the community and keep your code style to match the rest of the codebase. The code you add or modify should look like the rest. You might not like the bracing style or the handling of spaces for indentation, but it's rude to submit a code change that doesn't match the existing standards. It's the same as saying "I don't like your style, and I think mine is better, so you should do it my way." 6. **Test a beta or release candidate**: Any project that's designed to run on multiple platforms can have all sorts of portability problems. When a release approaches and a beta or release candidate is published, the project leader hopes that it will be tested by many different people on many different platforms. You can be one of those people and help ensure that the package works on your platform. Typically you only need to download, build, and test the software, but the value to the project can be huge if you're on an uncommon distribution or hardware. Just reporting back that the build and test works helps the project leaders know that the impending release is solid. 7. **Fix a bug**: This is usually where contributors wanting to get working on code start. It’s simple: Find an interesting-sounding bug in the ticket system and try to fix it in the code. Document the fix in the code if it's appropriate. It's a good idea to add a test to the test suite to test the spot of code you fixed; some projects require bug fixes to include tests. Keep notes as you poke around this unfamiliar codebase. Even if you aren't able to fix the bug, document in the ticket what you discovered as part of the fix attempt. What you find helps those who come after you. 8. **Write a test**: Most projects have a test suite that tests the code, but it's hard to imagine a test suite that couldn't have more tests added to it. Use a test coverage tool like gcov for C, or Devel::Cover for Perl to identify areas in the source code that aren't tested by the test suite. Then, add a test to the suite to cover it. 9. **Silence a compiler warning**: The build process for many C-based projects often spew the odd compiler warning flag to the screen. These warnings are usually not indicators of a problem, but they can look like it. Having too many warnings can make the compiler sound like it's crying wolf. Check to see if the code could actually be hiding a bug. If not, modifying the source to silence helps to hide these false positives. 10. **Add a comment**: When you're digging through the code, you may find some spots that are confusing. Chances are if you were confused, others will be as well. Document them in the code and submit a patch. Work with Documentation Documentation is typically the part of a project that gets short shrift. It also can suffer from having been written from the point of view of those who are familiar with the project, rather than through the eyes of someone just getting into it. If you've ever read docs for a project where you think, "It's as though this manual expects that I already know how to use the package," you know what I'm talking about. Often a set of fresh eyes can point out deficiencies in the documentation that those close to the project don't notice. 11. **Create an example**: There is no project that has too many how-to examples. Whether it's a web API, a library of routines, a GUI app like Gimp or a command line tool, a good example of proper usage can more clearly and quickly explain proper usage of software than pages of documentation. For an API or library, create an example program that uses the tool. This could even be extracted from code you've written, trimmed down to the bare necessities. For a tool, show real-world examples of how you've used it in your daily life. If you’re visually oriented, consider creating a screen-capture of an important process, such as how to install the application. Work with Community Open source is only partly about code. Community makes open source work. Here are ways you can help build it up. 12. **Answer a question**: The best way to help build the community is by helping others. Answering a question, especially from someone who is just getting their feet wet, is crucial to helping the project grow and thrive. The time you take to help a beginner, even if they're asking a question where you could easily throw back a quick "RTFM," pays off down the road in getting another active member of the community. Everyone starts out somewhere, and projects need a constant inflow of people if they're to stay vital. 13. **Write a blog post**: If you've got a blog, write about your experiences with the project that you're using. Tell about a problem you faced using the software and what you did to solve it. You'll be helping in two ways, both by helping keep the project on the minds of others around you, and by creating a record for anyone else who has your problem in the future and searches the web for the answer. (A blog of your technical adventures is also an excellent way to show real-world experience with the software in question next time you go hunting for a job using it.) 14. **Improve a website**: If you've got skills in web design and can help improve the website, and thus the public-facing image of the project, that's time well spent. Perhaps the project could use a graphic overhaul, or a logo to identify the project. These may be skills lacking in the community. I know I'd love it if I could get some graphic design help on my projects' websites. 15. **Write technical documentation** If you can write about how an application or piece of software works, you could write technical documentation about it. Especially open source projects that are looking to update, revamp, expand, or create technical docs for the general public to read. The more you write in plain english, the better. The best part, you don't have to be a programmer to write technical docs. Most of all, listen to what people around you discuss. See if you can recognize a pressing need. For instance, recently on the Parrot developers' mailing list, it was decided to use GitHub as the trouble ticket system, abandoning the old Trac installation they had. Some people were against the move because there was no way to convert the tickets to GitHub's system. After a day of back and forth arguing, I piped up and said "How about if I write a converter?" People were thrilled at the idea. I spent the time to write a conversion program for the 450+ tickets, so we lost none of our ticket history. It was a great success. I got to pitch in, and the core developers stayed focused on the business of working on Parrot. 16. **Teach and Help others**: The best way to learn more about a topic is to try to teach it. The best teacher is the one who can explain complex stuff with simple examples. So you need to try to be the best teacher to be the best learner and the best in your programming world. Teaching others will make you feel better about yourself and it will help you get better skills and knowledge in your profession. When you get help from someone don't keep it to yourself share it with others. Make the world a better place to live. 17. **Improve Accessibility** - Audit project documentation/websites for: - Alt text for images. - Screen reader compatibility. - Suggest fixes for: - Color contrast. - Keyboard navigation. - Semantic HTML. 18. **Organize Community Events** - Help organize: - Virtual meetups or hackathons. - "Ask Me Anything" (AMA) sessions with maintainers. - Moderate forums/Discord/Slack to keep discussions productive. 19. **Curate Resources** - Create an **"Awesome [Project Name]"** list with: - Tutorials, videos, third-party tools. - Compile a **FAQ section** from common questions in forums/issues. 20. **Social Media & Outreach** - Manage project’s Twitter/LinkedIn: - Share updates, milestones, or contributor spotlights. - Write **"Getting Started" threads** or tweetorials for new users. 21. **Localization & Internationalization** - Translate UI strings (via Crowdin/Weblate). - Adapt docs for regional contexts (e.g., date formats, idioms). 22. **Design & UX Feedback** - Mockup UI improvements (Figma/Canva sketches). - Report confusing workflows (e.g., "Settings menu is hard to find"). 23. **Grant Writing & Fundraising** - Apply for open-source grants (GitHub Sponsors, NLnet). - Draft **case studies** showcasing project impact. ================================================ FILE: docs/additional-material/git_workflow_scenarios/Useful-links-for-further-learning.md ================================================ # Useful Links This document is dedicated to all the tips and tricks websites, blog posts, and helpful sites that make our lives easier. They are a great reference to serve all of our needs, be it a beginner or an expert. This page should act as an index of all those useful links that would help everybody who is new in the open-source domain or someone who wants to learn more. ## The List 1. [Interactive tutorial to git](https://try.github.io) 2. [Youtube: Git and GitHub for Beginners by freecodecamp](https://www.youtube.com/watch?v=RGOj5yH7evk) 3. [git - the simple guide](http://rogerdudler.github.io/git-guide/) 4. [On undoing, fixing, or removing commits in git](http://sethrobertson.github.io/GitFixUm/fixup.html) 5. [Git and GitHub tutorial translated to many languages](https://github.com/Roshanjossey/first-contributions) 6. [Merge Conflicts](https://www.git-tower.com/learn/git/ebook/en/command-line/advanced-topics/merge-conflicts) 7. [Resolving Merge Conflicts](https://githowto.com/resolving_conflicts) 8. [Basics of Git - The Simple Quick Start Guide](https://blog.praveen.science/basics-of-git-the-quick-start-guide/) 9. [Git Standards followed in our way of Spotify Agile Methodology](https://blog.praveen.science/git-standards-followed-in-our-way-of-spotify-agile-methodolgy/) 10. [Git Shortcuts](https://blog.praveen.science/git-shortcuts/) 11. [Official Git cheat sheet in many languages](https://services.github.com/on-demand/resources/cheatsheets) 12. [Git cheat sheet from Tower](https://www.git-tower.com/learn/cheat-sheets/git) 13. [Common Git Problems](https://www.codementor.io/citizen428/git-tutorial-10-common-git-problems-and-how-to-fix-them-aajv0katd) 14. [Git Rebase](https://blog.gitprime.com/git-rebase-an-illustrated-guide/) 15. [Beginner's Guide to Rebasing and Squashing](https://github.com/servo/servo/wiki/Beginner%27s-guide-to-rebasing-and-squashing) 16. [Git Cheatsheet that shows correlations between commands and files](http://ndpsoftware.com/git-cheatsheet.html) 17. [How to contribute](https://opensource.guide/how-to-contribute/) 18. [Getting started with Open Source](https://github.com/OpenSourceHelpCommunity/Getting-Started-With-Contributing-to-Open-Sources) 19. [How to contribute](https://github.com/freeCodeCamp/how-to-contribute-to-open-source) 20. [Atlassians Git Tutorials](https://www.atlassian.com/git) 21. [Pull request reviews](https://help.github.com/articles/about-pull-request-reviews/) 22. [Another Interactive tutorial for git](https://learngitbranching.js.org/) 23. [Git commandline cheat-sheet](https://gist.github.com/davfre/8313299) 24. [Programming Books](https://github.com/EbookFoundation/free-programming-books) 25. [E-Book of professional tip and secrets](https://goalkicker.com/GitBook/GitProfessionalTipsSecrets.pdf) 26. [tutorial about simple rules of become git professional](https://medium.freecodecamp.org/follow-these-simple-rules-and-youll-become-a-git-and-github-master-e1045057468f) 27. [A Note About Git Commit Messages](https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) 28. [5 Useful Tips For A Better Commit Message](https://thoughtbot.com/blog/5-useful-tips-for-a-better-commit-message) 29. [Version Control using Git](https://ourcodingclub.github.io/2017/02/27/git.html) 30. [Version Control with Git](https://www.udacity.com/course/version-control-with-git--ud123) 31. [Audit the Coursera course from Google](https://www.coursera.org/learn/introduction-git-github) 32. [Using Version Control in VS Code](https://code.visualstudio.com/docs/editor/versioncontrol) 33. [Git vs Github: What's the Difference and How to Get Started with Both](https://kinsta.com/knowledgebase/git-vs-github/) 34. [Hello World Github guides](https://guides.github.com/activities/hello-world/) 35. [How To Use GitHub](https://www.edureka.co/blog/how-to-use-github/) 36. [10 Days of Git and Github](https://github.com/Asabeneh/10-days-of-git-and-github) 37. [Keyboard shortcuts for Github](https://docs.github.com/en/get-started/using-github/keyboard-shortcuts) 38. [Complete Git and GitHub Tutorial by Kunal Kushwaha](https://www.youtube.com/watch?v=apGV9Kg7ics&ab_channel=KunalKushwaha) 39. [Git workflow Cheat Sheet](https://drive.google.com/uc?export=download&id=1QPRh5YmqQm4DFfitelPYlBTWC2I6tTTM) 40. [Beginers Guide To Proper Git Workflow](https://medium.com/@anjulapaulus_84798/beginners-guide-to-proper-git-workflow-35a2d967734e) 41. [How to using Github-Pages](https://docs.github.com/en/pages) 42. [Learn about Github Copilot](https://docs.github.com/en/copilot/about-github-copilot/what-is-github-copilot) Keep adding more links, that you find helpful. ================================================ FILE: docs/additional-material/git_workflow_scenarios/additional-material.md ================================================ # Additional information We assume that you have already finished with the basic tutorial before coming here. This document will give you some additional information about advanced Git techniques. ### [Amending a commit](amending-a-commit.md) This document provides information about how to amend a commit on the remote repository. Amending a commit is a way to modify the most recent commit you have made in your current branch. This can be helpful if you need to edit the commit message or if you forgot to include changes in the commit. You can continue to amend a commit until you push it to the remote repository. > Use this when you need to adjust a commit you made. ### [Configuring git](configuring-git.md) This document provides information about how to configure user details and other options in git. > Use this to better control your git configurations. ### [Keeping your fork synced with the repository](keeping-your-fork-synced-with-this-repository.md) This document provides information about how to keep your forked repository up-to-date with the base repository. This is important, as hopefully you and many others will contribute to the project. > Follow these steps if your fork doesn't have any changes in parent repository. ### [Moving a Commit to a different Branch](moving-a-commit-to-a-different-branch.md) This document provides information about how to move a Commit to another Branch. > Take these steps to move a commit to another branch. ### [Removing a File](removing-a-file.md) This document provides information about how to remove a file from your local repository. > Follow these steps to learn how to remove a file prior to a commit ### [Removing a branch from your repository](removing-branch-from-your-repository.md) This document provides information about how to delete a branch from your repository. > Only after your pull request gets merged, follow to next steps ### [Resolving Merge Conflicts](resolving-merge-conflicts.md) This document provides information about how to resolve merge conflicts. > Take these steps to resolve the annoying merge conflicts. ### [Reverting a commit](reverting-a-commit.md) This document provides information about how to revert a commit on the remote repository. It will come in handy in case you need to undo a commit that has already been pushed to Github. > Take these steps if you want to reverse a commit. ### [Squashing Commits](squashing-commits.md) This document provides information about how to squash commits with an interactive rebase. > Use this if you want to open a PR in an open source project and the reviewer asks you to squash every commit into one, with an informative commit message. ### [Undo-ing a local commit](undoing-a-commit.md) This document provides information about how to undo a commit on your local repository. This is what you need to do when you feel you've messed up your local repository and wish to reset the local repository. > Take these steps if you want to undo/reset a local commit. ### [Useful Links](Useful-links-for-further-learning.md) This document is dedicated to all the tips and tricks websites, blog posts, and helpful sites that make our lives easier. They are a great reference to serve all of our needs, be it a beginner or an expert. This page should act as an index of all those useful links that would help everybody who is new in the open-source domain or someone who wants to learn more. ### [Creating a .gitignore file](creating-a-gitignore-file.md) This document explains what a .gitignore file does, why to use it and how to create a .gitignore file. This file is used in almost all git projects. It helps commit only necessary files to git. ### [Storing Credentials](storing-credentials.md) This document explains how to store your credentials for repositories. This can be a security concern, so please follow the security policies of your place of work/study. ================================================ FILE: docs/additional-material/git_workflow_scenarios/amending-a-commit.md ================================================ # Amending a Commit What if you commit a change to your remote repository only to realize later that you have a typo in the commit message or you forgot to add a line in your most recent commit. How do you edit that? This is what this tutorial covers. ## Changing a recent commit message after you have pushed to Github. To do this without opening a file: * Type in the ```git commit --amend -m "followed by your new commit message"``` * Run ```git push origin ``` to commit the changes to the repository. Note: If you type in just ```git commit --amend```, your text editor would open up prompting you to edit the commit message. Adding the ``-m`` flags prevents it. ## Modifying on a single commit So, what if we forgot to make a minor change to a file like changing a single word and we have already pushed the commit to our remote repository? To illustrate here is a log of my commits: ``` g56123f create file bot file a2235d updated contributor.md a5da0d modified bot file ``` Let's say I forgot to add a single word to the bot file There are 2 ways to go about this. The first is to have an entirely new commit that contains the change like so: ``` g56123f create file botfile a2235d updated contributor.md a5da0d modified botfile b0ca8f added single word to botfile ``` The second way is to amend the a5da0d commit, add this new word and push it to Github as one commit. The second sounds better since it is just a minor change. To achieve this, we would do the following: * Modify the file. In this case, I will modify the botfile to include the word I omitted previously. * Next, add the file to the staging area with ```git add ``` Usually after adding files to the staging area, the next thing we do is git commit -m "our commit message" right? But since what we want to achieve here is to amend the previous commit, we would instead run: * ```git commit --amend``` This would then bring up the text editor and prompt you to edit the message. You can decide to leave the message as it was before or change it. * Exit the editor * Push your changes with ```git push origin ``` That way, both changes would be in one single commit. ## Modifying commits on remote If the commit that you like to amend has been already pushed to the remote, amending this commit will lead to your local history being diverged from the remote (since you basically create a new commit and replace the amended one). Since you want to change the commit on the remote, you need to overwrite the remotes history on your branch. To achieve that, follow the same procedure as described above, but use force push when pushing your commit to the remote. > **Warning** > Force pushing to the remote will overwrite (and discard) changes on the remote and only keep your pushed commits. Changes on the remote, that other team members did in the meantime, will be overwritten as well. This is how you modify the last recent commit on the remote: ```bash git add git commit --amend -m "followed by your new commit message" git push --force ``` > Using `--force-with-lease` is a safer option instead of `--force` which avoids overwriting other people's changes on the remote branch (if you do not intend to do so). ================================================ FILE: docs/additional-material/git_workflow_scenarios/check-commit-log.md ================================================ # Check commit log In order to check commits log for a branch, or, a file, following command can be used: `git log [options] [path]` The output of this command is given in reverse chronological order by default. ## Command output example ``` $ git log commit e3fabb30ab536bd5876461d8a749301a321e714f (HEAD -> check-commit-log-ko, upstream/main, origin/main, origin/HEAD, main) Author: Dan Yunheum Seol Date: Tue Jun 4 01:07:25 2024 -0400 Add dan-seol to Contributors list (#84962) commit 4af4ec8a56e057ce8768af77eda528453974d0bc Author: Edgar Humberto Tijerina Tamez <168693312+EdgarHTT@users.noreply.github.com> Date: Mon Jun 3 23:06:05 2024 -0600 Add Edgar Tijerina to Contributors list (#84961) ``` ## Command variations and options - In order to perform the commits reachable from a particular commit ids: (In this case, `foo` and `bar`)
`git log foo bar ` - It is also possible to remove the commits reachable from a given commit id by adding a `^` in front of commit id: (In this case, `baz`)
`git log foo bar ^baz` - Commit log for a particular file:
`git log --all ` - Limit number of commits in log: (In this case, `5`)
`git log -n 5` ## Refer - [Official documentation](https://git-scm.com/docs/git-log) ================================================ FILE: docs/additional-material/git_workflow_scenarios/configuring-git.md ================================================ # Configuring git The first time you tried to commit using git, you might have gotten a prompt like the one below: ```bash $ git commit *** Please tell me who you are. Run git config --global user.email "you@example.com" git config --global user.name "Your Name" to set your account's default identity. Omit --global to set the identity only in this repository. ``` Git needs to know who you are when you create a commit. When you are working collaboratively, you should be able to see who modified what parts of the project and when, and thus, git has been designed to create commits tied to a name and an email. There are multiple ways to provide the `git commit` command with your email and name, and we'll go through some of them below. ### Global Config When you store something in the global config, it is accessible system wide in all the repositories you work on. This is the preferred way and works for most use cases. To store something in the global config, you use the `config` command as follows: `$ git config --global ` In the case of user details, we run it as follows: ``` $ git config --global user.email "you@example.com" $ git config --global user.name "Your Name" ``` ### Repository Config As the name says, these configurations are scoped to your current repository. If you want to commit to a particular repository, say, a work related project, with your company's email, then you could use this method. To store something in the repository config, you use the `config` command by omitting the `--global` flag as follows: `$ git config ` In the case of user details, we run it as follows: ``` $ git config user.email "you@alternate.com" $ git config user.name "Your Name" ``` ### Command-line Config These type of configurations are scoped to the current command only. All git commands take `-c` arguments before the action verb to set temporary configuration data. To store something in the command line config, run your command as follows: `$ git -c = -c = ` In our example, we would run the commit command as follows: `git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Your commit message"` ### Note on Precedence Among the three methods described here, the precedence order is `command-line > repository > global`. This means that, if a variable is configured in the command-line as well as globally, the command-line value would be used for the operation. ## Beyond User Details We have dealt with only the user details till now while working with the config. However, there are several other configuration options available. Some of them are: 1. `core.editor` - to specify the name of the editor used for writing commit messages, etc. 2. `commit.template` - to specify a file on the system as the initial commit template. 3. `color.ui` - to specify a boolean value for using colors in git's output. We have abstracted some details for ease of understanding. For further reading, head over to [git-scm.com](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration). ================================================ FILE: docs/additional-material/git_workflow_scenarios/creating-a-gitignore-file.md ================================================ ## Understanding .gitignore The `.gitignore` file is an essential component of Git's workflow. It tells Git which files and folders to ignore, preventing unnecessary or sensitive data from being tracked in your repository. ## Why Use .gitignore? Certain files should not be included in version control because they are either: - Temporary or system-generated (e.g., cache, build files, logs) - Large dependencies that can be reinstalled (e.g., `node_modules`) - Personal or sensitive configuration files (e.g., API keys, environment variables) - IDE or editor-specific files (e.g., `.vscode/`, `.idea/`) Ignoring these files keeps the repository clean, reduces conflicts, and prevents security risks. ## Creating a .gitignore File To create a `.gitignore` file: 1. In your project root directory, create a new text file named `.gitignore`. 2. List the files and folders you want to ignore, one per line. 3. Save the file. ### Basic Syntax for .gitignore - `*` → Wildcard for matching multiple files. - `/` → Specifies path relative to `.gitignore`. - `#` → Adds comments. ### Example .gitignore File: ```sh # Ignore Mac system files .DS_Store # Ignore dependency folders node_modules/ venv/ # Ignore log and cache files *.log .cache/ # Ignore environment files .env # Ignore all text files *.txt ``` ## Global .gitignore (For All Projects) To create a global `.gitignore` file (applies to all repositories): ```sh git config --global core.excludesfile ~/.gitignore_global ``` Then, edit `~/.gitignore_global` as you would a local `.gitignore`. ## Removing Files from Git Tracking If a file was already committed before adding it to `.gitignore`, you need to remove it from tracking: - **Untrack a single file** (but keep it locally): ```sh git rm --cached filename ``` - **Untrack all ignored files**: ```sh git rm -r --cached . git add . git commit -m "Updated .gitignore" ``` To undo `git rm --cached filename`, use: ```sh git add filename ``` ================================================ FILE: docs/additional-material/git_workflow_scenarios/delete-branch-locally.md ================================================ # Deleting a locally created Branch This will be handy when you accidentally misspelled a branch name. This can be done in *3* ways ``` git branch -D ``` ``` git branch --delete --force # Same as -D ``` ``` git branch --delete # Error on unmerge ``` -D stands for --delete --force which will delete the branch even it's not merged (force delete), but you can also use -d which stands for --delete which throws an error respective of the branch merge status... ================================================ FILE: docs/additional-material/git_workflow_scenarios/gitflow.md ================================================ # Gitflow Gitflow is a branching model for Git made by Vincent Driessen. Here the discussion would be the requirements and use-cases of Gitflow.
The Gitflow workflow defines a strict branching model designed around the project release, which provides a robust framework for managing larger projects. Gitflow is ideally suited for projects that have a scheduled release cycle and for the DevOps best practice of continuous delivery. It assigns very specific roles to different branches and defines how and when they should interact. It uses individual branches for preparing, maintaining and recording releases. ## Implementation 1. **Develop and Master Branches**: Instead of a single master branch, Git Flow uses two branches to record the history of the project. It is based on two main branches with infinite lifetime namely master and develop: - **Master Branch**: The master branch contains the production code and stores the official release history. - **Develop Branch**: The develop branch contains pre-production code and serves as an integration branch for features. - **Creating a Develop Branch**:
Without using the Gitflow extensions: ``` git branch develop git push -u origin develop ``` Using the Gitflow extensions: When using the gitflow extension library, executing `git flow init` on an existing repo will create the develop branch. ``` git flow init ``` 2. **Feature Branch**: Each new feature should reside in its branch, which can be pushed to the central repository for backup/collaboration. Feature branches use the latest develop as their parent branch. When a feature is complete, it gets merged back into develop. Features should never interact directly with the master branch. - **Creating a Feature Branch**:
Without git-flow extensions: ``` git checkout develop git checkout -b feature_branch ``` With gitflow extensions: ``` git flow feature start feature_branch ``` - **Finishing a Feature Branch**:
Without git-flow extensions: ``` git checkout develop git merge feature_branch ``` With git-flow extensions: ``` git flow feature finish feature_branch ``` 3. **Release Branch**: Once develop has acquired enough features for a release (or a predetermined release date is approaching), we fork a release branch off of develop. Creating this branch starts the next release cycle, so no new features can be added after this point—only bug fixes, documentation generation, and other release-oriented tasks should go in this branch. Release branch may branch off from develop and must merge into both master and develop.
Using a dedicated branch to prepare releases makes it possible for one team to polish the current release while another team continues working on features for the next release. - **Creating a Release Branch**:
Without the git-flow extensions: ``` git checkout develop git checkout develop git checkout -b release/0.1.0 ``` When using the git-flow extensions: ``` git flow release start 0.1.0 ``` Switched to a new branch 'release/0.1.0' - **Finishing a Release Branch**:
Without git-flow extensions: ``` git checkout master git merge release/0.1.0 ``` With git-flow extensions: ``` git flow release finish 0.1.0 ``` 4. **Hotfix Branch**: Maintenance or “hotfix” branches are used to quickly patch production releases. Hotfix branches are necessary to act immediately upon an undesired status of master. Hotfix branches are a lot like release branches and feature branches except they’re based on master instead of develop. This is the only branch that should fork directly off of master. As soon as the fix is complete, it should be merged into both master and develop (or the current release branch), and the master branch should be tagged with an updated version number. - **Creating a Hotfix Branch**:
Without git-flow extensions: ``` git checkout master git checkout -b hotfix_branch ``` With git-flow extensions: ``` git flow hotfix start hotfix_branch ``` - **Finishing a Hotfix Branch**:
Without git-flow extensions: ``` git checkout master git merge hotfix_branch git checkout develop git merge hotfix_branch ``` With git-flow extensions: ``` git branch -D hotfix_branch git flow hotfix finish hotfix_branch ``` ## Advantages - Ensures a clean state of branches at any given moment in the life cycle of a project. - The naming convention of branches follows a systematic pattern making it easier to comprehend. - Has extensions and support on most used git tools. - Ideal in case of maintaining multiple versions in production. - Great for a release-based software workflow. - Offers a dedicated channel for hotfixes to production. ## Disadvantages - Git history becomes unreadable. - The master/ develop branch split is considered redundant and makes the Continuous Delivery/ Integration harder. - Not recommended in case of maintaining a single version in production. ## Summary Here we discussed the Git Flow Workflow. Git Flow is one of the many styles of Git workflows you and your team can utilize. Let’s summarize the whole workflow of Git Flow: 1. A develop branch is created from master. 1. Feature branches are created from develop. 1. When a feature is complete it is merged into the develop branch. 1. A release branch is created from develop. 1. When the release branch is done it is merged into develop and master. 1. If an issue in the master is detected a hotfix branch is created from master. 1. Once the hotfix is complete it is merged to both develop and master. ================================================ FILE: docs/additional-material/git_workflow_scenarios/installing-git-arch.md ================================================ # Installing Git on Arch Linux To install Git on Arch Linux, you can use the package manager pacman. First, open a terminal and update the system with the following command: ```shell $ sudo pacman -Syu ``` Next, install Git by running: ```shell $ sudo pacman -S git ``` To confirm that Git has been installed correctly, run the following command: ```shell $ git --version ``` You should see output similar to: ```shell Output $ git version 2.34.1 ``` # Set up Git Configuration can be achieved by using the git config command. Specifically, you need to provide your name and email address because Git embeds this information into each commit you do. You can add this information by typing: Now that we are done with installing Git, let us configure it for first time use using "git config" command. We need to make sure your username and email address are set correctly. To set them, use the command: ```shell $ git config --global user.name "Your Name" $ git config --global user.email "youremail@domain.com" ``` You can display all the configuration items that have been set by entering the following command in your terminal: ```shell $ git config --list ``` If all config field have been set up to your need the output should look something like ```shell user.name=Your Name user.email=youremail@domain.com ``` # Persist Git Credentials By default, Git will prompt you to re-enter your username and password every time you interact with a remote repository. You can configure Git to cache or store your credentials to avoid this. Below are two common methods: ### 1. Credential Caching Git can temporarily store your credentials in memory, so you don't need to re-enter them frequently. Run the following command to enable credential caching: ```shell $ git config --global credential.helper cache ``` By default, credentials will be cached for 15 minutes. To adjust the timeout period (e.g., 1 hour), use: ```shell $ git config --global credential.helper 'cache --timeout=3600' ``` --- ### 2. Credential Storing If you prefer to store your credentials permanently in plain text (less secure but convenient), you can use the following command: ```shell $ git config --global credential.helper store ``` When using this method, your credentials will be saved in plain text in `~/.git-credentials`. Be cautious with this approach, especially on shared or public machines. ================================================ FILE: docs/additional-material/git_workflow_scenarios/installing-git-ubuntu.md ================================================ # Installing Git Ubuntu OS Git by default is likely already installed in your Ubuntu OS . You can confirm this by launching your terminal and entering following command in to your terminal: ```shell $ git --version ``` If you receive output similar to the following, then Voila! you have readily installed Git on your machine. ```shell Output $ git version 2.34.1 ``` If this applies to you, proceed to [set up git](#set-up-git) below. If a Git version number was not on the output as shown above, you can still install it using Ubuntu's APT default package manager. Update your local package index first by using the apt package management tools. Head back to your terminal and enter the following command. ```shell $ sudo apt update ``` Once this is completed, then enter the following command to install in Git: ```shell $ sudo apt install git ``` You can confirm that you have installed Git correctly by running the following command and checking that you receive relevant output. ```shell $ git --version ``` ```shell Output $ git version 2.34.1 ``` With Git successfully installed, you can now proceed below by setting it up. # Set up Git Configuration can be achieved by using the git config command. Specifically, you need to provide your name and email address because Git embeds this information into each commit you do. You can add this information by typing: Now that we are done with installing Git, let us configure it for first time use using "git config" command. We need to make sure your username and email address are set correctly. To set them, use the command: ```shell $ git config --global user.name "Your Name" $ git config --global user.email "youremail@domain.com" ``` You can display all the configuration items that have been set by entering the following command in your terminal: ```shell $ git config --list ``` If all config field have been set up to your need the output should look something like ```shell user.name=Your Name user.email=youremail@domain.com ``` ... # Persist Git Credentials By default, Git will keep asking you for your details everytime you want to push to a remote repo. In Git, you can configure the caching of your credentials to avoid entering your username and password repeatedly. There are a couple of methods to achieve this: 1. Credential caching: Git provides a credential caching system that can store your credentials in memory for a specified period. This way, you don't have to re-enter your details every time you interact with a remote repository. To enable credential caching, you can use the following command: ```shell $ git config --global credential.helper cache ``` By default, Git will cache your credentials for 15 minutes. You can adjust the cache timeout period by specifying the --timeout option followed by the desired number of seconds. For example, to set the cache timeout to 1 hour (3600 seconds), you can use: ```shell $ git config --global credential.helper 'cache --timeout=3600' ``` 2. Credential Storing: This sets Git's credential helper to "store". When using this credential helper, Git will store the credentials for a remote repository in a plain-text file on disk. This method is the simplest but least secure option for credential storage. ```shell $ git config --global crednetial.helper store ``` With the store credential helper, the credentials entered for a remote repository will be stored permanently in a file located at ~/.git-credentials on Linux or macOS, or %USERPROFILE%\.git-credentials on Windows. The credentials will be stored in plain text format, which means they are readable if someone gains access to the file. The advantage of using the store credential helper is that you won't be prompted for credentials every time you interact with the remote repository. However, keep in mind the security implications of storing credentials in plain text, especially if you are using a shared or public machine. ================================================ FILE: docs/additional-material/git_workflow_scenarios/keeping-your-fork-synced-with-this-repository.md ================================================ # Keeping your fork synced with this repository First, the flow for a full sync should be understood, which is important. In this schema, there are 3 different repos: my public repo on Github `github.com/firstcontributions/first-contributions.git`, your fork of the repo on GitHub `github.com/Your-Name/first-contributions/` and your local machine's repo from which you are suppose to work. This kind of cooperation is typical for open source projects and called `Triangle Workflows`. triangle workflow To keep your two repos up-to-date with my public repo, we first have to fetch and merge the public repo with your local machine's repo. Our second move will be to push your local repo to your GitHub fork. As you've seen earlier, it's only from your fork that you can ask for a "pull request". So your GitHub fork is the last repo to be updated. Now, let's see how to do it: First, you must be on your main branch. To know which branch you are on, check the first line of: ``` git status ``` if you are not already on main: ``` git checkout main ``` Then you should add my public repo to your git with `add upstream remote-url`: ``` git remote add upstream https://github.com/firstcontributions/first-contributions.git ``` This is a way of telling git that another version of this project exists in the specified url and we're calling it `upstream`. Once your git has a name let's fetch the latest version of the public repository: ``` git fetch upstream ``` You've just fetched the latest version of my fork (`upstream` remote). Now, you need to merge the public repository into your main branch. ``` git rebase upstream/main ``` Here you're merging the public repository with your main branch. Your local machine's main branch is now up-to-date. Lastly, if you push your main branch to your fork, your GitHub fork will also have the changes: ``` git push origin main ``` Notice here you're pushing to the remote named `origin`. If you want to fetch and merge the latest changes of my fork (`upstream` remote) to your local branch at same time then you can directly go for: ``` git pull upstream main ``` So by now or at this point, all your repositories are up-to-date. Well done! You should do this, every time your GitHub repo tells you that you are a few commits behind. ================================================ FILE: docs/additional-material/git_workflow_scenarios/moving-a-commit-to-a-different-branch.md ================================================ # Moving a commit to a different branch What if you commit a change, and then realize that you committed to a different branch? How can you change that? This is what this tutorial covers. ## Moving the latest commits to an existing branch To do this, type: ```git reset HEAD~ --soft``` - Undoes the last commit, but leaves the changes available. ```git stash``` - Records the state of the directory. ```git checkout name-of-the-correct-branch``` - Switches to another branch. ```git stash pop``` - Removes latest stashed state. ```git add .``` - Or try adding individual files. ```git commit -m "your message here"``` - Saves and Commits the changes. Now your changes are on the correct branch ### Moving the latest commits to a new Branch To do this, type: ```git branch newbranch``` - Creates a new Branch. Saving all the Commits. ```git reset --hard HEAD~#``` - Move master back by # commits. Remember, these commits will be gone from master ```git checkout newbranch``` - Goes to the branch you created. It will have all the commits. Remember: Any changes not committed will be LOST. ================================================ FILE: docs/additional-material/git_workflow_scenarios/rebase-vs-merge.md ================================================ # Rebase vs Merge When contributing to open-source projects, it’s important to understand how to integrate your changes cleanly. Two common ways to bring updates from one branch into another are **merge** and **rebase**. ## What Is Rebase? **Rebasing** replays your commits from one branch on top of another — effectively moving your work to start from the tip of another branch. This creates a **linear and clean commit history** without merge commits. ### Example ```bash # Switch to your feature branch git switch feature_branch # Rebase your feature branch on top of main git rebase main ``` Alternatively, ```bash git checkout git rebase ``` > `git switch ` and `git checkout ` both switch branches, but `switch` is newer and more user-friendly. --- Both merge and rebase are used to integrate changes from one branch into another. **Merging** combines the histories of two branches by creating a new **merge commit**. It **preserves the true sequence of events**, showing exactly how and when branches diverged and rejoined. ```bash * b576e33 (HEAD -> main) Merge branch 'feature' into main |\ | * 22c5476 C4 | * b1a9c33 C3 * | f2a4d33 C2 (branch - 'feature') |/ * c9f0a10 C1 (main) ``` **Rebasing**, on the other hand, **reapplies your commits** on top of another branch’s latest state. This effectively **keeps the commit history linear and clean**, as if all your work happened sequentially after the commits on the target branch. ```bash * e4d2b3c (HEAD -> feature) C4 * 3f68a71 C3 (branch - 'feature') * f2a4d33 C2 * c9f0a10 C1 (main) ``` ``` bash # This command will display an ASCII-style commit graph directly in your terminal. # It shows commit history in a tree-like structure. git log --graph --oneline --all ``` ## Merge vs Rebase | **Feature** | **Merge** | **Rebase** | |------------------|------------------------------------------------|---------------------------------------------| | **History** | Preserves the true chronological history | Creates a linear history | | **Extra Commits**| Adds an extra merge commit | No extra commits | | **Readability** | Can become cluttered with merge commits | Easier to read and follow | | **Use Case** | Ideal for public branches (e.g., `main`) | Ideal for personal or feature branches | ## Important Rule **Never rebase a public/shared branch (like main).** Rebasing rewrites commit history, which can cause problems for collaborators who have already based work on those commits. Always rebase your personal or feature branch **onto main**, not the other way around. > If the branch is shared — use merge. > If the branch is personal — use rebase. ## Git Configuration Options You can tell Git whether to merge or rebase when pulling updates: ```bash # Always merge (default behavior) git config pull.rebase false # Always rebase by default (recommended for linear history) git config --global pull.rebase true ``` **NOTE: Setting the global option ensures your local branches stay clean and linear without unnecessary merge commits.** ================================================ FILE: docs/additional-material/git_workflow_scenarios/removing-a-file.md ================================================ # Removing a file from Git Sometimes, you may want to remove a file from Git but not delete it from your computer. You can achieve this by using the following command: ``git rm --cached`` ## So what happened? Git will no longer keep track of changes in the removed file. As far as Git knows, it's as if you had deleted the file. If you were to locate the file in your file system, you will notice that it's still there. Notice that in the example above, the flag `--cached` is used. If we didn't add this flag, Git will remove the file from not just the repo, but from your file system too. If you commit the change with `git commit -m "Remove file1.js"` and pushed it to the remote repository using `git push origin master`, the remote repository will remove the file. ## Additional features - If you want to remove more than one file, you can include them all in the same command: `git rm file1.js file2.js file3.js --cached` - You can use a wildcard (*) to remove similar files. For example, if you would like to remove all .txt files from your local repository: `git rm *.txt --cached` ================================================ FILE: docs/additional-material/git_workflow_scenarios/removing-branch-from-your-repository.md ================================================ # Remove a branch from your repository If you have followed the tutorial up-to-now, our `` branch has finished its purpose, it is time to delete it from your local machine's repo. This isn't necessary, but the name of this branch shows its rather special purpose. Its life can be made correspondingly short. First, let's merge your `` to your master, so to go to your master branch: ``` git checkout master ``` Merge `` to master: ``` git merge master ``` Remove `` on your local machine's repo: ``` git branch -d ``` You have now deleted your local machine's `` branch and everything looks neat and tidy. Though, at this point, you should still have the `` branch in your GitHub fork. However, before you delete this, remember that you have sent a "Pull request" to my repo from this remote branch. So unless I've already merged it, don't delete this branch. However, if I have merged your branch and you want to delete the remote branch, use: ``` git push origin --delete ``` Now, you know how to tidy your branches. With time, many commits will be added to my public repo. And the master branches of your local machine and of your GitHub fork won't be up-to-date. So in order to keep your repositories synchronized with mine, follow the steps below. #### [Keeping your fork synced with the repository](keeping-your-fork-synced-with-this-repository.md) ================================================ FILE: docs/additional-material/git_workflow_scenarios/resetting-a-branch.md ================================================ # Reset a branch ```reset``` is the command which can be used when we want to reset the repository with respect to a commit or a branch. A reset, as the name suggests, discards everything on the base(current) branch and makes it exactly same as the branch with which we chose to reset the base branch (calling it as origin branch). This essentially means, that we will have a copy of the origin branch with the name of base branch.
However, the question is, why don't we just delete the base branch and checkout a new branch with the name of base branch from origin branch. Technically, it will have the same effect as resetting but in some industrial situations we do not have the access to delete a branch, or we can not delete a branch as it will hamper/disrupt a CI/CD pipeline or maybe an ongoing workflow. Hence, to avoid such situations which can lead to downtimes, we suggest using `git reset` whenever we want to reset a particular branch. ## The Command Its very easy to execute a git reset for branch. ``` git reset ``` An example could be: ``` git reset stage master --hard ``` The above command will reset the `stage` branch with `master` and therefore make `stage` exactly same as `master`. You must be wondering about why `--hard` flag is used? This is to ignore all the changes which are or will be staged before/after the reset. ================================================ FILE: docs/additional-material/git_workflow_scenarios/resetting-a-commit.md ================================================ # Reset a commit ```reset``` is the command which can be used when we want to move the repository back to a previous commit, discarding any changes made after that commit.
The main difference between resetting and reverting a commit is that git reset ```unstages a file and bring our changes back to the working directory``` and git revert ```removes the commits from the remote repository```.
```git reset``` can be achieved using following commands: - The following command will give summary of all the commits using following two parameters: - The first seven characters of the commit hash - this is what we need to refer to in our **reset** command. - the commit message ``` git log --oneline ``` - One can reset repository back to the specific commit using following command:
```git reset commithash``` where commithash being the first 7 characters of the commit hash we found in the log ================================================ FILE: docs/additional-material/git_workflow_scenarios/resolving-merge-conflicts.md ================================================ # What is a merge conflict? A merge conflict occurs when changes from different branches clash and Git cannot merge them automatically. Common scenarios include: - Two contributors editing the same line in a file. - One contributor deletes a file that another has modified. - Simultaneous renaming of a file to different names in separate branches. In such cases, Git will pause the merge process and mark the conflicting files for manual resolution. There are tools that helps users resolve these conflicts but in this guide, we will be focusing on the git command line tool. ## How to resolve a merge conflict? 1. **Identify Conflicted Files** After attempting a merge, Git will notify you of conflicts. Use the following command to list them: ```bash git status ``` Look for files listed under "Unmerged paths." 2. **Open and Examine Conflicted Files** Open each conflicted file in your preferred text editor. Git sets boundaries for conflicts using the following markers: ```plaintext <<<<<<< HEAD Your changes ======= Incoming changes >>>>>>> branch-name ``` - `<<<<<<< HEAD` represents your current branch's changes. - `=======` separates the conflicting changes. - `>>>>>>> branch-name` shows the incoming changes from the other branch. 3. **Resolve the Conflicts** Decide how to integrate the changes: - Keep your changes. - Accept the incoming changes. - Combine both changes in a coherent manner. After making the necessary edits, remove the conflict markers (<<<<<<<, =======, >>>>>>>) 4. **Mark Conflicts as Resolved** Once you've resolved the conflicts in a file: ```bash git add ``` **Repeat this for each conflicted file.** 5. **Commit the Merge** After staging all resolved files: ```bash git commit -m "Resolved merge conflicts" ``` 🎉This finalizes the merge process.🎉 --- # Additional information ## Tools to Assist in Conflict Resolution - Git Merge Tool: Launches a visual merge tool to help resolve conflicts. ```bash git mergetool ``` > Note: Ensure you have a merge tool installed (e.g., Meld, KDiff3, Beyond Compare). - Abort a Merge: If you wish to cancel the merge process: ```bash git merge --abort ``` ## Best Practices to Avoid Conflicts Pull Regularly: Frequently pull changes from the main branch to stay updated. ```bash git pull origin main ``` Work on Feature Branches: Create separate branches for each feature or fix. ```bash git checkout -b feature-branch ``` ## Additional Resources - [GitHub: Resolving Merge Conflicts via Command Line](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-using-the-command-line) - [Atlassian: Git Merge Conflicts Tutorial](https://www.atlassian.com/git/tutorials/using-branches/merge-conflicts) - [FreeCodeCamp: Practical Guide to Merge Conflicts](https://www.freecodecamp.org/news/resolve-merge-conflicts-in-git-a-practical-guide/) By following this guide, you'll be well-equipped to handle merge conflicts confidently, ensuring a smoother contribution process to any open source project! ================================================ FILE: docs/additional-material/git_workflow_scenarios/reverting-a-commit.md ================================================ # Revert a commit To revert a commit simply means to create a brand new commit that undoes all the changes made in a previous one. It is like doing a ```CTRL + Z ``` on git. Reversion is made easier in git because every commit you push to your remote repository has a unique alphanumeric key known as SHA(Secure Hash Algorithm) tied to it. So this means you can revert any commit as long as you have the SHA. But then, you have to be careful to reverse orderly so as not to mess your repository up. To pick out the SHA of the specific commit we want to undo, a log of all the commits we have made so far would come in handy. To get this, we would run the command: ```git log --oneline ``` Running the ```git log``` command alone would also give us the SHAs (in long form) However using the ```--oneline ``` flag tells git that we want it displayed in a concise (one line) manner for easy read. The first 7 characters displayed when you run this command is called the abbreviated commit hash. For example, here is what I get when I run ```git log --oneline ``` on this repository: ``` 389004d added spacing in title c1b9fc1 Merge branch 'master' into tutorials 77eaafd added tutorial for reverting a commit ``` So this shows that with ```git log --oneline```, we can fetch a list of all the commits made on the repository together with the first 7 characters of its SHA. Now, Let's assume I want to undo my commit of "added spacing in title", here are the steps I would take: * Copy the SHA of the commit which, in this case is ```389004d``` * Then, run the command ```git revert 389004d``` This would pop open my text editor and prompt me to edit the commit message. You can decide to leave the commit message as the default git message which starts with the word `Revert` or you can also decide to customize the message to your liking. * Next, I will save and close the text editor. * Return to the command line. * Run ```git push origin ``` to push the reverted changes to Github. And that is it, the change would be undone. In this case, my repository would be reverted to how it looked like in ```c1b9fc1``` ================================================ FILE: docs/additional-material/git_workflow_scenarios/squashing-commits.md ================================================ # What is squashing? In git, squashing refers to rewriting the history of your commits, so you end up with one commit with a description of the changes done. It's usually done in open source projects because a lot of the history of a branch in open source projects is only relevant to the developer who created it, and this provides a simpler way to describe the changes made and also revert them if needed. # How do you squash commits? First, perform a git log to review the commits you would like to merge in your current branch. ``` git log ``` You should see a series of your commits like so: ``` commit blablabla Author: omguhh Date: 10/10/20 Commit message 1 commit blablabla2 Author: omguhh Date: 10/10/20 Commit message 2 ``` So now that you see the commits you wish to merge to one, we can move along into doing that with ```git rebase```. Assuming you're already familiar with ```git rebase```, we can starting squashing commits in the interactive mode of git rebase that you can activate like so: ``` git rebase -i ``` Now, with interactive rebasing you can specify the starting and end point of how far back you want to go with commits like so: ``` git rebase -i HEAD~2 ``` Running this command will show you something like the following: ``` pick blablabla Changing test01.txt file pick blablabla2 Adding dummy01.txt file # # Commands: # p, pick = use commit # r, reword = use commit, but edit the commit message # e, edit = use commit, but stop for amending # s, squash = use commit, but meld into previous commit # f, fixup = like "squash", but discard this commit's log message # x, exec = run command (the rest of the line) using shell # # These lines can be re-ordered; they are executed from top to bottom. # # If you remove a line here THAT COMMIT WILL BE LOST. # # However, if you remove everything, the rebase will be aborted. # # Note that empty commits are commented out ``` So if you want to squash ```blablabla2``` into ```blablablabla```, you would change the following : ``` pick blablabla Changing test01.txt file squash blablabla2 Adding dummy01.txt file ``` If all goes well, you'd get a result that looks like this: ``` # This is a combination of 2 commits. # The first commit's message is: commit message 1 # This is the 2nd commit message: commit message 2 ``` That you can freely change before you decide to exit the editor to save these changes. Running git log again should show you the commit message you entered before exiting the screen with the commits combined into one. ================================================ FILE: docs/additional-material/git_workflow_scenarios/stashing-a-file.md ================================================ # Stashing What if you are working on a big code and suddenly you need to switch the branch from which you are currently working on to some other branch. Since the code, is not complete, and without any tests, you probably don't want to commit it. But you cannot move to the other branch without committing the changes, Git won't let you break this flow. What do we do then? How do we prevent an unnecessary commit, while being able to jump branches? This is what this tutorial covers. ## Stashing your work Let's assume you are working on a project's branch where you have changed some files. Now if you run ```git status``` you can see your changes in the files. ``` $ git status # On branch master # Changes to be committed: # (use "git reset HEAD ..." to unstage) # # modified: index.html # # Changes not staged for commit: # (use "git add ..." to update what will be committed) # # modified: lib/simplegit.rb # ``` Now you want to switch your branch, but don't want to commit the changes yet; so you would stash the changes. To push a new stash on to your stack, run ```git stash```: ``` $ git stash Saved working directory and index state \ "WIP on master: 049d078 added the index file" HEAD is now at 049d078 added the index file (To restore them type "git stash apply") ``` Now your working directory is clean, use ```git status``` : ``` $ git status # On branch master nothing to commit, working directory clean ``` Now you can switch to any branch and do your work; your stashed changes are stored in form of a stack. To see which stashes you have stored in the stack you can use ```git stash list```: ``` $ git stash list stash@{0}: WIP on master: 049d078 added the index file stash@{1}: WIP on master: c264051 Revert "added file_size" stash@{2}: WIP on master: 21d80a5 added number to log ``` In case you want to re-apply the changes you just stashed, you can use the command ```git stash apply```. By using this command you can reapply the most recent stashed file. In order to reapply any other file, you can specify it by naming it like: ```git stash apply ```, in place of `````` write the name of the stash you need to reapply. ``` $ git stash apply # On branch master # Changes not staged for commit: # (use "git add ..." to update what will be committed) # # modified: index.html # modified: lib/simplegit.rb # ``` You can see that git re-modifies the file that you uncommitted when you saved the stash. In this case, you had a clean working directory when you tried to apply the stash, and you tried to apply it on the same branch you saved it from; but having a clean working directory and applying it on the same branch aren’t necessary to successfully apply a stash. You can save a stash on one branch, switch to another branch later, and re-apply the changes in the new branch. You can also have modified and uncommitted files in your working directory when you apply a stash, git gives merge conflicts if anything no longer applies cleanly. The changes made to your files are reapplied, but the file you staged was not restaged. To do so you need to run the command ```git stash apply``` with a ```--index``` to tell the command to reapply the staged changes. If you have run that instead, you would have returned to your original position: ``` $ git stash apply --index # On branch master # Changes to be committed: # (use "git reset HEAD ..." to unstage) # # modified: index.html # # Changes not staged for commit: # (use "git add ..." to update what will be committed) # # modified: lib/simplegit.rb # ``` The apply command only applies the stashed work, but you still have that on your stack. In order to remove it, you can run ```git stash drop``` with the name of the stash to remove. ``` $ git stash list stash@{0}: WIP on master: 049d078 added the index file stash@{1}: WIP on master: c264051 Revert "added file_size" stash@{2}: WIP on master: 21d80a5 added number to log $ git stash drop stash@{0} Dropped stash@{0} (364e91f3f268f0900bc3ee613f9f733e82aaed43) ``` You can use ```git stash pop``` to un-stash the last changes drop it from your stash's stack. ## Un-applying a Stash In some cases you want to apply stashed changes, do some work, but un-apply the changes that originally came from the stash. Git does not provide command like ```git unapply```, but it is possible to achieve this effect by simply retrieving the patch associated with a stash and applying it in reverse: ```$ git stash show -p stash@{0} | git apply -R``` Again if you don't specify a stash, Git assumes the most recent stash: ```$ git stash show -p | git apply -R``` You may want to create an alias and effectively add a ```stash-unapply``` command to your Git. For example: ``` $ git config --global alias.stash-unapply '!git stash show -p | git apply -R' $ git stash apply $ #... work work work $ git stash-unapply ``` ## Creating a Branch from Stash If you stash some work, leave it there for a while, and continue on the branch from which you stashed the work, you may have a problem reapplying the work. If the apply tries to modify a file that you’ve since modified, you’ll get a merge conflict and will have to resolve it. If you want an easier way to test the stashed changes again, you can run ```git stash branch```, which creates a new branch for you, checks out the commit you were on when you stashed your work, reapplies your work there, and then drops the stash if it applies successfully: ``` $ git stash branch testchanges Switched to a new branch "testchanges" # On branch testchanges # Changes to be committed: # (use "git reset HEAD ..." to unstage) # # modified: index.html # # Changes not staged for commit: # (use "git add ..." to update what will be committed) # # modified: lib/simplegit.rb # Dropped refs/stash@{0} (f0dfc4d5dc332d1cee34a634182e168c4efc3359) ``` This is a nice shortcut to recover stashed work easily and work on it in a new branch. ================================================ FILE: docs/additional-material/git_workflow_scenarios/storing-credentials.md ================================================ # Storing Credentials You might have complained about this before - entering your username and password each time you access the repository can be a hassle and can interrupt your workflow if it takes too long. But it doesn't need to be that way. We will be covering one of the methods available to us - [git credential cache](https://git-scm.com/docs/git-credential-cache). **Note:** Please follow the security policies of your place of work/study. ## Caching We can use git credential cache to store our username and password. **Attention:** This method saves the credentials in *plaintext* on your PC's disk. Everyone on your computer can access it, e.g. malicious NPM modules. ### Global Credential Cache If we wish to, we can store the credentials for every repository we are working with using one simple command: ``` $ git config --global credential.helper cache ``` **Reminder:** Please follow the security policies of your place of work/study. ### Repository Credential Cache We can store the credentials for the repository we are working with using one simple command, similar to before: ``` $ git config credential.helper cache ``` **Reminder:** Please follow the security policies of your place of work/study. ### Cache Timeout If we do not specify a length of time to store our credentials, they can potentially be stored forever. However, we can determine how long they will be kept in memory using this command: ``` git config credential.helper 'cache --timeout=' ``` Using the helper, the credentials will never touch the disk and will be erased after the specified timeout. The default value is 900 seconds (15 minutes). #### References [Stack Overflow](https://stackoverflow.com/questions/35942754/how-can-i-save-username-and-password-in-git) ### [Additional Material](additional-material.md) ================================================ FILE: docs/additional-material/git_workflow_scenarios/undoing-a-commit.md ================================================ # Undo local commits To undo a local commit, all you need to do is ``` git reset ``` This command will reset your staging area to your most recent commit, but the changes you made to your working directory will not change. So, you can still re-commit again what you've changed. Or, if you only want to remove one file from your previous commit. Then, you can do the command below ``` git reset ``` The command will remove only the specified file from the staging area, but changes made on the file will still remain. Example of ```git reset``` usage ``` # Make changes in index.php and tutorial.php # Add files into the staging area $ git add . # Remembered both files need to be committed separately # Unstage tutorial.php $ git reset tutorial.php # Commit index.php first $ git commit -m "Changed index.php" # Commit tutorial.php now $ git add tutorial.php $ git commit -m "Changed tutorial.php" ``` Let's say if you have messed up your local repository and you just want to reset it to your last commit. Then, you can run the command below. ``` git reset --hard ``` The command will not only reset your staging area, but also revert all your changes on the files to your last commit. The mode ```--hard``` tells Git to undo all the changes in the working directory too. You should only run this when you are really sure of throwing your whole local development out. Example of ```git reset --hard``` usage ``` # Decided to start a crazy experiment # Create a new file 'crazy.php' and add some code to it # Commit crazy.php $ git add crazy.php $ git commit -m "Started a crazy dev" # Edit crazy.php file again and changed a lot of other files # Commit all tracked files $ git add . $ git commit -m "Continued dev" # Tested and things went out of hand # Decided to remove the whole things $ git reset --hard HEAD~2 ``` The ```git reset --hard HEAD~2``` moves the current branch backward by 2 commit points at the same time reverting all changes you have made and remove the 2 snapshots we have just created from project history. P.s. Never perform ```git reset --hard``` if you've already pushed your commits to a shared repository as it will cause problems to everyone on that repository. ================================================ FILE: docs/additional-material/git_workflow_scenarios/why-using-branches.md ================================================ ## Why Use Branches When Contributing? Git branches are an essential tool for collaboration in software development. They allow multiple developers to work on different features or bug fixes simultaneously without interfering with the main project code. By using branches, you can experiment freely, test new ideas, and merge only the best changes into the main project. ## What Are Branches? A **branch** in Git is essentially a separate line of development. It allows you to create an isolated version of the project where you can make changes without affecting the main codebase. When you're ready, you can merge your branch back into the main project. ### How Branches Work Every branch is just a pointer to a specific commit in the project history. When you create a new branch, Git duplicates the state of the current branch, allowing you to work independently. New commits are added to this branch's history without affecting the main branch. - To switch between branches, use `git checkout`. - To combine changes from one branch into another, use `git merge`. ## Why Use Branches? Branches make collaboration **structured and efficient**. Without them, all changes would be made directly to the main project, leading to confusion, errors, and conflicting code. ### Example: The Car Paint Job Analogy Imagine a car manufacturing team deciding on the default color for a new car model. Initially, the car is set to be **olive green**. However, a few team members want to see how it looks in **red**. - Instead of repainting the original car, they create a **prototype** with red paint. - If the red color is approved, it replaces the original color (i.e., the branch is merged into the main project). - If the red color is rejected, the prototype is discarded (i.e., the branch is deleted). Similarly, in Git, branches allow developers to test new features without directly modifying the main codebase. ## Feature Branching Instead of having one branch per developer, it's better to create **one branch per feature**. This keeps things organized and prevents unnecessary conflicts. ### Example: Alice & Bob's Feature Development - **Alice** is working on **Feature A** and makes several commits. - She then switches to **Feature C** and makes more commits. - Meanwhile, **Bob** finishes **Feature B** and wants to start working on **Feature A**. - Bob pulls in Alice’s branch, but now his branch contains **Feature A, Feature B, and some incomplete parts of Feature C**. - When he tries to merge his branch, he faces conflicts because Feature C is unfinished. To avoid this: - Alice should have separate branches for **Feature A** and **Feature C**. - Bob should have separate branches for **Feature B** and **Feature A**. This way, they can work without interfering with each other's progress. ## Creating and Managing Branches ### Create a New Branch ```sh git branch my-new-branch ``` This creates a new branch named `my-new-branch` without switching to it. ### Switch to a Branch ```sh git checkout my-new-branch ``` This moves you to `my-new-branch`, allowing you to work on it. ### Create and Switch to a Branch (Shortcut) ```sh git checkout -b my-new-branch ``` This creates and switches to the new branch in a single step. ### Delete a Branch (After Merging) ```sh git branch -d my-new-branch ``` This removes `my-new-branch` if it has already been merged. ### Force Delete a Branch (Without Merging) ```sh git branch -D my-new-branch ``` Use this with caution! It deletes the branch even if it has unmerged changes. ## Additional Resources - [Git Branching Guide (Atlassian)](https://www.atlassian.com/git/tutorials/using-branches) - [Removing a Branch from Your Repository](https://github.com/jashnimje/first-contributions/blob/7dcae72208e4b42fcf834b4f189fa8ee78238077/additional-material/git_workflow_scenarios/removing-branch-from-your-repository.md) ================================================ FILE: docs/additional-material/translations/Belarusian/Useful-links-for-further-learning.by.md ================================================ # Карысныя спасылкі Гэты дакумент прысвечаны ўсіх сайтаў з парадамі і рэкамендацыямі, паведамленнях у блогах і карысным сайтам, якія палягчаюць наша жыццё. Яны з'яўляюцца выдатным арыенцірам для задавальнення ўсіх нашых патрэбаў, няхай гэта будзе пачатковец або эксперт. Гэтая старонка павінна служыць індэксам ўсіх тых карысных спасылак, якія дапамогуць усім, хто пачатковец у вобласці адкрытага зыходнага кода, ці каму-небудзь, хто хоча даведацца больш. ## Спіс 1. [Interactive tutorial to git](https://try.github.io) 2. [git - the simple guide](http://rogerdudler.github.io/git-guide/) 3. [On undoing, fixing, or removing commits in git](http://sethrobertson.github.io/GitFixUm/fixup.html) 4. [Git and GitHub tutorial translated to many languages](https://github.com/Roshanjossey/first-contributions) 5. [Merge Conflicts](https://www.git-tower.com/learn/git/ebook/en/command-line/advanced-topics/merge-conflicts) 6. [Resolving Merge Conflicts](https://githowto.com/resolving_conflicts) 7. [Basics of Git - The Simple Quick Start Guide](https://blog.praveen.science/basics-of-git-the-quick-start-guide/) 8. [Git Standards followed in our way of Spotify Agile Methodology](https://blog.praveen.science/git-standards-followed-in-our-way-of-spotify-agile-methodolgy/) 9. [Git Shortcuts](https://blog.praveen.science/git-shortcuts/) 10. [Official Git cheat sheet in many languages](https://services.github.com/on-demand/resources/cheatsheets) 11. [Git cheat sheet from Tower](https://www.git-tower.com/learn/cheat-sheets/git) 12. [Common Git Problems](https://www.codementor.io/citizen428/git-tutorial-10-common-git-problems-and-how-to-fix-them-aajv0katd) 13. [Git Rebase](https://blog.gitprime.com/git-rebase-an-illustrated-guide/) 14. [Beginner's Guide to Rebasing and Squashing](https://github.com/servo/servo/wiki/Beginner%27s-guide-to-rebasing-and-squashing) 15. [Git Cheatsheet that shows correlations between commands and files](http://ndpsoftware.com/git-cheatsheet.html) 16. [How to contribute](https://opensource.guide/how-to-contribute/) 17. [Getting started with Open Source](https://github.com/OpenSourceHelpCommunity/Getting-Started-With-Contributing-to-Open-Sources) 18. [How to contribute](https://github.com/freeCodeCamp/how-to-contribute-to-open-source) 19. [Atlassians Git Tutorials](https://www.atlassian.com/git) 20. [Pull request reviews](https://help.github.com/articles/about-pull-request-reviews/) 21. [Another Interactive tutorial for git](https://learngitbranching.js.org/) 22. [Git commandline cheat-sheet](https://gist.github.com/davfre/8313299) 23. [Programming Books](https://github.com/EbookFoundation/free-programming-books) 24. [E-Book of professional tip and secrets](https://goalkicker.com/GitBook/GitProfessionalTipsSecrets.pdf) 25. [tutorial about simple rules of become git professional](https://medium.freecodecamp.org/follow-these-simple-rules-and-youll-become-a-git-and-github-master-e1045057468f) 26. [A Note About Git Commit Messages](https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) 27. [5 Useful Tips For A Better Commit Message](https://thoughtbot.com/blog/5-useful-tips-for-a-better-commit-message) 28. [Version Control using Git](https://ourcodingclub.github.io/2017/02/27/git.html) 29. [Version Control with Git](https://www.udacity.com/course/version-control-with-git--ud123) Працягвайце дадаваць больш спасылак, якія вам падаюцца карыснымі. ================================================ FILE: docs/additional-material/translations/Belarusian/additional-material.by.md ================================================ # Дадатковая інфармацыя Тут мы мяркуем, што вы ўжо асвоілі асноўную інструкцыю. Дадатковая інфармацыя змяшчае некаторыя звесткі аб GIT камандах, необходимыж ў больш складаных сітуацыях. ### [Выпраўленні ў каміты](amending-a-commit.by.md) Дакумент змяшчае інфармацыю аб тым, як ўнесці выпраўлення ў commit ў аддаленым рэпазітары. > Яна неабходная для тых выпадкаў, калі вы хочаце змяніць commit, які вы зрабілі раней. ### [Канфігураванне GIT](configuring-git.by.md) Дакумент змяшчае сведния пра тое, як змяніць інфармацыю аб карыстальніку і іншыя налады GIT. > Ён будзе карысны, калі вы захочаце зрабіць ўстаноўкі GIT больш зручнымі. ### [Сінхранізацыя вашага адгалінаванні з асноўным рэпазітаром](keeping-your-fork-synced-with-this-repository.by.md) Дакумент распавядае аб тым, як забяспечыць сінхранізацыю вашага адгалінаванні з асноўным рэпазітаром. Забеспячэнне сінхранізацыі небходнасць, так як, наколькі можна спадзявацца, вы будзеце працаваць над праектам не ў адзіноце, а ўносіць змены ў яго, разам з іншымі ўдзельнікамі. > Выканайце гэтыя дзеянні, калі ваша адгалінаванне не мае змяненняў у master галінцы рэпазітара. ### [Перамяшчэнне камітаў ў іншую галінку](moving-a-commit-to-a-different-branch.by.md) Дакумент змяшчае звесткі аб тым, як перамясціць commit ў іншую галінку. > Выканайце названыя крокі, каб перамясціць комм ў іншую галінку. ### [Выдаленне файла](removing-a-file.by.md) Дакумент апісвае як выдаліць файл з вашага лакальнага рэпазітара. > Азнаёмцеся з гэтымі камандамі каб зразумець як выдаліць файл перад тым, як зрабіць commit. ### [Выдаленне галінкі з вашага рэпазітара](removing-branch-from-your-repository.by.md) Дакумент змяшчае інфармацыю аб тым, як выдаліць галінку з вашага рэпазітара. > Выкарыстоўвайце гэтыя каманды толькі пасля таго, як ваш pull-request быў задаволены. ### [Дазвол канфліктаў пры зліцці галінак](resolving-merge-conflicts.by.md) Дакумент змяшчае інфармацыю аб тым, як вырашаць канфлікты, якія ўзнікаюць пры зліцці галінак. > Прапанаваныя тут крокі дапамогуць вам разабрацца з вельмі непрыемнымі выпадкамі канфліктаў якія ўзнікаюць пры зліцці галінак. ### [Адмена камітаў](reverting-a-commit.by.md) Дакумент інструктуе як адмяніць commit ў аддаленым рэпазітары. Такая аперацыя будзе карысная ў тых выпадках, калі вам неабходна адыграць назад той commit, які ўжо быў пасланы на Github (pushed). > Выканайце названыя тут крокі каб адмяніць commit. ### [Сумяшчэнне камітаў (squashing)](squashing-commits.by.md) Дакумент апісвае, як сумяшчаць камітаў пры дапамозе інтэрактыўнага перабазавання. > Выкарыстоўвайце гэтыя інструкцыі, калі вы стварылі пул-реквест ў open source праекце, але эксперт праекта просіць вас сумясціць усе вашыя камітаў ў адзін комм з змястоўным каментаром. ### [Адмена лакальнага каміту](undoing-a-commit.by.md) Дакумент утрымлівае інфармацыю, як адыграць назад commit ў вашым лакальным рэпазітары. Вам спатрэбіцца гэтая інфармацыя ў тым выпадку, калі вы вырашыце, што вы сапсавалі ваш рэпазітар і захочаце вярнуць яго змесціва да першапачатковага стану. > Выконвайце гэтым інструкцыям, калі вы хочаце адмяніць тыя змены, якія былі зробленыя апошнім лакальным commit . ### [Карысныя спасылкі](Useful-links-for-further-learning.by.md) Гэты файл утрымлівае спасылкі на блог-пасты, карысныя вэб-сайты, вэб-сайты з пералікам рэкамендацыі і прыёмаў, якія часта палягчаюць наша жыццё. Як пачаткоўцам, так і экспертам мы рэкамендуем звяртацца да іх па меры неабходнасці. Гэты файл утрымлівае спіс карысных спасылак, якія напэўна дапамогуць і тым, хто робіць першыя крокі ў open source, і тым, хто захоча павялічыць свае веды ў гэтай галіне. ================================================ FILE: docs/additional-material/translations/Belarusian/amending-a-commit.by.md ================================================ # Выпраўленні ў каміты Уявіце, што вы зрабілі commit ў выдалены рэпазітар, а потым зразумелі, што дапусцілі памылку друку ў каментары да commit або забыліся ўставіць радок у гэты апошні па часе commit. Як паступіць у гэтай сітуацыі? Менавіта пра гэта і пойдзе гаворка ў гэтым дакуменце. ## Як змяніць каментар да нядаўняга камітаў пасля таго, як ён быў пасланы на Github (pushed) Каб зрабіць гэта, не адкрываючы файл для рэдагавання, * Набярыце ```git commit --amend -m "followed by your new commit message"``` * А затым выканаеце ```git push origin ``` для таго, каб паслаць змены на Github. Заўвага: Калі вы набярэце, толькі ```git commit --amend```, то адкрыецца тэкставы рэдактар і прапануе адрэдагаваць каментар да commit. Выкарыстанне ключа `` -m`` адмяняе запуск рэдактара. ## Як зрабіць змены ў адным commit Што калі мы забыліся зрабіць невялікае змяненне ў файле, напрыклад, замяніць адно слова ў commit, які ўжо пасланы ў выдалены рэпазітар? Хай, для прыкладу, запісы ў часопісе маіх commit выглядаюць наступным чынам: `` ` g56123f create file bot file a2235d updated contributor.md a5da0d modified bot file `` ` Дапусцім, я забыўся дадаць адно слова ў файл bot file Ёсць два спосабу выправіць гэта. Першы заключаецца ў стварэнні новага commit, які змяшчае гэта змена, напрыклад, так: `` ` g56123f create file botfile a2235d updated contributor.md a5da0d modified botfile b0ca8f added single word to botfile `` ` Другі спосаб складаецца ў выпраўленні камітаў a5da0d, даданні гэтага прапушчанага слова і запушивании гэтых змяненняў на Github ў выглядзе аднаго камітаў. Другі спосаб ўяўляецца пераважнай, паколькі справа ідзе толькі аб нязначным змене. Каб дамагчыся гэтага, мы паступім наступным чынам: * Зменім файл. У дадзеным выпадку я змяню файл botfile, дадаўшы да яго слова, якое я прапусціў раней. * Далей, праіндэксуем гэты файл пры дапамозе каманды ```git add ``` У звычайным выпадку адразу пасля індэксавання мы робім `` `git commit -m" коментар да нашага commit "` ``, правільна? Але паколькі ў дадзеным выпадку наша задача - выправіць папярэдні commit, - то замест гэтага мы выканаем такую каманду: * ```git commit --amend``` У выніку адкрыецца акно тэкставага рэдактара, у якім мы маем магчымасць зрабіць змены ў каментары. Мы можам на самай справе адрэдагаваць каментар, ці пакінуць яго без зменаў. * Выйдзем з рэдактара * Запушим нашы змены пры дапамозе каманды ```git push origin ``` Такім чынам, абодва выпраўлення апынуцца ў адным commit. ================================================ FILE: docs/additional-material/translations/Belarusian/configuring-git.by.md ================================================ # Канфігураванне GIT Калі вы ўпершыню паспрабавалі зрабіць commit, вы маглі ўбачыць такое паведамленне: ```bash $ git commit *** Please tell me who you are. Run git config --global user.email "you@example.com" git config --global user.name "Your Name" to set your account's default identity. Omit --global to set the identity only in this repository. ``` Каб стварыць commit, GIT павінен ведаць хто з'яўляецца яго аўтарам. Пры сумеснай працы, неабходна ведаць кім і калі былі змененыя тыя ці іншыя часткі праекта, таму GIT прадугледжвае, што кожны commits пры яго стварэнні асацыюецца з імем і емейл адрасам карыстальніка. Існуе некалькі спосабаў, якія дазваляюць асацыяваць каманду `git commit` з вашым емейл і імем, і тут мы пералічым некаторыя з іх. ### Глабальная канфігурацыя Інфармацыя, захаваная як частка глабальнай канфігурацыі, адносіцца да ўсёй сістэмы, г.зн. да ўсіх рэпазітароў, у якіх вы працуеце. Гэта пераважны спосаб, прыдатны для большасці з варыянтаў выкарыстання. Каб захаваць што-небудзь у глабальным канфігурацыі, вы выкарыстоўваеце каманду `config` наступным чынам: `$ git config --global ` Ва ўжыванні да інфармацыі пра карыстальніка, мы выконваем гэтыя каманды такім чынам: `` ` $ git config --global user.email "you@example.com" $ git config --global user.name "Your Name" `` ` ### Канфігурацыя рэпазітара Як вынікае з назвы, гэтыя канфігурацыі адносяцца да вашага бягучага сховішча. Калі вы хочаце прыняць удзел у пэўным сховішчы, скажам, на праекце, звязаным з працай, з электроннай поштай вашай кампаніі, то вы можаце скарыстацца гэтым метадам. Каб змяніць канфігурацыю на ўзроўні рэпазітара, варта апусціць ключ `--global` у камандзе` config` такім чынам: `$ git config ` Ва ўжыванні да інфармацыі пра карыстальніка, гэта выглядае наступным чынам: `` ` $ git config user.email "you@alternate.com" $ git config user.name "Your Name" `` ` ### Канфігурацыя ў камандным радку Гэты спосаб канфігурацыі адносіцца толькі да дадзенай камандзе. Усе каманды GIT дазваляюць выкарыстоўваць ключ `-c` перад дзеясловам ідэнтыфікуюць каманду для часовай ўстаноўкі канфігурацыйных параметеров. Для змены параметраў канфігурацыі, якія распаўсюджваюцца толькі на дадзеную каманду, карыстайцеся наступным фарматам каманд GIT: `$ git -c = -c = ` Для нашага выпадку Каманда для камітаў будзе вылядеть так: `git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Your commit message"` ### Заўвага аб парадку предшествования Парадак предшествования сярод трох згаданых тыпаў каманд канфігурацыі вызначаецца як `command-line > repository > global`. Гэта азначае, што калі якая-небудзь пераменная вызначана, як у глабальнай канфігурацыі, так і ў камандным радку, то будзе выкарыстана значэнне, прысвоенае у камандным радку. ## Не толькі інфармацыя пра карыстальніка Да гэтага часу, абмяркоўваючы канфігурацыю GIT'а, мы дакраналіся толькі інфармацыі пра карыстальніка. Аднак GIT дазваляе канфігураваць яшчэ неслколько параметраў. Вось некторые з іх: 1. `core.editor` - паказвае назва рэдактара для рэдагавання каментар для камітаў і да т.п., 2. `commit.template` - паказвае файл, які змяшчае першапачатковы темплат для камітаў, 3. `color.ui` - лагічная зменная, якая ўказвае ці варта испольовать каляровыя шрыфты ў паведамленнях на тэрмінале GIT'а. Для прастаты мы апусцілі некаторыя дэталі. Для больш падрабязнага азнаямлення звярніцеся да [git-scm.com](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration). ================================================ FILE: docs/additional-material/translations/Belarusian/keeping-your-fork-synced-with-this-repository.by.md ================================================ # Сінхранізацыя вашага адгалінаванні з асноўным рэпазітаром Па-першае, варта разумець паток для поўнай сінхранізацыі, што важна. У гэтай схеме ёсць 3 розныя рэпазітары: мае адкрытыя сховішча ў Github `github.com / firstcontributions / first-doprino.git`, ваш відэлец сховішча на GitHub` github.com / Your-Name / first-donates / ` і сховішча мясцовай машыны, на якой вы павінны працаваць. Такі від супрацоўніцтва характэрны для праектаў з адкрытым зыходным кодам і называецца `Triangle Workflows`. triangle workflow Каб захаваць вашыя два сховішчы ў актуальным стане з маім адкрытым сховішчам, мы спачатку павінны здабыць і аб'яднаць агульнае сховішча з рэпазітарам вашай лакальнай машыны. Наш другі крок - перанесці ваша мясцовае сховішча ў відэлец GitHub. Як вы ўжо бачылі раней, толькі "з відэльцам" вы можаце папрасіць "pull request". Такім чынам, відэлец GitHub - апошняе сховішча, якое трэба абнавіць. Зараз давайце паглядзім, як гэта зрабіць: Па-першае, вы павінны быць на сваім вядучым аддзяленні. Каб даведацца, на якой філіяле вы знаходзіцеся, праверце першы радок: ``` git status ``` калі вы яшчэ не на майстры: ``` git checkout master ``` Затым вы павінны дадаць маё агульнадаступнае сховішча ў свой git з `add addstream stream-url`: ``` git remote add upstream https://github.com/firstcontributions/first-contributions.git ``` Гэта спосаб сказаць Git, што іншая версія гэтага праекта існуе ў паказаным URL-адресе, і мы называем яго "вышэй". Пасля таго, як ваш git мае імя, давайце пазнаём апошнюю версію грамадскага сховішча: ``` git fetch upstream ``` Вы толькі што атрымалі апошнюю версію майго відэльца (`upstream` remote). Зараз вам трэба аб'яднаць агульнадаступнае сховішча ў ваша галоўнае аддзяленне. ``` git rebase upstream/master ``` Тут вы аб'яднаеце грамадскае сховішча з вашай галоўнай галіной. Галоўнае аддзяленне вашай мясцовай машыны зараз актуальнае. І, нарэшце, калі вы націснеце галоўную галінку на відэлец, ваша відэлец GitHub таксама будзе змяняць: ``` git push origin master ``` Звярніце ўвагу, вы націскаеце на remote імя `origin`. Такім чынам, да гэтага часу альбо ў гэты момант усе вашыя сховішчы актуальныя. Добра зроблена! Вы павінны рабіць гэта кожны раз, калі ваш сховішча GitHub паведамляе вам, што вы здзяйсняеце некалькі commits. ================================================ FILE: docs/additional-material/translations/Belarusian/moving-a-commit-to-a-different-branch.by.md ================================================ # Перамяшчэнне камітаў ў іншую галінку Што рабіць, калі вы здзяйсняеце змены, а потым разумееце, што вы здзейснілі іншую галіну? Як вы можаце гэта змяніць? Вось што ахоплівае гэты падручнік. ## Перамяшчэнне апошніх камітаў ў існуючую галінку Для такога перамяшчэння, набярыце: `` `git reset HEAD ~ --soft` `` - Адмяняе апошняе commit, але пакідае даступныя змены. `` `git stash` `` - Захоўвае стан дырэкторыі. `` `git checkout <імя правільнай галінкі>` `` - Перамыкаецца на іншую галінку. `` `git stash pop` `` - Вяртае апошняе захаванае стан. `` `git add .` `` - Дадае індывідуальныя файлы. `` `git commit -m "your message here"``` - Захоўвае і ўносіць змены. Зараз вашы змены - у правільнай галінцы. ### Перамяшчэнне апошніх камітаў ў новую галінку Для такога перамяшчэння, набярыце: `` `git branch newbranch` `` - Стварае новую галінку, захоўваючы ўсе камітаў. `` `git reset --hard HEAD ~ [n]` `` - Вяртае галінку master назад на n камітаў. Майце на ўвазе, што змены змяшчаюцца ў гэтых камітаў будуць цалкам выдалены з галінкі master. `` `git checkout newbranch` `` - Перамыкаецца на галінку, якую вы стварылі. Гэтая галінка цяпер змяшчае ўсе commits. Запомніце: Любыя змены, якія не былі ўключаныя ў commit, будуць цалкам страчаныя. ================================================ FILE: docs/additional-material/translations/Belarusian/removing-a-file.by.md ================================================ # Выдаленне файла з-пад GIT кантролю Часам можа ўзнікнуць неабходнасць выдаліць файл з-пад GIT кантролю, але захаваць яго на кампутары. Гэта можа быць дасягнута з дапамогай наступнай каманды: `` git rm <файл> --cached`` ## Што ж адбылося? GIT больш не кантралюе змены ў аддаленым файле. З пункту гледжання GIT, гэты файл адсутнічае, але калі вы паспрабуеце лакалізаваць гэты файл у файлавай сістэме, то вы ўбачыце, што ён усё яшчэ на месцы. Звярніце ўвагу, што ў прыведзеным вышэй прыкладзе выкарыстоўваецца сцяг `--cached`. Калі мы не дадамо гэты сцяг, Git выдаліць файл не толькі з сховішча, але і з вашай файлавай сістэмы. Калі вы здзейсніце змяненне з дапамогай `git commit -m" Remove file1.js "` і перанеслі яго ў аддаленае сховішча з дапамогай `git push origin master`, выдалены рэпазітар выдаліць файл. ## Дадатковая інфармацыя - Калі вы хочаце выдаліць больш за адзін файл, гэта можна зрабіць, пералічыўшы ўсе файлы ў адной камандзе: `git rm file1.js file2.js file3.js --cached` - Вы можаце выкарыстоўваць шаблон (*) для выдалення файлаў з блізкімі імёнамі, напрыклад, калі вы хочаце выдаліць усе .txt файлы з лакальнага рэпазітара, набярыце: `git rm * .txt --cached` ================================================ FILE: docs/additional-material/translations/Belarusian/removing-branch-from-your-repository.by.md ================================================ # Выдаленне галінкі з вашага рэпазітара Калі вы да гэтага часу выконвалі ўрок, то наша галіна `` скончыла сваё прызначэнне, прыйшоў час выдаліць яго з рэпазітара вашай лакальнай машыны. Гэта не абавязкова, але назва гэтай галіны паказвае сваё даволі спецыяльнае прызначэнне. Яго жыццё можа быць адпаведна кароткім. Спачатку давайце аб'яднаем ваша `` з вашым майстрам, каб перайсці да вашай галіны: ``` git checkout master ``` Зліце `` у майстар: ``` git merge master ``` Выдаліце `` у сховішчах вашай лакальнай машыны: ``` git branch -d ``` Цяпер вы выдалілі галінку лакальнай машыны `` і ўсё выглядае акуратна і акуратна. Хоць, у гэты момант у вашай раздзеле GitHub усё яшчэ павінна быць аддзяленне ``. Тым не менш, перш чым выдаліць гэта, памятайце, што вы адправілі "Pull request" у маё сховішча з гэтага аддаленага аддзялення. Таму, калі я ўжо аб'яднаў гэта, не выдаляйце гэтую галінку. Аднак калі я аб'яднаў вашу галіну і вы хочаце выдаліць аддаленую галінку, выкарыстоўвайце: ``` git push origin --delete ``` Цяпер вы ведаеце, як прывесці ў парадак свае галіны. З часам у маім публічным сховішчы будзе дададзена шмат камісій. І галоўныя галіны мясцовай машыны і вашага відэльца GitHub не будуць актуальнымі. Такім чынам, каб захаваць вашыя сховішча сінхранізаванымі з маімі, выканайце наступныя дзеянні. #### [Захоўваючы відэлец сінхранізаваным з сховішчам](keeping-your-fork-synced-with-this-repository.md) ================================================ FILE: docs/additional-material/translations/Belarusian/resolving-merge-conflicts.by.md ================================================ # Што такое канфлікт зліцця? Пры спробе аб'яднаць іншую галінку з вашай бягучай працоўнай галіной, вы ўносіце змены ў іншы кантэкст і аб'ядноўваючы іх з вашымі бягучымі файламі. Калі два чалавекі змянілі аднолькавыя радкі ў адным файле альбо калі адзін чалавек вырашыў выдаліць яго, а другі вырашыў змяніць яго, Git не зможа вызначыць, якая версія з'яўляецца правільнай. Затым Git пазначыць файл як канфлікт - які вам давядзецца вырашыць, каб працягнуць працу. # Як вырашыць канфлікт аб аб'яднанні? Сутыкнуўшыся з канфліктам зліцця, git пазначыць праблемную вобласць у файле, уключыўшы яе ў “<<<<<<<< HEAD” and “>>>>>>>>>>[other branch name]” Змесціва пасля першага маркера паходзіць з вашай бягучай галіны. Пасля кутніх дужак, Git паведамляе нам, адкуль (з якой галіны) адбыліся змены. Радок з "=======" падзяляе два супярэчлівыя змены. Наша задача складаецца ў тым, каб ачысціць гэтыя радкі: калі мы скончым, файл павінен выглядаць так, як мы хочам, каб ён выглядаў. Пажадана звярнуцца да таварыша па камандзе, які напісаў супярэчлівыя змены, каб вырашыць, якая версія павінна быць канчатковай. Гэта можа быць альбо ваша - альбо можа быць сумесь паміж імі. напрыклад: ``` <<<<<<< HEAD:mergetest This is my third line ======= This is a fourth line I am adding >>>>>>> 4e2b407f501b68f8588aa645acafffa0224b9b78:mergetest ``` `<<<<<<<`: Пазначае пачатак радкоў, якія мелі канфлікт аб'яднання. Першы набор радкоў - гэта радкі з файла, у які вы спрабавалі аб'яднаць змены. `=======`: Паказвае кропку перапынку, якая выкарыстоўваецца для параўнання. Разбівае змены, якія карыстальнік здзейсніў (вышэй) да зменаў, якія адбываюцца ад аб'яднання (унізе), каб візуальна ўбачыць адрозненні. `>>>>>>>`: Пазначае канец радкоў, якія мелі канфлікт зліцця. Вы можаце вырашыць канфлікт, адрэдагаваўшы файл, а затым злучыўшы яго ўручную. Гэта можа азначаць адмену альбо змены альбо чыё-небудзь ці далейшае спалучэнне двух. Вам таксама трэба выдаліць файлы <<<<<<<< ',' ======= 'і' >>>>>>> '. Пасля развязання канфлікту зрабіце `git add`. Не забудзьцеся запусціць тэсты, бо вы павінны пераканацца, што вы вырашылі канфлікт. Вы таксама можаце загрузіць розныя плагіны ў залежнасці ад IDE, які вы выкарыстоўваеце для больш простага спосабу ўрэгулявання канфліктаў аб'яднання. # Як адмяніць зліццё? Калі вы хочаце адмяніць зліццё, то можаце зрабіць `git merge —abort` ================================================ FILE: docs/additional-material/translations/Belarusian/reverting-a-commit.by.md ================================================ # Вярнуць каміт Скасаваць абавязацельства проста азначае стварыць зусім новы дакумент, які адмяняе ўсе змены, унесеныя ў папярэдні. Гэта як рабіць `` CTRL + Z `` `на git. У Git пераўтварэнне палягчаецца, таму што кожны ўклад, які вы commit на свой аддалены сховішча, мае ўнікальны алфавітна-лічбавы ключ, вядомы пад назвай SHA (Secure Hash Algorithm). Такім чынам, гэта азначае, што вы можаце вярнуць любыя абавязацельствы, пакуль у вас ёсць SHA. Але потым, вы павінны быць асцярожныя, каб змяніць упарадкаванасць, каб не сапсаваць ваша сховішча. Каб выбраць SHA канкрэтнага абавязацельства, якое мы хочам адмяніць, зручны быў бы часопіс усіх дасягнутых намі абавязкаў. Каб атрымаць гэта, мы запусцім каманду: `` `git log --oneline` `` Адзінае выкананне каманды `` git log`` таксама дасць нам SHA (у доўгай форме) Аднак выкарыстанне сцяга `` --oneline `` кажа git, што мы хочам, каб ён быў адлюстраваны ў сціслым (адным радку) парадку для зручнага чытання. Першыя 7 знакаў, якія адлюстроўваюцца пры выкананні гэтай каманды, называюцца скарочаным хэшам фіксацыі. Напрыклад, вось што я атрымліваю, калі ў гэтым рэпазітары запускаю `` git log --oneline ``: ``` 389004d added spacing in title c1b9fc1 Merge branch 'master' into tutorials 77eaafd added tutorial for reverting a commit ``` Гэта паказвае, што з дапамогай `` git log --oneline``, мы можам атрымаць спіс усіх абавязацельстваў, зробленых у сховішча, разам з першымі 7 сімваламі яго SHA. Давайце выкажам здагадку, што я хачу адмяніць здзяйсненне "дадання прамежкаў у загалоўку". Вось наступныя дзеянні: * Скапіруйце SHA дакумента, які ў дадзеным выпадку з'яўляецца `` 389004d `` * Затым запусціце каманду ```git revert 389004d``` Гэта адкрые мой тэкставы рэдактар і прапануе мне адрэдагаваць паведамленне пра commit. Вы можаце вырашыць пакінуць паведамленне commit як паведамленне па змаўчанні git, якое пачынаецца са слова `Revert` альбо вы таксама можаце вырашыць наладзіць паведамленне па сваім гусце. * Далей я буду захоўваць і закрываць тэкставы рэдактар. * Вярнуцца да каманднага радка. * Запусціце `` `git push origin ` ``, каб націснуць на зваротныя змены ў Github. І гэта ўсё, змены будуць адменены. У гэтым выпадку маё сховішча будзе зменена на тое, як яно выглядала ў `` c1b9fc1`` ================================================ FILE: docs/additional-material/translations/Belarusian/squashing-commits.by.md ================================================ # Што такое squashing? У git, squashing маецца на ўвазе перапісванне гісторыі вашых учынкаў, таму вы ў канчатковым выніку займаецеся апісаннем зробленых змяненняў. Звычайна гэта робіцца ў праектах з адкрытым зыходным кодам, таму што шмат гісторыяў філіялаў у праектах з адкрытым зыходным кодам мае дачыненне толькі да распрацоўшчыка, які іх стварыў, і гэта дае больш просты спосаб апісаць унесеныя змены, а таксама пры неабходнасці аднавіць іх. # Як вы робіце squash камітаў? Па-першае, выканаць часопіс git, каб прааналізаваць каміт, якія вы хацелі б аб'яднаць у вашай бягучай галіны. ``` git log ``` Вы павінны ўбачыць шэраг сваіх абавязацельстваў так: ``` commit blablabla Author: omguhh Date: 10/10/20 Commit message 1 commit blablabla2 Author: omguhh Date: 10/10/20 Commit message 2 ``` Такім чынам, зараз, калі вы бачыце каміты, якія вы хочаце злучыць з адным, мы можам перайсці да гэтага з `` git rebase `` . Зыходзячы з таго, што вы ўжо знаёмыя з `` git rebase `` , мы можам пачаць squashing камітаў ў інтэрактыўным рэжыме git rebase, які можна актываваць так: ``` git rebase -i ``` Цяпер, пры дапамозе інтэрактыўнага rebasing вы можаце вызначыць пачатковую і канчатковую кропку таго, як далёка вы хочаце ісці з такімі ўчынкамі: ``` git rebase -i HEAD~2 ``` Запуск гэтай каманды пакажа вам нешта падабаецца наступнае: ``` pick blablabla Changing test01.txt file pick blablabla2 Adding dummy01.txt file # # Commands: # p, pick = use commit # r, reword = use commit, but edit the commit message # e, edit = use commit, but stop for amending # s, squash = use commit, but meld into previous commit # f, fixup = like "squash", but discard this commit's log message # x, exec = run command (the rest of the line) using shell # # These lines can be re-ordered; they are executed from top to bottom. # # If you remove a line here THAT COMMIT WILL BE LOST. # # However, if you remove everything, the rebase will be aborted. # # Note that empty commits are commented out ``` Такім чынам, калі вы хочаце squash ``` blablabla2``` на ``` blablablabla```, вы змяніце наступнае: ``` pick blablabla Changing test01.txt file squash blablabla2 Adding dummy01.txt file ``` Калі ўсё пойдзе добра, вы атрымаеце такі вынік: ``` # This is a combination of 2 commits. # The first commit's message is: commit message 1 # This is the 2nd commit message: commit message 2 ``` Што вы можаце свабодна змяніць, перш чым вырашыць выйсці з рэдактара, каб захаваць гэтыя змены. Запуск часопіса git павінен паказаць вам паведамленне аб здзяйсненні, якое вы ўвялі перад выхадам на экран, з абавязацельствамі, аб'яднанымі ў адзін. ================================================ FILE: docs/additional-material/translations/Belarusian/stashing-a-file.by.md ================================================ # Прыхаваць Што рабіць, калі вы працуеце над вялікім кодам і раптам вам трэба пераключыць галіну, з якой вы зараз працуеце, на іншую. Паколькі код не з'яўляецца поўным і без якіх-небудзь тэстаў вы, верагодна, не хочаце яго commit. Але вы не можаце перайсці ў іншую галіну без унясення змяненняў, Git не дазволіць вам парушыць гэты паток. Што мы тады робім? Як мы прадухіляем непатрэбнае commit, маючы магчымасць скакаць з галінак? Вось што ахоплівае гэты падручнік. ## Схаванне працы Дапусцім, што вы працуеце ў аддзяленні праекта, дзе вы змянілі некаторыя файлы. Цяпер, калі вы запусціце ``git status``, вы можаце ўбачыць змены ў файлах. ``` $ git status # On branch master # Changes to be committed: # (use "git reset HEAD ..." to unstage) # # modified: index.html # # Changes not staged for commit: # (use "git add ..." to update what will be committed) # # modified: lib/simplegit.rb # ``` Цяпер вы хочаце пераключыць сваю галіну, але пакуль не хочаце ўносіць змены; каб вы захавалі змены. Каб націснуць на stack новы сродак, запусціце `` git stash``: ``` $ git stash Saved working directory and index state \ "WIP on master: 049d078 added the index file" HEAD is now at 049d078 added the index file (To restore them type "git stash apply") ``` Цяпер ваш працоўны каталог чысты, выкарыстоўвайце ```git status```: ``` $ git status # On branch master nothing to commit, working directory clean ``` Цяпер вы можаце перайсці ў любую галіну і зрабіць сваю працу; схаваныя змены захоўваюцца ў выглядзе stack. Каб даведацца, якія stashes вы захоўваеце ў stack, вы можаце выкарыстоўваць `` git stash list``: ``` $ git stash list stash@{0}: WIP on master: 049d078 added the index file stash@{1}: WIP on master: c264051 Revert "added file_size" stash@{2}: WIP on master: 21d80a5 added number to log ``` У выпадку, калі вы хочаце паўторна ўжыць змены, якія вы толькі што схавалі, вы можаце скарыстацца камандай `` git stash apply``. З дапамогай гэтай каманды вы можаце паўторна ўжыць апошні захованы файл. Для таго, каб паўторна прымяніць любы іншы файл, вы можаце пазначыць яго, назваўшы яго так: ```git stash apply ```, замест `` `` `` напішыце імя stash i трэба зноў падаваць. ``` $ git stash apply # On branch master # Changes not staged for commit: # (use "git add ..." to update what will be committed) # # modified: index.html # modified: lib/simplegit.rb # ``` Вы можаце бачыць, што git паўторна змяняе файл, які вы выдалілі, калі вы захавалі пазыцыю. У гэтым выпадку ў вас быў чысты рабочы каталог, калі вы спрабавалі прымяніць stash, і вы паспрабавалі прымяніць яго ў той жа галіны, ад якой вы захавалі; але мець чыстую працоўную дырэкторыю і ўжываць яе ў той жа галінцы не трэба, каб паспяхова ўжываць скрыні. Вы можаце захаваць скрыні на адной галінцы, перайсці на іншую галінку пазней і зноў ужыць змены ў новай галінцы. Вы таксама можаце мець змененыя і неадкрытыя файлы ў вашым працоўным каталогу, калі вы ўжываеце stash, git дае канфлікты зліцця, калі што-небудзь больш не ўжываецца чыста. Змены, унесеныя ў вашыя файлы, паўторна ўжываюцца, але файл, які вы стварылі, не быў перазагружаны. Для гэтага вам трэба выканаць каманду `` git stash apply`` з ```--index```, каб сказаць камандзе зноў прымяняць паэтапныя змены. Калі б вы запусцілі гэта, вы вярнуліся ў зыходнае становішча: ``` $ git stash apply --index # On branch master # Changes to be committed: # (use "git reset HEAD ..." to unstage) # # modified: index.html # # Changes not staged for commit: # (use "git add ..." to update what will be committed) # # modified: lib/simplegit.rb # ``` Каманда ўжываць прымяняецца толькі для зачыненай працы, але ў вас усё яшчэ ёсць у вашым stack. Для таго, каб выдаліць яго, вы можаце запусціць `` git stash drop`` з іменем stack для выдалення. ``` $ git stash list stash@{0}: WIP on master: 049d078 added the index file stash@{1}: WIP on master: c264051 Revert "added file_size" stash@{2}: WIP on master: 21d80a5 added number to log $ git stash drop stash@{0} Dropped stash@{0} (364e91f3f268f0900bc3ee613f9f733e82aaed43) ``` Вы можаце выкарыстоўваць `` git stash pop``, каб выдаліць апошнія змены, выдаліўшы іх са свайго stack. ## Адмена прымянення stash У некаторых выпадках вы хочаце прымяніць затоеныя змены, выканаць некаторыя працы, але ўжываць змены, якія першапачаткова прыйшлі з stash. Git не падае такую каманду, як `` git unapply` ``, але можна дасягнуць гэтага эфекту, проста здабыўшы patch, звязаны са stash, і прымяніць яго ў зваротным парадку: ```$ git stash show -p stash@{0} | git apply -R``` Зноў жа, калі вы не ўкажыце stash, Git мяркуе самую свежую stash: ```$ git stash show -p | git apply -R``` Магчыма, вы захочаце стварыць псеўданім і эфектыўна дадаць каманду `` stash-unapply`` у свой Git. Напрыклад: ``` $ git config --global alias.stash-unapply '!git stash show -p | git apply -R' $ git stash apply $ #... work work work $ git stash-unapply ``` ## Стварэнне аддзялення з stash Калі вы захоўваеце якую-небудзь працу, пакіньце яе там на некаторы час і працягвайце працу на той галінцы, з якой вы схавалі працу, у вас могуць паўстаць праблемы пры паўторнай працы. Калі заяўка паспрабуе змяніць файл, які вы ў свой час змянілі, у вас атрымаецца канфлікт аб'яднання, і вам прыйдзецца яго вырашыць. Калі вы хочаце больш проста пратэставаць схаваныя змены, вы можаце запусціць `` git stash branch``, які стварае для вас новае аддзяленне, правярайце абавязацельствы, якія вы выконвалі, калі вы прыхавалі працу, і зноў адпраўляе сваю працу. там, а затым скідае скрыню, калі яна паспяхова ўжываецца: ``` $ git stash branch testchanges Switched to a new branch "testchanges" # On branch testchanges # Changes to be committed: # (use "git reset HEAD ..." to unstage) # # modified: index.html # # Changes not staged for commit: # (use "git add ..." to update what will be committed) # # modified: lib/simplegit.rb # Dropped refs/stash@{0} (f0dfc4d5dc332d1cee34a634182e168c4efc3359) ``` Гэта добры цэтлік, каб лёгка аднавіць схаваную працу і працаваць над ёй у новым аддзяленні. ================================================ FILE: docs/additional-material/translations/Belarusian/undoing-a-commit.by.md ================================================ # Адмяніць мясцовыя каміты Каб адмяніць мясцовыя каміты, усё, што вам трэба зрабіць, гэта ``` git reset ``` Гэтая каманда прывядзе да скіду staging вобласці да апошні каміт, але змены, якія ўнесены ў ваш працоўны каталог, не зменіцца. Такім чынам, вы ўсё яшчэ можаце зноў камітаць тое, што вы змянілі. Ці, калі вы хочаце выдаліць толькі адзін файл з папярэдняга каміту. Затым вы можаце зрабіць каманду ніжэй ``` git reset ``` Каманда выдаліць толькі пазначаны файл з staging вобласці, але змены, унесеныя ў файл, усё яшчэ застануцца. Прыклад выкарыстання ```git reset``` ``` # Make changes in index.php and tutorial.php # Add files into the staging area $ git add . # Remembered both files need to be committed separately # Unstage tutorial.php $ git reset tutorial.php # Commit index.php first $ git commit -m "Changed index.php" # Commit tutorial.php now $ git add tutorial.php $ git commit -m "Changed tutorial.php" ``` Дапусцім, калі вы пераблыталі сваё лакальнае сховішча і проста хочаце скінуць яго на апошні ўдзел. Затым вы можаце запусціць каманду ніжэй. ``` git reset --hard ``` Каманда не толькі скіне ваша staging вобласць, але і верне ўсе вашы змены ў файлах да вашай апошняй commit. Рэжым `` --hard `` загадвае Git таксама адмяняць усе змены ў працоўным каталогу. Вы павінны запускаць гэта толькі тады, калі вы сапраўды ўпэўненыя ў тым, што выкінеце цэлае local development. Прыклад выкарыстання ```git reset --hard``` ``` # Decided to start a crazy experiment # Create a new file 'crazy.php' and add some code to it # Commit crazy.php $ git add crazy.php $ git commit -m "Started a crazy dev" # Edit crazy.php file again and changed a lot other files # Commit all tracked files $ git add . $ git commit -m "Continued dev" # Tested and things went out of hand # Decided to remove the whole things $ git reset --hard HEAD~2 ``` ```git reset --hard HEAD~2``` перамяшчае бягучую галінку назад на 2 commits адначасова, аднаўляючы ўсе зробленыя вамі змены і выдаляючы 2 здымкі, якія мы толькі што стварылі з гісторыі праектаў. P.s. Ніколі не выконвайце `` git reset --hard```, калі вы ўжо перанеслі свае commits ў агульнае сховішча, паколькі гэта прывядзе да праблем з усімі рэпазітарамі. ================================================ FILE: docs/additional-material/translations/Bengali/add-file.bn.md ================================================ ## একটি নতুন ফাইল সংযুক্ত করার টিউটোরিয়াল আপনি যদি নতুন একটি ফাইল আপনার Git রিপোজিটরিতে সংযুক্ত করতে চান, তাহলে এই টিউটোরিয়ালটি আপনার সাহায্য করতে পারে। 1. **নতুন ফাইল তৈরি করুন**: - আপনি যে প্রজেক্ট ফোল্ডারে চান, তাতে যান। - নতুন ফাইল তৈরি করতে আপনি যে টেক্সট সম্পাদক বা IDE ব্যবহার করে যেতে পারেন, বা যদি আপনার কোন আইডি থাকে তাহলে তার মাধ্যমেও ফাইল তৈরি করতে পারেন। - ফাইলটির একটি নির্দিষ্ট নাম দিন এবং সংরক্ষণ করুন। 2. **ফাইলটি স্থানান্তর করুন**: - টার্মিনাল খুলুন এবং রিপোজিটরি ফোল্ডারে চলে যান। - নতুন ফাইলটি স্থানান্তর করতে আপনি নিম্নলিখিত কমান্ডটি ব্যবহার করুন: ``` git add নতুন_ফাইল.এক্সটেনশন ``` 3. **কমিট করুন**: - ফাইলটি স্থানান্তর করার পরে, একটি কমিট তৈরি করুন। - নিম্নলিখিত কমান্ডটি ব্যবহার করুন: ``` git commit -m "নতুন ফাইল সংযুক্ত করা হয়েছে" ``` 4. **রিমোট রিপোজিটরিতে পুশ করুন**: - এখন আপনার ফাইলটি আপনার লোকাল রিপোজিটরিতে রয়েছে। এটি রিমোট রিপোজিটরিতে পাঠাতে হলে নিম্নলিখিত কমান্ডটি ব্যবহার করুন: ``` git push দূরস্থ_শাখা ``` - এখানে "দূরস্থ_শাখা" তা হলো সে নাম যেখানে আপনি ফাইলটি সংযুক্ত করতে চান। এখন আপনি নতুন একটি ফাইলকে আপনার রিপোজিটরিতে সংযুক্ত করেছেন। ================================================ FILE: docs/additional-material/translations/Bengali/additional-material.be.md ================================================ # অতিরিক্ত তথ্য আমরা ধরে নিচ্ছি যে আপনি এখানে আসার আগে প্রাথমিক টিউটোরিয়ালটি ইতিমধ্যেই শেষ করেছেন। এই নথিটি আপনাকে উন্নত গিট কৌশল সম্পর্কে কিছু অতিরিক্ত তথ্য দেবে। ### [একটি প্রতিশ্রুতি সংশোধন](amending-a-commit.md) এই নথিটি রিমোট রিপোজিটরিতে একটি প্রতিশ্রুতি কীভাবে সংশোধন করতে হয় সে সম্পর্কে তথ্য সরবরাহ করে। একটি প্রতিশ্রুতি সংশোধন করা হল আপনার বর্তমান শাখায় করা সাম্প্রতিকতম প্রতিশ্রুতি পরিবর্তন করার একটি উপায়। আপনি যদি প্রতিশ্রুতি বার্তাটি সম্পাদনা করতে চান বা আপনি প্রতিশ্রুতিতে পরিবর্তনগুলি অন্তর্ভুক্ত করতে ভুলে যান তবে এটি সহায়ক হতে পারে। আপনি একটি প্রতিশ্রুতি সংশোধন করা চালিয়ে যেতে পারেন যতক্ষণ না আপনি এটিকে দূরবর্তী সংগ্রহস্থলে ঠেলে দেন। > আপনার করা একটি প্রতিশ্রুতি সামঞ্জস্য করার প্রয়োজন হলে এটি ব্যবহার করুন। ### [গিট কনফিগার করা](configuring-git.md) এই নথি ব্যবহারকারী বিবরণ এবং অন্যান্য বিকল্পগুলি গিটে কনফিগার করতে কিভাবে তথ্য প্রদান করে তা সম্পর্কে তথ্য প্রদান করে। > গিট কনফিগারেশন চলাচল আপনার গিট কনফিগারেশন ভাল করার জন্য এটি ব্যবহার করুন। ### [আপনার ফর্ক এই রিপোজিটরি সাথে সিঙ্ক রাখা](keeping-your-fork-synced-with-this-repository.md) এই নথি আপনার ফর্কড রিপোজিটরি আপ-টু-ডেট রাখতে কিভাবে সম্পর্কিত তথ্য প্রদান করে যেভাবে আপনি আশা করছেন এবং আশাবাদে আপনি এবং অনেকে প্রকল্পে অবদান রাখবেন। > এই পদক্ষেপগুলি অনুসরণ করুন যদি আপনার ফর্কে কোনও পরিবর্তন না থাকে মূল রিপোজিটরি থেকে। ### [একটি কমিটকে আবার অন্য শাখায় সরানো](moving-a-commit-to-a-different-branch.md) এই নথি একটি কমিটকে অন্য শাখায় সরাতে কীভাবে তথ্য প্রদান করে। > একটি কমিটকে অন্য শাখায় সরাতে এই পদক্ষেপগুলি নিন। ### [একটি ফাইল সরানো](removing-a-file.md) এই নথি আপনার লোকাল রিপোজিটরি থেকে একটি ফাইল সরাতে কীভাবে তথ্য প্রদান করে। > একটি কমিট পূর্বে একটি ফাইল সরানোর জন্য এই পদক্ষেপগুলি অনুসরণ করুন। ### [আপনার রিপোজিটরি থেকে একটি শাখা সরানো](removing-branch-from-your-repository.md) এই নথি তথ্য সরবরাহ করে কিভাবে আপনি আপনার রিপোজিটরি থেকে একটি শাখা মুছতে পারেন। > আপনার পুল অনুরোধটি মার্জ হলে, পরবর্তী পদক্ষেপগুলি অনুসরণ করুন। ### [মার্জ সংঘর্ষ সমাধান](resolving-merge-conflicts.md) এই নথি তথ্য সরবরাহ করে কিভাবে মার্জ সংঘর্ষ সমাধান করতে হয়। > ক্ষিপ্তকর মার্জ সংঘর্ষগুলি সমাধান করতে এই পদক্ষেপগুলি নিন। ### [একটি কমিট পুনরায় ফিরানো](reverting-a-commit.md) এই নথি তথ্য সরবরাহ করে কিভাবে রিমোট রিপোজিটরিতে একটি কমিট পুনরায় ফিরাতে হয়। এটি কাজে আসবে যখন আপনি ইতিমধ্যে Github-এ পুশ করা একটি কমিট কে আনডু করতে হবে। > একটি কমিট পুনরায় ফিরাতে এই পদক্ষেপগুলি নিন। ### [কমিটগুলি স্কোয়াশ করা](squashing-commits.md) এই নথি তথ্য সরবরাহ করে কিভাবে ইন্টারাক্টিভ রিবেস দ্বারা কমিটগুলি স্কোয়াশ করতে হয়। > এটি ব্যবহার করুন যদি আপনি একটি ওপেন সোর্স প্রকল্পে একটি পিআর খোলতে চান এবং পর্যালোচক আপনি প্রত্যেক কমিটকে একটিতে স্কোয়াশ করতে বলে। ### [স্থানীয় কমিট পুনরায় করা](undoing-a-commit.md) এই নথি তথ্য সরবরাহ করে কিভাবে আপনি আপনার স্থানীয় রিপোজিটরিতে একটি কমিট পুনরায় করতে পারেন। এটি তখন প্রয়োজন হয় যখন আপনি মনে করেন যে আপনি আপনার স্থানীয় রিপোজিটরি গুলি জটিল করে দিয়েছেন এবং আপনি স্থানীয় রিপোজিটরি রিসেট করতে চান। > আপনি যদি একটি স্থানীয় কমিট পুনরায় করতে চান তবে এই পদক্ষেপগুলি নিন। ### [দরকারি লিঙ্কসমূহ](Useful-links-for-further-learning.md) এই নথি সমস্ত টিপস এবং ট্রিক ওয়েবসাইট, ব্লগ পোস্ট এবং সাহায্যকারী সাইটগুলির উপর ভরা দেওয়া হয় যা আমাদের জীবনকে সহজ করে। এগুলি সমস্ত প্রয়োজনীয় তথ্যের জন্য একটি মহাপ্রয়োজনী সূত্র। এই পৃষ্ঠাটি সকল উপকারী লিঙ্কের একটি সূচী হিসেবে করতে পারে। ### [.gitignore ফাইল তৈরি করা](creating-a-gitignore-file.md) এই নথি ব্যাখ্যা করে কী করে .gitignore ফাইল কাজ করে, তার জন্য কেন এবং .gitignore ফাইল কীভাবে তৈরি করতে হয়। এই ফাইলটি প্রায় সব গিট প্রকল্পে ব্যবহৃত হয়। এটি গিটে কেবল প্রয়োজনীয় ফাইলগুলি কমিট করতে সাহায ### [শংসাপত্র সংরক্ষণ করা](storing-credentials.md) এই নথি বর্ণনা করে কীভাবে আপনি আপনার ভণ্ডার জন্য শংসার রক্ষণা করতে পারেন। এটি একটি নিরাপত্তা সম্পর্কিত সময় হতে পারে, তাই আপনি আপনার কাজে/অধ্যয়নের স্থানের নিরাপত্তা নীতিগুলি অনুসরণ করুন। ================================================ FILE: docs/additional-material/translations/Bengali/check-commit-log-bn.md ================================================ # কমিট লগ পরীক্ষা করুন কোনও শাখা বা ফাইলের জন্য কমিট লগ পরীক্ষা করার জন্য, নিম্নলিখিত কমান্ডটি ব্যবহার করা যেতে পারে: `git log [options] [path]` এই কমান্ডের আউটপুট ডিফল্টরূপে বিপরীত কালানুক্রমিক ক্রমে দেওয়া হয়। ## কমান্ড আউটপুট উদাহরণ ``` $ git log commit e3fabb30ab536bd5876461d8a749301a321e714f (HEAD -> check-commit-log-ko, upstream/main, origin/main, origin/HEAD, main) লেখক: ড্যান ইউনহিউম সিওল তারিখ: মঙ্গলবার ৪ জুন ০১:০৭:২৫ ২০২৪ -০৪০০ অবদানকারীদের তালিকায় ড্যান-সিওল যোগ করুন (#৮৪৯৬২) commit 4af4ec8a56e057ce8768af77eda528453974d0bc লেখক: এডগার হাম্বার্তো তিজেরিনা তেমেজ <168693312+EdgarHTT@users.noreply.github.com> তারিখ: সোমবার ৩ জুন ২৩:০৬:০৫ ২০২৪ -০৬০০ এডগার টিজেরিনাকে অবদানকারীদের তালিকায় যোগ করুন (#৮৪৯৬১) ``` ## কমান্ডের বৈচিত্র্য এবং বিকল্প - একটি নির্দিষ্ট কমিট আইডি থেকে পৌঁছানো যায় এমন কমিটগুলি সম্পাদন করার জন্য: (এই ক্ষেত্রে, `foo` এবং `bar`)
`git log foo bar ` - কমিট আইডির সামনে `^` যোগ করে একটি প্রদত্ত কমিট আইডি থেকে পৌঁছানো যায় এমন কমিটগুলি অপসারণ করাও সম্ভব: (এই ক্ষেত্রে, `baz`)
`git log foo bar ^baz` - একটি নির্দিষ্ট ফাইলের জন্য কমিট লগ:
git log --all ` - লগে কমিটের সংখ্যা সীমিত করুন: (এই ক্ষেত্রে, `5`)
`git log -n 5` ## দেখুন - [অফিসিয়াল ডকুমেন্টেশন](https://git-scm.com/docs/git-log) ================================================ FILE: docs/additional-material/translations/Bengali/configuration-in-bn-github.md ================================================ # গিট কনফিগারেশন প্রথমবারের মতো যখন আপনি `commit` করার চেষ্টা করবেন, তখন এই ধরনের বার্তা দেখতে পাবেন: ```bash $ git commit *** Please tell me who you are. Run git config --global user.email "you@example.com" git config --global user.name "Your Name" to set your account's default identity. Omit --global to set the identity only in this repository. ``` একটি `commit` তৈরি করতে গিটকে জানতে হবে যে এর লেখক কে। সহযোগী কাজের ক্ষেত্রে, প্রকল্পের বিভিন্ন অংশের পরিবর্তন করেছেন কে এবং কবে, তা জানা খুবই গুরুত্বপূর্ণ। তাই গিটে প্রতিটি `commit`-এর সাথে ব্যবহারকারীর নাম এবং ইমেল ঠিকানা সংযুক্ত করা হয়। এখানে কিছু উপায় আছে যার মাধ্যমে আপনি আপনার ইমেল এবং নাম `git commit` কমান্ডের সাথে যুক্ত করতে পারেন। ### গ্লোবাল কনফিগারেশন গ্লোবাল কনফিগারেশনে সংরক্ষিত তথ্য সমস্ত গিট রিপোজিটরিতে প্রযোজ্য। এটি হল সবচেয়ে ব্যবহৃত পদ্ধতি। গ্লোবাল কনফিগারেশনে কিছু সেট করতে, আপনি `config` কমান্ডটি এভাবে ব্যবহার করতে পারেন: ```bash $ git config --global ``` ব্যবহারকারীর তথ্য সেট করার জন্য, এটি এভাবে হবে: ```bash $ git config --global user.email "you@example.com" $ git config --global user.name "Your Name" ``` ### রিপোজিটরি স্তরের কনফিগারেশন এই ধরনের কনফিগারেশন শুধুমাত্র আপনার বর্তমান রিপোজিটরিতে প্রযোজ্য। যদি আপনি কোনও নির্দিষ্ট রিপোজিটরিতে কাজ করতে চান (উদাহরণস্বরূপ, কোম্পানির প্রকল্পে), তবে এই পদ্ধতি ব্যবহার করতে পারেন। রিপোজিটরি স্তরের কনফিগারেশন সেট করতে, `--global` বাদ দিয়ে `config` কমান্ডটি ব্যবহার করুন: ```bash $ git config ``` ব্যবহারকারীর তথ্য সেট করার জন্য, এটি এভাবে হবে: ```bash $ git config user.email "you@alternate.com" $ git config user.name "Your Name" ``` ### কমান্ড লাইনে কনফিগারেশন এই ধরনের কনফিগারেশন শুধুমাত্র একটি নির্দিষ্ট কমান্ডের জন্য প্রযোজ্য। সব গিট কমান্ডে `-c` ব্যবহার করে আপনি কনফিগারেশন পরামিতি সেট করতে পারেন। একটি কমান্ডের জন্য কনফিগারেশন পরিবর্তন করতে, গিট কমান্ডটি এভাবে ব্যবহার করুন: ```bash $ git -c = -c = ``` আমাদের ক্ষেত্রে, `commit` কমান্ডটি এভাবে হবে: ```bash git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Your commit message" ``` ### অগ্রাধিকারের ক্রম এই তিনটি কনফিগারেশন পদ্ধতির মধ্যে অগ্রাধিকারের ক্রম হল: `কমান্ড লাইন > রিপোজিটরি > গ্লোবাল`। এর মানে হল যদি কোনও পরিবর্তনশীল গ্লোবাল এবং কমান্ড লাইনে উভয় ক্ষেত্রেই সেট করা থাকে, তবে কমান্ড লাইনের মান ব্যবহার করা হবে। ## শুধু ব্যবহারকারীর তথ্য নয় এখন পর্যন্ত আমরা গিট কনফিগারেশন নিয়ে আলোচনা করেছি শুধু ব্যবহারকারীর তথ্যের ক্ষেত্রে। কিন্তু গিট আরও অনেক পরামিতি কনফিগার করতে দেয়। এখানে কিছু উল্লেখযোগ্য উদাহরণ: 1. `core.editor` - কমিট মেসেজ এডিট করার জন্য ব্যবহৃত টেক্সট এডিটর, 2. `commit.template` - কমিটের জন্য প্রাথমিক টেমপ্লেট ফাইল, 3. `color.ui` - টার্মিনালে গিট মেসেজে রঙিন ফন্ট ব্যবহার করা যাবে কিনা তা নির্ধারণ করে। আরও বিস্তারিত জানতে [git-scm.com](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration) দেখুন। ================================================ FILE: docs/additional-material/translations/Bengali/creating-gitignore-file-bn.md ================================================ ## .gitignore বোঝা `.gitignore` ফাইলটি Git-এর কর্মপ্রবাহের একটি অপরিহার্য উপাদান। এটি Git-কে বলে যে কোন ফাইল এবং ফোল্ডারগুলিকে উপেক্ষা করতে হবে, যা আপনার সংগ্রহস্থলে অপ্রয়োজনীয় বা সংবেদনশীল ডেটা ট্র্যাক করা থেকে বিরত রাখে। ## কেন .gitignore ব্যবহার করবেন? কিছু ফাইল সংস্করণ নিয়ন্ত্রণে অন্তর্ভুক্ত করা উচিত নয় কারণ সেগুলি হল: - অস্থায়ী বা সিস্টেম-উত্পাদিত (যেমন, ক্যাশে, বিল্ড ফাইল, লগ) - বৃহৎ নির্ভরতা যা পুনরায় ইনস্টল করা যেতে পারে (যেমন, `node_modules`) - ব্যক্তিগত বা সংবেদনশীল কনফিগারেশন ফাইল (যেমন, API কী, পরিবেশ ভেরিয়েবল) - IDE বা সম্পাদক-নির্দিষ্ট ফাইল (যেমন, `.vscode/`, `.idea/`) এই ফাইলগুলি উপেক্ষা করলে সংগ্রহস্থল পরিষ্কার থাকে, দ্বন্দ্ব হ্রাস পায় এবং নিরাপত্তা ঝুঁকি প্রতিরোধ করে। ## একটি .gitignore ফাইল তৈরি করা একটি `.gitignore` ফাইল তৈরি করতে: ১. আপনার প্রোজেক্ট রুট ডিরেক্টরিতে, `.gitignore` নামে একটি নতুন টেক্সট ফাইল তৈরি করুন। ২. আপনি যে ফাইল এবং ফোল্ডারগুলিকে উপেক্ষা করতে চান তার তালিকা তৈরি করুন, প্রতি লাইনে একটি করে। ৩. ফাইলটি সংরক্ষণ করুন। ### .gitignore এর জন্য মৌলিক সিনট্যাক্স - `*` → একাধিক ফাইল মেলানোর জন্য ওয়াইল্ডকার্ড। - `/` → `.gitignore` এর সাথে সম্পর্কিত পথ নির্দিষ্ট করে। - `#` → মন্তব্য যোগ করে। ### উদাহরণ .gitignore ফাইল: ```sh # ম্যাক সিস্টেম ফাইল উপেক্ষা করুন .DS_Store # নির্ভরতা ফোল্ডার উপেক্ষা করুন node_modules/ venv/ # লগ এবং ক্যাশে ফাইল উপেক্ষা করুন *.log .cache/ # পরিবেশ ফাইল উপেক্ষা করুন .env # সকল টেক্সট ফাইল উপেক্ষা করুন *.txt ``` ## গ্লোবাল .gitignore (সকল প্রকল্পের জন্য) একটি গ্লোবাল `.gitignore` ফাইল তৈরি করতে (সকল সংগ্রহস্থলের ক্ষেত্রে প্রযোজ্য): ```sh git config --global core.excludesfile ~/.gitignore_global ``` তারপর, `~/.gitignore_global` সম্পাদনা করুন যেমন আপনি একটি স্থানীয় `.gitignore` করবেন। ## গিট ট্র্যাকিং থেকে ফাইল অপসারণ যদি কোনও ফাইল `.gitignore` এ যোগ করার আগে ইতিমধ্যেই কমিট করা হয়ে থাকে, তাহলে আপনাকে এটি ট্র্যাকিং থেকে সরিয়ে ফেলতে হবে: - **একটি ফাইল আনট্র্যাক করুন** (তবে স্থানীয়ভাবে রাখুন): ```sh git rm --cached filename ``` - **সকল উপেক্ষা করা ফাইল আনট্র্যাক করুন**: ``sh git rm -r --cached . git add . git commit -m "আপডেট করা .gitignore" ``` `git rm --cached filename` পূর্বাবস্থায় ফেরাতে, ব্যবহার করুন: ``sh git add filename ``` ================================================ FILE: docs/additional-material/translations/Bengali/fix-git-permission-error-bn.md ================================================ # ওপেন সোর্স অবদানের জন্য Git অনুমতি ত্রুটি সমাধান ## সমস্যা আমি "first-contributions" রিপোজিটরিতে অবদান রাখার চেষ্টা করার সময় একটি অনুমতি ত্রুটি পেয়েছিলাম। আমি নতুন ব্রাঞ্চ তৈরি করে এবং পরিবর্তনগুলি পুশ করার চেষ্টা করার পর: ```bash $ git checkout -b fahimar_oss_YYYY Switched to a new branch 'fahimar_oss_YYYY' $ git push origin fahimar_oss_YYYY remote: Permission to firstcontributions/first-contributions.git denied to fahimar. fatal: unable to access 'https://github.com/firstcontributions/first-contributions.git/': The requested URL returned error: 403 ``` সমস্যাটি ছিল যে, আমি মূল রিপোজিটরিটি সরাসরি ক্লোন করেছিলাম এবং সেখানে পুশ করার চেষ্টা করেছিলাম। একজন বাইরের অবদানকারী হিসেবে, আমার মূল রিপোজিটরিতে লেখার অনুমতি নেই। ## সমাধান আমি নিম্নলিখিত উপায়ে এই সমস্যাটি সমাধান করেছি: 1. আমার রিমোট URL পরিবর্তন করে এটিকে আমার ব্যক্তিগত ফর্কে পয়েন্ট করানো: ```bash $ git remote set-url origin https://github.com/yourname/first-contributions.git ``` 2. রিমোট ঠিকভাবে আপডেট হয়েছে কিনা তা যাচাই করা: ```bash $ git remote -v origin https://github.com/yourname/first-contributions.git (fetch) origin https://github.com/yourname/first-contributions.git (push) ``` 3. সফলভাবে আমার ফর্কে পুশ করা: ```bash $ git push origin fahimar_oss_YYYY ``` 4. GitHub আমাকে একটি লিঙ্ক দিয়েছিল যাতে আমি আমার ব্রাঞ্চ থেকে পুল রিকোয়েস্ট তৈরি করতে পারি: ``` remote: Create a pull request for 'fahimar_oss_YYYY' on GitHub by visiting: remote: https://github.com/fahimar/first-contributions/pull/new/fahimar_oss_YYYY ``` ## প্রধান শিক্ষা ওপেন সোর্স অবদানের জন্য সঠিক কাজের ধারাবাহিকতা হল: 1. মূল রিপোজিটরিটি আপনার GitHub অ্যাকাউন্টে ফর্ক করুন 2. আপনার ফর্কটি স্থানীয়ভাবে ক্লোন করুন 3. একটি নতুন ব্রাঞ্চে পরিবর্তন করুন 4. আপনার ফর্কে পুশ করুন 5. আপনার ফর্ক থেকে মূল রিপোজিটরিতে পুল রিকোয়েস্ট তৈরি করুন যদি আপনি আগে মূল রিপোজিটরি ক্লোন করে থাকেন এবং আপনার ফর্ক না করে থাকেন, তবে উপরে দেখানো মতো রিমোট URL আপডেট করে এটি ঠিক করতে পারেন। ================================================ FILE: docs/additional-material/translations/Bengali/gitflow-bn.md ================================================ গিটফ্লো (Gitflow) গিটফ্লো হলো একটি গিট ব্রাঞ্চিং মডেল, যা ভিনসেন্ট ড্রিসেন প্রস্তাব করেছিলেন। এখানে মূলত এর প্রয়োজনীয়তা ও ব্যবহারিক দিকগুলো নিয়ে আলোচনা করা হলো। গিটফ্লো ওয়ার্কফ্লো একটি কড়া ব্রাঞ্চিং মডেল, যা প্রজেক্টের রিলিজ সাইকেলকে ঘিরে তৈরি। এটি বড় প্রজেক্ট ম্যানেজ করার জন্য একটি শক্তিশালী কাঠামো দেয়। বিশেষ করে নির্দিষ্ট সময়ে রিলিজ দেওয়া প্রকল্পের জন্য এবং Continuous Delivery (CD) এর মতো DevOps প্র্যাকটিসের জন্য এটি উপযোগী। গিটফ্লো প্রতিটি ব্রাঞ্চের জন্য নির্দিষ্ট ভূমিকা ঠিক করে দেয় এবং কখন কীভাবে এগুলো একে অপরের সাথে মিশবে তা নির্ধারণ করে। এখানে আলাদা ব্রাঞ্চ ব্যবহার করা হয় প্রস্তুতি, রক্ষণাবেক্ষণ এবং রিলিজ সংরক্ষণ করার জন্য। বাস্তবায়ন (Implementation) 1. ডেভেলপ (develop) এবং মাস্টার (master) ব্রাঞ্চ সাধারণভাবে একটি মাস্টার ব্রাঞ্চ থাকার বদলে গিটফ্লো দুইটি প্রধান ব্রাঞ্চ ব্যবহার করে, যেগুলোর লাইফটাইম অসীম ধরা হয়। Master Branch: প্রোডাকশন কোড থাকে এখানে। অফিসিয়াল রিলিজ ইতিহাস সংরক্ষিত হয় এই ব্রাঞ্চে। Develop Branch: এখানে প্রি-প্রোডাকশন কোড থাকে। নতুন ফিচারগুলোর ইন্টিগ্রেশনের জন্য এটি ব্যবহৃত হয়। Develop ব্রাঞ্চ তৈরি করা: 👉 গিটফ্লো এক্সটেনশন ছাড়া: git branch develop git push -u origin develop 👉 গিটফ্লো এক্সটেনশন দিয়ে: git flow init 2. ফিচার (Feature) ব্রাঞ্চ প্রতিটি নতুন ফিচার একটি আলাদা ব্রাঞ্চে তৈরি হয়। এগুলো develop ব্রাঞ্চ থেকে তৈরি হবে এবং কাজ শেষ হলে develop এ মার্জ করা হবে। কোনো ফিচার ব্রাঞ্চ সরাসরি master এর সাথে যুক্ত হবে না। Feature ব্রাঞ্চ তৈরি করা: 👉 গিটফ্লো এক্সটেনশন ছাড়া: git checkout develop git checkout -b feature_branch 👉 গিটফ্লো এক্সটেনশন দিয়ে: git flow feature start feature_branch Feature ব্রাঞ্চ শেষ করা: 👉 গিটফ্লো এক্সটেনশন ছাড়া: git checkout develop git merge feature_branch 👉 গিটফ্লো এক্সটেনশন দিয়ে: git flow feature finish feature_branch 3. রিলিজ (Release) ব্রাঞ্চ যখন develop ব্রাঞ্চে পর্যাপ্ত ফিচার যুক্ত হয় (বা নির্ধারিত রিলিজ সময় চলে আসে), তখন develop থেকে একটি release ব্রাঞ্চ তৈরি হয়। এই ব্রাঞ্চ তৈরি হওয়ার পর আর নতুন ফিচার যোগ করা যাবে না। শুধু বাগ ফিক্স, ডকুমেন্টেশন, এবং রিলিজ সংক্রান্ত পরিবর্তন করা যাবে। Release ব্রাঞ্চ শেষে master এবং develop – দুইটিতেই মার্জ হবে। Release ব্রাঞ্চ তৈরি করা: 👉 গিটফ্লো এক্সটেনশন ছাড়া: git checkout develop git checkout -b release/0.1.0 👉 গিটফ্লো এক্সটেনশন দিয়ে: git flow release start 0.1.0 Release ব্রাঞ্চ শেষ করা: 👉 গিটফ্লো এক্সটেনশন ছাড়া: git checkout master git merge release/0.1.0 👉 গিটফ্লো এক্সটেনশন দিয়ে: git flow release finish 0.1.0 4. হটফিক্স (Hotfix) ব্রাঞ্চ হঠাৎ প্রোডাকশনে কোনো সমস্যা ধরা পড়লে দ্রুত সমাধানের জন্য hotfix ব্রাঞ্চ তৈরি হয়। এটি সরাসরি master থেকে তৈরি হয়। ফিক্স শেষ হলে এটি master এবং develop (বা বর্তমান release ব্রাঞ্চ) – উভয়েই মার্জ হবে। এরপর master এ নতুন ভার্সন ট্যাগ করা হবে। Hotfix ব্রাঞ্চ তৈরি করা: 👉 গিটফ্লো এক্সটেনশন ছাড়া: git checkout master git checkout -b hotfix_branch 👉 গিটফ্লো এক্সটেনশন দিয়ে: git flow hotfix start hotfix_branch Hotfix ব্রাঞ্চ শেষ করা: 👉 গিটফ্লো এক্সটেনশন ছাড়া: git checkout master git merge hotfix_branch git checkout develop git merge hotfix_branch 👉 গিটফ্লো এক্সটেনশন দিয়ে: git branch -D hotfix_branch git flow hotfix finish hotfix_branch সুবিধা (Advantages) যেকোনো সময় প্রকল্পের ব্রাঞ্চের অবস্থা পরিষ্কার থাকে। ব্রাঞ্চের নামকরণ নিয়মতান্ত্রিক হওয়ায় সহজে বোঝা যায়। গিটফ্লো অনেক জনপ্রিয় টুলে এক্সটেনশনসহ সমর্থিত। একাধিক প্রোডাকশন ভার্সন রক্ষণাবেক্ষণের জন্য উপযোগী। রিলিজ-ভিত্তিক সফটওয়্যার ওয়ার্কফ্লোর জন্য আদর্শ। প্রোডাকশনে হঠাৎ সমস্যার সমাধানের জন্য আলাদা চ্যানেল দেয়। অসুবিধা (Disadvantages) গিট ইতিহাস অনেক সময় জটিল হয়ে যায়। master/develop বিভাজন Continuous Delivery বা Continuous Integration–এর জন্য জটিলতা বাড়ায়। যদি একটাই প্রোডাকশন ভার্সন থাকে, তবে এটি ব্যবহার করা সুপারিশ করা হয় না। সারসংক্ষেপ (Summary) গিটফ্লো ওয়ার্কফ্লোর মূল ধাপগুলো হলো: master থেকে একটি develop ব্রাঞ্চ তৈরি হয়। নতুন ফিচার develop থেকে তৈরি হয়। ফিচার শেষ হলে develop এ মার্জ হয়। develop থেকে একটি release ব্রাঞ্চ তৈরি হয়। release ব্রাঞ্চ শেষ হলে এটি master এবং develop – উভয়েই মার্জ হয়। master এ কোনো সমস্যা হলে master থেকে hotfix ব্রাঞ্চ তৈরি হয়। hotfix শেষ হলে এটি develop এবং master – উভয়েই মার্জ হয়। ================================================ FILE: docs/additional-material/translations/Bengali/merge-conflict.md ================================================ মার্জ কনফ্লিক্ট (Merge Conflict) কী? যখন আপনি অন্য কোনো ব্রাঞ্চকে আপনার বর্তমান কাজের ব্রাঞ্চের সাথে মার্জ করতে চান, তখন মূলত অন্য একটি কনটেক্সট থেকে পরিবর্তন নিয়ে এসে আপনার বর্তমান ফাইলগুলোর সাথে মিশিয়ে দিচ্ছেন। কিন্তু যদি একই ফাইলের একই লাইন একাধিক ব্যক্তি পরিবর্তন করে থাকেন, অথবা একজন ফাইল ডিলিট করে ফেলেছেন আর অন্যজন সেটি পরিবর্তন করেছেন — তখন গিট বুঝতে পারে না কোন ভার্সন রাখা উচিত। এই পরিস্থিতিতেই গিট ফাইলটিকে conflict অবস্থায় চিহ্নিত করে। আপনাকেই সেটি সমাধান করতে হয়, তারপর কাজ চালিয়ে যেতে পারবেন। মার্জ কনফ্লিক্ট কীভাবে সমাধান করবেন? যখন merge conflict হয়, গিট ফাইলের ভেতরে বিশেষ চিহ্ন দিয়ে সমস্যাযুক্ত অংশগুলো দেখায়। এটি সাধারণত এরকম থাকে: <<<<<<< HEAD:mergetest This is my third line ======= This is a fourth line I am adding >>>>>>> 4e2b407f501b68f8588aa645acafffa0224b9b78:mergetest <<<<<<< HEAD: এখানে আপনার বর্তমান ব্রাঞ্চের কনটেন্ট থাকবে। =======: উপরের (আপনার ব্রাঞ্চের) পরিবর্তন আর নিচের (অন্য ব্রাঞ্চের) পরিবর্তনের মাঝে পার্থক্য বোঝানোর জন্য ব্যবহৃত হয়। >>>>>>>: এখানে অন্য ব্রাঞ্চ থেকে আসা পরিবর্তনগুলো থাকে। 👉 আপনাকে ফাইলটি এডিট করে ঠিক করতে হবে কোন কনটেন্ট থাকবে। হয় আপনার পরিবর্তন রাখতে পারেন নয়তো অন্যজনের পরিবর্তন রাখতে পারেন অথবা দুইটিকে মিলিয়ে একটি নতুন ভার্সন বানাতে পারেন। কাজ শেষে অবশ্যই <<<<<<<, =======, >>>>>>> এই মার্কার লাইনগুলো মুছে ফেলতে হবে। সমাধানের ধাপ: ফাইল এডিট করে কনফ্লিক্ট ঠিক করুন। পরিবর্তন নিশ্চিত করতে git add করুন। সব টেস্ট রান করে নিশ্চিত হোন যে সমাধান সঠিক হয়েছে। 👉 চাইলে আপনার IDE-এর জন্য প্লাগইন ব্যবহার করতে পারেন, যা ভিজ্যুয়ালভাবে কনফ্লিক্ট রেজলভ করা সহজ করে দেয়। কীভাবে একটি Merge বাতিল করবেন? যদি মার্জ করার সময় ভুল হয় বা মাঝপথে বাতিল করতে চান, তাহলে নিচের কমান্ড ব্যবহার করতে পারেন: git merge --abort এটি মার্জ প্রক্রিয়াটি থামিয়ে দেয় এবং আপনার ব্রাঞ্চকে আগের অবস্থায় ফিরিয়ে নিয়ে যায়। ================================================ FILE: docs/additional-material/translations/Bengali/things-a-non-programmer-can-do-bn.md ================================================ # একজন নন-প্রোগ্রামার যা করতে পারেন ## শোনা শুরু করুন ওপেন সোর্স-এ সবকিছুতেই অন্যরা জড়িত। আপনি একটি দলে যোগ দিতে চাইছেন, এবং এর অর্থ হল সম্প্রদায়টি এবং এটি কীভাবে কাজ করে তা বোঝা। একটি প্রকল্পে প্রবেশ করে "হাই, আমার মনে হয় এই প্রকল্পটি কী করা উচিত" বলা সাধারণত ভালো জিনিস হিসাবে নেওয়া হয় না। কিছু প্রকল্প এই ধরণের পদ্ধতিকে স্বাগত জানাতে পারে, কিন্তু যদি প্রকল্পটি দীর্ঘদিন ধরে চলছে, তাহলে সেই মনোভাব গ্রহণের সম্ভাবনা কম। **প্রকল্পের কী প্রয়োজন তা জানার জন্য শোনাই সর্বোত্তম উপায়।** ১. **একটি মেইলিং তালিকায় যোগদান করুন**: অনেক প্রকল্পের জন্য, মেইলিং তালিকা হল প্রকল্পের উন্নয়ন সম্পর্কে যোগাযোগের প্রধান মাধ্যম। বড় প্রকল্পে, বেছে নেওয়ার জন্য অনেক মেইলিং তালিকা রয়েছে। উদাহরণস্বরূপ, PostgreSQL প্রকল্পের মেইলিং তালিকা পৃষ্ঠায় কমপক্ষে ১২টি ব্যবহারকারী-ভিত্তিক তালিকা এবং ছয়টি বিকাশকারী তালিকা রয়েছে। আমি আপনাকে প্রধান ব্যবহারকারী-ভিত্তিক তালিকা এবং মূল বিকাশকারী তালিকা অনুসরণ করার পরামর্শ দিচ্ছি যেখানে আপনি শুনতে শুরু করবেন। ২. **একটি ব্লগ অনুসরণ করুন**: মূল ডেভেলপারদের দ্বারা পরিচালিত ব্লগগুলি প্রায়শই ভবিষ্যতের রিলিজে কী আসছে, এবং সেখানে পৌঁছানোর জন্য কী কী প্রয়োজন সে সম্পর্কে তথ্য দেয়। একটি প্ল্যানেট সাইট প্রকল্পের সাথে সম্পর্কিত অনেক উৎস থেকে সংবাদ এবং ব্লগ এন্ট্রি একত্রিত করে। যদি planet.gnome.org বা planet.mysql.com এর মতো কোনও প্ল্যানেট সাইট থাকে, তাহলে সেখান থেকে শুরু করুন। "planet " লিখে গুগলে অনুসন্ধান করুন। ৩. **একটি IRC চ্যানেলে যোগদান করুন**: অনেক ওপেন সোর্স প্রকল্পে ডেডিকেটেড ইন্টারনেট রিলে চ্যাট (IRC) চ্যানেল থাকে যেখানে ডেভেলপার এবং ব্যবহারকারীরা সমস্যা এবং উন্নয়ন নিয়ে আলোচনা করতে আড্ডা দেয়। চ্যানেলটির নাম এবং এটি কোন IRC নেটওয়ার্কে পাওয়া যায় তার বিশদ জানতে প্রকল্পের ওয়েবসাইটটি দেখুন। **টিকিট নিয়ে কাজ করুন** কোড হল যেকোনো ওপেন সোর্স প্রকল্পের হৃদয়, কিন্তু মনে করবেন না যে কোড লেখাই অবদান রাখার একমাত্র উপায়। নতুন বৈশিষ্ট্য তৈরি এবং বাগ সংশোধন করার তাড়াহুড়োয় কোড এবং কোডের চারপাশের সিস্টেমগুলি প্রায়শই অবহেলিত হয়। এই ক্ষেত্রগুলিকে একটি প্রকল্পে আপনার পা রাখার সহজ উপায় হিসেবে দেখুন। বেশিরভাগ প্রকল্পের একটি সর্বজনীনভাবে দৃশ্যমান সমস্যা টিকিট সিস্টেম থাকে, যা প্রকল্পের ওয়েবসাইটের প্রথম পৃষ্ঠা থেকে লিঙ্ক করা হয় এবং ডকুমেন্টেশনে অন্তর্ভুক্ত থাকে। এটি ব্যবহারকারী এবং ডেভেলপারদের মধ্যে যোগাযোগের প্রাথমিক মাধ্যম। এটিকে আপডেট রাখা প্রকল্পকে সাহায্য করার একটি দুর্দান্ত উপায়। টিকিটিং সিস্টেমে আপনার বিশেষ অনুমতি নেওয়ার প্রয়োজন হতে পারে, যা বেশিরভাগ প্রকল্প নেতারা আপনাকে টিকিট পরিষ্কার করতে সাহায্য করার সময় দিতে পেরে খুশি হবেন। ৪. **একটি বাগ নির্ণয়**: বাগগুলি প্রায়শই খারাপভাবে রিপোর্ট করা হয়। একটি বাগ নির্ণয় এবং ট্রাইএজিং ডেভেলপারদের সমস্যার সুনির্দিষ্ট দিকগুলি খুঁজে বের করার সময় সময় বাঁচাতে সাহায্য করতে পারে। যদি কোনও ব্যবহারকারী রিপোর্ট করেন, "আমি যখন X করি তখন সফ্টওয়্যারটি কাজ করে না," তাহলে সেই সমস্যার মধ্যে কী কী যায় তার সুনির্দিষ্ট দিকগুলি খুঁজে বের করার জন্য কিছু সময় ব্যয় করুন। এটি কি পুনরাবৃত্তিযোগ্য? আপনি কি বারবার সমস্যাটি তৈরি করার জন্য পদক্ষেপের একটি সেট তৈরি করতে পারেন? আপনি কি সমস্যাটি সংকুচিত করতে পারেন, যেমন শুধুমাত্র একটি ব্রাউজারে ঘটছে কিন্তু অন্য ব্রাউজারে নয়, অথবা একটি ডিস্ট্রো কিন্তু অন্য ব্রাউজারে নয়? যদিও আপনি জানেন না যে সমস্যাটি কী, পরিস্থিতি সংকুচিত করার জন্য আপনি যে প্রচেষ্টা করেন তা অন্য কারও পক্ষে এটি ঠিক করা সহজ করে তোলে। আপনি যা আবিষ্কার করেন, তা সকলের দেখার জন্য বাগ সিস্টেমের টিকিটে যুক্ত করুন। ৫. **সংশোধিত বাগগুলি বন্ধ করুন**: প্রায়শই কোডবেসে বাগগুলি ঠিক করা হয় কিন্তু তাদের সম্পর্কে রিপোর্ট করা টিকিট টিকিটিং সিস্টেমে আপডেট করা হয় না। এই ক্রাফ্টটি পরিষ্কার করা সময়সাপেক্ষ হতে পারে, তবে এটি পুরো প্রকল্পের জন্য মূল্যবান। এক বছরেরও বেশি পুরানো টিকিটের জন্য টিকিট সিস্টেমে জিজ্ঞাসা করে শুরু করুন এবং দেখুন বাগটি এখনও বিদ্যমান কিনা। বাগটি ঠিক করা হয়েছে কিনা এবং বন্ধ করা যেতে পারে কিনা তা দেখতে প্রকল্পের রিলিজ পরিবর্তন লগটি পরীক্ষা করুন। যদি এটি ঠিক করা হয়েছে বলে জানা যায়, তাহলে টিকিটের সংস্করণ নম্বরটি নোট করুন এবং এটি বন্ধ করুন। সফ্টওয়্যারের সর্বশেষ সংস্করণ দিয়ে বাগটি পুনরায় তৈরি করার চেষ্টা করুন। যদি এটি সর্বশেষ সংস্করণ দিয়ে পুনরায় তৈরি করা না যায়, তাহলে টিকিটে এটি লিখে রাখুন এবং বন্ধ করে দিন। যদি এটি এখনও বিদ্যমান থাকে, তাহলে টিকিটেও এটি লিখে রাখুন এবং এটি খোলা রাখুন। কোডের সাথে কাজ করা সকল অভিজ্ঞতা স্তরের প্রোগ্রামাররা প্রকল্পের কোডের সাথে সাহায্য করতে পারে। ভাববেন না যে আপনার প্রিয় প্রকল্পে প্রকৃত অবদান রাখার জন্য আপনাকে একজন কোডিং প্রতিভা হতে হবে। যদি আপনার কাজের ক্ষেত্রে কোড পরিবর্তন জড়িত থাকে, তাহলে প্রকল্পটি অবদানকারীদের কাছ থেকে কোড পাওয়ার জন্য যে পদ্ধতি ব্যবহার করে তা অনুসন্ধান করুন। প্রতিটি প্রকল্পের নিজস্ব কর্মপ্রবাহ থাকে, তাই কোড জমা দেওয়ার আগে এটি কীভাবে করবেন তা জিজ্ঞাসা করুন। উদাহরণস্বরূপ, PostgreSQL প্রকল্পটি তার প্রক্রিয়ায় খুবই কঠোর: কোড পরিবর্তনগুলি প্যাচ আকারে একটি মেইলিং তালিকায় পাঠানো হয় যেখানে মূল বিকাশকারীরা পরিবর্তনের প্রতিটি দিক পরীক্ষা করে। অন্যদিকে, Parrot এর মতো একটি প্রকল্প যেখানে কোডবেসে কমিট সুবিধা পাওয়া সহজ। যদি প্রকল্পটি GitHub ব্যবহার করে, তাহলে এমন একটি কর্মপ্রবাহ থাকতে পারে যা GitHub এর পুল অনুরোধ বৈশিষ্ট্য ব্যবহার করে। কোনও দুটি প্রকল্প একই নয়। যখনই আপনি কোড পরিবর্তন করবেন, তখন নিশ্চিত করুন যে আপনি সম্প্রদায়ের একজন দায়িত্বশীল সদস্য হিসেবে কাজ করছেন এবং আপনার কোড স্টাইলটি কোডবেসের বাকি অংশের সাথে মিলে যাচ্ছে। আপনি যে কোডটি যোগ করবেন বা পরিবর্তন করবেন তা বাকি অংশের মতো দেখতে হবে। আপনার ব্রেসিং স্টাইল বা ইন্ডির জন্য স্পেস পরিচালনা পছন্দ নাও হতে পারে। ================================================ FILE: docs/additional-material/translations/Chinese/Things a non Programmer can do.zh-cn.md ================================================ # 非程序员可以做的事 ## 从倾听开始 开源的本质是人与人之间的合作。 你想要加入一个团队，就必须了解这个社区以及它是如何运作的。 直接进入一个项目并说“嗨，我认为这个项目应该做XXX”通常不会被很好地接受。 某些项目可能欢迎这种方式，但如果项目已经运行一段时间，这种态度很难被采纳。 **倾听是了解项目真正需求的最佳方式。** 1. **加入邮件列表**： 对于许多项目来说，邮件列表是关于项目开发的主要沟通渠道。在大型项目中，可能会有很多不同的邮件列表可供选择。例如，PostgreSQL 项目在其邮件列表页面上就有不少于 12 个面向用户的列表和 6 个开发者列表。 建议你一开始关注主要的用户列表和核心开发者列表来“听听看”。 2. **关注博客**： 核心开发人员维护的博客通常会分享有关未来版本的计划，以及达成这些目标的过程。一个叫做 planet 的网站会汇集来自多个相关来源的新闻和博客内容。 如果某个项目有 planet 网站，比如 planet.gnome.org 或 planet.mysql.com，请从那里开始。只需在 Google 中搜索 "planet " 即可。 3. **加入 IRC 频道**： 许多开源项目都有专属的 IRC（互联网中继聊天）频道，开发者和用户会在里面讨论问题与开发进度。在项目的官方网站上通常可以找到 IRC 频道的名称和所在网络的信息。 **处理工单系统** 代码是任何开源项目的核心，但不要以为只有写代码才算是贡献。 代码的维护及其周边系统往往在开发新功能或修复 bug 的过程中被忽略。 这些部分是你进入项目的良好切入点。 大多数项目都有公开的故障工单系统，通常在项目主页和文档中就能找到链接。 它是用户与开发者之间的主要沟通渠道。 保持工单系统的更新就是一种很有价值的贡献。 你可能需要获得该系统的特别权限，一旦你表示出愿意协助维护，项目负责人通常会很乐意为你开放权限。 4. **诊断 bug**： 很多 bug 报告都不够详细。 协助诊断并分析 bug 可以大大节省开发者排查问题的时间。 比如用户报告“我做了 X 操作，软件就坏了”，你可以尝试复现问题，找出具体触发条件。 这个问题是可以重复触发的吗？能不能提炼出一套步骤重现问题？是否只在某些浏览器或操作系统中才出现？ 即使你不清楚问题的根本原因，但你做出的分析工作，也会让其他人更容易去修复它。 无论你发现了什么，请将其记录在工单系统中，方便所有人查看。 5. **关闭已修复的 bug**： 有些 bug 虽然已经在代码中修复，但对应的工单却没有更新状态。 清理这些“陈年工单”虽然耗时，但对整个项目非常有帮助。 你可以从查询一年以前的工单开始，检查这些 bug 是否仍然存在。 阅读项目的更新日志，确认 bug 是否已被修复。 如果确定已修复，请在工单中注明修复版本并关闭工单。 也可以尝试使用最新版本重现这个 bug。 如果无法复现，请在工单中注明并关闭；如果仍存在，也请更新工单说明并保留为“打开”状态。 ## 参与代码工作 不同经验水平的开发者都可以为项目贡献代码。 不要认为只有编程大神才有资格参与贡献。 如果你的工作涉及代码更改，请先了解项目是如何接受代码贡献的。 每个项目的工作流都不同，因此在提交代码之前请先询问清楚流程。 例如，PostgreSQL 项目对代码提交要求非常严格：必须以补丁形式发送到邮件列表，由核心开发者详细审查。 而 Parrot 项目则相对宽松，很容易就能获得代码库的提交权限。 如果项目托管在 GitHub 上，可能还会使用 pull request 的工作流。 没有两个项目是完全相同的。 每当你修改代码时，请务必遵守已有代码风格，使你提交的代码看起来就像是原生的一部分。 即使你不喜欢某种括号或缩进方式，也不应擅自改变已有风格。 这就像在说：“我不喜欢你们的风格，我的更好，你们应该改成我的。” 6. **测试测试版或候选版本**： 如果一个项目支持多个平台，那发布前的可移植性测试就至关重要。 当项目发布 beta 或 RC（Release Candidate）版本时，项目负责人希望有人能在各种平台上进行测试。 你就可以成为其中一员，帮助确认在你的环境下也能正常运行。 通常你只需下载、构建并运行软件即可。 尤其当你使用的是较为冷门的操作系统或硬件时，你的反馈对项目非常宝贵。 7. **修复一个 bug**： 这是很多想写代码的新手常见的起点。 很简单：在工单系统中找一个感兴趣的问题，尝试去修复它。 如果合适，可以在代码中添加注释记录你的修改；如果项目有测试套件，最好也为你修复的 bug 添加测试用例。 即便你没能修复 bug，也请将你调查的结果写进工单中，这对后来的人是很有帮助的。 8. **编写测试用例**： 大多数项目都有测试套件，但几乎没有哪个测试覆盖是“完美”的。 可以使用测试覆盖工具（如：C 的 gcov，Perl 的 Devel::Cover）找出哪些代码尚未被测试。 然后为这些部分添加测试用例。 9. **消除编译警告**： 许多基于 C 的项目在编译时会有很多警告信息。 虽然多数情况下这并不影响程序运行，但会制造混乱或误导。 你可以排查警告背后是否隐藏真正的 bug。 如果没有实际问题，就修改代码消除警告，提升代码整洁度。 10. **添加注释**： 当你在阅读代码时，可能会遇到令人困惑的部分。 如果你感到困惑，别人可能也会。 请在适当位置添加注释并提交补丁，帮助其他人理解代码。 ## 编写文档 文档常常是被忽视的一部分。 而且很多时候文档是“内部人”写给“内部人”的，忽略了初学者视角。 如果你曾看过某个手册让你觉得：“作者好像默认我已经懂这套系统了”，你就明白我的意思了。 新人的眼睛能发现老成员早已忽视的问题。 11. **创建示例**： 任何项目都不嫌示例多。 无论是 Web API、函数库、图形工具（如 Gimp）或命令行工具， 一个实用示例往往比一大堆文档更能直观说明使用方式。 对于 API 或库，可以写个简单的 demo；对于工具，展示真实的使用情景。 如果你擅长视觉内容，也可以录屏展示如何安装、配置等步骤。 ## 参与社区 开源项目不仅仅是代码。社区才是开源的生命力来源。以下是你可以帮助社区的方式： 12. **回答问题**： 帮助新手是社区成长的重要方式。 即使对方的问题很基础，也不要敷衍了事。 哪怕是你很想说“RTFM”，请记住：帮助他们，就等于在培养未来的维护者。 每个人都是从新手走过来的，项目要保持活力就需要不断有新人加入。 13. **写一篇博客**： 如果你有博客，请写下你使用该项目的经验。 记录你遇到的问题和解决办法，这不仅可以帮助搜索到的人，也有助于传播该项目。 （顺带一提，如果你未来找工作，技术博客是一个很好的展示作品集的方式） 14. **优化网站**： 如果你有网页设计技能，可以协助美化项目网站或设计 logo，提升项目的公众形象。 这些往往是开源社区中缺乏的技能，我相信很多维护者都会非常欢迎这方面的协助。 15. **编写技术文档**： 如果你擅长用通俗易懂的方式说明软件原理，可以帮助项目撰写或更新技术文档。 很多开源项目都在寻找志愿者来扩展文档，尤其是面向普通大众的部分。 你不需要是程序员，只要能把话说清楚就行。 最重要的是，倾听周围人的讨论，观察有没有什么急需解决的问题。 例如，在 Parrot 项目的邮件列表中，有人提议将工单系统从 Trac 转移到 GitHub。 但由于缺乏转换工具，一度引发争论。我当时提出“我可以写一个转换器”。 大家非常欢迎这个提议。我花时间写了一个转换程序，把 450 多条工单全部迁移了过去。 这是一次很成功的贡献。开发者继续专注写代码，而我解决了一个让大家头疼的问题。 16. **教学与协助他人**： 最好的学习方式就是尝试去教别人。 能用最简单的例子讲清复杂概念的老师，往往才是最厉害的。 教学不但能加深你自己的理解，也能帮助别人快速上手。 你从别人那里学到的知识，也请传递下去，让世界变得更美好。 ================================================ FILE: docs/additional-material/translations/Chinese/Useful-links-for-further-learning.zh-cn.md ================================================ # 实用链接 本页面致敬所有让我们生活更轻松的技巧网站、博客文章和实用链接。 无论是初学者还是资深开发者，它们都是极好的参考资源。 这个页面将作为一个索引，汇总所有对开源领域新人或想深入了解的人有帮助的链接。 ## 链接列表 **请注意: 以下所有链接均为英文内容。** 1. [Git 交互式教程](https://try.github.io) 2. [YouTube：FreeCodeCamp 的 Git 和 GitHub 初学者教程](https://www.youtube.com/watch?v=RGOj5yH7evk) 3. [git - 简明指南](http://rogerdudler.github.io/git-guide/) 4. [如何撤销、更改或删除 Git 提交](http://sethrobertson.github.io/GitFixUm/fixup.html) 5. [Git 和 GitHub 教程（多语言版本）](https://github.com/Roshanjossey/first-contributions) 6. [解决合并冲突](https://www.git-tower.com/learn/git/ebook/en/command-line/advanced-topics/merge-conflicts) 7. [Git How To：解决合并冲突](https://githowto.com/resolving_conflicts) 8. [Git 基础 - 快速入门指南](https://blog.praveen.science/basics-of-git-the-quick-start-guide/) 9. [我们在 Spotify Agile 方法中使用的 Git 标准](https://blog.praveen.science/git-standards-followed-in-our-way-of-spotify-agile-methodolgy/) 10. [Git 快捷方式](https://blog.praveen.science/git-shortcuts/) 11. [官方 Git 多语言备忘单](https://services.github.com/on-demand/resources/cheatsheets) 12. [来自 Tower 的 Git 备忘单](https://www.git-tower.com/learn/cheat-sheets/git) 13. [常见 Git 问题及解决方法](https://www.codementor.io/citizen428/git-tutorial-10-common-git-problems-and-how-to-fix-them-aajv0katd) 14. [Git Rebase 图解指南](https://blog.gitprime.com/git-rebase-an-illustrated-guide/) 15. [新手 Rebasing 与 Squashing 指南](https://github.com/servo/servo/wiki/Beginner%27s-guide-to-rebasing-and-squashing) 16. [命令与文件关联的 Git 速查表](http://ndpsoftware.com/git-cheatsheet.html) 17. [如何贡献开源](https://opensource.guide/how-to-contribute/) 18. [开源贡献入门指南](https://github.com/OpenSourceHelpCommunity/Getting-Started-With-Contributing-to-Open-Sources) 19. [FreeCodeCamp 的开源贡献指南](https://github.com/freeCodeCamp/how-to-contribute-to-open-source) 20. [Atlassian 的 Git 教程](https://www.atlassian.com/git) 21. [Pull Request 审查流程](https://help.github.com/articles/about-pull-request-reviews/) 22. [另一个 Git 交互式教程](https://learngitbranching.js.org/) 23. [Git 命令行速查表](https://gist.github.com/davfre/8313299) 24. [编程书籍（免费)](https://github.com/EbookFoundation/free-programming-books) 25. [Git 专业技巧与秘籍电子书](https://goalkicker.com/GitBook/GitProfessionalTipsSecrets.pdf) 26. [成为 Git 专家的简单规则](https://medium.freecodecamp.org/follow-these-simple-rules-and-youll-become-a-git-and-github-master-e1045057468f) 27. [关于 Git 提交信息的建议](https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) 28. [更好的提交信息的 5 个技巧](https://thoughtbot.com/blog/5-useful-tips-for-a-better-commit-message) 29. [Git 版本控制基础](https://ourcodingclub.github.io/2017/02/27/git.html) 30. [Git 版本控制课程（Udacity）](https://www.udacity.com/course/version-control-with-git--ud123) 31. [Coursera 上 Google 提供的 Git 课程（可试听）](https://www.coursera.org/learn/introduction-git-github) 32. [在 VS Code 中使用版本控制](https://code.visualstudio.com/docs/editor/versioncontrol) 33. [Git 与 GitHub 的区别以及入门方法](https://kinsta.com/knowledgebase/git-vs-github/) 34. [Hello World Github 教程](https://guides.github.com/activities/hello-world/) 35. [如何使用 GitHub](https://www.edureka.co/blog/how-to-use-github/) 36. [Git 与 GitHub 的 10 天教程](https://github.com/Asabeneh/10-days-of-git-and-github) 37. [GitHub 快捷键列表](https://docs.github.com/en/get-started/using-github/keyboard-shortcuts) 38. [Kunal Kushwaha 的 Git 和 GitHub 完整教程（YouTube）](https://www.youtube.com/watch?v=apGV9Kg7ics&ab_channel=KunalKushwaha) 39. [Git 工作流速查表（Google Drive)](https://drive.google.com/uc?export=download&id=1QPRh5YmqQm4DFfitelPYlBTWC2I6tTTM) 40. [初学者 Git 工作流指南](https://medium.com/@anjulapaulus_84798/beginners-guide-to-proper-git-workflow-35a2d967734e) 41. [如何使用 GitHub Pages](https://docs.github.com/en/pages) 42. [了解 GitHub Copilot](https://docs.github.com/en/copilot/about-github-copilot/what-is-github-copilot) 持续添加你觉得有用的链接吧！ ================================================ FILE: docs/additional-material/translations/Chinese/additional-material.zh-cn.md ================================================ # 附加资料 我们认为你在来到这里之前已经完成基本教学。附加资料会给你关于 Git 进阶技术的信息。 ### [从你的 repository 删除分支](../removing-branch-from-your-repository.md) 这份文件教你如何从 repository 删除分支。 > 在做这些步骤前确定你的 pull request 是被合并的。 ### [保持你的分叉与 repository 同步](../keeping-your-fork-synced-with-this-repository.md) 这份文件提供保持分叉与原始 repository 同步的资料。这件事情是很重要的，因为有其他人会对 project 做出贡献。 > 如果你的分叉没有对原始 repository 做改变，根据这些步骤操作。 ### [回滚 commit](../reverting-a-commit.md) 这份文件提供如何对远端 repository 回滚 commit。这项操作在需要回滚 commit，但已经 push 到 Github时适用。 > 如果你想要回滚 commit，根据这些步骤操作。 ### [修改 commit](../amending-a-commit.md) 这份文件教你如何在修改在远端的 commit。 > 在你需要调整 commit 的时候使用这个。 ### [恢复本地的 commit](../undoing-a-commit.md) 这份文件教你如何恢复本地的 commit。在你觉得你搞砸了本地的 repository，并且希望重置你的 repository时，照着做就对了。 > 如果你需要回复/重置 commit 时，跟着做吧。 ### [解决合并冲突](../resolving-merge-conflicts.md) 这份文件教你解决合并时的冲突。 > 跟着这些步骤来解决烦人的冲突。 ### [删除文件](../removing-a-file.md) 这份文件教你从本地 repository 中删除文件。 > 跟着这些步骤学习如何从之前的 commit 中删除文件。 ### [移动 commit 到另一个分支](../moving-a-commit-to-a-different-branch.md) 这份文件教你如何移动 commit 到另一个分支。 > 跟着步骤移动 commit 到另一个分支。 ### [配置 git](../configuring-git.md) 这份文件教你设置 git 的用户资料与其他选项。 > 阅读这份文件让你对 git 配置更有掌握。 ### [好用的链接](../Useful-links-for-further-learning.md) 这份文件包含许多好用的博文、网站、提示和小技巧，了解这些让我们可以更容易上手。这一页应该当做好用链接的索引，让开源的新手还有想认识开源的人可以了解更多。 ### [挤压 commits](../squashing-commits.md) 这份文件教你如何通过交互式 rebase 挤压 commits。 > 如果你想要发出一个 PR，但检阅者要求你将一部分 commits 挤压成一个 commits 通过交互式 rebase。 ================================================ FILE: docs/additional-material/translations/Chinese/addtional-material.cht.md ================================================ # 附加資料 我們認為你在來到這裡以前已經完成基本教學。附加資料會給你關於 Git 進階技術的資訊。 ### [從你的 repository 刪除分支](../../git_worklow_scenarios/removing-branch-from-your-repository.md) 這份文件教你如何從 repository 刪除分支。 > 在做這些步驟前確定你的 pull request 是被合併的。 ### [保持你的分叉與 repository 同步](../../git_workflow_scenarios/keeping-your-fork-synced-with-this-repository.md) 這份文件提供保持分叉與原始 repository 同步的資料。這件事情是很重要的，因為有其他人會對 project 做出貢獻。 > 如果你的分叉沒有對原始 repository 做改變，根據這些步驟做操作。 ### [回復 commit](../../git_workflow_scenarios/reverting-a-commit.md) 這份文件提供如何對遠端 repository 回復 commit。這項操作適用在你需要回復 commit，但你已經 push 到 Github。 > 如果你想要回復 commit，根據這些步驟操作。 ### [修訂 commit](../../git_workflow_scenarios/amending-a-commit.md) 這份文件教你如何在修訂在遠端的 commit。 > 在你需要調整 commit 的時候使用這個。 ### [回復本地的 commit](../../git_workflow_scenarios/undoing-a-commit.md) 這份文件教你如何回復本地的 commit。在你覺得你搞砸了本地的 repository，並且希望重置你的 repository時，照著做就對了。 > 如果你需要回復/重置 commit 時，跟著做吧。 ### [解決合併時的衝突](../../git_workflow_scenarios/resolving-merge-conflicts.md) 這份文件教你解決合併時的衝突。 > 跟著這些步驟來解決煩人的衝突。 ### [刪除檔案](../../git_workflow_scenarios/removing-a-file.md) 這份文件教你從本地 repository 中刪除檔案。 > 跟著這些步驟學習如何從之前的 commit 中刪除檔案。 ### [移動 commit 到另一個分支](../../git_workflow_scenarios/moving-a-commit-to-a-different-branch.md) 這份文件教你如何移動 commit 到另一個分支。 > 跟著步驟移動 commit 到另一個分支。 ### [配置 git](../../git_workflow_scenarios/configuring-git.md) 這份文件教你設定 git 的使用者資料與其他選項。 > 閱讀這份文件讓你對 git 配置更有掌握。 ### [好用的連結](../../git_workflow_scenarios/Useful-links-for-further-learning.md) 這份文件包含許多好用的部落格文章、網站、提示和小技巧，了解這些讓我們可以更容易上手。這一頁應該當做好用連結的索引，讓開源的新手還有想認識開源的人可以了解更多。 ### [擠壓 commits](../../git_workflow_scenarios/squashing-commits.md) 這份文件教你如何藉由互動式 rebase 擠壓 commits。 > 如果你想要發出一個 PR，但檢閱者要求你將一部份 commits 擠壓成一個 commits 藉由互動式 rebase。 ================================================ FILE: docs/additional-material/translations/Chinese/amending-a-commit.zh-cn.md ================================================ # 修改 Commit 假设你已经将一个更改提交到远程仓库，但后来你发现提交信息有一个拼写错误，或者你忘记在最近的提交中添加一行。 你该如何编辑这个提交？这篇教程将为你解答。 ## 在推送到 Github 后修改最近的提交信息 如果你不想打开文件，可以通过以下方式进行修改： * 输入 `git commit --amend -m "然后是你新的提交信息"` * 运行 `git push origin ` 将更改提交到仓库。 注意：如果只输入 `git commit --amend`，则会打开文本编辑器，提示你编辑提交信息。 添加 `-m` 标志可以防止这种情况。 ## 修改单个提交 那么，如果我们忘记对文件做一个小的更改，比如更改一个单词，而且我们已经将提交推送到远程仓库了，怎么办呢？ 以下是我的提交日志： ``` g56123f 创建 bot 文件 a2235d 更新 contributor.md a5da0d 修改 bot 文件 ``` 假设我忘记在 bot 文件中添加一个单词。 有两种方法可以解决这个问题。第一种方法是创建一个包含更改的新提交，如下所示： ``` g56123f 创建 bot 文件 a2235d 更新 contributor.md a5da0d 修改 bot 文件 b0ca8f 添加 bot 文件中的单词 ``` 第二种方法是修改 `a5da0d` 提交，添加这个新单词，并将其作为一个提交推送到 Github。 第二种方法更好，因为这只是一个小改动。 为了实现这一点，我们可以按照以下步骤操作： * 修改文件。在本例中，我会修改 bot 文件，加入之前遗漏的单词。 * 接下来，使用 `git add ` 将文件添加到暂存区。 通常，在将文件添加到暂存区之后，我们会运行 git commit -m "我们的提交信息"`, 对吧？ 但由于我们希望修改的是上一个提交，我们应该运行： * `git commit --amend` 这会打开文本编辑器，提示你编辑提交信息。你可以选择保留原来的信息，也可以修改它。 * 退出编辑器 * 使用 `git push origin ` 推送更改 这样，两个更改就会合并为一个提交。 ## 修改远程提交 如果你想修改的提交已经推送到远程，修改该提交将导致你的本地历史与远程分支不同步（因为你实际上创建了一个新提交并替换了已修改的提交）。 由于你希望更改远程的提交，你需要覆盖远程仓库中的历史记录。为了实现这一点，请按照上述相同的步骤操作，但在推送提交到远程时使用强制推送。 > **警告** > 强制推送到远程将覆盖（并丢弃）远程上的更改，只保留你推送的提交。其他团队成员在此期间对远程的更改也将被覆盖。 这是如何修改远程仓库中最后一次提交的方法： ```bash git add git commit --amend -m "然后是你的新提交信息" git push --force ``` >使用 `--force-with-lease` 比 `--force` 更安全，它可以避免覆盖远程分支上其他人的更改（如果你不打算这么做）。 ================================================ FILE: docs/additional-material/translations/Chinese/check-commit-log.zh-cn.md ================================================ # 查看提交日志 为了查看某个分支或某个文件的提交日志，可以使用以下命令： `git log [options] [path]` 该命令的输出默认按逆时间顺序排列。 ## 命令输出示例 ``` $ git log commit e3fabb30ab536bd5876461d8a749301a321e714f (HEAD -> check-commit-log-ko, upstream/main, origin/main, origin/HEAD, main) Author: Dan Yunheum Seol yunheum.seol@mail.mcgill.ca Date: Tue Jun 4 01:07:25 2024 -0400 Add dan-seol to Contributors list (#84962) commit 4af4ec8a56e057ce8768af77eda528453974d0bc Author: Edgar Humberto Tijerina Tamez <168693312+EdgarHTT@users.noreply.github.com> Date: Mon Jun 3 23:06:05 2024 -0600 Add Edgar Tijerina to Contributors list (#84961) ``` ## 命令变体和选项 - 若要查看从某些特定提交 ids: （例如 `foo` 和 `bar`）可达的提交，可以使用：
`git log foo bar ` - 也可以通过在提交 id 前添加 `^` 来排除某个提交（例如 `baz`）：
`git log foo bar ^baz` - 查看特定文件的提交日志：
`git log --all ` - 限制日志中提交的数量：（例如 `5`）
`git log -n 5` ## 参考 - [官方文档](https://git-scm.com/docs/git-log) ================================================ FILE: docs/additional-material/translations/Chinese/configuring-git.zh-cn.md ================================================ # 配置 git 第一次使用 git 提交时，你可能会看到如下提示： ```bash $ git commit *** 请告诉我你是谁。 运行 git config --global user.email "you@example.com" git config --global user.name "Your Name" 来设置你账户的默认身份。 如果只想在当前仓库设置身份，省略 --global。 ``` Git 在创建提交时需要知道你是谁。当你在团队中协作时，你应该能够看到是谁修改了项目的哪些部分以及何时修改的，因此，Git 设计时就要求每个提交都与一个名字和电子邮件地址相关联。 有多种方法可以为 `git commit` 命令提供你的电子邮件和用户名，下面我们将介绍几种常用的方法。 ### 全局配置 当你将某个配置存储在全局配置中时，它在你工作的所有仓库中都是可访问的。这是推荐的方式，并且适用于大多数使用场景。 要将某个配置存储在全局配置中，你可以使用以下 `config` 命令： `$ git config --global ` 对于用户信息，我们可以运行： ``` $ git config --global user.email "you@example.com" $ git config --global user.name "Your Name" ``` ### 仓库配置 顾名思义，这些配置仅作用于当前仓库。如果你想在某个特定仓库中提交，例如工作项目，并使用你公司的电子邮件地址，你可以使用这种方法。 要将某个配置存储在仓库配置中，可以在 `config` 命令中省略 `--global` 标志，如下所示： `$ git config ` 对于用户信息，我们可以运行： ``` $ git config user.email "you@alternate.com" $ git config user.name "Your Name" ``` ### 命令行配置 这些配置仅作用于当前命令。所有 git 命令在动作动词之前都可以使用 `-c` 参数来设置临时配置数据。 要在命令行配置中存储某个配置，按如下方式运行命令： `$ git -c = -c = ` 在我们的例子中，我们将提交命令改为： `git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Your commit message"` ### 配置优先级说明 在这里描述的三种方法中，优先级顺序是 `command-line > repository > global`。这意味着，如果同一个变量在命令行和全局中都有配置，命令行的值将用于该操作。 ### 超出用户信息 到目前为止，我们仅在配置中处理了用户信息。然而，还有许多其他配置选项。以下是一些常见的配置： 1. `core.editor` - 指定用于编写提交消息等的编辑器名称。 2. `commit.template` - 指定系统中作为初始提交模板的文件。 3. `color.ui` - 指定是否在 git 输出中使用颜色的布尔值。 为了便于理解，我们简化了一些细节。如果你想进一步了解，访问 [git-scm.com](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration)。 ================================================ FILE: docs/additional-material/translations/Chinese/creating-a-gitignore-file.zh-cn.md ================================================ # .gitignore .gitignore 文件是一个文本文件，用于告诉 Git 在项目中哪些文件或文件夹应被忽略。 一个本地的 .gitignore 文件通常放置在项目的根目录下。你也可以创建一个全局的 .gitignore 文件，这样文件中的任何条目都会在你所有的 Git 仓库中被忽略。 ## 为什么使用 .gitignore 现在你可能会想，为什么要让 Git 忽略某些文件和文件夹。原因是你不希望像构建文件、缓存文件、其他本地配置文件（例如 node_modules）、编译文件、IDE 创建的临时文件等被 Git 跟踪。通常，这样做是为了避免提交工作目录中的临时文件，这些文件对其他协作者没有用。 ## 入门 要创建一个本地的 .gitignore 文件，创建一个文本文件并命名为 .gitignore（记得在文件名前加上 `.`）。然后根据需要编辑此文件。每一行都应该列出你希望 Git 忽略的文件或文件夹。 该文件中的条目也可以遵循匹配模式。 ``` * 用作通配符匹配 / 用于忽略相对于 .gitignore 文件的路径名 # 用于在 .gitignore 文件中添加注释 下面是 .gitignore 文件的一个示例： # 忽略 Mac 系统文件 .DS_store # 忽略 node_modules 文件夹 node_modules # 忽略所有文本文件 *.txt # 忽略与 API 密钥相关的文件 .env # 忽略 SASS 配置文件 .sass-cache ``` 要添加或更改全局 `.gitignore` 文件，运行以下命令： ``` git config --global core.excludesfile ~/.gitignore_global ``` 这将创建文件 ~/.gitignore_global。现在，你可以像本地 .gitignore 文件一样编辑这个文件。你所有的 Git 仓库都会忽略全局 .gitignore 文件中列出的文件和文件夹。 ## 如何取消跟踪已提交的文件 要取消跟踪单个文件，即停止跟踪该文件但不删除它，可以使用： ``` git rm --cached filename ``` 要取消跟踪 .gitignore 中的每个文件： 首先，提交任何未提交的代码更改，然后运行： ``` git rm -r --cached ``` 这将从索引（暂存区）中移除任何已更改的文件，然后运行： ``` git add . ``` Commit it: ``` git commit -m ".gitignore is now working" ``` 要撤销 ```git rm --cached filename```，使用 ```git add filename``` ================================================ FILE: docs/additional-material/translations/Chinese/delete-branch-locally.zh-cn.md ================================================ # 删除本地创建的分支 当你不小心拼错了分支名称时，这个操作会非常有用。 你可以通过 *3* 种方式来删除分支： ``` git branch -D ``` ``` git branch --delete --force # 与 -D 相同 ``` ``` git branch --delete # 如果未合并会报错 ``` -D 代表 --delete --force，即即使分支未合并，也会强制删除该分支。你也可以使用 -d，它代表 --delete，当分支未合并时，会抛出错误。 ================================================ FILE: docs/additional-material/translations/Chinese/gitflow.zh-cn.md ================================================ # Gitflow Gitflow 是由 Vincent Driessen 创建的 Git 分支模型。本文将讨论 Gitflow 的要求和用例。
Gitflow 工作流定义了一个围绕项目发布而设计的严格分支模型，提供了一个强大的框架来管理大型项目。Gitflow 特别适用于具有计划发布周期的项目以及 DevOps 最佳实践中的持续交付。它为不同的分支分配了非常具体的角色，并定义了它们应该如何以及何时互动。它使用独立的分支来准备、维护和记录发布。 ## 实现 1. **Develop 和 Master Branches**：与单一的 master 分支不同，Git Flow 使用两个分支来记录项目的历史。它基于两个具有无限生命周期的主分支，即 master 和 develop： - **Master Branch**：master 分支包含生产代码并存储官方的发布历史。 - **Develop Branch**：develop 分支包含预生产代码，作为功能的集成分支。 - **创建 Develop Branch**：
不使用 Gitflow 扩展时： ``` git branch develop git push -u origin develop ``` 使用 Gitflow 扩展时：当使用 gitflow 扩展库时，在现有的仓库中执行 `git flow init` 将创建 develop 分支。 ``` git flow init ``` 2. **Feature Branch**：每个新功能应该放在它自己的分支上，可以推送到中央仓库以备份或协作。Feature 分支使用最新的 develop 作为其父分支。当功能完成时，它会合并回 develop。功能分支永远不应直接与 master 分支交互。 - **创建 Feature Branch**：
不使用 git-flow 扩展时： ``` git checkout develop git checkout -b feature_branch ``` 使用 gitflow 扩展时： ``` git flow feature start feature_branch ``` - **完成 Feature Branch**：
不使用 git-flow 扩展时： ``` git checkout develop git merge feature_branch ``` 使用 git-flow 扩展时： ``` git flow feature finish feature_branch ``` 3. **Release Branch**：当 develop 分支包含足够的功能用于发布（或者接近预定的发布日期）时，我们会从 develop 分支派生出一个 release 分支。创建这个分支标志着下一个发布周期的开始，因此在此之后不能再添加新功能——只能添加 bug 修复、文档生成和其他与发布相关的任务。Release 分支应从 develop 分支派生，并必须同时合并到 master 和 develop 分支。
使用专门的分支来准备发布使得一个团队可以在 polishing 当前发布时，另一个团队继续为下一个发布开发新功能。 - **创建 Release Branch**：
不使用 git-flow 扩展时： ``` git checkout develop git checkout develop git checkout -b release/0.1.0 ``` 使用 git-flow 扩展时： ``` git flow release start 0.1.0 ``` 切换到新分支 'release/0.1.0' - **完成 Release Branch**：
不使用 git-flow 扩展时： ``` git checkout master git merge release/0.1.0 ``` 使用 git-flow 扩展时： ``` git flow release finish 0.1.0 ``` 4. **Hotfix Branch**：维护或“hotfix”分支用于快速修复生产发布。Hotfix 分支对于立即解决 master 分支中的不希望出现的问题非常必要。Hotfix 分支与 release 分支和 feature 分支类似，不同之处在于它是基于 master 分支而非 develop 分支派生的。这是唯一一个应直接从 master 分支派生的分支。修复完成后，它应该同时合并到 master 和 develop（或当前的 release 分支），并且 master 分支应该打上更新的版本号标签。 - **创建 Hotfix Branch**：
不使用 git-flow 扩展时： ``` git checkout master git checkout -b hotfix_branch ``` 使用 git-flow 扩展时： ``` git flow hotfix start hotfix_branch ``` - **完成 Hotfix Branch**：
不使用 git-flow 扩展时： ``` git checkout master git merge hotfix_branch git checkout develop git merge hotfix_branch ``` 使用 git-flow 扩展时： ``` git branch -D hotfix_branch git flow hotfix finish hotfix_branch ``` ## 优势 - 确保项目生命周期中的任何时刻分支状态保持清晰。 - 分支的命名约定遵循系统化模式，使其更容易理解。 - 支持大多数常用的 git 工具和扩展。 - 适合在生产中维护多个版本。 - 非常适合基于发布的软件工作流。 - 提供了专门用于生产热修复的渠道。 ## 劣势 - Git 历史记录变得难以阅读。 - master 和 develop branch的分割被认为是冗余的，并使持续交付/集成变得更加困难。 - 不推荐用于维护生产中的单一版本。 ## 总结 我们在这里讨论了 Git Flow 工作流。Git Flow 是你和你的团队可以使用的多种 Git 工作流之一。让我们总结一下 Git Flow 的整个工作流： 1. 从 master 创建一个 develop 分支。 2. 从 develop 创建功能分支。 3. 当功能完成时，将其合并到 develop 分支。 4. 从 develop 创建一个 release 分支。 5. 当 release 分支完成时，将其合并到 develop 和 master。 6. 如果 master 中发现问题，则从 master 创建一个 hotfix 分支。 7. 一旦 hotfix 完成，它将被合并到 develop 和 master。 ================================================ FILE: docs/additional-material/translations/Chinese/installing-git-arch.zh-cn.md ================================================ # 在 Arch Linux 上安装 Git 要在 Arch Linux 上安装 Git，可以使用包管理器 pacman。首先，打开终端并使用以下命令更新系统： ```shell $ sudo pacman -Syu ``` 接下来，运行以下命令安装 Git： ```shell $ sudo pacman -S git ``` 要确认 Git 是否正确安装，运行以下命令： ```shell $ git --version ``` 你应该会看到类似以下的输出： ```shell Output $ git version 2.34.1 ``` # 设置 Git 配置可以通过使用 git config 命令来完成。 具体来说，你需要提供你的名字和电子邮件地址，因为 Git 会将这些信息嵌入到你做的每个提交中。 你可以通过输入以下命令来添加这些信息： 现在我们已经完成了 Git 的安装，让我们使用 "git config" 命令配置 Git 以供首次使用。 我们需要确保你的用户名和电子邮件地址设置正确。要设置它们，使用以下命令： ```shell $ git config --global user.name "Your Name" $ git config --global user.email "youremail@domain.com" ``` 你可以通过在终端中输入以下命令来显示所有已设置的配置项： ```shell $ git config --list ``` 如果所有配置字段已按照你的需求设置，输出应该类似于： ```shell user.name=Your Name user.email=youremail@domain.com ``` # 持久化 Git 凭证 默认情况下，Git 每次与远程仓库交互时都会提示你重新输入用户名和密码。你可以配置 Git 来缓存或存储你的凭证，以避免这种情况。以下是两种常用的方法： ### 1. 凭证缓存 Git 可以将你的凭证暂时存储在内存中，这样你就不需要频繁地重新输入它们。运行以下命令启用凭证缓存： ```shell $ git config --global credential.helper cache ``` 默认情况下，凭证会缓存 15 分钟。要调整超时时间（例如，1 小时），可以使用： ```shell $ git config --global credential.helper 'cache --timeout=3600' ``` --- ### 2. 凭证存储 如果你更倾向于将凭证永久存储为明文（不太安全，但方便），可以使用以下命令： ```shell $ git config --global credential.helper store ``` 使用此方法时，你的凭证将以明文形式保存在 `~/.git-credentials` 文件中。特别是在共享或公共计算机上使用此方法时，请小心操作。 ================================================ FILE: docs/additional-material/translations/Chinese/installing-git-ubuntu.zh-cn.md ================================================ # 在 Ubuntu OS 上安装 Git 默认情况下，Git 很可能已经在你的 Ubuntu 操作系统中安装好了。你可以通过打开终端并输入以下命令来确认： ```shell $ git --version ``` 如果你看到类似下面的输出，那么恭喜你！你已经成功安装了 Git。 ```shell Output $ git version 2.34.1 ``` 如果适用于你，接下来可以继续进行 Git 配置,去[设置 Git](#设置-Git)。 如果输出中没有显示 Git 版本号，你仍然可以通过 Ubuntu 的 APT 包管理器来安装 Git。 首先，通过使用 apt 包管理工具更新本地包索引。返回到你的终端并输入以下命令。 ```shell $ sudo apt update ``` 完成后，输入以下命令来安装 Git： ```shell $ sudo apt install git ``` 你可以通过运行以下命令并检查是否收到相关输出，来确认 Git 是否已正确安装： ```shell $ git --version ``` ```shell Output $ git version 2.34.1 ``` Git 成功安装后，接下来可以配置 Git。 # 设置 Git 配置可以通过使用 git config 命令来完成。 具体来说，你需要提供你的名字和电子邮件地址，因为 Git 会将这些信息嵌入到你做的每个提交中。 你可以通过输入以下命令来添加这些信息： 现在我们已经完成了 Git 的安装，让我们使用 "git config" 命令配置 Git 以供首次使用。 我们需要确保你的用户名和电子邮件地址设置正确。要设置它们，使用以下命令： ```shell $ git config --global user.name "Your Name" $ git config --global user.email "youremail@domain.com" ``` 你可以通过在终端中输入以下命令来显示所有已设置的配置项： ```shell $ git config --list ``` 如果所有配置字段已按照你的需求设置，输出应该类似于： ```shell user.name=Your Name user.email=youremail@domain.com ``` ... # 持久化 Git 凭证 默认情况下，Git 会在每次你推送到远程仓库时要求你输入用户名和密码。 在 Git 中，你可以配置凭证缓存，以避免每次输入用户名和密码。以下是实现这一目标的几种方法： 1. 凭证缓存：Git 提供了一个凭证缓存系统，可以在指定的时间内将你的凭证存储在内存中。这样，你就不需要每次与远程仓库交互时重新输入凭证。 要启用凭证缓存，你可以使用以下命令： ```shell $ git config --global credential.helper cache ``` 默认情况下，Git 会将凭证缓存 15 分钟。你可以通过指定 --timeout 选项并跟上所需的秒数来调整缓存超时时间。 例如，要将缓存超时设置为 1 小时（3600 秒），可以使用： ```shell $ git config --global credential.helper 'cache --timeout=3600' ``` 2. 凭证存储：这将 Git 的凭证助手设置为 "store"。使用这个凭证助手时，Git 会将远程仓库的凭证存储在磁盘上的一个明文文件中。这种方法是最简单的，但存储明文凭证的方式也是最不安全的。 ```shell $ git config --global crednetial.helper store ``` 使用存储凭证助手时，输入的凭证会永久保存在 Linux 或 macOS 上的 ~/.git-credentials 文件中，或 Windows 上的 %USERPROFILE%\.git-credentials 文件中。这些凭证将以明文格式存储，这意味着如果有人获取到该文件，就可以读取凭证。 使用存储凭证助手的优点是，你每次与远程仓库交互时，不需要再次输入凭证。然而，特别是在使用共享或公共计算机时，请注意存储明文凭证的安全隐患。 ================================================ FILE: docs/additional-material/translations/Chinese/keeping-your-fork-synced-with-this-repository.zh-cn.md ================================================ # 保持你的分叉与该仓库同步 首先，应该理解完整同步的流程，这一点非常重要。在这个流程中，有三个不同的仓库：我的公共仓库在 GitHub 上 `github.com/firstcontributions/first-contributions.git`，你在 GitHub 上的仓库分叉 `github.com/Your-Name/first-contributions/`，以及你本地机器上的仓库，你应该在其中进行工作。这种合作方式通常用于开源项目，称为 `Triangle Workflows`。 triangle workflow 为了保持你的两个仓库与我的公共仓库同步，我们首先需要将公共仓库的内容拉取并与本地机器上的仓库合并。 我们的第二步是将你的本地仓库推送到你的 GitHub 分叉。如前所述，只有通过你的分叉你才能发起一个“拉取请求”。因此，你的 GitHub 分叉是最后更新的仓库。 现在，让我们看看如何做到这一点： 首先，你必须确保自己处于主分支上。要知道自己当前在哪个分支，可以检查的第一行： ``` git status ``` 如果你不在主分支上，输入以下命令切换到主分支： ``` git checkout main ``` 然后，你应该将我的公共仓库添加到你的 Git 仓库中，使用 `add upstream remote-url`： ``` git remote add upstream https://github.com/firstcontributions/first-contributions.git ``` 这告诉 Git，指定的 URL 位置有该项目的另一个版本，并且我们将其命名为 `upstream`。一旦你的 Git 配置了上游仓库，你就可以拉取公共仓库的最新版本： ``` git fetch upstream ``` 你刚刚拉取了我仓库的最新版本（`upstream` 远程仓库）。现在，你需要将公共仓库的内容合并到你的主分支中： ``` git rebase upstream/main ``` 在这里，你正在将公共仓库合并到你的主分支。现在，你本地机器上的主分支已更新。最后，如果你将主分支推送到你的 GitHub 分叉，那么你的 GitHub 分叉也会更新： ``` git push origin main ``` 请注意，这里你推送的是名为 `origin` 的远程仓库。 如果你想同时将我仓库的最新更改（`upstream` 远程仓库）拉取并合并到你本地的分支中，可以直接使用： ``` git pull upstream main ``` 到目前为止，你的所有仓库都已更新。做得很好！每当你的 GitHub 仓库提示你比公共仓库落后几个提交时，你都应该执行这些操作。 ================================================ FILE: docs/additional-material/translations/Chinese/moving-a-commit-to-a-different-branch.zh-cn.md ================================================ # 移动提交到不同的分支 假设你提交了一个更改，然后意识到你提交到了错误的分支。 你该如何更改呢？这篇教程将为你解答。 ## 将最新的提交移动到现有分支 为此，请输入以下命令： ```git reset HEAD~ --soft``` - 撤销上一个提交，但保留更改。 ```git stash``` - 记录当前目录的状态。 ```git checkout name-of-the-correct-branch``` - 切换到正确的分支。 ```git stash pop``` - 恢复最近的存储状态。 ```git add .``` - 或者尝试单独添加文件。 ```git commit -m "your message here"``` - 保存并提交更改。 现在你的更改已经在正确的分支上了。 ### 将最新的提交移动到新分支 为此，请输入以下命令： ```git branch newbranch``` - 创建一个新分支，保存所有提交。 ```git reset --hard HEAD~#``` - 将 master 分支回退 # 个提交。记住，这些提交将从 master 中消失。 ```git checkout newbranch``` - 切换到你创建的新分支，所有提交都会在该分支中。 记住：任何未提交的更改将会丢失。 ================================================ FILE: docs/additional-material/translations/Chinese/removing-a-file.zh-cn.md ================================================ # 从 Git 中移除文件 有时你可能想要从 Git 中移除一个文件，但不想从你的计算机中删除它。你可以使用以下命令来实现： ``git rm --cached`` ## 那么发生了什么？ Git 将不再跟踪被移除文件的更改。对 Git 来说，就像你删除了这个文件一样。如果你在文件系统中找到这个文件，你会发现它依然存在。 注意，在上述示例中使用了 `--cached` 标志。如果我们没有加上这个标志，Git 将不仅从仓库中移除文件，还会从你的文件系统中删除它。 如果你使用 `git commit -m "Remove file1.js"` 提交更改，并通过 `git push origin master` 推送到远程仓库，远程仓库也会删除该文件。 ## 其他功能 - 如果你想删除多个文件，可以将它们全部包含在同一命令中： `git rm file1.js file2.js file3.js --cached` - 你可以使用通配符（*）删除相似的文件。例如，如果你想从本地仓库中删除所有 `.txt` 文件： `git rm *.txt --cached` ================================================ FILE: docs/additional-material/translations/Chinese/removing-branch-from-your-repository.zh-cn.md ================================================ # 从你的仓库中移除分支 如果你已经按照教程进行到此，我们的 `` 分支已经完成了它的使命，是时候将其从你本地机器的仓库中删除了。虽然这不是必须的，但该分支的名称显示了它的特殊用途，因此它的生命周期可以相应地短一些。 首先，让我们将你的 `` 合并到你的 master 分支中，因此切换到 master 分支： ``` git checkout master ``` 将 `` 合并到 master: ``` git merge master ``` 在你本地机器的仓库中移除`` : ``` git branch -d ``` 现在你已经删除了你本地机器上的 `` 分支，一切看起来整洁干净。 不过，在此时，你应该仍然在你的 GitHub 分叉中有 `` 分支。然而，在删除之前，请记住，你是从这个远程分支向我的仓库提交了一个 "Pull request"。因此，除非我已经合并了这个请求，否则不要删除这个分支。 然而，如果我已经合并了你的分支，并且你想删除远程分支，可以使用： ``` git push origin --delete ``` 现在，你知道如何整理你的分支了。 随着时间的推移，我的公共仓库会添加很多提交。而你本地机器和 GitHub 分叉的 master 分支将不会保持同步。因此，为了保持你的仓库与我的同步，请按照下面的步骤进行操作。 #### [保持你的分叉与仓库同步](keeping-your-fork-synced-with-this-repository.zh-cn.md) ================================================ FILE: docs/additional-material/translations/Chinese/resetting-a-branch.zh-cn.md ================================================ # 重置一个分支 `reset` 是一个可以用来重置仓库（相对于某个提交或分支）的命令。正如其名字所示，重置会丢弃当前（基础）分支上的所有内容，并使其与我们选择重置的目标分支（称为原始分支）完全相同。这实际上意味着，我们将得到一个原始分支的副本，名称为基础分支。
然而，问题是，为什么我们不直接删除基础分支，然后从原始分支中检出一个新的基础分支呢？从技术角度来看，这将与重置具有相同的效果，但在一些工业场景下，我们无法删除分支，或者我们不能删除分支，因为删除分支可能会干扰/破坏 CI/CD 流水线，或者影响正在进行的工作流。因此，为了避免这种可能导致停机的情况，我们建议在需要重置某个分支时使用 `git reset`。 ## 命令 执行 `git reset` 重置分支非常简单。 ``` git reset ``` 一个示例如下： ``` git reset stage master --hard ``` 上述命令将 `stage` 分支重置为 `master`，因此 `stage` 分支将与 `master` 完全相同。 你可能会想，为什么要使用 `--hard` 标志？这是为了忽略在重置之前或之后被暂存的所有更改。 ================================================ FILE: docs/additional-material/translations/Chinese/resetting-a-commit.zh-cn.md ================================================ # 重置一个提交 ```reset``` 是一个用于将仓库回退到之前某个提交的命令，丢弃该提交之后的所有更改。
重置和撤销提交的主要区别在于，git reset ```取消暂存文件并将我们的更改带回工作目录``` 而 git revert ```从远程仓库中删除提交```。
```git reset``` 可以通过以下命令来实现： - 以下命令将以两个参数的方式给出所有提交的摘要： - 提交哈希的前七个字符 - 这是我们在 **reset** 命令中需要引用的内容。 - 提交信息 ``` git log --oneline ``` - 可以使用以下命令将仓库重置到特定的提交：
```git reset commithash``` 其中 commithash 是我们在日志中找到的提交哈希的前 7 个字符。 ================================================ FILE: docs/additional-material/translations/Chinese/resolving-merge-conflicts.zh-cn.md ================================================ # 什么是合并冲突？ 当你尝试将另一个分支合并到当前工作分支时，你是在将另一个上下文的更改与当前工作文件结合在一起。 如果两个人修改了同一文件的相同行，或者一个人决定删除该文件，而另一个人决定修改它，Git 无法识别哪个版本是正确的。Git 会标记该文件为存在冲突 - 在解决冲突之前，你无法继续工作。 # 如何解决合并冲突？ 当遇到合并冲突时，Git 会通过在文件中将问题区域包裹在“<<<<<<<< HEAD”和“>>>>>>>>>>[other branch name]”中来标记冲突。 第一个标记后的内容来自你当前的工作分支。尖括号后，Git 会告诉我们更(改来自哪个分支)。一个“=======”行将两个冲突的更改分开。 我们的任务是清理这些行：当我们完成后，文件应该看起来正是我们想要的样子。建议咨询写入冲突更改的队友，决定哪个版本应该是最终的。可能是你们其中一个的版本，也可能是两者的混合。 例如： ``` <<<<<<< HEAD:mergetest This is my third line ======= This is a fourth line I am adding >>>>>>> 4e2b407f501b68f8588aa645acafffa0224b9b78:mergetest ``` `<<<<<<<`：表示合并冲突行的开始。第一组行来自你试图合并更改的文件。 `=======`：表示用于比较的断点。分隔用户提交的更改（上方）和来自合并的更改（下方），以便直观地看到差异。 `>>>>>>>`：表示合并冲突行的结束。 你可以通过编辑文件来解决冲突，然后手动合并 Git 难以合并的部分。这可能意味着丢弃你的更改或别人的更改，或者两者的混合。你还需要删除文件中的 '<<<<<<<'、'=======' 和 '>>>>>>>'。 一旦解决了冲突，请使用 `git add` 命令。不要忘记运行测试，因为你需要确保已正确解决冲突。 你还可以根据所使用的 IDE 下载不同的插件，以便更轻松地解决合并冲突。 # 如何撤销合并？ 如果你想撤销合并，可以使用 `git merge --abort`。 ================================================ FILE: docs/additional-material/translations/Chinese/reverting-a-commit.zh-cn.md ================================================ # 撤销一个提交 撤销一个提交意味着创建一个全新的提交，撤销之前提交所做 的所有更改。这就像在 Git 中执行 `CTRL + Z`。 在 Git 中，撤销操作变得更加简单，因为你推送到远程仓库的每个提交都有一个唯一的字母数字键（称为 SHA，安全哈希算法）与之关联。 这意味着只要你有该提交的 SHA，你就可以撤销任何提交。 但你必须小心按顺序撤销操作，以免破坏你的仓库。 为了获取我们想要撤销的特定提交的 SHA，查看所有提交的日志会很有帮助。 要获取此信息，我们可以运行命令： ```git log --oneline ``` 仅运行 ```git log``` 命令也会给我们返回 SHA（长格式）。 但使用 ```--oneline``` 标志会告诉 Git 我们希望以简洁（单行）的方式显示，以便更容易阅读。 当你运行此命令时，显示的前 7 个字符就是所谓的简短提交哈希。 例如，运行 ```git log --oneline``` 时，我得到的输出如下： ``` 389004d added spacing in title c1b9fc1 Merge branch 'master' into tutorials 77eaafd added tutorial for reverting a commit ``` 这表明，通过使用 ```git log --oneline```，我们可以获取仓库中所有提交的列表，并附带每个提交的前 7 个字符的 SHA。 现在，假设我想撤销我提交的 "在标题中添加了空格" 这个更改，以下是我将采取的步骤： * 复制该提交的 SHA，在本例中是 ```389004d``` * 然后运行命令 ```git revert 389004d``` 这将打开我的文本编辑器，并提示我编辑提交信息。 你可以选择保留 Git 的默认提交信息，该信息以 `Revert` 开头， 也可以根据自己的喜好自定义提交信息。 * 接下来，我将保存并关闭文本编辑器。 * 返回命令行。 * 运行 ```git push origin ``` 将撤销的更改推送到 GitHub。 就这样，变更被撤销。在这种情况下，我的仓库将恢复到 ```c1b9fc1``` 时的状态。 ================================================ FILE: docs/additional-material/translations/Chinese/squashing-commits.zh-cn.md ================================================ # 什么是 Squashing（压缩提交）？ 在 Git 中，**squashing（压缩提交）** 是指重写提交历史，把多个提交合并成一个提交，并添加一个描述性信息来说明这次更改的内容。 在开源项目中，这通常是常见操作，因为分支的详细历史记录往往只对原始开发者有意义。 压缩提交可以简化更改记录，也方便在需要时进行回滚。 # 如何进行提交压缩（Squash commits）？ 首先，你可以执行 `git log` 命令，查看你当前分支中要合并的提交历史： ``` git log ``` 你会看到类似这样的提交记录： ``` commit blablabla Author: omguhh Date: 10/10/20 提交信息 1 commit blablabla2 Author: omguhh Date: 10/10/20 提交信息 2 ``` 现在你已经找到了要合并的提交，可以使用 ```git rebase```来进行压缩。假设你已经熟悉 ```git rebase```，我们可以通过 **交互模式（interactive mode）** 来进行操作： ``` git rebase -i ``` 你也可以通过指定回溯的提交数来启动交互式 rebase，比如： ``` git rebase -i HEAD~2 ``` 执行该命令后，你将看到类似以下内容的交互式界面： ``` pick blablabla Changing test01.txt file pick blablabla2 Adding dummy01.txt file # # 可用命令： # p, pick = 使用该提交 # r, reword = 使用该提交，但修改提交信息 # e, edit = 使用该提交，但中断以进行修改 # s, squash = 使用该提交，但合并进前一个提交 # f, fixup = 类似 squash，但忽略该提交信息 # x, exec = 执行 shell 命令 # # 你可以调整这些行的顺序，Git 会按顺序执行。 # # 如果删除某一行，该提交将会丢失。 # # 如果删除所有行，rebase 将会被取消。 # # 空提交将会被注释掉。 ``` 所以，如果你想将 ```blablabla2``` 压缩到 ```blablablabla```，你应该将其改成如下形式： ``` pick blablabla 更改 test01.txt 文件 squash blablabla2 添加 dummy01.txt 文件 ``` 一切正常的话，你将看到如下合并提交的编辑界面： ``` # 这是两个提交的合并结果. # 第一个提交的信息是： 提交信息 1 # 第二个提交的信息是： 提交信息 2 ``` 你可以在此自由修改合并提交的信息。 退出并保存后，执行 `git log` 命令应显示你刚刚输入的合并信息，且这两个提交已被合并为一个。 ================================================ FILE: docs/additional-material/translations/Chinese/stashing-a-file.zh-cn.md ================================================ # 使用 Git Stash 暂存工作进度 如果你正在进行一个大型开发任务，突然需要切换分支去做其他事情，但当前代码还没写完、也没有测试， 你可能并不希望提交这些不完整的更改。可 Git 不允许你直接切换分支，除非先处理这些更改。 那该怎么办呢？如何避免提交未完成的代码，同时还能自由切换分支？ 这就是本教程要讲解的内容。 ## 暂存你的工作（Stashing） 假设你在项目的某个分支中修改了一些文件，此时运行 ```git status``` 可以看到： ``` $ git status # 当前分支：master # 暂存区中的更改： # (使用 "git reset HEAD ..." 来取消暂存) # # 修改: index.html # # 未暂存的更改： # (使用 "git add ..." 来更新将要提交的内容) # # 修改: lib/simplegit.rb # ``` 此时你想切换分支，但又不想提交更改。那就使用 ```git stash```: ``` $ git stash Saved working directory and index state \ "WIP on master: 049d078 added the index file" HEAD is now at 049d078 added the index file (要恢复这些更改，输入 "git stash apply") ``` 现在你的工作目录是干净的，可以使用 ```git status``` 查看： ``` $ git status # 当前分支：master 没有要提交的内容，工作目录干净 ``` 此时你可以切换到任意分支继续开发。你 stash 的内容被保存在一个栈（stack）中。你可以使用 ```git stash list``` 查看所有保存的 stash： ``` $ git stash list stash@{0}: WIP on master: 049d078 added the index file stash@{1}: WIP on master: c264051 Revert "added file_size" stash@{2}: WIP on master: 21d80a5 added number to log ``` 如果你想重新应用刚刚保存的 stash，可以使用 ```git stash apply```。默认情况下，它会应用最近一次保存的 stash。 如果你想应用指定的 stash，可以使用命令 ```git stash apply ```，将 `` 替换为对应名称： ``` $ git stash apply # 当前分支：master # 未暂存的更改： # (使用 "git add ..." 来更新将要提交的内容) # # 修改： index.html # 修改： lib/simplegit.rb # ``` 你会发现 Git 恢复了你在执行 stash 时未提交的更改。 在这个示例中，你在应用 stash 时处于干净的工作目录，且是在与 stash 创建时相同的分支； 但请注意：**并不要求工作目录必须干净，也不需要在原分支才能成功应用 stash。** 你可以在一个分支中保存 stash，之后切换到另一个分支并重新应用它。 即使当前工作目录中存在未提交的更改，也可以应用 stash；但如果某些内容无法干净地应用，Git 会提示合并冲突。 文件中的更改虽然恢复了，但之前已暂存（staged）的文件并没有恢复到暂存区。 要恢复这些被暂存的更改，你需要使用带有 ```--index``` 参数的 ```git stash apply```： ``` $ git stash apply --index # 当前分支： master # 已暂存更改： # (使用 "git reset HEAD ..." 取消暂存) # # 修改： index.html # # 未暂存更改： # (使用 "git add ..." to update what will be committed) # # 修改： lib/simplegit.rb # ``` `apply` 命令仅仅是恢复 stash 内容，它不会自动从 stash 栈中移除对应条目。 如果你想删除某个 stash，可以使用 ```git stash drop``` 并指定 stash 名称： ``` $ git stash list stash@{0}: WIP on master: 049d078 added the index file stash@{1}: WIP on master: c264051 Revert "added file_size" stash@{2}: WIP on master: 21d80a5 added number to log $ git stash drop stash@{0} Dropped stash@{0} (364e91f3f268f0900bc3ee613f9f733e82aaed43) ``` 你也可以使用 ```git stash pop``` 命令，它会应用最后一次 stash 的内容并将其从栈中删除。 ## 取消应用已应用的 Stash（Un-applying） 有时你应用了 stash，做了一些工作，但之后想要**撤销**刚刚恢复的 stash 更改。 Git 并没有内建 ```git unapply``` 命令，但你可以使用“反向补丁”来实现类似效果： ```$ git stash show -p stash@{0} | git apply -R``` 如果不指定 stash，Git 默认使用最新的 stash： ```$ git stash show -p | git apply -R``` 你也可以为此配置一个快捷别名： ``` $ git config --global alias.stash-unapply '!git stash show -p | git apply -R' $ git stash apply $ #... 进行工作 $ git stash-unapply ``` ## 从 Stash 创建新分支 如果你 stash 了某些更改，但后来继续在该分支上进行开发， 再次应用 stash 时可能会因为文件已被修改而引发**冲突**。 如果你想更方便地重新测试 stash 的内容，可以使用 ```git stash branch``` 命令。 它会执行以下操作： 1. 创建一个新分支； 2. 回到你 stash 时所在的提交； 3. 应用 stash 内容； 4. 应用成功后自动删除 stash。 示例： ``` $ git stash branch testchanges Switched to a new branch "testchanges" # 当前分支： testchanges # 已暂存的更改： # (使用 "git reset HEAD ..." 取消暂存) # # 修改: index.html # # 未暂存的更改： # (使用 "git add ..." 来更新将要提交的内容) # # 修改: lib/simplegit.rb # Dropped refs/stash@{0} (f0dfc4d5dc332d1cee34a634182e168c4efc3359) ``` 这是一个非常实用的快捷方式，可以轻松恢复你 stash 的内容，并在一个新分支中继续开发。 ================================================ FILE: docs/additional-material/translations/Chinese/storing-credentials.zh-cn.md ================================================ # 存储凭据（用户名与密码） 你可能遇到过这样的烦恼——每次访问仓库都要输入用户名和密码，这很麻烦，而且若耗时过长还会打断你的工作流。 但其实没必要如此繁琐。 这里我们介绍一种常见的方式： [git credential cache](https://git-scm.com/docs/git-credential-cache)。 **注意：** 请遵循你所在单位或学校的安全策略。 ## 凭据缓存（Caching） 我们可以使用 Git 的 credential cache 来存储用户名和密码。 **警告：** 此方法会将凭据以*明文*形式保存在你电脑的硬盘上。 任何人都可以访问该文件，比如恶意的 NPM 模块。 ### 全局凭据缓存 如果你希望为所有仓库启用凭据缓存，只需执行以下命令： ``` $ git config --global credential.helper cache ``` **提醒：** 请遵循你所在单位或学校的安全策略。 ### 仓库级别的凭据缓存 如果你只想为当前仓库启用缓存，可以使用以下命令： ``` $ git config credential.helper cache ``` **提醒：** 请遵循你所在单位或学校的安全策略。 ### 缓存超时时间 如果不指定缓存时间，凭据可能会被永久保留在内存中。 你可以通过以下命令设置缓存的持续时间（单位为秒）： ``` git config credential.helper 'cache --timeout=' ``` 使用此 helper，凭据只会存储在内存中，不会写入磁盘，且在指定时间后会自动清除。 默认超时时间是 900 秒（15 分钟）。 #### 参考资料： [Stack Overflow](https://stackoverflow.com/questions/35942754/how-can-i-save-username-and-password-in-git) ### [附加材料](additional-material.md) ================================================ FILE: docs/additional-material/translations/Chinese/undoing-a-commit.zh-cn.md ================================================ # 撤销本地提交 要撤销本地提交，只需要运行以下命令： ``` git reset ``` 此命令会将暂存区（staging area）重置为你最近的一次提交，但工作目录中的更改不会被影响。 因此，你仍然可以重新提交这些更改。 如果你只是想从上一次提交中移除某个文件，可以使用以下命令： ``` git reset <文件名> ``` 该命令只会将指定的文件从暂存区中移除，但文件中的更改仍然保留。 ```git reset``` 使用示例： ``` # 修改了 index.php 和 tutorial.php # 将文件添加到暂存区 $ git add . # 想起来这两个文件应该分开提交 # 取消暂存 tutorial.php $ git reset tutorial.php # 先提交 index.php $ git commit -m "Changed index.php" # 现在提交 tutorial.php $ git add tutorial.php $ git commit -m "修改了 tutorial.php" ``` 假设你把本地仓库搞乱了，只想恢复到最近一次提交的状态， 你可以运行以下命令： ``` git reset --hard ``` 这个命令不仅会重置暂存区，还会把工作目录中的所有更改回退到最近一次提交。 其中的 ```--hard``` 模式表示 Git 会同时撤销工作目录中的所有改动。 **只有当你确定想彻底丢弃本地的所有开发内容时，才应该使用这个命令。** ```git reset --hard``` 使用示例： ``` # 决定开始一个疯狂的实验 # 创建一个新文件 'crazy.php' 并写入一些代码 # 提交 crazy.php $ git add crazy.php $ git commit -m "开始了疯狂的开发" # 再次编辑 crazy.php 并修改了很多其他文件 # 提交所有被跟踪的文件 $ git add . $ git commit -m "继续开发" # 测试后情况失控 # 决定把所有内容撤销 $ git reset --hard HEAD~2 ``` ```git reset --hard HEAD~2``` 会将当前分支回退两个提交点， 同时撤销你所做的所有更改，并将这两个提交从项目历史中移除。 注意： 如果你已经将提交推送到了共享仓库，请不要执行 ```git reset --hard``` 因为这将对仓库中的其他人造成问题。 ================================================ FILE: docs/additional-material/translations/Chinese/why-using-branches.zh-cn.md ================================================ # 为什么在贡献时要使用分支 ## 什么是分支？ 分支（Branch）本质上是指向某个提交（commit）的指针。 当你创建分支时，Git 会基于你当前的代码状态生成一个新的快照，你可以在这个分支上自由修改，而不会影响主代码（通常是 master 分支）。 当你对实验结果满意并希望将其合并进主代码时，只需运行： master. 这会告诉 Git：将你在实验分支上的更改合并到 master 主分支中。 在多人参与的开源项目中，使用分支可以让每位贡献者独立开发，不影响主分支，从而更方便地合并最合适的代码。 ## 它是如何工作的？ 分支代表了一条独立的开发路径。 分支是编辑/暂存/提交流程的抽象表现。你可以将其想象为：为你开辟了一套新的工作目录、暂存区和项目历史。 新提交会被记录在当前分支的历史中，从而在项目历史中形成一个“分叉”。 `git branch` 命令可用于创建、列出、重命名和删除分支。 但它并不能用于切换分支或合并历史记录。因此，它通常与 `git checkout` 和 `git merge` 命令一起使用。 ## 为什么要使用分支？ 如果你仍然在思考“为什么我们要在版本控制中使用分支？”，那这里有一个简单的例子可以说明： 假设某款量产汽车在正式发布前需要喷漆，原定默认颜色为“橄榄绿”，但制造团队的一些成员想展示“红色”版本。 为了避免混乱，“红色喷漆”就像是主项目（汽车）的一个分支。 如果将该分支合并进主项目，那么最终的颜色就是红色；如果不合并，则继续使用橄榄绿。 是否将某个贡献者的分支合并进主分支，通常由项目负责人决定。 ## 举个例子 Alice 在开发功能 A，Bob 在开发功能 B。 Alice 完成功能 A 一半后，提交了几次；但功能 A 实在太复杂，于是她决定先去开发功能 C，并继续在同一分支（alice）提交。 与此同时，Bob 完成功能 B 后，打算接手功能 A，于是他把 alice 分支合并到了自己的 bob 分支中。 等 Bob 完成功能 A 后，准备将 bob 分支合并进 master。 但 bob 分支此时包含了功能 A、功能 B 和部分功能 C，而功能 C 还没完成！ 这就很容易在合并时引发混乱的冲突。 解决办法是：不要用“人名分支”，而应该使用“功能分支”。 Alice 应该为功能 A 和功能 C 分别创建分支；Bob 应该为功能 B 和功能 A 分别创建分支。 这样，他们就能并行开发各自的功能，互不干扰。 ## 如何创建分支？ #### 创建分支 ``` git branch 任意分支名 ``` 这将新建一个名为“任意分支名”的分支。 在这个分支上进行的更改不会影响主分支。 详细教程请参考： [如何创建分支](https://www.atlassian.com/git/tutorials/using-branches) #### 删除分支 ``` git branch -d 任意分支名 ``` 此命令会从 Git 仓库中删除名为“任意分支名”的分支。 参考： [如何从仓库中移除分支](https://github.com/jashnimje/first-contributions/blob/7dcae72208e4b42fcf834b4f189fa8ee78238077/additional-material/git_workflow_scenarios/removing-branch-from-your-repository.md) ================================================ FILE: docs/additional-material/translations/Egyptian/Things a non Programmer can do.eg.md ================================================ # حاجات ممكن اللي مش مبرمج يعملها ## اسمع الأول كل حاجة في الـ Open Source بتعتمد على الناس اللي شغالة فيها. إنت عايز تنضم لفريق، وده معناه إنك تفهم المجتمع شغال إزاي. لو دخلت على مشروع وقلت "هاي، أنا شايف إن المشروع المفروض يعمل كذا" غالبًا ده مش هيكون مقبول. ممكن مشاريع معينة تكون بتحب الأسلوب ده، لكن لو المشروع ليه فترة شغال، نسبة إن الناس تتقبل الكلام ده قليلة. **أحسن حاجة تعملها في الأول إنك تسمع وتشوف الناس شغالة إزاي.** 1. **اشترك في Mailing List**: في مشاريع كتير، الـ mailing list هي وسيلة التواصل الرئيسية بين الناس اللي بتطور المشروع. في المشاريع الكبيرة، هتلاقي كذا mailing list. مثلاً، مشروع PostgreSQL عنده أكتر من 12 mailing list للمستخدمين و6 للمطورين. ابدأ بمتابعة الـ list الأساسية للمستخدمين وواحدة من بتوع المطورين علشان تفهم اللي بيحصل. 2. **تابع Blog**: المطورين الكبار غالبًا بيكتبوا تدوينات بيشرحوا فيها اللي هيحصل في النسخ الجاية، وبيتكلموا عن اللي اتعمل علشان نوصل للمرحلة دي. في مواقع اسمها Planet بتجمع التدوينات والأخبار من كذا مصدر عن المشروع. لو فيه planet زي planet.gnome.org أو planet.mysql.com، يبقى ده مكان كويس تبدأ منه. اكتب في جوجل "planet <اسم المشروع>". 3. **ادخل على قناة IRC**: معظم مشاريع الـ Open Source عندها قنوات IRC الناس بتدخل تتكلم فيها عن المشاكل والتطوير. ادخل على موقع المشروع وشوف اسم القناة على أي شبكة IRC. **اشتغل على التذاكر** الكود هو الأساس في أي مشروع مفتوح المصدر، بس ده مش معناه إن الكود هو الطريقة الوحيدة اللي ممكن تساهم بيها. فيه حاجات تانية كتير الناس بتكسل تعملها، زي صيانة النظام أو متابعة المشاكل. ابدأ من هنا وهتلاقي نفسك بقيت جزء من الفريق. معظم المشاريع عندها نظام تذاكر على الموقع الرسمي. ده بيكون وسيلة تواصل بين الناس اللي بتستخدم البرنامج والمطورين. تنضيف التذاكر دي وتحديثها بيساعد الفريق جدًا. ممكن تحتاج صلاحيات علشان تعدل على التذاكر، بس صدقني، أول ما تقول إنك عايز تساعد، هيدوك الصلاحيات دي على طول. 4. **حلل مشكلة (Bug)**: ساعات الناس بتبلّغ عن مشاكل بشكل مش واضح. لو حد قال "البرنامج بيهنّج لما بعمل كذا"، خد وقتك وحاول تعرف المشكلة دي بتحصل إزاي. هل بتتكرر؟ تقدر تكتب خطوات تثبت بيها إنها بتحصل؟ بتحصل على متصفح معين؟ ولا في نظام تشغيل معين؟ حتى لو معرفتش تحلها، إنك توضّح المشكلة أكتر بيسهّل على حد تاني ييجي يحلها. وكل اللي تكتشفه، اكتبه في التذكرة علشان غيرك يستفيد. 5. **اقفل التذاكر القديمة**: كتير من المشاكل بتكون اتحلت، بس التذاكر لسه مفتوحة. البحث في التذاكر القديمة وتنضيفها حاجة مهمة جدًا. ابدأ بدور على تذاكر بقالها أكتر من سنة وشوف هل المشكلة لسه موجودة ولا اتصلحت. راجع سجل التغييرات في الإصدارات وشوف لو فيه ذكر للمشكلة. لو اتحلت، اكتب رقم النسخة في التذكرة واقفلها. جرّب تعيد المشكلة في آخر نسخة من البرنامج. لو مشتغلتش، اكتب ده في التذكرة واقفلها. لو لسه موجودة، اكتبه برضو وسيب التذكرة مفتوحة. ## الشغل على الكود الناس اللي عندها خبرة مختلفة في البرمجة تقدر تساعد في الكود. مش لازم تكون مبرمج جامد علشان تساهم. لو ناوي تعدل على الكود، اعرف الأول المشروع بيشتغل إزاي في موضوع استلام التعديلات. كل مشروع ليه طريقة معينة، فاسأل الأول. مثلاً، PostgreSQL بيستقبل التعديلات على شكل Patch في mailing list، والمطورين بيراجعوها كويس جدًا. لكن في مشروع زي Parrot، ممكن تاخد صلاحيات التعديل بسهولة. لو المشروع على GitHub، غالبًا بيستخدموا Pull Requests. كل مشروع وليه طريقته. لما تعدل حاجة، خليك محترم مع باقي الفريق وحافظ على تنسيق الكود زي ما هو. ما تحاولش تفرض أسلوبك. الكود اللي بتكتبه لازم يشبه اللي موجود، حتى لو مش عاجبك. 6. **اختبر نسخة Beta أو Release Candidate**: المشاريع اللي بتشتغل على كذا نظام تشغيل ساعات بيكون فيها مشاكل توافق. قبل الإصدارات، المطورين بينزلوا نسخ تجريبية علشان الناس تجربها. لو شغّلت البرنامج على نظام تشغيل مختلف واشتغل، ده بيساعدهم يعرفوا إن النسخة كويسة. مش لازم تعمل حاجة غير إنك تبني البرنامج وتفتحه وتجربه. لو شغال، بلغهم. ده بيفرق كتير جدًا مع المطورين. 7. **صلّح Bug**: ده غالبًا أول حاجة الناس بتعملها لما تبدأ تشتغل في الكود. دور على Bug شكله بسيط، وجرب تصلحه. اكتب ملاحظاتك جوه الكود، ولو في Test يوضح إن المشكلة اتحلت، ضيفه. لو معرفتش تصلحها، اكتب اللي وصلتله في التذكرة. 8. **اكتب Test**: معظم المشاريع عندها Tests، بس دايمًا فيه مكان لإضافة تانية. استخدم أدوات بتقيس مدى التغطية، زي `gcov` أو `Devel::Cover`. وشوف أجزاء الكود اللي مش متغطية، وضيف لها Test. 9. **اسكت تحذير من الكومبايلر**: لما تبني برامج C، ممكن يطلعلك تحذيرات. مش دايمًا معناها إن فيه مشكلة، بس بتشوّش. لو شفت تحذير، شوف هل فعلاً فيه مشكلة؟ لو لأ، عدل الكود علشان تسكت التحذير. 10. **ضيف تعليق**: لو لقيت جزء في الكود مش مفهوم، اكتبه تعليق. أكيد في ناس غيرك هتتلخبط برضو. ابعت تعديل فيه التعليقات دي. ## الشغل على التوثيق المستندات دايمًا بتتاخد بشكل بسيط. وساعات بتكون مكتوبة كأن اللي بيقراها أصلاً فاهم المشروع. لو حسيت إن التوثيق مش واضح، قول. اللي عنيهم جديدة بيشوفوا حاجات الناس اللي شغالة عليها مش شايفاها. 11. **اعمل مثال**: مفيش مشروع عنده أمثلة كتير كفاية. لو فيه API، أو مكتبة، أو برنامج GUI زي Gimp، أو حتى أداة سطر أوامر – اعمل مثال عملي بيشرح ازاي تستخدمه. ممكن المثال يكون حاجة بسيطة من كود انت كتبته، أو حتى فيديو Screen Recording وانت بتستخدمه. الناس بتحب تشوف التطبيق العملي أكتر من الكلام. ## اشتغل مع المجتمع الـ Open Source مش بس كود. المجتمع هو اللي بيخلي المشاريع دي تعيش وتكبر. فيه طرق كتير تقدر تساعد بيها في تقوية المجتمع حوالي المشروع. 12. **جاوب على سؤال**: أحسن طريقة تساعد بيها المشروع والمجتمع هي إنك تساعد غيرك. لما حد جديد يسأل سؤال، وحضرتك تجاوبه بدل ما تقول له "روح اقرأ الـ Manual"، كده إنت مش بس ساعدته، إنت كمان شجّعته يكمل، ويمكن كمان يبقى عضو نشيط في المشروع بعد كده. كلنا بدأنا من الصفر، والمشاريع محتاجة دايمًا ناس جديدة تدخل علشان تفضل عايشة. 13. **اكتب تدوينة (Blog Post)**: لو عندك مدونة، احكي فيها عن تجربتك مع المشروع اللي بتستخدمه. قول واجهت إيه مشاكل، وازاي حليتها. كده بتساعد المشروع بطريقتين: - إنك بتخلي الناس تفكر في المشروع وتسمع عنه. - وإنك بتسيب أثر للي بعدك لو حد واجه نفس المشكلة وعمل بحث على جوجل. (والتدوينة دي كمان ممكن تبقى وسيلة كويسة توري بيها خبرتك الحقيقة في الشغل لما تيجي تدور على شغل.) 14. **طوّر موقع المشروع**: لو عندك خبرة في تصميم المواقع، وساعدت في تحسين الموقع أو شكله العام، ده وقتك مش بيضيع. يمكن المشروع محتاج لوجو، أو ستايل أحسن، أو تنظيم أحسن للمحتوى. الحاجات دي ساعات بتكون ناقصة عند المبرمجين، وساعتها أي حد عنده ذوق أو خبرة في التصميم بيفرق جامد. أنا عن نفسي بتمنى ألاقي حد يساعدني في التصميم في مشاريعي! 15. **اكتب توثيق تقني (Documentation)**: لو تقدر تشرح ازاي برنامج أو أداة شغالة، يبقى تقدر تكتب توثيق تقني عنها. مشاريع Open Source كتير بتبقى محتاجة توثيق جديد، أو تطوير اللي موجود، أو تبسيطه للناس. كل ما كانت كتابتك أبسط وأوضح، كل ما كانت أحسن. وأجمل حاجة؟ مش لازم تكون مبرمج علشان تكتب Documentation. والأهم من كل ده، اسمع الناس بتتكلم عن إيه. حاول تلاحظ المشاكل اللي محتاجة حل. مثلاً، في مرة على Mailing List لمشروع Parrot، قرروا ينقلوا من Trac لـ GitHub في نظام التذاكر. ناس كتير كانوا ضد القرار علشان مفيش طريقة ينقلوا التذاكر القديمة. دخلت وقلت "طب ما أكتب أنا برنامج يحوّل التذاكر؟" والناس فرحت جدًا. فعلاً كتبت برنامج نقل أكتر من 450 تذكرة، واحتفظنا بتاريخهم. نجاح جميل، وساعدت الفريق، والمطورين ركزوا في شغلهم بدل وجع الدماغ. 16. **علّم وساعد غيرك**: أحسن طريقة تتعلم بيها أكتر، إنك تشرح اللي فهمته لحد تاني. المدرّس الشاطر هو اللي يقدر يشرح حاجة معقدة بطريقة بسيطة. لو علمت حد، أو ساعدته، مش بس هتحس إنك عملت حاجة كويسة، ده كمان هيثبت المعلومة في دماغك، ويقوّي مهاراتك. ولما حد يساعدك، ما تحتفظش بالمعلومة لنفسك. شارك اللي عرفته، وخلّي الدنيا مكان أحسن. والسلام عليكم ورحمة الله وبركاته. ================================================ FILE: docs/additional-material/translations/Farsi/amending-a-commit.fa.md ================================================ # اصلاح یک کامیت چه کار باید بکنی اگر یک تغییر را روی کامیت کردی ولی بعدا متوجه شدی که پیام کامیت مشکل داشته و یا فراموش کردی یک خط به آخرین کامیتت اضافه کنی. چجوری میشود این را اصلاح کرد؟ این موضوعی است که در این آموزش به آن پرداخته میشود. ## تغییر دادن پیام یک کامیت که اخیرا به گیت هاب ارسال کردی برای این کار بدون باز کردن فایلی: 1.تایپ کنید: ``` git commit --amend -m "پیام جدید برای این کامیت" ``` 2.دستور ``` git push origin <نام-شاخه> ``` را اجرا کنید تا تغییرات در مخزن ثبت شوند
نکته: اگر فقط تایپ کنی ```git commit --amend```، ویرایشگر متنت باز خواهد شد و درخواست تغییر پیام کامیت را خواهد داشت. اضافه کردن ```m-``` از این پیشگیری می کند. ## اصلاح کردن یک کامیت حالا اگر فراموش کرده باشی که یک تغییر کوچک مثل اضافه کردن یک کلمه به یک فایل را انجام بدی، و قبلا تغییرات را ثبت و به مخزن ارسال کرده باشی، چیکار باید انجام بدی؟ مثلا این لاگ (log) کامیت هاست: ``` g56123f create botfile a2235d updated contributor.md a5da0d modified botfile ``` برای مثال فراموش کردی که یک کلمه به (botfile) اضافه کنی. از دو روش میشود این کار را انجام داد. راه اول این است که یک کامیت جدید ایجاد کرد که شامل این تغییرات هست: ``` g56123f create botfile a2235d updated contributor.md a5da0d modified botfile b0ca8f added single word to botfile ``` راه دوم این است که کامیت (a5da0d) را اصلاح کنی، کلمه جدید را اضافه کنی و به عنوان "یک" کامیت به مخزن ارسال کنی. این راه به نسبت بهتر است برای اینکه فقط یک تغییر کوچک است. برای این کار به ترتیب: 1.فایل را اصلاح کن. در این مثال فایل (botfile) را اصلاح میکنیم تا کلمه جدید را اضافه کنیم. 2.فایل را به تغییرات اضافه کنید: ``` git add <اسم-فایل> ``` معمولا بعد از اضافه کردن تغییرات، با دستور ``` git commit -m "our commit message" ``` تغییرات را ثبت میکنیم، ولی به خاطر اینکه می خواهیم کامیت قبلی را اصلاح کنیم، این دستور را اجرا کنیم: ``` git commit --amend ``` با اجرای این دستور ویرایشگر متن باز خواهد شد و تا پیام کامیت را تغییر بدی ویرایشگر متن را ببند تغییرات رو به مخزن ارسال کن.. ``` git push origin <اسم-شاخه> ``` تمام شد. الان هر دو تغییر در یک کامیت ثبت شده اند. ================================================ FILE: docs/additional-material/translations/Farsi/delete-branch-locally.fa.md ================================================ # حذف کردن شاخه که به صورت محلی ایجاد شده است این در زمانی سودمند خواهد بود که شما نام یک شاخه (برنچ) را اشتباه نوشته اید. این کار به _3_ روش قابل انجام است ``` git branch -D <نام_مخزن> ``` ``` git branch --delete --force <نام_مخزن> # Same as -D ``` ``` git branch --delete <نام_مخزن> # Error on unmerge ``` پرچم `-D` مخفف `delete --force--` است که شاخه را حتی اگر مرج نشده باشد حذف میکند. (حذف اجباری)، ولی شما میتوانید از پرچم `d-` استفاده کنید که مخفف `delete--` است که با توجه با وضعیت مرج شاخه ارور خواهد داد. ================================================ FILE: docs/additional-material/translations/Farsi/moving-a-commit-to-a-different-branch.fa.md ================================================ ## فراموش کردن رفتن به یک مخزن دیگر وقتی که شما تغییراتی روی برنچ فعلی انجام داده ای و فراموش کرده اید آن را روی برنچ جدید انجام بدهید باید 1- مرحله اول با دستور ``` git commit --amend -m "پیام جدید برای این کامیت" ``` را می کنید و وقتی کاملا تغییرات شما کامیت شده باشد 2- مخزن جدید ایجاد میکنید با دستور git checkout -b <نام_مخزن> و می توانید تمام تغییرات را در مخزن جدید داشته باشید و در همان مخزن آن را push کنید ================================================ FILE: docs/additional-material/translations/French/Things a non Programmer can do.fr.md ================================================ # Ce qu'un non programmeur peut faire ## Être attentive Dans le domaine de l'open source, toute démarche, qu'il s'agisse de programmation ou d'autres aspects, requiert la contribution et l'implication d'autres personnes. Rejoindre une équipe open source, implique de comprendre la dynamique de la communauté et son mode de fonctionnement. Plutôt que d'arriver sur un projet en affirmant immédiatement, "Voici ce que je pense que ce projet devrait faire", il est généralement plus bénéfique d'adopter une approche plus attentive. Certains projets peuvent accueillir favorablement ce type d'approche, mais si le projet existe depuis un certain temps, les chances que cette attitude soit adoptée sont faibles. L'écoute est le meilleur moyen de savoir ce dont le projet a besoin. 1. **S'abonner à une liste de diffusion** : Pour de nombreux projets, la liste de diffusion est le principal moyen de communication sur le développement du projet. Dans les grands projets, il existe de nombreuses listes de diffusion. Par exemple, le projet PostgreSQL a pas moins de 12 listes orientées utilisateurs et six listes de développeurs sur sa page de listes de diffusion. Je vous suggère de suivre la liste principale orientée utilisateurs et la liste principale de développeurs pour commencer à écouter. 2. **Suivre un blog** : Les blogs tenus par les développeurs principaux donnent souvent des informations sur les prochaines versions et sur les étapes nécessaires pour y parvenir. Un site planet regroupe des nouvelles et des articles de blog provenant de nombreuses sources liées au projet. S'il existe un site planet, comme planet.gnome.org ou planet.mysql.com, commencez par là. Il suffit de chercher "planet" dans Google. 3. **Rejoindre un canal IRC** : De nombreux projets open source disposent de canaux IRC (Internet relay chat) dédiés où les développeurs et les utilisateurs se retrouvent pour discuter des problèmes et du développement. Consultez le site web du projet pour connaître le nom du canal et le réseau IRC sur lequel il se trouve. 4. **Travailler avec des tickets**: Le code est au cœur de tout projet open source, mais il ne faut pas croire que l'écriture de code est la seule façon de contribuer. La maintenance du code et des systèmes qui l'entourent est souvent négligée dans la course à la création de nouvelles fonctionnalités et à la correction des bogues. Ces domaines sont un moyen facile de mettre un pied dans un projet. La plupart des projets disposent d'un système de tickets de dépannage visible par tous, lié à la page d'accueil du site web du projet et inclus dans la documentation. Il s'agit du principal canal de communication entre les utilisateurs et les développeurs. Le maintenir à jour est un excellent moyen d'aider le projet. Il se peut que vous deviez obtenir des autorisations spéciales dans le système de tickets, que la plupart des chefs de projet seront heureux de vous accorder lorsque vous direz que vous voulez aider à nettoyer les tickets. 5. **Diagnostiquer un bogue** : Les bogues sont souvent mal signalés. Le diagnostic et le triage d'un bogue peuvent aider les développeurs à gagner du temps en leur permettant de comprendre les spécificités du problème. Si un utilisateur signale que "le logiciel ne fonctionne pas lorsque je fais X", prenez le temps d'analyser les détails de ce problème. Est-il reproductible ? Pouvez-vous créer une série d'étapes pour provoquer le problème de manière répétée ? Pouvez-vous circonscrire le problème, par exemple s'il ne se produit que sur un navigateur et pas sur un autre, ou sur une distribution et pas sur une autre ? Même si vous ne savez pas ce qui cause le problème, l'effort que vous faites pour réduire les circonstances permet à quelqu'un d'autre de le résoudre plus facilement. Quoi que vous découvriez, ajoutez-le au ticket dans le système de gestion des bogues pour que tout le monde puisse le voir. 6. **Fermer les bogues corrigés** : Il arrive souvent que des bogues soient corrigés dans la base de code, mais que les tickets signalés à leur sujet ne soient pas mis à jour dans le système de gestion des tickets. Le nettoyage de ces bogues peut prendre du temps, mais il est précieux pour l'ensemble du projet. Commencez par interroger le système de tickets pour les tickets datant de plus d'un an et voyez si le bogue existe toujours. Consultez le journal des modifications de la version du projet pour voir si le bogue a été corrigé et s'il peut être fermé. Si l'on sait qu'il a été corrigé, notez le numéro de version dans le ticket et fermez-le. Essayez de recréer le bogue avec la dernière version du logiciel. S'il ne peut pas être recréé avec la dernière version, notez-le dans le ticket et fermez-le. S'il existe toujours, notez-le également dans le ticket et laissez-le ouvert. Travailler avec du code Des programmeurs de tous les niveaux d'expérience peuvent aider à développer le code du projet. Ne pensez pas que vous devez être un génie du codage pour apporter une réelle contribution à votre projet favori. Si votre travail consiste à modifier le code, renseignez-vous sur la méthode utilisée par le projet pour obtenir le code des contributeurs. Chaque projet a son propre flux de travail, alors renseignez-vous sur la façon de procéder avant de commencer à soumettre du code. Par exemple, le projet PostgreSQL est très rigoureux dans son processus : Les modifications de code sont envoyées sous forme de correctifs à une liste de diffusion où les développeurs principaux examinent minutieusement chaque aspect du changement. À l'autre extrémité, on trouve un projet comme Parrot, où il est facile d'obtenir des privilèges de validation pour la base de code. Si le projet utilise GitHub, il peut y avoir un flux de travail qui utilise la fonction de demande d'extraction de GitHub. Il n'y a pas deux projets identiques. Chaque fois que vous modifiez du code, veillez à agir en tant que membre responsable de la communauté et à conserver un style de code qui corresponde au reste de la base de code. Le code que vous ajoutez ou modifiez doit ressembler au reste. Vous pouvez ne pas aimer le style des accolades ou la gestion des espaces pour l'indentation, mais il est impoli de soumettre une modification de code qui ne correspond pas aux normes existantes. Cela revient à dire : "Je n'aime pas votre style, et je pense que le mien est meilleur, alors vous devriez le faire à ma façon". 7. **Tester une version bêta ou une "release candidate"** : Tout projet conçu pour fonctionner sur plusieurs plateformes peut rencontrer toutes sortes de problèmes de portabilité. Lorsqu'une version approche et qu'une version bêta ou candidate est publiée, le chef de projet espère qu'elle sera testée par de nombreuses personnes différentes sur de nombreuses plateformes différentes. Vous pouvez être l'une de ces personnes et contribuer à faire en sorte que le paquetage fonctionne sur votre plateforme. En général, il suffit de télécharger, de compiler et de tester le logiciel, mais la valeur pour le projet peut être énorme si vous utilisez une distribution ou un matériel peu courant. Le simple fait de signaler que la compilation et le test fonctionnent permet aux chefs de projet de savoir que la version imminente est solide. 8. **Corriger un bogue** : C'est généralement par là que commencent les contributeurs désireux de travailler sur le code. C'est simple : Trouvez un bogue intéressant dans le système de tickets et essayez de le corriger dans le code. Documentez la correction dans le code si cela est approprié. C'est une bonne idée d'ajouter un test à la suite de tests pour tester la partie du code que vous avez corrigée ; certains projets exigent que les corrections de bogues incluent des tests. Prenez des notes pendant que vous fouillez dans cette base de code inconnue. Même si vous ne parvenez pas à corriger le bogue, documentez dans le ticket ce que vous avez découvert dans le cadre de la tentative de correction. Ce que vous trouvez aide ceux qui viennent après vous. 9. **Écrire un test**: La plupart des projets ont une suite de tests qui teste le code, mais il est difficile d'imaginer une suite de tests qui ne pourrait pas être complétée par d'autres tests. Utilisez un outil de couverture des tests comme gcov pour le C, ou Devel::Cover pour Perl pour identifier les zones du code source qui ne sont pas testées par la suite de tests. Ensuite, ajoutez un test à la suite pour couvrir ces zones. 10. **Faire taire un avertissement du compilateur** : Le processus de compilation de nombreux projets basés sur le langage C fait souvent apparaître à l'écran un avertissement du compilateur. Ces avertissements ne sont généralement pas des indicateurs d'un problème, mais ils peuvent y ressembler. Un trop grand nombre d'avertissements peut donner l'impression que le compilateur crie au loup. Vérifiez si le code ne cache pas un bogue. Si ce n'est pas le cas, la modification du code source pour le rendre silencieux permet de dissimuler ces faux positifs. 11. **Ajouter un commentaire** : Lorsque vous fouillez dans le code, il se peut que vous trouviez des points qui prêtent à confusion. Il y a de fortes chances que si vous avez été dérouté, d'autres le seront aussi. Documentez-les dans le code et soumettez un correctif. Travailler avec la documentation La documentation est généralement la partie d'un projet qui est la plus négligée. Elle peut aussi souffrir d'avoir été écrite du point de vue de ceux qui connaissent bien le projet, plutôt qu'à travers les yeux de quelqu'un qui vient de s'y lancer. Si vous avez déjà lu la documentation d'un projet et que vous vous êtes dit : "C'est comme si ce manuel s'attendait à ce que je sache déjà comment utiliser ce paquet", vous savez de quoi je parle. Souvent, un regard neuf peut mettre en évidence des lacunes dans la documentation que les personnes proches du projet ne remarquent pas. 12. **Create an example** : There is no project that has too many how-to examples. Whether it's a web API, a library of routines, a GUI app like Gimp or a command line tool, a good example of proper usage can more clearly and quickly explain proper usage of software than pages of documentation. For an API or library, create an example program that uses the tool. This could even be extracted from code you've written, trimmed down to the bare necessities. For a tool, show real-world examples of how you've used it in your daily life. If you’re visually oriented, consider creating a screen-capture of an important process, such as how to install the application. Travailler avec la communauté L'open source n'est qu'une partie du code. C'est la communauté qui fait fonctionner l'open source. Voici comment vous pouvez contribuer à son développement 13. **Répondre à une question** : La meilleure façon de contribuer à la construction de la communauté est d'aider les autres. Répondre à une question, en particulier à celle d'un débutant, est essentiel pour aider le projet à se développer et à prospérer. Le temps que vous prenez pour aider un débutant, même s'il pose une question à laquelle vous pourriez facilement répondre par un rapide "RTFM", vous permet de devenir un membre actif de la communauté. Tout le monde commence quelque part, et les projets ont besoin d'un afflux constant de personnes pour rester dynamiques. 14. **Rédigez un article de blog** : Si vous avez un blog, écrivez sur vos expériences avec le projet que vous utilisez. Racontez un problème que vous avez rencontré en utilisant le logiciel et ce que vous avez fait pour le résoudre. Vous apporterez une double aide, en contribuant à maintenir le projet dans l'esprit des personnes qui vous entourent et en créant une trace pour toute personne qui, à l'avenir, sera confrontée à votre problème et cherchera la réponse sur le web. (Un blog relatant vos aventures techniques est également un excellent moyen de montrer votre expérience concrète du logiciel en question la prochaine fois que vous chercherez un emploi dans ce domaine). 15. **Améliorer un site web** : Si vous avez des compétences en conception de sites web et que vous pouvez aider à améliorer le site web, et donc l'image du projet auprès du public, c'est du temps bien utilisé. Le projet pourrait peut-être bénéficier d'une refonte graphique ou d'un logo pour l'identifier. Il s'agit peut-être de compétences qui font défaut à la communauté. Je sais que j'aimerais beaucoup avoir de l'aide en matière de conception graphique pour les sites web de mes projets. 16. **Rédiger de la documentation technique** : Si vous pouvez écrire sur le fonctionnement d'une application ou d'un logiciel, vous pouvez rédiger de la documentation technique à son sujet. En particulier pour les projets open source qui cherchent à mettre à jour, réorganiser, développer ou créer des documents techniques destinés au grand public. Plus vous écrivez en anglais simple, mieux c'est. Le plus intéressant, c'est qu'il n'est pas nécessaire d'être programmeur pour rédiger des documents techniques. Surtout, écoutez ce que disent les gens autour de vous. Voyez si vous pouvez reconnaître un besoin pressant. Par exemple, récemment, sur la liste de diffusion des développeurs de Parrot, il a été décidé d'utiliser GitHub comme système de tickets d'incident, abandonnant l'ancienne installation de Trac qu'ils avaient. Certaines personnes se sont opposées à cette décision car il n'y avait aucun moyen de convertir les tickets au système de GitHub. Après une journée de discussions, j'ai pris la parole et j'ai dit : "Et si j'écrivais un convertisseur ?". Les gens étaient ravis de l'idée. J'ai pris le temps d'écrire un programme de conversion pour les plus de 450 tickets, de sorte que nous n'avons rien perdu de l'historique de nos tickets. Ce fut un grand succès. J'ai pu apporter ma contribution, et les développeurs principaux sont restés concentrés sur leur travail sur Parrot. 17. **Enseigner et aider les autres** : La meilleure façon d'en savoir plus sur un sujet est d'essayer de l'enseigner. Le meilleur professeur est celui qui peut expliquer des choses complexes avec des exemples simples. Vous devez donc essayer d'être le meilleur professeur pour être le meilleur apprenant et le meilleur dans votre monde de programmation. Enseigner aux autres vous permettra de vous sentir mieux dans votre peau et vous aidera à acquérir de meilleures compétences et connaissances dans votre profession. Lorsque vous recevez de l'aide de quelqu'un, ne la gardez pas pour vous, partagez-la avec les autres. Faites du monde un endroit où il fait bon vivre. ================================================ FILE: docs/additional-material/translations/French/additional-material.fr.md ================================================ # Informations supplémentaires Nous partons du principe que vous avez déjà lu le tutoriel basique avant de vous rendre ici. Ce document vous donnera des informations complémentaires sur les techniques avancées de Git. ### [Modifier un commit](amending-a-commit.md) Cette page vous donnera les informations dont vous avez besoin pour modifier un commit sur un répertoire distant : > Utilisez ceci pour corriger un commit que vous avez réalisé. ### [Configurer git](configuring-git.md) Cette page vous donnera les informations dont vous avez besoin pour configurer les détails utilisateur vous concernant et d'autres options dans git : > A utiliser pour un meilleur contrôle de la configuration de votre git. ### [Gardez votre embranchement (fork) synchronisé avec le répertoire](keeping-your-fork-synced-with-this-repository.md) Ce document vous donne les informations pour conserver un répertoire "fork" à jour avec le répertoire source. Ceci est important et nous espérons que vous et beaucoup d'autres vont contribuer à ce projet. > Suivez ces étapes si vous ne voyez aucun changement sur votre embranchement dans le répertoire parent. ### [Déplacer un Commit vers une Branche différente](moving-a-commit-to-a-different-branch.md) Cette page vous donnera les informations dont vous avez besoin pour déplacer un Commit vers une Branche différente : > Suivez ces étapes pour déplacer un Commit vers une Branche différente. ### [Supprimer un Fichier](removing-a-file.md) Cette page vous donnera les informations dont vous avez besoin pour supprimer un Fichier depuis votre répertoire local : > Suivez ces étapes pour apprendre comment supprimer un fichier avant d'effectuer un commit. ### [Supprimer une branche dans votre répertoire](removing-branch-from-your-repository.md) Cette page vous donnera les informations dont vous avez besoin pour supprimer une branche de votre répertoire : > Ne suivez ces étapes qu'une fois que votre demande de tirage a été fusionnée. ### [Résoudre les conflits de fusion (Merge Conflicts)](resolving-merge-conflicts.md) Cette page vous donnera les informations dont vous avez besoin pour résoudre les problèmes de fusion : > Suivez ces étapes pour résoudre ces problèmes de fusion (souvent pénibles). ### [Revenir à un commit](reverting-a-commit.md) Cette page vous aidera si vous avez besoin de revenir à un commit précédent, sur le répertoire distant. Ceci est pratique dans le cas où vous auriez besoin d'annuler un commit que vous auriez déjà poussé sur Github. > Suivez ces étapes si vous souhaitez reprendre un commit. ### [Aplatir des Commits](squashing-commits.md) Cette page vous apprendra comment aplatir plusieurs commits en un seul. > A utiliser si vous voulez ouvrir une demande de révision (pull request) et que l'évaluateur vous demande d'"aplatir" tous les commits en un seul, contenant un message d'information global. ### [Annuler un commit local](undoing-a-commit.md) Cette page vous donne les informations dont vous avez besoin pour annuler un commit sur votre répertoire local. C'est ce que vous aurez besoin de faire si vous sentez que vous avez fait une erreur dans votre répertoire local et que vous voulez revenir à l'état précédent. > Suivez ces instructions si vous voulez annuler / revenir à l'état précédent sur un commit local. ### [liens utiles](Useful-links-for-further-learning.md) Cette page est dédiée à tous les sites de trucs et astuces, les blogs, et en règle générale les sites qui nous aident à rendre nos vies plus faciles. Ils sont d'excellentes références pour répondre à tous vos besoins, que vous soyez débutant ou expert. Cette page devrait être un index de tous ces liens utiles qui aideront tous ceux qui sont nouveaux dans le domaine de l'open-source ou ceux qui veulent approfondir leurs connaissances. ### [Créer un fichier .gitignore](creating-a-gitignore-file.md) Ce document explique à quoi sert un fichier .gitignore, pourquoi l'utiliser et comment le créer. Ce fichier est utilisé dans quasiment tous les projets git. Il aide à ne prendre en compte dans les commits que les fichiers nécessaires. ================================================ FILE: docs/additional-material/translations/French/amending-a-commit.fr.md ================================================ # Modifier un commit Imaginons que vous avez effectué un commit sur votre répertoire distant et que vous vous rendez compte plus tard qu'il y a une coquille dans le message de commit ou que vous avez oublié d'ajouter une ligne dans votre tout dernier commit. Comment faire pour rectifier cette erreur ? C'est le sujet de ce tutoriel. ## Changer un message de commit récent après l'avoir poussé sur Github Pour se faire sans même ouvrir un fichier : * Taper la commande ```git commit --amend -m "suivi de votre nouveau message de commit"``` * Lancer la commande ```git push origin ``` pour effectuer un commit vers le répertoire. NB : Si vous tapez uniquement ```git commit --amend```, l'éditeur de texte s'ouvre et vous demande de modifier le message de commit. Ajoutez l'option ``-m`` pour éviter de passer par l'éditeur de texte. ## Modifier un commit précis Donc, qu'est-ce qu'il se passe si vous oubliez de faire un changement mineur sur un fichier, comme changer un mot et que vous avez déjà poussé ce commit vers notre répertoire distant ? Pour illustrer ce propos, voici un log de mes commits ; ``` g56123f création d'un fichier bot a2235d mise à jour de contributeur.md a5da0d modification du fichier bot ``` Imaginons que j'ai oublié d'ajouter un mot dans le fichier bot. Il y a deux façons de régler ce problème. Le premier est de faire un nouveau commit qui contient le changement comme ceci : ``` g56123f création d'un fichier bot a2235d mise à jour de contributeur.md a5da0d modification du fichier bot b0ca8f ajout d'un mot dans le fichier bot ``` La seconde façon est de modifier le commit a5da0d et d'ajouter ce nouveau mot puis le pousser sur Github le tout dans un seul commit. Cette deuxième option semble plus adaptée, étant donné qu'il s'agit d'un changement mineur. Pour se faire, il faut suivre les étapes suivantes : * Modifier le fichier. Dans notre cas, on modifie le fichier bot pour y inclure le mot oublié. * Ensuite, ajouter le fichier dans la zone de transit avec la commande ```git add ``` D'habitude, après avoir ajouté des fichiers dans la zone de transit, l'étape suivante est d'exécuter la commande git commit -m "notre message de commit", n'est-ce pas ? Mais comme ce qu'on veut ici c'est modifier le commit précédent, on va plutôt lancer les commandes : * ```git commit --amend``` Cela va faire apparaître l'éditeur de texte qui vous demande de modifier le message. Vous pouvez décider de laisser le message tel quel ou bien le changer. * Quitter l'éditeur * Pousser vos changements avec la commande ```git push origin ``` De cette façon, les deux changements se trouvent dans un même commit. ================================================ FILE: docs/additional-material/translations/French/check-commit-log.fr.md ================================================ # Vérifier l'historique des commits Pour vérifier l'historique des commits d'une branche ou d'un fichier, la commande suivante peut être utilisée : git log [options] [path] Par défaut, la sortie de cette commande est affichée dans l'ordre chronologique inverse. ## Variations et options de la commande - Pour effectuer les commits accessibles à partir de certains identifiants de commit : (Dans ce cas,`foo` et `bar`)
`git log foo bar` - Il est également possible de supprimer les commits accessibles à partir d'un identifiant de commit donné en ajoutant un `^` devant l'identifiant de commit: (Dans ce cas, `baz`)
`git log foo bar ^baz` - Historique des commits pour un fichier spécifique
`git log --all ` - Limiter le nombre de commits affichés dans l'historique : (Dans ce cas, `5`)
`git log -n 5` ## Référence - [Documentation officielle](https://git-scm.com/docs/git/fr) ================================================ FILE: docs/additional-material/translations/Germany ================================================ ================================================ FILE: docs/additional-material/translations/Greek/git_workflow_scenarios/additional-material.gr.md ================================================ # Επιπλέον πληροφορίες Υποθέτουμε ότι έχετε ήδη ολοκληρώσει το βασικό μάθημα πριν έρθετε εδώ. Αυτό το έγγραφο θα σας παρέχει πρόσθετες πληροφορίες για προηγμένες τεχνικές του Git. ### [Τροποποίηση μιας καταχώρησης (commit)](amending-a-commit.md) Αυτό το έγγραφο παρέχει πληροφορίες σχετικά με το πώς να τροποποιήσετε μια καταχώρηση (commit) στο απομακρυσμένο αποθετήριο. Η τροποποίηση μιας καταχώρησης είναι ένας τρόπος για να διορθώσετε την πιο πρόσφατη καταχώρηση που έχετε κάνει στο τρέχον παρακλάδι σας. Αυτό μπορεί να είναι χρήσιμο εάν χρειάζεστε να επεξεργαστείτε το μήνυμα της καταχώρησης ή αν ξεχάσατε να συμπεριλάβετε αλλαγές στην καταχώρηση. Μπορείτε να συνεχίσετε να τροποποιείτε μια καταχώρηση μέχρι να την στείλετε στο απομακρυσμένο αποθετήριο. > Χρησιμοποιήστε αυτό όταν χρειάζεστε να προσαρμόσετε μια καταχώρηση που έχετε κάνει. ### [Διαμόρφωση του Git](configuring-git.md) Αυτό το έγγραφο παρέχει πληροφορίες σχετικά με το πώς να διαμορφώσετε τις λεπτομέρειες του χρήστη και άλλες επιλογές στο Git. > Χρησιμοποιήστε αυτό για να έχετε καλύτερο έλεγχο των ρυθμίσεων του Git σας. ### [Συγχρονισμός του δικού σας αποθετηρίου με το αποθετήριο κύριου κώδικα](keeping-your-fork-synced-with-this-repository.md) Αυτό το έγγραφο παρέχει πληροφορίες για το πώς να κρατήσετε το δικό σας διακλαδισμένο αποθετήριο ενημερωμένο με το κύριο αποθετήριο. Αυτό είναι σημαντικό, διότι ελπίζουμε ότι εσείς και πολλοί άλλοι θα συνεισφέρετε στο έργο. > Ακολουθήστε αυτά τα βήματα εάν το δικό σας διακλαδισμένο αποθετήριο δεν έχει κάποιες αλλαγές στο κύριο αποθετήριο. ### [Μεταφορά μιας καταχώρησης (commit) σε διαφορετικό παρακλάδι](moving-a-commit-to-a-different-branch.md) Αυτό το έγγραφο παρέχει πληροφορίες σχετικά με το πώς να μεταφέρετε μια καταχώρηση (commit) σε ένα άλλο παρακλάδι. > Ακολουθήστε αυτά τα βήματα για να μετακινήσετε μια καταχώρηση (commit) σε άλλο παρακλάδι. ### [Διαγραφή ενός αρχείου](removing-a-file.md) Αυτό το έγγραφο παρέχει πληροφορίες σχετικά με το πώς να διαγράψετε ένα αρχείο από το τοπικό αποθετήριο σας. > Ακολουθήστε αυτά τα βήματα για να μάθετε πώς να διαγράψετε ένα αρχείο πριν από μια καταχώρηση (commit). ### [Διαγραφή παρακλαδιού από το αποθετήριο σας](removing-branch-from-your-repository.md) Αυτό το έγγραφο παρέχει πληροφορίες σχετικά με το πώς να διαγράψετε ένα παρακλάδι από το αποθετήριο σας. > Μόνο μετά την ενσωμάτωση (merge) του αιτήματος σας, ακολουθήστε τα επόμενα βήματα. ### [Επίλυση συγχώνευσης συγκρούσεων](resolving-merge-conflicts.md) Αυτό το έγγραφο παρέχει πληροφορίες σχετικά με το πώς να επιλύσετε θέματα σύγκρουσης συγχώνευσης. > Ακολουθήστε αυτά τα βήματα για να επιλύσετε τις ενοχλητικές συγχωνεύσεις συγκρούσεων. ### [Αναστροφή μιας καταχώρησης (commit)](reverting-a-commit.md) Αυτό το έγγραφο παρέχει πληροφορίες σχετικά με το πώς να αναστρέψετε μια καταχώρηση (commit) στο απομακρυσμένο αποθετήριο. Θα σας φανεί χρήσιμο στην περίπτωση που χρειάζεστε να αναιρέσετε μια καταχώρηση (commit) που έχει ήδη ανέβει (pushed) στο Github. > Ακολουθήστε αυτά τα βήματα αν θέλετε να αναστρέψετε μια καταχώρηση (commit). ### [Συμπίεση καταχωρήσεων (commits)](squashing-commits.md) Αυτό το έγγραφο παρέχει πληροφορίες σχετικά με το πώς να συμπιέσετε (squash) καταχωρήσεις (commits) με μια διαδραστική επανεβολή (rebase). > Χρησιμοποιήστε αυτό αν θέλετε να ανοίξετε ένα αίτημα συμμετοχής (pull request) σε ένα έργο ανοιχτού κώδικα και ο αναθεωρητής (reviewer) σας ζητήσει να συμπιέσετε κάθε καταχώρηση σε μία, με ένα ενημερωτικό μήνυμα καταχώρησης. ### [Αναίρεση τοπικής καταχώρησης (commit)](undoing-a-commit.md) Αυτό το έγγραφο παρέχει πληροφορίες σχετικά με το πώς να αναιρέσετε μια καταχώρηση (commit) στο τοπικό αποθετήριό σας. Αυτό είναι αυτό που χρειάζεται να κάνετε όταν νιώθετε ότι έχετε μπερδέψει το τοπικό αποθετήριό σας και επιθυμείτε να επαναφέρετε το τοπικό αποθετήριο. > Ακολουθήστε αυτά τα βήματα αν θέλετε να αναιρέσετε/επαναφέρετε μια τοπική καταχώρηση (commit). ### [Χρήσιμοι σύνδεσμοι](Useful-links-for-further-learning.md) Αυτό το έγγραφο είναι αφιερωμένο σε όλους τους ιστότοπους με συμβουλές και κόλπα, αναρτήσεις σε ιστολόγια και χρήσιμους ιστότοπους που κάνουν τη ζωή μας πιο εύκολη. Αποτελεί μια εξαιρετική πηγή αναφοράς για όλες τις ανάγκες μας, είτε είμαστε αρχάριοι είτε ειδικοί, στον χώρο του ανοικτού κώδικα ή θέλουμε να μάθουμε περισσότερα. ### [Δημιουργία αρχείου .gitignore](creating-a-gitignore-file.md) Αυτό το έγγραφο εξηγεί τι κάνει ένα αρχείο .gitignore, γιατί να το χρησιμοποιήσετε και πώς να δημιουργήσετε ένα αρχείο .gitignore. Αυτό το αρχείο χρησιμοποιείται σε σχεδόν όλα τα αποθετήρια Git. Βοηθά να κάνετε commit μόνο τα απαραίτητα αρχεία στο Git. ### [Αποθήκευση διαπιστευτηρίων](storing-credentials.md) Αυτό το έγγραφο εξηγεί πώς να αποθηκεύσετε τα διαπιστευτήριά σας για αποθετήρια. Αυτό μπορεί να αποτελεί ανησυχία για την ασφάλεια, για αυτό παρακαλούμε να ακολουθείτε τις πολιτικές ασφαλείας του χώρου εργασίας/μελέτης σας. ================================================ FILE: docs/additional-material/translations/Greek/git_workflow_scenarios/amending-a-commit.gr.md ================================================ # Τροποποίηση μιας Καταχώρησης (Commit) Τι γίνεται αν κάνετε μια αλλαγή στο απομακρυσμένο αποθετήριό σας μόνο για να συνειδητοποιήσετε αργότερα ότι έχετε ένα τυπογραφικό στο μήνυμα της καταχώρησης ή ότι ξεχάσατε να προσθέσετε μια γραμμή στην πιο πρόσφατη καταχώρησή σας. Πώς μπορείτε να το επεξεργαστείτε αυτό; Αυτό είναι αυτό που καλύπτεται σε αυτό το μάθημα. ## Αλλαγή του μηνύματος μιας πρόσφατης καταχώρησης μετά την αποστολή στο Github. Για να το κάνετε αυτό χωρίς να ανοίξετε ένα αρχείο: * Πληκτρολογήστε ```git commit --amend -m "και ακολουθείτε με το νέο μήνυμα καταχώρησης σας"``` * Εκτελέστε ```git push origin <όνομα παρακλαδιού>``` για να κάνετε commit τις αλλαγές στο αποθετήριο. Σημείωση: Αν πληκτρολογήσετε μόνο ```git commit --amend```, ο κειμενογράφος σας θα ανοίξει και θα σας ζητήσει να επεξεργαστείτε το μήνυμα της καταχώρησης. Η προσθήκη της σημαίας ```-m``` το αποτρέπει. ## Τροποποίηση μιας μόνο καταχώρησης Τι γίνεται αν ξεχάσατε να κάνετε μια μικρή αλλαγή σε ένα αρχείο, όπως να αλλάξετε μια μόνο λέξη, και έχετε ήδη ανεβάσει την καταχώρηση στο απομακρυσμένο αποθετήριο; Για να εξηγήσουμε, εδώ είναι ένα αρχείο καταγραφής των καταχωρήσεων μου: ``` g56123f: δημιουργία αρχείου botfile a2235d: ενημέρωση του contributor.md a5da0d: τροποποίηση του αρχείου botfile ``` Ας πούμε ότι ξέχασα να προσθέσω μια λέξη στο αρχείο bot. Υπάρχουν 2 τρόποι να προχωρήσουμε σε αυτό. Ο πρώτος είναι να έχουμε μια εντελώς νέα καταχώρηση που περιέχει την αλλαγή ως εξής: ``` g56123f: δημιουργία αρχείου botfile a2235d: ενημέρωση του contributor.md a5da0d: τροποποίηση του αρχείου botfile b0ca8f: προσθήκη μιας μόνο λέξης στο αρχείο botfile ``` Ο δεύτερος τρόπος είναι να τροποποιήσουμε την καταχώρηση a5da0d, να προσθέσουμε αυτή τη νέα λέξη και να το ανεβάσουμε στο Github ως ένα μόνο commit. Ο δεύτερος τρόπος φαίνεται καλύτερος αφού είναι μια μικρή αλλαγή. Για να το επιτύχουμε αυτό, θα κάνουμε τα εξής: * Τροποποιήστε το αρχείο. Σε αυτή την περίπτωση, θα τροποποιήσω το αρχείο botfile για να προσθέσω τη λέξη που παρέλειψα προηγουμένως. * Στη συνέχεια, προσθέστε το αρχείο στην περιοχή ενστάλαξης με το ```git add <όνομα αρχείου>``` Συνήθως, μετά την προσθήκη αρχείων στην περιοχή ενστάλαξης, το επόμενο πράγμα που κάνουμε είναι ```git commit -m "το μήνυμα καταχώρησής μας"``` σωστά; Αλλά αφού αυτό που θέλουμε να επιτύχουμε εδώ είναι να τροποποιήσουμε την προηγούμενη καταχώρηση, αντ' αυτού θα τρέξουμε: * ```git commit --amend``` Αυτό θα σας φέρει στον κειμενογράφο και θα σας ζητήσει να επεξεργαστείτε το μήνυμα. Μπορείτε να αποφασίσετε να αφήσετε το μήνυμα όπως ήταν πριν ή να το αλλάξετε. * Έξοδος από τον κειμενογράφο * Ανεβάστε τις αλλαγές σας με ```git push origin <όνομα παρακλαδιού>``` Με αυτόν τον τρόπο, και οι δύο αλλαγές θα είναι σε ένα μόνο commit. ## Τροποποίηση καταχωρήσεων στο απομακρυσμένο αποθετήριο Εάν η καταχώρηση που θέλετε να τροποποιήσετε έχει ήδη ανεβεί στο απομακρυσμένο αποθετήριο, η τροποποίηση αυτής της καταχώρησης θα οδηγήσει στην αποκλιμάκωση της τοπικής ιστορίας από το απομακρυσμένο (καθώς ουσιαστικά δημιουργείτε μια νέα καταχώρηση και αντικαθιστάτε την τροποποιημένη). Εφόσον θέλετε να αλλάξετε την καταχώρηση στο απομακρυσμένο, θα πρέπει να αντικαταστήσετε την ιστορία του απομακρυσμένου στον παρακλάδι σας. Για να το επιτύχετε αυτό, ακολουθήστε την ίδια διαδικασία όπως περιγράφεται παραπάνω, αλλά χρησιμοποιήστε την εντολή force push (εξαναγκαστική αποστολή) όταν ανεβάζετε την καταχώρησή σας στο απομακρυσμένο. > **Προειδοποίηση** > Η force push στο απομακρυσμένο θα αντικαταστήσει (και θα απορρίψει) τις αλλαγές στο απομακρυσμένο και θα διατηρήσει μόνο τις καταχωρήσεις που ανεβάσατε. Οι αλλαγές στο απομακρυσμένο που έκαναν άλλα μέλη της ομάδας στο μεταξύ θα αντικατασταθούν επίσης. Αυτό είναι πώς μπορείτε να τροποποιήσετε την πιο πρόσφατη καταχώρηση στο απομακρυσμένο: ```bash git add <τα αρχεία που άλλαξαν> git commit --amend -m "και ακολουθείτε με το νέο μήνυμα καταχώρησής σας" git push --force ``` > Η χρήση της --force-with-lease είναι μια πιο ασφαλής επιλογή αντί για το --force, καθώς αποφεύγει την αντικατάσταση των αλλαγών άλλων ατόμων στον απομακρυσμένο κλάδο (εάν δεν το επιθυμείτε). ================================================ FILE: docs/additional-material/translations/Greek/git_workflow_scenarios/check-commit-log.gr.md ================================================ # Έλεγχος καταγραφής αλλαγών (commit log) Για να ελέγξετε την καταγραφή αλλαγών (commit log) για ένα κλαδί ή ένα αρχείο, μπορείτε να χρησιμοποιήσετε την ακόλουθη εντολή: ```bash git log [επιλογές] [διαδρομή] ``` Η έξοδος αυτής της εντολής παρέχεται με την προεπιλεγμένη σειρά αναστροφής χρονολογίας. ## Παραλλαγές και επιλογές της εντολής - Για να καταγράψετε τις αλλαγές που είναι προσβάσιμες από συγκεκριμένα αναγνωριστικά αλλαγών (π.χ. foo και bar), χρησιμοποιήστε: ` git log foo bar ` - Είναι επίσης δυνατό να αφαιρέσετε τις αλλαγές που είναι προσβάσιμες από ένα συγκεκριμένο αναγνωριστικό αλλαγών (π.χ. baz), προσθέτοντας ένα ^ μπροστά από το αναγνωριστικό: `git log foo bar ^baz` - Για να δείτε την καταγραφή αλλαγών για ένα συγκεκριμένο αρχείο, χρησιμοποιήστε: `git log --all <όνομα_αρχείου>` - Περιορίστε τον αριθμό των αλλαγών στην καταγραφή (π.χ. `5`) χρησιμοποιώντας: `git log -n 5` ## Αναφορές - [Επίσημη τεκμηρίωση](https://git-scm.com/docs/git-log) ================================================ FILE: docs/additional-material/translations/Greek/git_workflow_scenarios/configuring-git.gr.md ================================================ # Διαμόρφωση του git Την πρώτη φορά που προσπαθήσατε να κάνετε commit χρησιμοποιώντας το git, πιθανόν να είδατε ένα παραθυράκι παρόμοιο με αυτό: ```bash $ git commit *** Παρακαλώ πείτε μου ποιός είστε. Εκτελέστε git config --global user.email "you@example.com" git config --global user.name "Your Name" για να ορίσετε την προεπιλεγμένη ταυτότητα του λογαριασμού σας. Παραλείψτε την επιλογή --global για να ορίσετε την ταυτότητα μόνο σε αυτό το αποθετήριο. ``` Το git χρειάζεται να γνωρίζει ποιός είστε κάθε φορά που δημιουργείτε ένα commit. Όταν εργάζεστε συνεργατικά, πρέπει να μπορείτε να δείτε ποιος έχει τροποποιήσει ποια μέρη του έργου και πότε. Επομένως, το git έχει σχεδιαστεί έτσι ώστε να δημιουργεί commits που συσχετίζονται με ένα όνομα και ένα email. Υπάρχουν πολλοί τρόποι για να παρέχετε το email και το όνομά σας στην εντολή `git commit`, και θα δούμε μερικούς από αυτούς παρακάτω. ### Παγκόσμια Διαμόρφωση Όταν αποθηκεύετε κάτι στην παγκόσμια διαμόρφωση (global config), είναι προσβάσιμο σε όλα τα αποθετήρια στα οποία εργάζεστε. Αυτός είναι ο προτιμώμενος τρόπος και λειτουργεί για τις περισσότερες περιπτώσεις. Για να αποθηκεύσετε κάτι στην παγκόσμια διαμόρφωση, χρησιμοποιείτε την εντολή `config` ως εξής: `$ git config --global <όνομα_μεταβλητής> <τιμή>` Στην περίπτωση των στοιχείων του χρήστη, το εκτελούμε ως εξής: ``` $ git config --global user.email "you@example.com" $ git config --global user.name "Your Name" ``` ### Διαμόρφωση Αποθετηρίου Όπως υποδηλώνει το όνομά τους, αυτές οι διαμορφώσεις εφαρμόζονται στο τρέχον αποθετήριο. Αν θέλετε να κάνετε commit σε ένα συγκεκριμένο αποθετήριο, για παράδειγμα, ένα έργο που σχετίζεται με την εργασία σας, μπορείτε να χρησιμοποιήσετε αυτήν τη μέθοδο. Για να αποθηκεύσετε κάτι στη διαμόρφωση αποθετηρίου, χρησιμοποιείτε την εντολή `config` αφήνοντας έξω τη σημαία `--global`, όπως εξής: `$ git config <όνομα_μεταβλητής> <τιμή>` Στην περίπτωση των στοιχείων του χρήστη, το εκτελούμε ως εξής: ``` $ git config user.email "you@alternate.com" $ git config user.name "Your Name" ``` ### Διαμόρφωση Μέσω Γρα μμής Εντολών Αυτού του τύπου διαμορφώσεις ισχύουν μόνο για την τρέχουσα εντολή. Όλες οι εντολές git δέχονται ορίσματα `-c` πριν το ρήμα δράσης για να ορίσουν προσωρινά δεδομένα διαμόρφωσης. Για να αποθηκεύσετε κάτι στη διαμόρφωση μέσω γραμμής εντολών, εκτελέστε την εντολή σας ως εξής: `$ git -c <μεταβλητή-1>=<τιμή> -c <μεταβλητή-2>=<τιμή> <εντολή>` Στο παράδειγμά μας, θα εκτελούσαμε την εντολή commit ως εξής: `git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Your commit message"` ### Σημείωση για την Προτεραιότητα Ανάμεσα στις τρεις μεθόδους που περιγράφηκαν εδώ, η προτεραιότητα είναι `command-line > repository > global`. Αυτό σημαίνει ότι, αν μια μεταβλητή έχει διαμορφωθεί τόσο μέσω γραμμής εντολών όσο και παγκοσμίως, η τιμή που δόθηκε μέσω γραμμής εντολών θα χρησιμοποιηθεί για τη λειτουργία. ## Εκτός από τα Στοιχεία του Χρήστη Μέχρι στιγμής ασχοληθήκαμε μόνο με τα στοιχεία του χρήστη κατά τη διαμόρφωση. Ωστόσο, υπάρχουν πολλές άλλες διαθέσιμες επιλογές διαμόρφωσης. Ορισμένες από αυτές είναι: 1. `core.editor` - για να καθορίσετε το όνομα του επεξεργαστή που χρησιμοποιείται για τη σύνταξη μηνυμάτων commit κ.λπ. 2. `commit.template` - για να καθορίσετε ένα αρχείο στο σύστημα ως πρότυπο αρχικού commit. 3. `color.ui` - για να καθορίσετε μια λογική τιμή για τη χρήση χρωμάτων στην έξοδο του git. Απλοποιήσαμε κάποιες λεπτομέρειες για ευκολία κατανόησης. Για περισσότερες πληροφορίες, επισκεφθείτε το [git-scm.com](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration). ================================================ FILE: docs/additional-material/translations/Greek/git_workflow_scenarios/creating-a-gitignore-file.gr.md ================================================ # .gitignore Το αρχείο .gitignore είναι ένα αρχείο κειμένου που λέει στο Git ποια αρχεία ή φάκελοι πρέπει να αγνοούνται σε ένα έργο. Ένα τοπικό αρχείο .gitignore τοποθετείται συνήθως στον ριζικό φάκελο ενός έργου. Μπορείτε επίσης να δημιουργήσετε ένα παγκόσμιο .gitignore αρχείο και οποιεσδήποτε καταχωρίσεις σε αυτό το αρχείο θα αγνοούνται σε όλα τα αποθετήρια Git σας. ## Γιατί .gitignore Τώρα μπορείτε να αναρωτηθείτε γιατί θέλετε το git να αγνοήσει ορισμένα αρχεία και φακέλους. Αυτό συμβαίνει διότι δεν θέλετε αρχεία όπως αρχεία κατασκευής, αρχεία cache, άλλα τοπικά αρχεία διαμόρφωσης όπως τα node modules, αρχεία μεταγλώττισης, προσωρινά αρχεία που δημιουργούνται από IDE, κ.λπ. να παρακολουθούνται από το git. Συνήθως χρησιμοποιείται για να αποφύγετε την δέσμευση προσωρινών αρχείων από τον τρέχοντα κατάλογο εργασίας που δεν είναι χρήσιμα για άλλους συνεργάτες. ## Ξεκινώντας Για να δημιουργήσετε ένα τοπικό αρχείο .gitignore, δημιουργήστε ένα αρχείο κειμένου και ονομάστε το .gitignore (να θυμάστε να συμπεριλάβετε το . στην αρχή). Στη συνέχεια, επεξεργαστείτε αυτό το αρχείο όπως χρειάζεται. Κάθε νέα γραμμή πρέπει να αναφέρει ένα επιπλέον αρχείο ή φάκελο που θέλετε το Git να αγνοεί. Οι καταχωρίσεις σε αυτό το αρχείο μπορούν να ακολουθούν και μοτίβα αντιστοίχισης. ``` * χρησιμοποιείται ως παντοτινή αντιστοιχία / χρησιμοποιείται για να αγνοήσετε ονόματα διαδρομών σχετικά με το αρχείο .gitignore # χρησιμοποιείται για να προσθέσετε σχόλια σε ένα αρχείο .gitignore Αυτό είναι ένα παράδειγμα του πώς μπορεί να φαίνεται το αρχείο .gitignore: # Αγνόησε τα αρχεία συστήματος Mac .DS_store # Αγνόησε το φάκελο node_modules node_modules # Αγνόησε όλα τα αρχεία κειμένου *.txt # Αγνόησε αρχεία που σχετίζονται με κλειδιά API .env # Αγνόησε αρχεία ρυθμίσεων SASS .sass-cache ``` Για να προσθέσετε ή να αλλάξετε το παγκόσμιο αρχείο .gitignore, εκτελέστε την ακόλουθη εντολή: ``` git config --global core.excludesfile ~/.gitignore_global ``` Αυτό θα δημιουργήσει το αρχείο ~/.gitignore_global. Τώρα μπορείτε να επεξεργαστείτε αυτό το αρχείο με τον ίδιο τρόπο με ένα τοπικό αρχείο .gitignore. Όλα τα αποθετήριά σας Git θα αγνοήσουν τα αρχεία και τους φακέλους που αναφέρονται στο παγκόσμιο αρχείο .gitignore. ## Πώς να Απεξαρτήσετε Αρχεία που Είχατε Ήδη Δεσμεύσει με νέο .gitignore Για να απεξαρτήσετε ένα μεμονωμένο αρχείο, δηλαδή να σταματήσετε την παρακολούθηση του αρχείου αλλά να μην το διαγράψετε από το σύστημα, χρησιμοποιήστε: ``` git rm --cached filename ``` Για να απεξαρτήσετε όλα τα αρχεία στο .gitignore: Πρώτα, κάντε commit σε οποιεσδήποτε εκκρεμείς αλλαγές κώδικα και στη συνέχεια εκτελέστε: ``` git rm -r --cached ``` Αυτό αφαιρεί οποιαδήποτε αλλαγμένα αρχεία από τον δείκτη (staging area), στη συνέχεια εκτελέστε: ``` git add . ``` Κάντε commit: ``` git commit -m ".gitignore δουλεύει τώρα" ``` Για να αναιρέσετε ```git rm --cached filename```, χρησιμοποιήστε ```git add filename```. ================================================ FILE: docs/additional-material/translations/Greek/git_workflow_scenarios/delete-branch-locally.gr.md ================================================ # Διαγραφή ενός τοπικά δημιουργημένου κλαδιού Αυτό θα είναι χρήσιμο όταν κάνετε κατά λάθος λάθος το όνομα ενός κλαδιού. Αυτό μπορεί να γίνει με *3* τρόπους ``` git branch -D <όνομα_κλαδιού> ``` ``` git branch --delete --force <όνομα_κλαδιού> # Ίδιο με το -D ``` ``` git branch --delete <όνομα_κλαδιού> # Σφάλμα κατά την ανενοχλησία ``` Το -D σημαίνει --delete --force, το οποίο θα διαγράψει το κλαδί ακόμα και αν δεν έχει συγχωνευτεί (αναγκαστική διαγραφή), αλλά μπορείτε επίσης να χρησιμοποιήσετε -d που σημαίνει --delete το οποίο θα εμφανίσει ένα σφάλμα ανάλογα με την κατάσταση συγχώνευσης του κλαδιού... ================================================ FILE: docs/additional-material/translations/Greek/git_workflow_scenarios/gitflow.gr.md ================================================ # Gitflow Το Gitflow είναι ένα μοντέλο κλαδισμού για το Git που δημιουργήθηκε από τον Vincent Driessen. Εδώ θα συζητήσουμε τις απαιτήσεις και τις περιπτώσεις χρήσης του Gitflow.
Η ροή εργασίας του Gitflow καθορίζει ένα αυστηρό μοντέλο κλαδισμού που σχεδιάστηκε γύρω από την έκδοση του έργου, παρέχοντας ένα αξιόπιστο πλαίσιο για τη διαχείριση μεγαλύτερων έργων. Το Gitflow είναι ιδανικό για έργα που έχουν προγραμματισμένο κύκλο κυκλοφορίας και για την καλύτερη πρακτική του DevOps για συνεχή παράδοση. Ορίζει πολύ συγκεκριμένους ρόλους για διάφορα κλαδιά και ορίζει πώς και πότε πρέπει να αλληλεπιδρούν. Χρησιμοποιεί ατομικά κλαδιά για την προετοιμασία, διατήρηση και καταγραφή κυκλοφοριών. ## Εφαρμογή 1. **Κλαδιά Develop και Master**: Αντί για ένα μόνο κύριο κλαδί, το Gitflow χρησιμοποιεί δύο κλαδιά για να καταγράψει το ιστορικό του έργου. Βασίζεται σε δύο κύρια κλαδιά με άπειρη διάρκεια ζωής, που ονομάζονται master και develop: - **Κλαδί Master**: Το κλαδί master περιέχει τον παραγωγικό κώδικα και αποθηκεύει το επίσημο ιστορικό κυκλοφοριών. - **Κλαδί Develop**: Το κλαδί develop περιέχει κώδικα προ-παραγωγής και λειτουργεί ως κλαδί ένταξης για χαρακτηριστικά. - **Δημιουργία κλαδιού Develop**:
Χωρίς τη χρήση των επεκτάσεων Gitflow: ``` git branch develop git push -u origin develop ``` Χρησιμοποιώντας τις επεκτάσεις Gitflow: Όταν χρησιμοποιείτε τη βιβλιοθή κη επέκτασης gitflow, η εκτέλεση της εντολής `git flow init` σε ένα υπάρχον αποθετήριο θα δημιουργήσει το κλαδί develop. ``` git flow init ``` 2. **Κλαδί Χαρακτηριστικών**: Κάθε νέο χαρακτηριστικό θα πρέπει να βρίσκεται στο δικό του κλαδί, το οποίο μπορεί να πατηθεί στο κεντρικό αποθετήριο για δημιουργία αντιγράφου ασφαλείας/συνεργασίας. Τα κλαδιά χαρακτηριστικών χρησιμοποιούν το πιο πρόσφατο develop ως γονικό κλαδί. Όταν ένα χαρακτηριστικό είναι ολοκληρωμένο, συγχωνεύεται πίσω στο κλαδί develop. Τα χαρακτηριστικά δεν πρέπει ποτέ να αλληλεπιδρούν απευθείας με το κύριο κλαδί. - **Δημιουργία κλαδιού Χαρακτηριστικού**:
Χωρίς τις επεκτάσεις git-flow: ``` git checkout develop git checkout -b feature_branch ``` Με τις επεκτάσεις gitflow: ``` git flow feature start feature_branch ``` - **Ολοκλήρωση κλαδιού Χαρακτηριστικού**:
Χωρίς τις επεκτάσεις git-flow: ``` git checkout develop git merge feature_branch ``` Με τις επεκτάσεις git-flow: ``` git flow feature finish feature_branch ``` 3. **Κλαδί Κυκλοφορίας**: Μόλις το develop έχει αποκτήσει αρκετά χαρακτηριστικά για μια κυκλοφορία (ή πλησιάζει μια προκαθορισμένη ημερομηνία κυκλοφορίας), δημιουργούμε ένα κλαδί κυκλοφορίας από το develop. Η δημιουργία αυτού του κλαδιού ξεκινά τον επόμενο κύκλο κυκλοφοριών, οπότε δεν μπορούν να προστεθούν νέα χαρακτηριστικά μετά από αυτό το σημείο - μόνο διορθώσεις σφαλμάτων, δημιουργία τεκμηρίωσης και άλλες εργασίες που αφορούν την κυκλοφορία πρέπει να προστεθούν σε αυτό το κλαδί. Το κλαδί κυκλοφορίας μπορεί να παρακλάδιασει από το develop και πρέπει να συγχωνευτεί και στο master και το develop.
Χρησιμοποιώντας ένα αφιερωμένο κλαδί για την προετοιμασία των κυκλοφοριών καθιστά δυνατή τη δυνατότητα μια ομάδα να βελτιστοποιεί την τρέχουσα κυκλοφορία ενώ μια άλλη ομάδα συνεχίζει να εργάζεται σε χαρακτηριστικά για την επόμενη κυκλοφορία. - **Δημιουργία κλαδιού Κυκλοφορίας**:
Χωρίς τις επεκτάσεις git-flow: ``` git checkout develop git checkout develop git checkout -b release/0.1.0 ``` Χρησιμοποιώντας τις επεκ τάσεις git-flow: ``` git flow release start 0.1.0 ``` Μετάβαση σε ένα νέο κλαδί 'release/0.1.0' - **Ολοκλήρωση κλαδιού Κυκλοφορίας**:
Χωρίς τις επεκτάσεις git-flow: ``` git checkout master git merge release/0.1.0 ``` Χρησιμοποιώντας τις επεκτάσεις git-flow: ``` git flow release finish 0.1.0 ``` 4. **Κλαδί Διόρθωσης**: Τα κλαδιά συντήρησης ή "διόρθωσης" χρησιμοποιούνται για γρήγορη επισκευή παραγωγικών κυκλοφοριών. Τα κλαδιά διόρθωσης είναι απαραίτητα για να δράσουν αμέσως σε μια ανεπιθύμητη κατάσταση του κλαδιού master. Τα κλαδιά διόρθωσης είναι πολύ παρόμοια με τα κλαδιά κυκλοφορίας και τα κλαδιά χαρακτηριστικών, εκτός από το γεγονός ότι βασίζονται στο master αντί για το develop. Αυτό είναι το μόνο κλαδί που πρέπει να αποκλίνει απευθείας από το κλαδί master. Μόλις ολοκληρωθεί η διόρθωση, πρέπει να συγχωνευτεί τόσο στο master όσο και στο develop (ή το τρέχον κλαδί κυκλοφορίας), και το κλαδί master πρέπει να σημειωθεί με ένα ενημερωμένο αριθμό έκδοσης. - **Δημιουργία κλαδιού Διόρθωσης**:
Χωρίς τις επεκτάσεις git-flow: ``` git checkout master git checkout -b hotfix_branch ``` Με τις επεκτάσεις git-flow: ``` git flow hotfix start hotfix_branch ``` - **Ολοκλήρωση κλαδιού Διόρθωσης**:
Χωρίς τις επεκτάσεις git-flow: ``` git checkout master git merge hotfix_branch git checkout develop git merge hotfix_branch ``` Με τις επεκτάσεις git-flow: ``` git branch -D hotfix_branch git flow hotfix finish hotfix_branch ``` ## Πλεονεκτήματα - Βεβαιώνει μια καθαρή κατάσταση των κλαδιών σε οποιοδήποτε σημείο του κύκλου ζωής ενός έργου. - Η ονομασία των κλαδιών ακολουθεί ένα συστηματικό πρότυπο που διευκολύνει την κατανόηση. - Έχει επεκτάσεις και υποστήριξη στα περισσότερα εργαλεία git που χρησιμοποιούνται. - Ιδανικό για περιπτώσεις διατήρησης πολλαπλών εκδόσεων στην παραγωγή. - Κατάλληλο για μια ροή εργασίας που βασίζεται σε κυκλοφορίες. - Προσφέρει ένα αφιερωμένο μονοπάτι για διορθώσεις παραγωγής. ## Μειονεκτήματα - Η ιστορία του Git γίνεται δυσανάγνωστη. - Ο διαχωρισμός των κλαδιών master / develop θεωρείται περιττός και δυσκολεύει την Συνεχή Παράδοση / Ενσωμάτωση. - Δεν συνίσταται στην περίπτωση διατήρησης μιας μόνο έκδοσης στην παραγωγή. ## Σύνοψη Εδώ συζητήσαμε τη Ροή Εργασίας του Gitflow. Το Gitflow είναι ένα από τα πολλά στυλ ροών εργασίας του Git που μπορείτε να χρησιμοποιήσετε εσείς και η ομάδα σας. Ας συνοψίσουμε ολόκληρη τη ροή εργασίας του Gitflow: 1. Δημιουργείται ένα κλαδί develop από το master. 2. Δημιουργούνται κλαδιά χαρακτηριστικών από το develop. 3. Όταν ένα χαρακτηριστικό είναι ολοκληρωμένο, συγχωνεύεται στο κλαδί develop. 4. Δημιουργείται ένα κλαδί κυκλοφορίας από το develop. 5. Όταν το κλαδί κυκλοφορίας είναι έτοιμο, συγχωνεύεται στα κλαδιά develop και master. 6. Εάν εντοπιστεί πρόβλημα στο master, δημιουργείται ένα κλαδί διόρθωσης από το master. 7. Μόλις ολοκληρωθεί το διόρθωμα, συγχωνεύεται τόσο στο develop όσο και στο master. ================================================ FILE: docs/additional-material/translations/Hindi/Amending a Commit ================================================ # कमिट में संशोधन करना आपके दूरस्थ संग्रहालय में एक परिवर्तन करते हैं, फिर बाद में पता चलता है कि आपके कमिट संदेश में त्रुटि है या आपने अपने सबसे हाल के कमिट में एक पंक्ति जोड़ना भूल दी है। आप ऐसा कैसे संपादित करेंगे? इस पर यह ट्यूटोरियल विस्तार से बताता है। ##Github पर अपलोड करने के बाद हाल के कमिट संदेश को संशोधित करना। इसे फ़ाइल खोले बिना करने के लिए: * निम्नलिखित कमांड का उपयोग करें ```git commit --amend -m "आपके नए कमिट संदेश के बाद" * चलाना ```git push origin ``` संग्रहालय में परिवर्तन को कमिट (commit) करने के लिए क्या होगा। नोट: यदि आप केवल ```git commit --amend```टाइप करते हैं, तो आपका पाठ संपादित करने के लिए आपके पाठ संपादक खुलेगा। ``-m`` फ़्लैग जोड़ने से इसे रोका जा सकता है। ## एक सिंगल कमिट पर संशोधन करना तो, यदि हम एक फ़ाइल में एक छोटे से बदलाव को करना भूल जाते हैं, जैसे एक शब्द को बदलना, और हमने पहले से ही उस कमिट को हमारे रिमोट रिपॉजिटरी में पुश कर दिया है? इसे व्यक्त करने के लिए यहां मेरे कमिट की एक लॉग है: ``` g56123f create file bot file a2235d updated contributor.md a5da0d modified bot file ``` चलिए मान लें कि मुझसे एक शब्द बदलने को भूल गया हूँ बॉट फ़ाइल में इसके लिए दो तरीके हैं। पहला है कि इसमें परिवर्तन को शामिल करने वाला एक नया कमिट हो, जैसे: ``` g56123f create file botfile a2235d updated contributor.md a5da0d modified botfile b0ca8f added single word to botfile ``` दूसरा तरीका है a5da0d कमिट को संशोधित करना, इस नए शब्द को जोड़ना और इसे एक कमिट के रूप में गिटहब पर पुश करना। दूसरा तरीका बेहतर लगता है क्योंकि यह केवल एक छोटे से बदलाव है। इसे प्राप्त करने के लिए, हम निम्नलिखित करेंगे: * फ़ाइल में संशोधन करें। इस मामले में, मैं बॉट फ़ाइल को संशोधित करके पिछले समय छूट गया शब्द शामिल करूंगा। * आगे बढ़ें, git add के साथ फ़ाइल को स्टेजिंग क्षेत्र में जोड़ें| आम तौर पर स्टेजिंग क्षेत्र में फ़ाइलें जोड़ने के बाद, अगला काम होता है git commit -m "हमारा कमिट संदेश" सही? लेकिन क्योंकि हम यहां पिछले कमिट को संशोधित करना चाहते हैं, इसलिए हम इसके बजाय निम्नलिखित कमांड चलाएंगे: * ```git commit --amend``` इससे पाठ संपादक खुलेगा और आपको संदेश संपादित करने के लिए कहेगा। आप पिछले जैसा संदेश छोड़ सकते हैं या इसे बदल सकते हैं। * संपादक(Editor) से बाहर निकलें * git push origin के साथ अपने बदलावों को पुश करें इस तरह, दोनों बदलावों को एक ही सिंगल कमिट में रखा जाएगा। ## रिमोट पर कमिट संशोधित करना यदि वह कमिट जिसे आप संशोधित करना चाहते हैं पहले से ही रिमोट पर पुश किया गया है, तो इसे संशोधित करने से आपका स्थानीय इतिहास रिमोट से अलग हो जाएगा (क्योंकि आप तदनुसार एक नया कमिट बनाते हैं और संशोधित कमिट को बदल देते हैं)। रिमोट पर कमिट को बदलने के लिए, अपनी शाखा पर रिमोट का इतिहास अधिलेखित करने की आवश्यकता होगी। इसे प्राप्त करने के लिए, ऊपर वर्णित प्रक्रिया का पालन करें, लेकिन जब आप अपनी कमिट को रिमोट पर पुश करें तो फ़ोर्स पुश का उपयोग करें। > **Warning** > फ़ोर्स पुश करने से रिमोट परिवर्तन (और उसे छोड़ देने) को अधिलेखित कर देगा और केवल आपके पुश किए गए कमिट रखेगा। रिमोट पर, टीम के अन्य सदस्यों द्वारा उस बीच में किए गए बदलावों को भी अधिलेखित कर देगा। इस तरह आप रिमोट परिवर्तन को संशोधित करते हैं: ```bash git add <आपकी बदली हुई फ़ाइलें> git commit --amend -m "आपका नया कमिट संदेश के बाद" git push --force ``` >उपयोग करने के लिए `--force` के बजाय `--force-with-lease` सुरक्षित विकल्प है जो रिमोट शाखा पर दूसरे लोगों के बदलावों को अधिलेखित करने से बचाता है (यदि ऐसा आपकी इच्छा नहीं है)। ================================================ FILE: docs/additional-material/translations/Hindi/Things a non Programmer can do ================================================ # Things a non Programmer can do ## सुनना शुरू करें सब कुछ ओपन सोर्स में दूसरे लोगों को शामिल करता है। आप एक टीम में शामिल होने की कोशिश कर रहे हैं, और इसका मतलब है कि आपको समुदाय को समझना होगा और यह कैसे काम करता है। एक परियोजना में प्रवेश करके "नमस्ते, यहाँ मुझे लगता है कि इस परियोजना को यह करना चाहिए" कहना आमतौर पर अच्छी बात नहीं मानी जाती है। कुछ परियोजनाएं इस तरह के दृष्टिकोण का स्वागत कर सकती हैं, लेकिन यदि परियोजना काफी समय से चल रही है, तो इस अवधारणा को स्वीकार करने की संभावना कम होती है। **परियोजना की आवश्यकताओं को जानने के लिए सुनना सबसे अच्छा तरीका है।** 1. **मेलिंग सूची में शामिल हों**: कई परियोजनाओं के लिए, मेलिंग सूची परियोजना के विकास के बारे में संचार का मुख्य साधन होती है। बड़ी परियोजनाओं में, कई मेलिंग सूची उपलब्ध होती हैं। उदाहरण के लिए, पोस्टग्रेसक्यूएल परियोजना में कम से कम 12 उपयोगकर्ता-ओरिएंटेड सूचियां और छह डेवलपर सूचियां हैं। मैं सुझाव देता हूँ कि आप मुख्य उपयोगकर्ता-ओरिएंटेड सूची और मूल डेवलपर सूची का पालन करें, जिसमें सुनना शुरू करें। 2. **एक ब्लॉग का पालन करें**: मूल डेवलपर द्वारा संचालित ब्लॉग आमतौर पर भविष्य में आने वाले रिलीज के बारे में जानकारी देते हैं, और यहां पहुंचने के लिए क्या किया गया है। एक प्लैनेट साइट परियोजना से संबंधित कई स्रोतों से समाचार और ब्लॉग प्रविष्टियों को संग्रहीत करती है। यदि कोई प्लैनेट साइट है, जैसे planet.gnome.org या planet.mysql.com, तो वहां से शुरू करें। "प्लैनेट <परियोजनानाम>" के लिए Google में खोजें। 3. **एक IRC चैनल में शामिल हों**: कई ओपन सोर्स परियोजनाओं में विशेष इंटरनेट रिले चैट (IRC) चैनल होते हैं जहां डेवलपर और उपयोगकर्ता समस्याओं और विकास की चर्चा करने के लिए रहते हैं। परियोजना की वेबसाइट में देखें कि चैनल का नाम क्या है और यह IRC नेटवर्क कहां मिलेगा। **टिकट के साथ काम करें** कोड किसी भी ओपन सोर्स परियोजना का हृदय होता है, लेकिन सोचें इसे कि कोड लिखना केवल योगदान करने का एकमात्र तरीका नहीं है। कोड और कोड के चारों ओर के सिस्टम की रखरखाव को अक्सर नई सुविधाओं को बनाने और बग्स को ठीक करने के दौरान अनदेखा कर दिया जाता है। इन क्षेत्रों को एक आसान तरीके से परियोजना में कदम रखने का एक अवसर मानें। अधिकांश परियोजनाएं एक सार्वजनिक दृश्यमान ट्रबल टिकट सिस्टम रखती हैं, जिसका लिंक परियोजना की वेबसाइट के मुख पृष्ठ से जुड़ा होता है और दस्तावेज़ीकरण में शामिल होता है। यह उपयोगकर्ताओं और डेवलपर्स के बीच संचार का मुख्य माध्यम होता है। इसे अद्यतित रखना परियोजना में मदद करने का एक बड़ा तरीका है। आपको टिकटिंग सिस्टम में विशेष अनुमतियाँ प्राप्त करने की आवश्यकता हो सकती है, जो अधिकांश परियोजना नेताओं को आपकी मदद करने की इच्छा बताते ही खुशी से देंगे। 4. **एक बग का निदान करें**: बग्स आमतौर पर गलत रूप में रिपोर्ट किए जाते हैं। एक बग का निदान करना और उसे व्याख्या करना, समस्या के विशेषांकों का पता लगाने के काम में डेवलपर्स को समय बचाने में मदद कर सकता है। यदि एक उपयोगकर्ता ने "मैं X करते समय सॉफ्टवेयर काम नहीं करता" रिपोर्ट की है, तो कुछ समय निकालें और इस समस्या के कारणों का पता लगाएं। क्या यह दोहराया जा सकता है? क्या आप समस्या को बार-बार पैदा करने के लिए कुछ स्टेप्स निर्धारित कर सकते हैं? क्या आप समस्या को सीमित कर सकते हैं, जैसे कि यह केवल एक ब्राउज़र पर होता है लेकिन दूसरे पर नहीं या एक डिस्ट्रो पर होता है लेकिन दूसरे पर नहीं? यदि आपको पता नहीं है कि समस्या का कारण क्या है, तो संकेतों को सीमित करने में जोखिम लेने का प्रयास करने से किसी दूसरे को इसे सुधारना आसान होता है। चाहे आप कुछ भी खोजें, उसे बग सिस्टम में टिकट में जोड़ें ताकि सभी देख सकें। 5. **ठीक हुए बग्स को बंद करें**: अक्सर बग्स को कोडबेस में ठीक कर लिया जाता है, लेकिन उसके बारे में रिपोर्ट किए गए टिकट सिस्टम में अद्यतित नहीं होते हैं। इस कचरे को साफ करना समय लेने वाला हो सकता है, लेकिन यह पूरे परियोजने के लिए महत्वपूर्ण है। एक वर्ष से पुराने टिकटों के लिए टिकट सिस्टम में क्वेरी करें और देखें कि बग अभी भी मौजूद है या नहीं। बग ठीक हुआ है और बंद किया जा सकता है यह जानने के लिए परियोजना के रिलीज चेंज लॉग की जांच करें। यदि यह ठीक होने के बारे में ज्ञात है, तो टिकट में संस्करण नंबर नोट करें और उसे बंद करें। नवीनतम संस्करण के साथ बग को पुनः बनाने का प्रयास करें। यदि नवीनतम संस्करण के साथ इसे पुनः बनाना संभव नहीं है, तो टिकट में इसे नोट करें और उसे बंद करें। यदि यह अभी भी मौजूद है, तो टिकट में यह नोट करें और खुले छोड़ दें। कोड के साथ काम करना प्रोग्रामर्स, सभी अनुभव स्तरों के, परियोजना में कोड के साथ मदद कर सकते हैं। सोचें नहीं कि आपको एक कोड जीनियस होना चाहिए ताकि आप अपने पसंदीदा परियोजना में वास्तविक योगदान कर सकें। यदि आपका काम कोड में संशोधन शामिल है, तो परियोजना द्वारा कोड को योगदानकर्ताओं से प्राप्त करने का तरीका जांचें। हर परियोजना की अपनी वर्कफ़्लो होती है, इसलिए कोड सबमिट करने से पहले उसके बारे में पूछें। उदाहरण के लिए, पोस्टग्रेएसक्यूएल (PostgreSQL) परियोजना इसकी प्रक्रिया में बहुत सख्त है: कोड संशोधन पैच रूप में एक मेलिंग सूची में भेजे जाते हैं जहां मुख्य डेवलपर्स बदलाव के हर पहलू की जांच करते हैं। दूसरी तरफ़, पैरॉट जैसी परियोजना में कोडबेस के लिए संबंधित अधिकार प्राप्त करना आसान होता है। यदि परियोजना GitHub का उपयोग करती है, तो GitHub के पुल अनुरोध सुविधा का उपयोग करने वाली एक वर्कफ़्लो हो सकती है। कोई भी दो परियोजनाएँ एक समान नहीं होतीं। जब भी आप कोड संशोधित करते हैं, सुनिश्चित करें कि आप समुदाय के एक ज़िम्मेदार सदस्य के रूप में कार्य कर रहे हैं और अपने कोड की शैली को कोडबेस के शेष से मेल खाती हो। आपके द्वारा जोड़ा या संशोधित किया गया कोड शेष के जैसा दिखना चाहिए। शायद आपको ब्रेसिंग स्टाइल या इंडेंटेशन के स्थान परस्पर न पसंद हो, लेकिन एक ऐसा कोड बदलाव सबमिट करना असभ्य है जो मौजूदा मानकों से मेल नहीं खाता है। यह कहने के समान है "मुझे आपकी शैली पसंद नहीं है और मुझे लगता है कि मेरी शैली बेहतर है, इसलिए आपको मेरे तरीके से करना चाहिए।" 6. **बीटा या रिलीज कैंडिडेट (beta or release candidate) का परीक्षण करें**: किसी भी परियोजना जो बहुविधियों पर चलाने के लिए डिज़ाइन की गई हो सकती है, कई प्रकार की पोर्टेबिलिटी समस्याएं हो सकती हैं। जब रिलीज के करीब आती है और एक बीटा या रिलीज कैंडिडेट प्रकाशित होता है, तो परियोजना के नेता की आशा होती है कि इसे कई अलग-अलग लोगों और अलग-अलग प्लेटफ़ॉर्मों पर परीक्षण किया जाए। आप उन लोगों में से एक हो सकते हैं और सुनिश्चित कर सकते हैं कि पैकेज आपकी प्लेटफ़ॉर्म पर काम करता है। आमतौर पर आपको केवल सॉफ़्टवेयर को डाउनलोड, बिल्ड और परीक्षण करने की आवश्यकता होती है, लेकिन यदि आप एक असामान्य वितरण या हार्डवेयर पर हैं, तो परियोजना के लिए महत्वपूर्ण मान्यता हो सकती है। बस यह रिपोर्ट करें कि बिल्ड और परीक्षण काम करता है, जिससे परियोजना के नेता को पता चलता है कि आगामी रिलीज सुदृढ़ है। 7. **एक बग (bug) को ठीक करें** : यह आमतौर पर उन योगदानकर्ताओं के लिए है जो कोड पर काम करना चाहते हैं। यह सरल है: टिकट सिस्टम में एक रोचक लगने वाले बग ढूंढें और कोड में उसे ठीक करने की कोशिश करें। अगर यह उचित हो, तो कोड में ठीक करने को दस्तावेज़ीकरण करें। यदि कोई परियोजना बग ठीक करने के लिए टेस्टों को शामिल करने की आवश्यकता है, तो एक टेस्ट सुइट में एक टेस्ट जोड़ने का एक अच्छा विचार होता है। आप इस अनजान कोडबेस के चारों ओर छूने के दौरान नोट्स रखें। यदि आप बग को ठीक नहीं कर पाते हैं, तो टिकट में दस्तावेज़ करें कि आपने ठीक करने के प्रयास के हिस्से के रूप में क्या खोजा है। आपके द्वारा मिली जानकारी उनकी मदद करती है जो आपके बाद आते हैं। 8. **एक टेस्ट लिखें:** अधिकांश परियोजनाओं में एक टेस्ट सुइट होती है जो कोड का टेस्ट करती है, लेकिन यह मुश्किल है कि कोई ऐसी टेस्ट सुइट हो जो इसे ज्यादा टेस्ट कर सके। C के लिए gcov जैसा एक टेस्ट कवरेज टूल या Perl के लिए Devel::Cover का उपयोग करें ताकि स्रोत कोड में वे क्षेत्र निश्चित हों जो टेस्ट सुइट द्वारा टेस्ट नहीं होते हैं। फिर, इसे कवर करने के लिए एक टेस्ट सुइट में एक टेस्ट जोड़ें। 9. **कैंपाइलर चेतावनी (compiler warning) को शांत करें** : बहुत से सी-आधारित परियोजनाओं के बिल्ड प्रक्रिया में अकसर स्क्रीन पर एक अजीब कैंपाइलर चेतावनी दिखाई देती है। ये चेतावनियाँ आमतौर पर किसी समस्या के संकेतक नहीं होती हैं, लेकिन ऐसा दिख सकता है। बहुत सारी चेतावनियों के होने से कैंपाइलर ऐसा लग सकता है कि यह झूल रहा है। देखें कि क्या कोड वास्तव में एक बग को छिपा रह सकता है। यदि नहीं, तो शांत करने के लिए स्रोत को संशोधित करना मददगार होता है ताकि ये गलत चेतावनियाँ छुपा सकें। 10. **टिप्पणी जोड़ें**: कोड में खोज करते समय, आपको कुछ स्थानों पर कंफ़्यूज़ हो सकता है। संभावना है कि यदि आप कंफ़्यूज़ हो रहे हैं, तो दूसरे भी होंगे। इन्हें कोड में दस्तावेज़ीकरण करें और एक पैच सबमिट करें। दस्तावेज़ीकरण के साथ काम करें दस्तावेज़ीकरण आमतौर पर एक परियोजना का वह हिस्सा होता है जिसे कम महत्व दिया जाता है। यह यह भी संघर्ष कर सकता है क्योंकि इसे उन लोगों की दृष्टि से लिखा गया है जो परियोजना को अच्छी तरह से जानते हैं, बल्कि उनकी नज़रिए से जो इसमें अभी नए हैं। यदि आपने कभी एक परियोजना के लिए दस्तावेज़ पढ़ी है जहां आपको लगता है, "ऐसा लगता है मानुअल मांगता है कि मेरे पास पहले से ही पैकेज का उपयोग करने का ज्ञान हो," तो आप जानते हैं कि मैं क्या कह रहा हूँ। अक्सर एक ताजगी वाले नज़रों की संचालन में दस्तावेज़ीकरण में कमी का पता लगा सकती है जिसे परियोजना के नजदीकी लोग नहीं देखते हैं। 11. **एक उदाहरण बनाएं**: कोई परियोजना ऐसी नहीं है जिसमें केवल हो-टू उदाहरण हों। चाहे यह एक वेब API हो, रूटीन का एक लाइब्रेरी हो, Gimp जैसा एक GUI ऐप हो या कमांड लाइन टूल हो, सही उपयोग का एक अच्छा उदाहरण सॉफ़्टवेयर के सही उपयोग को पृष्ठों के दस्तावेज़ीकरण से अधिक स्पष्टता और तेज़ी से समझा सकता है। एक API या लाइब्रेरी के लिए, उपकरण का उपयोग करके एक उदाहरण प्रोग्राम बनाएं। यह आपके द्वारा लिखे गए कोड से निकाला जा सकता है, जिसे नियमित करके कम कर दिया जाए। टूल के लिए, अपने दैनिक जीवन में इसे कैसे उपयोग किया गया है के वास्तविक उदाहरण दिखाएं। यदि आप दृश्य-ओरिएंटेड हैं, ऐप्लिकेशन की स्थापना कैसे करें जैसे महत्वपूर्ण प्रक्रिया का स्क्रीन कैप्चर बनाने का विचार करें। समुदाय के साथ काम करें ओपन सोर्स केवल कोड के बारे में होता है वही नहीं है। समुदाय ओपन सोर्स को कामयाब बनाता है। यहां वह तरीके हैं जिनसे आप उसे मजबूत कर सकते हैं। 12. **सवाल का जवाब दें**: समुदाय को बनाने की सबसे अच्छी विधि है दूसरों की मदद करना। एक सवाल का जवाब देना, विशेष रूप से जब उसे शुरुआती तरीके से अभी अभी समझने वाले व्यक्ति से पूछा जाता है, परियोजना को बढ़ाने और मांगलिक बनाने में महत्वपूर्ण होता है। आपका समय जो आप एक शुरुआत करने वाले की मदद करने में लगाते हैं, यद्यपि वे एक सवाल पूछ रहे हों जहां आप आसानी से तेज़ी से "RTFM" लौटा सकते हैं, तो आपको बाद में समुदाय का एक और सक्रिय सदस्य प्राप्त करने में लाभ मिलता है। हर कोई कहीं ना कहीं से शुरुआत करता है, और परियोजनाएं जीवंत रहने के लिए निरंतर लोगों के प्रवाह की आवश्यकता होती है। 13. **ब्लॉग पोस्ट लिखें**: यदि आपके पास एक ब्लॉग है, तो उस परियोजना के साथ अपने अनुभवों के बारे में लिखें जिसका आप उपयोग कर रहे हैं। सॉफ़्टवेयर का उपयोग करते समय आपने किसी समस्या का सामना किया हो तो उसके समाधान के बारे में बताएं। आप दो तरीकों से मदद कर रहे होंगे, एक तो आप उस परियोजना को आपके चारों ओर रखने में मदद कर रहे होंगे, और दूसरा, आपकी समस्या को भविष्य में किसी और द्वारा खोजने पर जवाब देने के लिए वेब खोज करने वालों के लिए एक रिकॉर्ड बना रहें होंगे। (एक आपके तकनीकी एडवेंचर का ब्लॉग उस सॉफ़्टवेयर के साथ वास्तविक दुनिया के अनुभव को दिखाने का एक उत्कृष्ट तरीका हो सकता है जब आप उसका उपयोग करके नौकरी की तलाश में जाते हैं)| 14. **वेबसाइट में सुधार करें**: यदि आपके पास वेब डिज़ाइन के कौशल हैं और आप सहायता करने के लिए वेबसाइट को और इस प्रकरण में प्रोजेक्ट की जनता के सामने छवि को सुधार सकते हैं, तो यह समय बहुत अच्छा बिताया गया होता है। शायद परियोजना को एक ग्राफ़िक बदल चाहिए, या परियोजना को पहचानने के लिए एक लोगो। ये सामग्री उन योग्यताओं की कमी हो सकती है जो समुदाय में नहीं हैं। मुझे यह जानकर खुशी होगी कि अगर मेरे परियोजनाओं की वेबसाइटों पर ग्राफ़िक डिज़ाइन मदद मिल सके। सबसे अधिक महत्वपूर्ण बात यह है कि आप चारों ओर के लोगों के बीच की चर्चा क्या है, इसे सुनें। यदि आप किसी महत्वपूर्ण आवश्यकता को पहचान सकते हैं, तो यह बड़ी बात हो सकती है। उदाहरण के लिए, हाल ही में पैरॉट डेवलपर्स के मेलिंग सूची पर त्रुटि टिकट सिस्टम के रूप में GitHub का उपयोग करने का निर्णय लिया गया, जहां वे पहले वाले Trac स्थापना को छोड़ रहे थे। कुछ लोग इस हरकत के खिलाफ थे क्योंकि उन्हें टिकट को GitHub के सिस्टम में परिवर्तित करने का कोई तरीका नहीं था। एक दिन की बहस के बाद, मैंने उठाने की कोशिश की और कहा "क्या अगर मैं एक कनवर्टर लिखता हूं?" लोग इस विचार से बहुत खुश थे। मैंने 450+ टिकटों के लिए एक कनवर्टर प्रोग्राम लिखने का समय बिताया, इसलिए हमारी टिकट इतिहास में से कोई भी खोने की समस्या नहीं हुई। यह एक बड़ी सफलता थी। मैंने सहयोग किया, और कोर डेवलपर्स पैरॉट पर काम करने के लिए केंद्रित रहे। ================================================ FILE: docs/additional-material/translations/Hindi/Useful-links-for-further-learning.hi.md ================================================ # उपयोगी लिंक्स यह लेख उन सभी युक्तियों और युक्तियों वाली वेबसाइटों, ब्लॉग पोस्टों और सहायक साइटों को समर्पित है जो हमारे जीवन को आसान बनाती हैं। वे हमारी सभी जरूरतों को पूरा करने के लिए एक महान संदर्भ हैं, चाहे वह नौसिखिया हो या विशेषज्ञ। इस पृष्ठ को उन सभी उपयोगी लिंक के सूचकांक के रूप में कार्य करना चाहिए जो ओपन-सोर्स डोमेन में नए लोगों या किसी ऐसे व्यक्ति की मदद करेगा जो अधिक सीखना चाहता है। ## सूची 1. [गिट के लिए इंटरैक्टिव ट्यूटोरियल](https://try.github.io) 2. [यूट्यूब: फ़्रीकोडकैंप द्वारा शुरुआती लोगों के लिए Git और GitHub](https://www.youtube.com/watch?v=RGOj5yH7evk) 3. [git - सरल मार्गदर्शक](http://rogerdudler.github.io/git-guide/) 4. [गिट में कमिट को पूर्ववत करना, ठीक करना या हटाना](http://sethrobertson.github.io/GitFixUm/fixup.html) 5. [Git और GitHub ट्यूटोरियल का कई भाषाओं में अनुवाद किया गया](https://github.com/Roshanjossey/first-contributions) 6. [संघर्षों को मर्ज करें](https://www.git-tower.com/learn/git/ebook/en/command-line/advanced-topics/merge-conflicts) 7. [मर्ज विवादों का समाधान](https://githowto.com/resolving_conflicts) 8. [Git की मूल बातें - सरल त्वरित प्रारंभ मार्गदर्शिका](https://blog.praveen.science/basics-of-git-the-quick-start-guide/) 9. [Spotify एजाइल मेथडोलॉजी के हमारे तरीके में Git मानकों का पालन किया गया](https://blog.praveen.science/git-standards-followed-in-our-way-of-spotify-agile-methodolgy/) 10. [गिट शॉर्टकट](https://blog.praveen.science/git-shortcuts/) 11. [कई भाषाओं में आधिकारिक Git चीट शीट](https://services.github.com/on-demand/resources/cheatsheets) 12. [टॉवर से गिट चीट शीट](https://www.git-tower.com/learn/cheat-sheets/git) 13. [सामान्य गिट समस्याएँ](https://www.codementor.io/citizen428/git-tutorial-10-common-git-problems-and-how-to-fix-them-aajv0katd) 14. [Git रिबेस](https://blog.gitprime.com/git-rebase-an-illustrated-guide/) 15. [रीबेस और स्क्वैष करना सीखें](https://github.com/servo/servo/wiki/Beginner%27s-guide-to-rebasing-and-squashing) 16. [Git चीटशीट जो कमांड और फ़ाइलों के बीच संबंध दिखाती है](http://ndpsoftware.com/git-cheatsheet.html) 17. [कैसे योगदान करें](https://opensource.guide/how-to-contribute/) 18. [ओपन सोर्स के साथ शुरुआत करें](https://github.com/OpenSourceHelpCommunity/Getting-Started-With-Contributing-to-Open-Sources) 19. [कैसे योगदान करें](https://github.com/freeCodeCamp/how-to-contribute-to-open-source) 20. [एटलसियंस गिट ट्यूटोरियल](https://www.atlassian.com/git) 21. [पुल अनुरोध समीक्षा](https://help.github.com/articles/about-pull-request-reviews/) 22. [गिट के लिए एक और इंटरैक्टिव ट्यूटोरियल](https://learngitbranching.js.org/) 23. [गिट कमांडलाइन चीट-शीट](https://gist.github.com/davfre/8313299) 24. [प्रोग्रामिंग के लिए पुस्तकें](https://github.com/EbookFoundation/free-programming-books) 25. [पेशेवर युक्तियों और रहस्यों की ई-पुस्तक](https://goalkicker.com/GitBook/GitProfessionalTipsSecrets.pdf) 26. [गिट पेशेवर बनने के सरल नियमों के बारे में ट्यूटोरियल](https://medium.freecodecamp.org/follow-these-simple-rules-and-youll-become-a-git-and-github-master-e1045057468f) 27. [Git कम्मिट संदेशों के बारे में एक नोट](https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) 28. [बेहतर कम्मिट संदेश के लिए 5 उपयोगी युक्तियाँ](https://thoughtbot.com/blog/5-useful-tips-for-a-better-commit-message) 29. [Git का उपयोग करके वरज़न कंट्रोल](https://ourcodingclub.github.io/2017/02/27/git.html) 30. [Git के साथ वरज़न कंट्रोल](https://www.udacity.com/course/version-control-with-git--ud123) 31. [Google से कौरसेरा पाठ्यक्रम का ऑडिट करें](https://www.coursera.org/learn/introduction-git-github) 32. [वीएस कोड में वरज़न कंट्रोल का उपयोग करना](https://code.visualstudio.com/docs/editor/versioncontrol) 33. [Git बनाम Github: क्या अंतर है और दोनों के साथ कैसे शुरुआत करें](https://kinsta.com/knowledgebase/git-vs-github/) 34. [हेलो वर्ल्ड GitHub गाइड](https://guides.github.com/activities/hello-world/) 35. [GitHub का उपयोग कैसे करें](https://www.edureka.co/blog/how-to-use-github/) 36. [Git और Github के 10 दिन](https://github.com/Asabeneh/10-days-of-git-and-github) 37. [GitHub के लिए कीबोर्ड शॉर्टकट](https://docs.github.com/en/get-started/using-github/keyboard-shortcuts) 38. [संपूर्ण Git और GitHub ट्यूटोरियल कुणाल कुशवाह द्वारा](https://www.youtube.com/watch?v=apGV9Kg7ics&ab_channel=KunalKushwaha) 39. [गिट वर्कफ़्लो चीट शीट](https://drive.google.com/uc?export=download&id=1QPRh5YmqQm4DFfitelPYlBTWC2I6tTTM) और अधिक लिंक जोड़ते रहें, जो आपको उपयोगी लगें। ================================================ FILE: docs/additional-material/translations/Hindi/add-file.hi.md ================================================ ## एक नई फ़ाइल जोड़ने का ट्यूटोरियल यदि आप एक नई फ़ाइल को अपने Git रिपॉज़िटरी में जोड़ना चाहते हैं, तो यह ट्यूटोरियल आपकी मदद करेगा। 1. **नई फ़ाइल बनाएं**: - अपने प्रोजेक्ट फ़ोल्डर में जाएं। - नई फ़ाइल बनाने के लिए अपने पसंदीदा टेक्स्ट संपादक का उपयोग करें या आपका कोई IDE हो तो वहां से नई फ़ाइल बना सकते हैं। - फ़ाइल को विशेष नाम दें और सहेजें। 2. **फ़ाइल को स्टेज करें**: - टर्मिनल खोलें और रिपॉज़िटरी फ़ोल्डर में जाएं। - नई फ़ाइल को स्टेज करने के लिए निम्नलिखित कमांड का उपयोग करें: ``` git add नया_फ़ाइल.एक्शन ``` 3. **कमिट करें**: - फ़ाइल को स्टेज करने के बाद, एक कमिट बनाएं। - निम्नलिखित कमांड का उपयोग करें: ``` git commit -m "नई फ़ाइल जोड़ी गई" ``` 4. **रिमोट रिपॉज़िटरी में पुश करें**: - आपकी फ़ाइल अब आपके लोकल रिपॉज़िटरी में है। अब इसे रिमोट रिपॉज़िटरी में भेजने के लिए निम्नलिखित कमांड का उपयोग करें: ``` git push दूरस्थ_शाखा ``` - यहाँ "दूरस्थ_शाखा" वह नाम है जिसमें आप फ़ाइल जोड़ना चाहते हैं। अब आपने एक नई फ़ाइल अपने रिपॉज़िटरी में जोड़ दी है। ================================================ FILE: docs/additional-material/translations/Hindi/moving-a-commit-to-a-different-branch.hi.md ================================================ # एक कमिट शाखा को एक अलग शाखा में ले जाना क्या होगा यदि आप कोई बदलाव कमिट करते हैं, और फिर महसूस करें कि आप एक अलग शाखा में हैं? आप इसे कैसे बदल सकते हैं? यह ट्यूटोरियल कवर करता है। ## सबसे मौजूदा काम को मौजूदा शाखा में ले जाना इस काम को करने के लिए, निम्नलिखित कदमों का पालन करें: ``` git reset HEAD~ --soft ``` - आपकी आखिरी कमिट को पूर्ववत करेगा, लेकिन उपलब्ध परिवर्तनों को छोड़ देगा। ``` git stash ``` - आपके निर्देशिका की स्थिति को बचाएगा। ``` git checkout name-of-the-correct-branch ``` - दूसरी शाखा में स्विच करेगा। ``` git stash pop ``` - आखिरी स्टेशेड स्टेटस को हटा देगा। ``` git add ``` - या अलग-अलग फाइलों को एक साथ स्टेज करने का प्रयास करेगा। ``` git commit -m "आपका संदेश यहां" ``` - परिवर्तनों को सुरक्षित करेगा और कमिट करेगा। अब आपके परिवर्तन सही शाखा पर हैं ### सबसे पुराना काम एक नई शाखा में ले जाना इस काम को करने के लिए, निम्नलिखित कदमों का पालन करें: ``` git branch newbranch``` - एक नई शाखा बनाएगा। सभी कमिट को सुरक्षित कर देगा। ``` git reset --hard HEAD~#``` - मास्टर को वापस # कमिट में ले जाएगा। याद रखें, यह काम मास्टर से जा चुका होगा। ``` git checkout newbranch``` - आपके द्वारा बनाई गई शाखा में जाएगा। इसमें सभी कमिट होंगे। याद रखें: कोई भी बदलाव कमिट नहीं किया गया होगा तो वह खो जाएगा। ================================================ FILE: docs/additional-material/translations/Hindi/removing-a-file.hi.md ================================================ Here's the corrected README.md file with improved grammar: # गिट से एक फाइल को हटाना कभी-कभी, आपको किसी फ़ाइल को Git से हटाने की आवश्यकता होती है, लेकिन आप नहीं चाहते कि यह आपके कंप्यूटर से हटा दिया जाए। आप निम्नलिखित कमांड का उपयोग करके इसे प्राप्त कर सकते हैं: ``git rm --cached`` ## इसका क्या मतलब है? Git अब हटाई गई फ़ाइल में किए गए परिवर्तनों का ट्रैकिंग नहीं करेगा। जैसा कि Git को पता होगा, आपने इस फ़ाइल को हटा दिया है। यदि आपने अपने फ़ाइल सिस्टम में फ़ाइल का पता लगाने का प्रयास किया हो, तो आप देखेंगे कि यह अभी भी वहीं है। यह ध्यान दें कि ऊपर के उदाहरण में, ``--cached`` फ़्लैग का प्रयोग किया गया है। अगर हमने इस ध्वज को नहीं जोड़ा होता, तो Git न केवल रेपोसिटरी से, बल्कि आपके फ़ाइल सिस्टम से भी फ़ाइल को हटा देता। यदि आप ``git commit -m "Remove file1.js"`` के साथ इस परिवर्तन को करते हैं और फिर ``git push origin master`` का उपयोग करके दूरस्थ रेपोसिटरी में पुश करते हैं, तो दूरस्थ रेपोसिटरी में फ़ाइल को हटा दिया जाएगा। ## अतिरिक्त विशेषताएँ - यदि आपको एक से अधिक फ़ाइलों को हटाना है, तो आप उन सभी को एक ही कमांड में शामिल कर सकते हैं: ``git rm file1.js file2.js file3.js --cached`` - आप वाइल्डकार्ड (*) का उपयोग करके समान प्रकार की फ़ाइलों को हटाने के लिए उपयोग कर सकते हैं। उदाहरण के लिए, यदि आप अपने स्थानीय भंडार से सभी .txt फ़ाइलों को हटाना चाहते हैं: ``git rm *.txt --cached`` ================================================ FILE: docs/additional-material/translations/Hindi/removing-branch-from-your-repository.hi.md ================================================ # अपने रिपॉजिटरी से एक शाखा निकालें यदि आपने अब तक ट्यूटोरियल का पालन किया है, तो हमारी `` शाखा ने अपना उद्देश्य पूरा कर लिया है, अब यह आपके स्थानीय मशीन के रेपो से इसे हटाने का समय है। यह आवश्यक नहीं है, लेकिन इस शाखा का नाम इसके बजाय विशेष उद्देश्य दिखाता है। इसका जीवन संगत रूप से छोटा हो सकता है। सबसे पहले, अपने मास्टर में अपने `` को मर्ज करें, इसलिए अपनी मास्टर शाखा पर जाएं: ``` git checkout master ``` उसके बाद मास्टर में ``मर्ज करें: ``` git merge master ``` फिर अपने स्थानीय मशीन के रेपो से `` निकालें: ``` git branch -d ``` अब आपने अपनी स्थानीय मशीन की `` शाखा हटा दी है और सब कुछ साफ़ सुथरा लग रहा है। हालांकि, इस समय, आपके पास अभी भी आपके गिटहब फोर्क में `` शाखा होनी चाहिए। हालांकि, इससे पहले कि आप इसे हटा दें, याद रखें कि आपने इस रिमोट शाखा से अपने रेपो को "पुल रिक्वेस्ट" भेजा है। इसलिए जब तक कि मैं इसे मर्ज नहीं करता हूं, इस शाखा को न हटाएं। हालांकि, अगर मैंने आपकी शाखा मर्ज कर ली है और आप रिमोट शाखा को हटाना चाहते हैं, तो इसका उपयोग करें: ``` git push origin --delete ``` अब, आप जानते हैं कि अपनी शाखाओं को कैसे साफ किया जाए। समय के साथ, मेरे सार्वजनिक रिपो में कई रेपो जोड़े जाएंगे। और आपकी स्थानीय मशीन और आपके गिटहब फर्क की मास्टर शाखाएं अद्यतित नहीं होंगी। तो अपने रेपोसिटोरिएस को मेरे साथ सिंक्रनाइज़ करने के लिए, नीचे दिए गए चरणों का पालन करें। #### [अपने फोर्क को रिपॉजिटरी के साथ सिंक रखना] (keeping-your-fork-synced-with-this-repository.md) ================================================ FILE: docs/additional-material/translations/Hindi/resetting-a-branch.hi.md ================================================ # एक शाखा रीसेट करें ```reset``` वह कमांड है जिसका उपयोग तब किया जा सकता है जब हम किसी कमिट या शाखा के संबंध में रिपॉजिटरी को रीसेट करना चाहते हैं। एक रीसेट, जैसा कि नाम से पता चलता है, वर्तमान शाखा पर सब कुछ त्याग देता है और इसे उस शाखा के समान बना देता है जिसके साथ हमने आधार शाखा को रीसेट करना चुना (इसे मूल शाखा भी कहा जाता है)। इसका अनिवार्य रूप से मतलब यह है कि हमारे पास मूल शाखा के नाम के साथ मूल शाखा की एक कॉपी होगी।
हालाँकि, सवाल यह है कि हम आधार शाखा को क्यों नहीं हटा देते हैं और मूल शाखा से आधार शाखा के नाम से एक नई शाखा क्यों नहीं चेकआउट कर देते हैं। तकनीकी रूप से, इसका प्रभाव रीसेट करने जैसा ही होगा लेकिन कुछ औद्योगिक स्थितियों में हमारे पास किसी शाखा को हटाने की पहुंच नहीं है, या हम किसी शाखा को हटा नहीं सकते हैं क्योंकि यह सीआई/सीडी पाइपलाइन या शायद चल रहे वर्कफ़्लो को बाधित/बाधित कर देगा। इसलिए, ऐसी स्थितियों से बचने के लिए जो डाउनटाइम का कारण बन सकती हैं, हम सुझाव देते हैं कि जब भी हम किसी विशेष शाखा को रीसेट करना चाहते हैं तो `git reset` का उपयोग करें। ## कम्मांड शाखा के लिए गिट रीसेट निष्पादित करना बहुत आसान है। ``` git reset ``` उदाहरण के तौर पर: ``` git reset stage master --hard ``` उपरोक्त कमांड `stage` शाखा को `master` के साथ रीसेट कर देगा और इसलिए `stage` को बिल्कुल `master` के समान बना देगा। आप सोच रहे होंगे कि `--hard` फ्लैग का उपयोग क्यों किया जाता है? इसका उद्देश्य उन सभी परिवर्तनों को अनदेखा करना है जो रीसेट से पहले/बाद में होंगे या होंगे। ================================================ FILE: docs/additional-material/translations/Hindi/resetting-a-commit.hi.md ================================================ # कमिट रीसेट करें ```reset``` वह कमांड है जिसका उपयोग तब किया जा सकता है जब हम रिपॉजिटरी को पिछली कमिट में वापस ले जाना चाहते हैं, उस कमिट के बाद किए गए किसी भी बदलाव को छोड़कर।
किसी कमिट को रीसेट करने और वापस लाने के बीच मुख्य अंतर यह है कि git रीसेट ```फ़ाइल को अनस्टेज करता है और हमारे परिवर्तनों को कार्यशील निर्देशिका में वापस लाता है``` और git revert ```रिमोट रिपॉजिटरी से कमिट्स को हटा देता है```।
```git reset``` निम्नलिखित कमांड का उपयोग करके प्राप्त किया जा सकता है: - निम्नलिखित कमांड निम्नलिखित दो मापदंडों का उपयोग करके सभी कमिटों का सारांश देगा: - कमिट हैश के पहले सात अक्षर - यही वह है जिसे हमें अपने **reset** कमांड में संदर्भित करना होगा। - प्रतिबद्ध संदेश ``` git log --oneline ``` - कोई निम्नलिखित कमांड का उपयोग करके रिपॉजिटरी को विशिष्ट कमिट पर वापस रीसेट कर सकता है:
```गिट रीसेट कमिटहैश``` जहां कमिटहैश कमिट हैश के पहले 7 अक्षर हैं जो हमें लॉग में मिले| ================================================ FILE: docs/additional-material/translations/Indonesian/Things a non Programmer can do.id.md ================================================ # Hal-hal yang dapat dilakukan oleh non Programmer ## Mulai mendengarkan Semua yang ada di open source melibatkan orang lain. Anda ingin bergabung dengan sebuah tim, dan itu berarti memahami komunitas dan cara kerjanya. Datang ke sebuah proyek dan berkata “Hai, inilah yang saya pikir harus dilakukan oleh proyek ini” biasanya tidak dianggap sebagai hal yang baik. Beberapa proyek mungkin akan menerima pendekatan semacam itu, tetapi jika proyek tersebut sudah berjalan cukup lama, kemungkinan sikap tersebut akan kecil. **Mendengarkan adalah cara terbaik untuk mengetahui apa yang dibutuhkan oleh proyek.**. 1. **Bergabunglah dengan milis**: Untuk banyak proyek, milis adalah saluran utama komunikasi tentang perkembangan proyek. Pada proyek-proyek besar, ada banyak milis yang dapat dipilih. Sebagai contoh, proyek PostgreSQL memiliki tidak kurang dari 12 milis berorientasi pengguna dan enam milis pengembang pada halaman milisnya. Saya sarankan Anda mengikuti milis berorientasi pengguna utama dan milis pengembang inti untuk mulai menyimak. 2. **Mengikuti sebuah blog: Blog yang dikelola oleh pengembang inti sering kali memberikan informasi tentang apa yang akan hadir di rilis mendatang, dan apa yang diperlukan untuk mencapainya. Situs planet mengumpulkan berita dan entri blog dari banyak sumber yang terkait dengan proyek. Jika ada situs planet, seperti planet.gnome.org atau planet.mysql.com, mulailah dari sana. Cari saja di Google dengan kata kunci “planet .” 3. **Bergabunglah dengan saluran IRC**: Banyak proyek open source memiliki saluran khusus Internet relay chat (IRC) di mana para pengembang dan pengguna berkumpul untuk mendiskusikan **Bekerja dengan Tiket** Kode adalah jantung dari setiap proyek open source, tetapi jangan berpikir bahwa menulis kode adalah satu-satunya cara untuk berkontribusi. Pemeliharaan kode dan sistem yang mengelilingi kode sering kali terabaikan karena terburu-buru untuk membuat fitur baru dan memperbaiki bug. Lihatlah area-area ini sebagai cara mudah untuk masuk ke dalam sebuah proyek. Sebagian besar proyek memiliki sistem tiket masalah yang dapat dilihat oleh publik, ditautkan dari halaman depan situs web proyek dan disertakan dalam dokumentasi. Ini adalah saluran utama komunikasi antara pengguna dan pengembang. Menjaga agar tetap mutakhir adalah cara yang bagus untuk membantu proyek. Anda mungkin perlu mendapatkan izin khusus dalam sistem tiket, yang sebagian besar pemimpin proyek akan dengan senang hati memberikannya kepada Anda ketika Anda mengatakan ingin membantu membersihkan tiket. 4. **Mendiagnosis bug**: Bug sering kali tidak dilaporkan dengan baik. Mendiagnosis dan melakukan triase terhadap bug dapat membantu menghemat waktu pengembang untuk mencari tahu secara spesifik masalahnya. Jika pengguna melaporkan, “Perangkat lunak tidak berfungsi ketika saya melakukan X,” luangkan waktu untuk mencari tahu secara spesifik apa yang menyebabkan masalah tersebut. Apakah masalah tersebut dapat diulang? Dapatkah Anda membuat serangkaian langkah yang menyebabkan masalah berulang kali? Dapatkah Anda mempersempit masalahnya, misalnya hanya terjadi pada satu browser tetapi tidak pada browser lainnya, atau satu distro tetapi tidak pada distro lainnya? Meskipun Anda tidak tahu apa yang menyebabkan masalah, upaya yang Anda lakukan untuk mempersempit masalah akan memudahkan orang lain untuk memperbaikinya. Apa pun yang Anda temukan, tambahkan ke tiket di sistem bug agar semua orang dapat melihatnya. 5. **Tutup bug yang sudah diperbaiki**: Sering kali bug diperbaiki di basis kode tetapi tiket yang dilaporkan tidak diperbarui di sistem tiket. Membersihkan kesalahan ini dapat memakan waktu, tetapi sangat berharga bagi keseluruhan proyek. Mulailah dengan menanyakan sistem tiket untuk tiket yang lebih tua dari satu tahun dan lihat apakah bug masih ada. Periksa log perubahan rilis proyek untuk melihat apakah bug telah diperbaiki dan dapat ditutup. Jika diketahui sudah diperbaiki, catat nomor versi di tiket dan tutup. Coba buat ulang bug dengan versi terbaru perangkat lunak. Jika tidak dapat dibuat ulang dengan versi terbaru, catat dalam tiket dan tutup. Jika masih ada, catat juga di tiket dan biarkan terbuka. Bekerja dengan Kode Programmer dari semua tingkat pengalaman dapat membantu dengan kode dalam proyek. Jangan berpikir bahwa Anda harus menjadi seorang jenius pengkodean untuk memberikan kontribusi nyata pada proyek favorit Anda. Jika pekerjaan Anda melibatkan modifikasi kode, selidiki metode yang digunakan proyek untuk mendapatkan kode dari kontributor. Setiap proyek memiliki alur kerjanya sendiri, jadi tanyakan tentang cara melakukannya sebelum Anda mulai mengirimkan kode. Sebagai contoh, proyek PostgreSQL sangat ketat dalam prosesnya: Modifikasi kode dikirim dalam bentuk tambalan ke milis di mana para pengembang inti meneliti setiap aspek perubahan. Di sisi lain adalah proyek seperti Parrot di mana mudah untuk mendapatkan hak komit ke basis kode. Jika proyek menggunakan GitHub, mungkin ada alur kerja yang menggunakan fitur pull request dari GitHub. Tidak ada dua proyek yang sama. Setiap kali Anda memodifikasi kode, pastikan Anda bertindak sebagai anggota komunitas yang bertanggung jawab dan menjaga gaya kode Anda agar sesuai dengan basis kode lainnya. Kode yang Anda tambahkan atau modifikasi harus terlihat seperti yang lainnya. Anda mungkin tidak menyukai gaya bracing atau penanganan spasi untuk lekukan, tetapi tidak sopan untuk mengirimkan perubahan kode yang tidak sesuai dengan standar yang ada. Ini sama saja dengan mengatakan “Saya tidak suka gaya Anda, dan menurut saya gaya saya lebih baik, jadi Anda harus melakukannya dengan cara saya.” 6. **Menguji versi beta atau kandidat rilis**: Setiap proyek yang dirancang untuk berjalan di berbagai platform dapat memiliki berbagai macam masalah portabilitas. Ketika sebuah rilis mendekati dan sebuah beta atau kandidat rilis diterbitkan, pemimpin proyek berharap bahwa hal itu akan diuji oleh banyak orang yang berbeda di berbagai platform. Anda dapat menjadi salah satu dari orang-orang tersebut dan membantu memastikan bahwa paket tersebut bekerja pada platform Anda. Biasanya Anda hanya perlu mengunduh, membangun, dan menguji perangkat lunak, tetapi nilainya bagi proyek bisa sangat besar jika Anda menggunakan distribusi atau perangkat keras yang tidak umum. Hanya dengan melaporkan kembali bahwa pembuatan dan pengujian telah berhasil, akan membantu para pemimpin proyek untuk mengetahui bahwa rilis yang akan datang sudah solid. 7. **Memperbaiki bug**: Ini biasanya merupakan tempat kontributor yang ingin mulai mengerjakan kode. Sederhana saja: Temukan bug yang terdengar menarik dalam sistem tiket dan coba perbaiki dalam kode. Dokumentasikan perbaikannya dalam kode jika sesuai. Sebaiknya tambahkan tes ke dalam test suite untuk menguji bagian kode yang telah Anda perbaiki; beberapa proyek memerlukan perbaikan bug untuk menyertakan tes. Buatlah catatan saat Anda mengutak-atik basis kode yang tidak Anda kenal. Bahkan jika Anda tidak dapat memperbaiki bug, dokumentasikan dalam tiket apa yang Anda temukan sebagai bagian dari upaya perbaikan. Apa yang Anda temukan akan membantu mereka yang datang setelah Anda. 8. **Menulis tes**: Sebagian besar proyek memiliki test suite yang menguji kode, tetapi sulit untuk membayangkan sebuah test suite yang tidak dapat menambahkan lebih banyak tes ke dalamnya. Gunakan alat bantu cakupan pengujian seperti gcov untuk C, atau Devel::Cover untuk Perl untuk mengidentifikasi area dalam kode sumber yang tidak diuji oleh rangkaian pengujian. Kemudian, tambahkan sebuah tes ke dalam rangkaian tes untuk menutupinya. 9. **Diamkan peringatan kompiler**: Proses build untuk banyak proyek berbasis C sering memuntahkan bendera peringatan kompiler yang aneh ke layar. Peringatan ini biasanya bukan merupakan indikator dari sebuah masalah, tetapi bisa terlihat seperti itu. Terlalu banyak peringatan dapat membuat kompiler terdengar seperti serigala yang menangis. Periksa untuk melihat apakah kode tersebut benar-benar menyembunyikan bug. Jika tidak, memodifikasi sumbernya untuk tidak bersuara akan membantu menyembunyikan kesalahan positif ini. 10. **Tambahkan komentar**: Ketika Anda menggali kode, Anda mungkin menemukan beberapa bagian yang membingungkan. Kemungkinan besar jika Anda bingung, orang lain juga akan bingung. Dokumentasikan dalam kode dan kirimkan patch. Bekerja dengan Dokumentasi Dokumentasi biasanya merupakan bagian dari sebuah proyek yang mendapat waktu singkat. Dokumentasi juga dapat mengalami kesulitan karena ditulis dari sudut pandang mereka yang sudah terbiasa dengan proyek tersebut, bukan dari sudut pandang seseorang yang baru saja masuk ke dalamnya. Jika Anda pernah membaca dokumen untuk sebuah proyek di mana Anda berpikir, “Sepertinya manual ini mengharapkan bahwa saya sudah tahu cara menggunakan paket ini,” Anda tahu apa yang saya bicarakan. Seringkali, satu set mata yang segar dapat menunjukkan kekurangan dalam dokumentasi yang tidak disadari oleh mereka yang dekat dengan proyek. 11. **Buatlah sebuah contoh**: Tidak ada proyek yang memiliki terlalu banyak contoh cara. Entah itu API web, pustaka rutinitas, aplikasi GUI seperti Gimp, atau alat baris perintah, contoh penggunaan yang baik dapat menjelaskan penggunaan perangkat lunak dengan lebih jelas dan cepat daripada halaman-halaman dokumentasi. Untuk API atau pustaka, buatlah contoh program yang menggunakan alat tersebut. Ini bahkan dapat diekstrak dari kode yang telah Anda tulis, dipangkas hingga ke hal-hal yang diperlukan. Untuk sebuah alat, tunjukkan contoh dunia nyata tentang bagaimana Anda menggunakannya dalam kehidupan sehari-hari. Jika Anda berorientasi pada visual, pertimbangkan untuk membuat tangkapan layar dari proses penting, seperti cara menginstal aplikasi. Bekerja dengan Komunitas Open source hanya sebagian dari kode. Komunitaslah yang membuat open source bekerja. Berikut adalah cara-cara yang dapat Anda lakukan untuk membantu membangunnya. 12. **Menjawab pertanyaan**: Cara terbaik untuk membantu membangun komunitas adalah dengan membantu orang lain. Menjawab pertanyaan, terutama dari seseorang yang baru saja memulai, sangat penting untuk membantu proyek tumbuh dan berkembang. Waktu yang Anda luangkan untuk membantu seorang pemula, bahkan jika mereka mengajukan pertanyaan di mana Anda dapat dengan mudah menjawab “RTFM” dengan cepat, akan terbayar di kemudian hari dengan mendapatkan anggota aktif lainnya di dalam komunitas. Semua orang memulai dari suatu tempat, dan proyek membutuhkan arus masuk orang yang konstan jika ingin tetap hidup. 13. **Tulislah sebuah postingan blog**: Jika Anda memiliki sebuah blog, tulislah tentang pengalaman Anda dengan proyek yang Anda gunakan. Ceritakan tentang masalah yang Anda hadapi dengan menggunakan perangkat lunak dan apa yang Anda lakukan untuk menyelesaikannya. Anda akan membantu dengan dua cara, yaitu dengan membantu menjaga proyek tetap berada di benak orang lain di sekitar Anda, dan dengan membuat catatan untuk orang lain yang memiliki masalah yang sama dengan Anda di masa depan dan mencari jawabannya di web. (Sebuah blog tentang petualangan teknis Anda juga merupakan cara yang sangat baik untuk menunjukkan pengalaman dunia nyata dengan perangkat lunak yang bersangkutan saat Anda mencari pekerjaan dengan menggunakan perangkat lunak tersebut). 14. **Memperbaiki situs web**: Jika Anda memiliki keahlian dalam desain web dan dapat membantu meningkatkan situs web, dan dengan demikian citra proyek yang dihadapi publik, itu adalah waktu yang dihabiskan dengan baik. Mungkin proyek tersebut dapat menggunakan perbaikan grafis, atau logo untuk mengidentifikasi proyek. Hal ini mungkin merupakan keterampilan yang kurang dimiliki oleh komunitas. Saya tahu saya akan sangat senang jika saya bisa mendapatkan bantuan desain grafis di situs web proyek saya. 15. **Menulis dokumentasi teknis** Jika Anda dapat menulis tentang bagaimana sebuah aplikasi atau perangkat lunak bekerja, Anda dapat menulis dokumentasi teknis tentangnya. Terutama proyek-proyek open source yang ingin memperbarui, mengubah, memperluas, atau membuat dokumen teknis untuk dibaca oleh masyarakat umum. Semakin banyak Anda menulis dalam bahasa Inggris, semakin baik. Bagian terbaiknya, Anda tidak harus menjadi seorang programmer untuk menulis dokumen teknis. Yang terpenting, dengarkan apa yang orang-orang di sekitar Anda diskusikan. Lihat apakah Anda dapat mengenali kebutuhan yang mendesak. Sebagai contoh, baru-baru ini di milis pengembang Parrot, diputuskan untuk menggunakan GitHub sebagai sistem tiket masalah, meninggalkan instalasi Trac lama yang mereka miliki. Beberapa orang menentang langkah tersebut karena tidak ada cara untuk mengubah tiket ke sistem GitHub. Setelah seharian berdebat, saya akhirnya berkata, “Bagaimana jika saya menulis konverter?” Orang-orang sangat senang dengan ide tersebut. Saya menghabiskan waktu untuk menulis program konversi untuk 450+ tiket, jadi kami tidak kehilangan riwayat tiket kami. Itu adalah sebuah kesuksesan besar. Saya bisa ikut serta, dan para pengembang inti tetap fokus pada bisnis pengerjaan Parrot. 16. **Mengajar dan Membantu orang lain**: Cara terbaik untuk mempelajari lebih lanjut tentang suatu topik adalah dengan mencoba mengajarkannya. Guru terbaik adalah guru yang dapat menjelaskan hal-hal yang rumit dengan contoh-contoh sederhana. Jadi, Anda perlu mencoba menjadi guru terbaik untuk menjadi pelajar terbaik dan yang terbaik di dunia pemrograman Anda. Mengajar orang lain akan membuat Anda merasa lebih baik tentang diri Anda sendiri dan akan membantu Anda mendapatkan keterampilan dan pengetahuan yang lebih baik dalam profesi Anda. Ketika Anda mendapatkan bantuan dari seseorang, jangan menyimpannya sendiri, tetapi bagikanlah dengan orang lain. Jadikan dunia tempat yang lebih baik untuk ditinggali. ================================================ FILE: docs/additional-material/translations/Indonesian/Useful-links-for-further-learning.id.md ================================================ # Tautan-tautan Bermanfaat Dokumen ini didedikasikan untuk semua situs web tips dan trik, postingan blog, dan situs bermanfaat yang membuat hidup kita lebih mudah. Ini adalah referensi yang bagus untuk memenuhi semua kebutuhan kita, baik itu pemula maupun ahli. Halaman ini berisi indeks dari semua tautan berguna yang akan membantu semua pemula dalam domain sumber terbuka atau seseorang yang ingin mempelajari lebih lanjut. ## Daftar Isi 1. [Tutorial git interaktif](https://try.github.io) 2. [Youtube: Git dan GitHub untuk pemula oleh freecodecamp](https://www.youtube.com/watch?v=RGOj5yH7evk) 3. [Git - panduan sederhana](http://rogerdudler.github.io/git-guide/) 4. [Tentang mengembalikan, menyesuaikan, atau menghapus commit pada git](http://sethrobertson.github.io/GitFixUm/fixup.html) 5. [Git and GitHub terjemahan tutorial untuk banyak bahasa](https://github.com/Roshanjossey/first-contributions) 6. [Konflik Merge](https://www.git-tower.com/learn/git/ebook/en/command-line/advanced-topics/merge-conflicts) 7. [Memperbaiki Konflik Merge](https://githowto.com/resolving_conflicts) 8. [Dasar - Dasar Git - Panduan cepat dan sederhana](https://blog.praveen.science/basics-of-git-the-quick-start-guide/) 9. [Standar - Standar Git menurut Agile Methodology Spotify](https://blog.praveen.science/git-standards-followed-in-our-way-of-spotify-agile-methodolgy/) 10. [Pintasan pada Git](https://blog.praveen.science/git-shortcuts/) 11. [Contekan Git resmi semua bahasa](https://services.github.com/on-demand/resources/cheatsheets) 12. [Contekan Git dari Tower](https://www.git-tower.com/learn/cheat-sheets/git) 13. [Permasalahan Umum Git](https://www.codementor.io/citizen428/git-tutorial-10-common-git-problems-and-how-to-fix-them-aajv0katd) 14. [Rebase pada Git](https://blog.gitprime.com/git-rebase-an-illustrated-guide/) 15. [Panduan Pemula untuk melakukan Rebase dan Squash](https://github.com/servo/servo/wiki/Beginner%27s-guide-to-rebasing-and-squashing) 16. [Contekan Git yang menunjukan korelasi antara perintah dan file](http://ndpsoftware.com/git-cheatsheet.html) 17. [Bagaimana Cara Berkontribusi](https://opensource.guide/how-to-contribute/) 18. [Memulai dengan Sumber Terbuka](https://github.com/OpenSourceHelpCommunity/Getting-Started-With-Contributing-to-Open-Sources) 19. [Bagaimana Cara Berkontribusi](https://github.com/freeCodeCamp/how-to-contribute-to-open-source) 20. [Tutorial Git Atlassians](https://www.atlassian.com/git) 21. [Tinjauan permintaan Pull](https://help.github.com/articles/about-pull-request-reviews/) 22. [Tutorial Interaktif lainnya untuk git](https://learngitbranching.js.org/) 23. [Contekan baris perintah pada Git](https://gist.github.com/davfre/8313299) 24. [Buku - Buku Pemrograman](https://github.com/EbookFoundation/free-programming-books) 25. [E-Book untuk profesional tip and rahasia](https://goalkicker.com/GitBook/GitProfessionalTipsSecrets.pdf) 26. [Tutorial tentang cara sederhana menjadi profesional git](https://medium.freecodecamp.org/follow-these-simple-rules-and-youll-become-a-git-and-github-master-e1045057468f) 27. [Sebuah catatan tentang Pesan Git Commit](https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) 28. [5 Tip Berguna Untuk Pesan Commit yang baik](https://thoughtbot.com/blog/5-useful-tips-for-a-better-commit-message) 29. [Kontrol Versi menggunakan Git](https://ourcodingclub.github.io/2017/02/27/git.html) 30. [Kontrol Versi dengan Git](https://www.udacity.com/course/version-control-with-git--ud123) 31. [Memeriksa kursus Coursera dari Google](https://www.coursera.org/learn/introduction-git-github) 32. [Menggunakan Kontrol Versi pada VS Code](https://code.visualstudio.com/docs/editor/versioncontrol) 33. [Git vs Github: Apa Perbedaannya dan Bagaimana cara menggunakan keduanya](https://kinsta.com/knowledgebase/git-vs-github/) 34. [Panduan Hello World Github](https://guides.github.com/activities/hello-world/) 35. [Bagaimana cara menggunakan GitHub](https://www.edureka.co/blog/how-to-use-github/) 36. [10 Hari tentang Git and Github](https://github.com/Asabeneh/10-days-of-git-and-github) 37. [Pintasan Keyboard untuk Github](https://docs.github.com/en/get-started/using-github/keyboard-shortcuts) 38. [Tutorial Lengkap Git and GitHub oleh Kunal Kushwaha](https://www.youtube.com/watch?v=apGV9Kg7ics&ab_channel=KunalKushwaha) Tambahkan tautan baru yang menurut Anda dapat membantu. ================================================ FILE: docs/additional-material/translations/Indonesian/additional-material.id.md ================================================ # Informasi tambahan Kami berasumsi Anda sudah menyelesaikan tutorial dasar sebelum datang ke sini. Dokumen ini akan memberikan beberapa informasi mengenai teknik Git yang lebih tinggi. ### [Hapus cabang dari repositori Anda](removing-branch-from-your-repository.id.md) Dokumen ini memberikan informasi mengenai bagaimana menghapus sebuah cabang dari repositori Anda. > Lakukan langkah ini setelah pull request Anda digabungkan (merge). ### [Agar fork Anda tetap sinkron dengan repositori](keeping-your-fork-synced-with-this-repository.md) Dokumen ini memberikan informasi mengenai bagaimana agar repositori yang kita fork tetap up-to-date dengan repositori dasar. Hal ini penting, karena bisa jadi Anda dan banyak kontributor lain berkontribusi dalam proyek tersebut. > Ikuti langkah-langkahnya jika fork Anda tidak punya perubahan dengan repositori induk. ### [Membatalkan commit](reverting-a-commit.md) Dokumen ini memberikan informasi bagaimana caranya membatalkan commit di repositori remote. Langkah ini perlu jika sewaktu-waktu Anda harus membatalkan sebuah commit yang telanjur sudah didorong ke GitHub. > Ikuti langkah-langkahnya untuk membatalkan sebuah commit. ### [Mengubah sebuah commit](amending-a-commit.md) Dokumen ini memberikan informasi mengenai cara mengubah sebuah commit di repositori remote. > Gunakan ini ketika kamu harus mengubah commit yang sudah dibuat. ### [Membatalkan commit lokal](undoing-a-commit.md) Dokumen ini memberikan informasi mengenai cara membatalkan sebuah commit di repositori lokal Anda. Hal ini diperlukan ketika Anda berpikir sudah merusak repositori lokal dan ingin me-reset repositori tersebut. > Lakukan cara ini jika ingin membatalkan/reset commit di lokal. ### [Mengatasi Merge Conflicts](resolving-merge-conflicts.md) Dokumen ini memberikan informasi mengenai cara mengatasi saat terjadi konflik ketika melakukan merge. > Lakukan langkah tersebut untuk mengatasi konflik merge yang mengganggu. ### [Menghapus sebuah berkas](removing-a-file.id.md) Dokumen ini memberikan informasi mengenai cara menghapus sebuah berkas dari repositori lokal. > Ikuti langkah tersebut untuk mempelajari bagaimana menghapus sebuah berkas sebelum di-commit. ### [Memindahkan Commit ke Cabang berbeda](moving-a-commit-to-a-different-branch.md) Dokumen ini memberikan informasi mengenai cara memindahkan sebuah commit ke cabang lain. > Ikuti langkah tersebut untuk memindahkan sebuah commit ke cabang lain. ### [Mengkonfigurasi git](configuring-git.md) Dokumen ini memberikan informasi mengenai cara mengkonfigurasi detail pengguna dan opsi lain di git. > Gunakan langkah ini agar konfigurasi git Anda menjadi lebih baik. ### [Tautan bermanfaat](Useful-links-for-further-learning.id.md) Dokumen ini didedikasikan untuk semua pos blog, laman yang sangat membantu, situs tip dan trik yang akan membuat hidup kita lebih mudah. Tautan tersebut tidak hanya untuk pemula, namun juga bagi yang sudah mahir. Halaman ini akan menjadi indeks untuk semua tautan yang bermanfaat yang mungkin saja bisa membantu siapapun yang baru terjun di dunia open-source atau siapapun yang ingin belajar lebih lanjut. ### [Menyatukan banyak Commit](squashing-commits.md) Dokumen ini menyediakan informasi mengenai bagaimana menyederhanakan banyak commit dengan rebase interaktif. > Gunakan ini jika Anda ingin membuka sebuah PR (Pull Request) dalam proyek open source dan periview meminta kamu untuk menyatukan setiap commit menjadi satu, dengan pesan commit yang informatif. ================================================ FILE: docs/additional-material/translations/Indonesian/removing-a-file.id.md ================================================ # Menghapus file Terkadang Anda ingin menghapus file dari Git, tetapi Anda tidak ingin menghapusnya dari komputer Anda. Anda dapat melakukan ini dengan menggunakan perintah berikut: `git rm --cached` ## Apa yang terjadi? Git tidak akan lagi melacak perubahan pada file yang dihapus. Bagi Git, file ini sudah tidak ada lagi. Jika Anda mencari file tersebut di disk Anda, Anda melihat bahwa file itu masih ada. Pada contoh di atas, kita menggunakan flag `--cached`. Jika kita tidak menggunakannya, Git juga akan menghapus file tersebut dari disk kita. Jika sekarang kita membuat komit dengan `git commit -m "Hapus file1.js"` dan mengirimkannya ke repositori jarak jauh dengan perintah `git push origin master`, file tersebut juga akan dihapus dari repositori jarak jauh. ## Opsi tambahan - Jika Anda ingin menghapus beberapa file, Anda dapat menyertakan semuanya dalam satu perintah: `git rm file1.js file2.js file3.js --cached` - Anda dapat menggunakan wildcard (\*) untuk menghapus file serupa. Misalnya, untuk menghapus semua file .txt dari repositori Anda, gunakan perintah: `git rm *.txt --cached` ================================================ FILE: docs/additional-material/translations/Indonesian/removing-branch-from-your-repository.id.md ================================================ # Remove a branch from your repository If you have followed the tutorial up-to-now, our `` branch has finished its purpose, it is time to delete it from your local machine's repo. This isn't necessary, but the name of this branch shows its rather special purpose. Its life can be made correspondingly short. First, let's merge your `` to your master, so to go to your master branch: ``` git checkout master ``` Merge `` to master: ``` git merge master ``` Remove `` on your local machine's repo: ``` git branch -d ``` You have now deleted your local machine's `` branch and everything looks neat and tidy. Though, at this point, you should still have the `` branch in your GitHub fork. However, before you delete this, remember that you have sent a "Pull request" to my repo from this remote branch. So unless I've already merged it, don't delete this branch. However, if I have merged your branch and you want to delete the remote branch, use: ``` git push origin --delete ``` Now, you know how to tidy your branches. With time, many commits will be added to my public repo. And the master branches of your local machine and of your GitHub fork won't be up-to-date. So in order to keep your repositories synchronized with mine, follow the steps below. #### [Keeping your fork synced with the repository](keeping-your-fork-synced-with-this-repository.md) ================================================ FILE: docs/additional-material/translations/Indonesian/resetting-a-commit.id.md ================================================ # Mengatur Ulang Sebuah commit `git reset` adalah perintah yang dapat digunakan ketika kita ingin memindahkan repositori kembali ke _commit_ sebelumnya, membuang semua perubahan yang dibuat setelah _commit_ tersebut.
Perbedaan utama antara mengatur ulang dan mengembalikan _commit_ adalah bahwa `git reset` menghapus tahapan berkas dan membawa perubahan Anda ke direktori kerja dan `git revert` menghapus _commit_ dari repositori remote.
`git reset` dapat dicapai dengan menggunakan perintah berikut: - Perintah berikut ini akan memberikan ringkasan dari semua commit dengan menggunakan dua parameter berikut: - Tujuh karakter pertama dari commit hash - inilah yang perlu kita rujuk dalam perintah **reset**. - Pesan commit ``` git log --oneline ``` - Seseorang dapat mengatur ulang repositori kembali ke commit tertentu menggunakan perintah berikut:
`git reset commithash` di mana commithash adalah 7 karakter pertama dari hash commit yang kami temukan di log ================================================ FILE: docs/additional-material/translations/Italian/removing-a-file.it.md ================================================ # Rimuovere un file da Git Può succedere che tu voglia rimuovere un file da Git, mantenendolo comunque nel tuo computer. Lo puoi fare eseguendo questo comando: ``git rm --cached`` ## Cosa fa questo comando? Git non terrà più conto dei cambiamenti inclusi nel file rimosso. Per Git, è come se tu avessi cancellato il file. Se però vai a cercare il file nel tuo sistema, vedrai che comunque è ancora lì. Come vedi, nell'esempio qui sopra viene usato il flag `--cached`. Senza questo flag Git rimuoverebbe il file non solamente dal repository, ma anche dal tuo sistema. Se decidi di validare questo cambiamento con `git commit -m "Remove file1.js"` e successivamente invii le modifiche al repository remoto usando `git push origin master`, vedrai che il repository remoto avrà rimosso il file. ## Funzioni aggiuntive - Per rimuovere più di un file, puoi aggiungerli tutti allo stesso comando in questo modo: `git rm file1.js file2.js file3.js --cached` - Puoi usare il metacarattere asterisco (*) per rimuovere i file simili tra loro. Per esempio, se vuoi rimuovere tutti i file con estensione .txt dal tuo repository locale puoi farlo così: `git rm *.txt --cached` ================================================ FILE: docs/additional-material/translations/Italian/reverting-a-commit.it.md ================================================ # ripristinare una commit Ripristinare (*revert) una commit significa creare una nuova commit che elimina tutti i cambiamenti apportati da quella precedente. È come fare un ```ctrl + Z``` su git. Il ripristino è reso più semplice in git perchè ogni commit che invii (*push) nella tua repository remota ha un'unica chiave alfanumerica associata, questa chiave è chiamata SHA (Secure Hash Algorithm). questo significa che puoi ripristinare una commit fintanto che possiedi la sua chiave SHA. ad ogni modo, bisogna prestare attenzione a ripristinare le commit in modo ordinato in modo da non mettere in disordine la tua repository. Per ottenere la chiave SHA della commit che vuoi ripristinare, viene in aiuto il log di tutte le commit che sono state fatte. per ottenere questo log possiamo utilizzare il comando: ```git log --oneline ``` Usando il comando ```git log``` da solo si ottengono comunque le SHA (in formato lungo) utilizzando però la flag ```--oneline ``` diciamo a git che vogliamo stampare a video un formato conciso (una linea) per facilitare la lettura. I primi 7 caratteri stampati quando esegui questo comando rappresentano un abbreviazione dell'hash della commit. Per esempio, questo è quello che ottengo quando eseguo ```git log --oneline ``` su questa repository: ``` 389004d added spacing in title c1b9fc1 Merge branch 'master' into tutorials 77eaafd added tutorial for reverting a commit ``` Questo esempio dimostra come con ```git log --oneline```, possiamo ottenere la lista di commit fatte sulla repository assieme ai primi 7 caratteri del suo SHA. Supponiamo ora che io voglia ripristinare la commit "added spacing in title", per fare questo seguirei questi passaggi: * Copio lo SHA della commit che, in questo caso è ```389004d``` * poi, eseguo il comando ```git revert 389004d``` Facendo questo si apre il mio editor di testo e mi viene chiesto di modificare il messaggio di commit. Puoi decidere di lasciare il messaggio di default che inizia con la parola `Revert` oppure puoi anche decidere di personalizzare il messaggio come preferisci. * In seguito, salvo il messaggio e chiudo l'editor di testo. * Vengo mandato nella linea di comando. * eseguo ```git push origin ``` per inviare i cambiamenti ripristinati su Github. E questo è tutto, i cambiamenti vengono eliminati. Nel mio caso, la repository viene ripristinata allo stesso stato di com'era in ```c1b9fc1``` ================================================ FILE: docs/additional-material/translations/Japanese/Things a non Programmer can do.ja.md ================================================ プログラマーでなくてもできること 聞くことから始めよう オープンソースはすべて、他の人々を巻き込むことです。 あなたはチームに加わろうとしており、それにはコミュニティとその仕組みを理解する必要があります。 プロジェクトに参加して「こんにちは、このプロジェクトにはこうしたほうがいいと思います」と言うのは、通常あまり歓迎されません。 一部のプロジェクトではそのようなアプローチを歓迎するかもしれませんが、長く続いているプロジェクトでは、その考え方はあまり受け入れられません。 プロジェクトのニーズを理解するには、まず聞くことが最も重要です。 1. メーリングリストに参加する 多くのプロジェクトでは、メーリングリストが開発に関する主なコミュニケーション手段となっています。 大規模なプロジェクトには、複数のメーリングリストがあります。 たとえば、PostgreSQLプロジェクトには、少なくとも12のユーザー向けリストと6つの開発者リストがあります。 主要なユーザー向けと開発者向けリストをフォローし、まずは「聞くこと」から始めましょう。 2. ブログをフォローする 主要な開発者が運営しているブログでは、今後のリリースや現在進行中の作業についての情報が得られます。 Planetサイトは、関連する複数のニュースソースやブログ投稿を一か所でまとめて表示します。 たとえば planet.gnome.org や planet.mysql.com のようなサイトがそうです。 Googleで「Planet <プロジェクト名>」と検索してみましょう。 3. IRCチャンネルに参加する 多くのオープンソースプロジェクトにはIRC（インターネットリレーチャット）チャンネルがあり、開発者やユーザーが問題や開発について話し合っています。 プロジェクトのWebサイトで、チャンネル名や使用しているIRCネットワークを確認しましょう。 チケットを使った作業 コードはオープンソースプロジェクトの中心ですが、貢献方法はそれだけではありません。 コードの周囲のシステムの保守は、新機能の追加やバグ修正の際に見過ごされがちです。 こうした分野に関わることは、プロジェクトへの入り口となります。 多くのプロジェクトには、公開されているトラブルチケットシステムがあり、公式Webサイトのトップページやドキュメントからリンクされています。 これはユーザーと開発者間の主なコミュニケーション手段です。これを最新に保つことは、大きな貢献となります。 一部の操作には特別な権限が必要ですが、多くのプロジェクトリーダーは喜んで協力してくれます。 4. バグの診断 バグはしばしば不正確に報告されます。 バグを診断して説明することは、開発者が問題の原因を特定する助けになります。 たとえば「Xをしたときにソフトが動かない」と報告された場合、再現できるか確認しましょう。 特定のブラウザでのみ発生するのか、特定のディストリビューションでのみ発生するのかを絞り込むことが重要です。 原因が分からなくても、可能な限り情報を絞り込むことで他の人が修正しやすくなります。 見つけたことはすべてチケットに記録しましょう。 5. 修正されたバグを閉じる バグがコードで修正されても、チケットが更新されていないことがあります。 このような「ごみ」を掃除するのは時間がかかりますが、プロジェクト全体にとっては非常に重要です。 1年以上前のチケットを検索し、バグがまだ存在するか確認してください。 リリースの変更ログを確認し、修正されたことが明らかであればチケットを閉じてください。 バグが再現できなければそれを記録し、閉じます。再現できれば、続けてオープンにしておきます。 コードを使った作業 経験レベルに関係なく、誰でもコードで貢献できます。 貢献するために天才である必要はありません。 コードの修正を行う場合は、そのプロジェクトがどのようにコードを受け入れているか確認してください。 各プロジェクトには独自のワークフローがあります。 たとえば PostgreSQL ではパッチをメーリングリストに送る厳格なルールがありますが、Parrot のようなプロジェクトではもっと簡単です。 GitHubを使用している場合は、Pull Requestを通じて貢献できます。 修正時は、既存のコードスタイルに従い、責任あるメンバーとして行動してください。 6. ベータ版やリリース候補版をテストする さまざまな環境で動作するソフトウェアには、移植性に関する問題が多く存在します。 リリース前にベータ版やRC版が公開された際は、異なる環境でのテストが期待されます。 あなたもその一員となり、自分の環境でビルド・実行・テストをして、動作報告を送りましょう。 7. バグを修正する これはコードに貢献したい人のための一般的な方法です。 チケットシステムから興味のあるバグを探し、修正に挑戦してください。 テストが必要であれば、それも追加しましょう。 修正できなかった場合でも、調査内容を記録することが次の人の助けになります。 8. テストを書く ほとんどのプロジェクトにはテストスイートがありますが、十分にカバーされていないこともあります。 テストカバレッジツールを使用して未カバー部分を探し、そこに対するテストを追加しましょう。 9. コンパイラ警告を修正する 多くのC系プロジェクトでは、ビルド時に警告が出ます。 それらの多くは深刻な問題ではありませんが、見た目が悪く、重要な警告を埋もれさせてしまうことがあります。 警告を解消するためのコード変更は、プロジェクトにとって役立ちます。 10. コメントを追加する コードを読む中で混乱する箇所があれば、他の人も同じように困る可能性があります。 そこにコメントを追加し、パッチとして提出しましょう。 ドキュメントで貢献する ドキュメントはしばしば軽視されがちであり、経験者の視点で書かれていることが多いため、初心者にはわかりにくいことがあります。 新しい視点から欠点を見つけ、改善することができます。 11. 使用例を作成する どんなプロジェクトでも、How-toの使用例は歓迎されます。 API、GUIアプリ、CLIツールなど、実用的な例を作りましょう。 セットアップ手順のスクリーンショットを追加するのも良いアイデアです。 コミュニティとの関わり方 オープンソースはコードだけではありません。コミュニティこそがそれを支える柱です。 12. 質問に答える 他人を助けることは、コミュニティを強くする最高の方法です。 特に初心者の質問に親切に答えることで、活発な参加者が増え、プロジェクトの将来が明るくなります。 13. ブログ投稿を書く 使っているソフトウェアに関して、経験や問題・解決策を書いてください。 他のユーザーが同様の問題に直面したとき、あなたのブログが役立つかもしれません。 また、将来そのソフトを使って職探しをする際の実績としても使えます。 14. Webサイトを改善する もしWebデザインのスキルがあれば、プロジェクトのWebサイトを改善することで貢献できます。 新しいロゴやバナー、レイアウトの改善など、あなたのスキルが生かされる場面は多くあります。 最も重要なのは、周囲の人々がどんな話をしているのか、耳を傾けることです。 必要なものに気づき、積極的に提案・行動することで、大きなインパクトを残すことができます。 たとえば、Parrotの開発者がTracからGitHubへチケットを移行するか議論していた際、 「コンバーターを書きましょうか？」と申し出たことで、450以上のチケットを失わずに済み、大きな成功となりました。 ================================================ FILE: docs/additional-material/translations/Kannada/Things a non programmer can do.ka.md ================================================ # ಪ್ರೋಗ್ರಾಮಿಂಗ್ ಮಾಡದವರು ಮಾಡಬಹುದಾದ ಕೆಲಸಗಳು ## ಕೇಳುವುದರಿಂದ ಪ್ರಾರಂಭಿಸಿ ಓಪನ್ ಸೋರ್ಸ್ ಪ್ರೊಜೆಕ್ಟ್ ಎಂದರೆ ಇತರ ವ್ಯಕ್ತಿಗಳೊಂದಿಗೆ ಕೆಲಸ ಮಾಡುವುದು. ನೀವು ಒಂದು ತಂಡಕ್ಕೆ ಸೇರಲು ನೋಡುತ್ತಿದ್ದೀರಿ, ಅಂದರೆ ಆ ಸಮುದಾಯ ಮತ್ತು ಅದರ ಕಾರ್ಯಪದ್ಧತಿಯನ್ನು ಅರ್ಥಮಾಡಿಕೊಳ್ಳುವುದು ಮುಖ್ಯ. ಒಂದು ಪ್ರೊಜೆಕ್ಟ್‌ಗೆ ಹೋದ ಕೂಡಲೇ **"ಇದು ನನ್ನ ಅಭಿಪ್ರಾಯ, ನೀವು ಹೀಗೆ ಮಾಡಬೇಕು"** ಎಂದು ಹೇಳುವುದು ಒಳ್ಳೆಯ ರೀತಿಯಲ್ಲ. ಕೆಲವು ಪ್ರೊಜೆಕ್ಟ್‌ಗಳು ಇದನ್ನು ಸಹಿಸಬಹುದು, ಆದರೆ ಬಹಳ ಕಾಲದಿಂದ ನಡೆಯುತ್ತಿರುವ ಪ್ರೊಜೆಕ್ಟ್‌ಗಳಲ್ಲಿ ಇದನ್ನು ಒಪ್ಪಿಕೊಳ್ಳುವ ಸಾಧ್ಯತೆ ಕಡಿಮೆ. **ಕೇಳುವುದು ಪ್ರೊಜೆಕ್ಟ್‌ ಅನ್ನು ಅರ್ಥಮಾಡಿಕೊಳ್ಳಲು ಉತ್ತಮ ವಿಧಾನ** ### 1. **ಮೇಲಿಂಗ್ ಲಿಸ್ಟ್‌ಗೆ ಸೇರಿಕೊಳ್ಳಿ** ಹೆಚ್ಚಿನ ಪ್ರೊಜೆಕ್ಟ್‌ಗಳಲ್ಲಿ ಮೇಜರ್ ಚರ್ಚೆಗಳು ಮೇಲಿಂಗ್ ಲಿಸ್ಟ್‌ನಲ್ಲಿ ನಡೆಯುತ್ತವೆ. ಉದಾಹರಣೆಗೆ, PostgreSQL ಪ್ರೊಜೆಕ್ಟ್‌ನಲ್ಲಿ ಬಳಕೆದಾರರಿಗಾಗಿ 12ಕ್ಕೂ ಹೆಚ್ಚು ಮತ್ತು ಡೆವಲಪರ್‌ಗಾಗಿ 6 ಮೇಲಿಂಗ್ ಲಿಸ್ಟ್‌ಗಳಿವೆ. ನೀವು ಮುಖ್ಯ ಬಳಕೆದಾರರ ಲಿಸ್ಟ್ ಮತ್ತು ಡೆವಲಪರ್ ಲಿಸ್ಟ್‌ ಅನ್ನು ಫಾಲೋ ಮಾಡಿ. ### 2. **ಬ್ಲಾಗ್‌ಗಳನ್ನು ಅನುಸರಿಸಿ** ಪ್ರಮುಖ ಡೆವಲಪರ್‌ಗಳು ಬರುವ ಅಪ್‌ಡೇಟ್‌ಗಳ ಬಗ್ಗೆ ಬ್ಲಾಗ್‌ಗಳಲ್ಲಿ ಬರೆಯುತ್ತಾರೆ. ಕೆಲವು ಒಟ್ಟುಗೂಡಿದ ವೆಬ್‌ಸೈಟ್‌ಗಳು (`planet.gnome.org`, `planet.mysql.com`) ಈ ಮಾಹಿತಿ ಒದಗಿಸುತ್ತವೆ. Googleನಲ್ಲಿ **"planet "** ಹುಡುಕಿ. ### 3. **IRC ಚಾನೆಲ್‌ ಸೇರಿ** ಹೆಚ್ಚಿನ ಓಪನ್ ಸೋರ್ಸ್ ಪ್ರೊಜೆಕ್ಟ್‌ಗಳು ಡೆಡಿಕೇಟೆಡ್ IRC ಚಾನೆಲ್ ಹೊಂದಿರುತ್ತವೆ, ಅಲ್ಲಿ ಡೆವಲಪರ್‌ಗಳು ಮತ್ತು ಬಳಕೆದಾರರು ತಮ್ಮ ಸಮಸ್ಯೆಗಳನ್ನು ಚರ್ಚಿಸುತ್ತಾರೆ. ಪ್ರೊಜೆಕ್ಟ್ ವೆಬ್‌ಸೈಟ್‌ನಲ್ಲಿ ಇದರ ಬಗ್ಗೆ ವಿವರ ಹುಡುಕಿ. ## **ಟಿಕೆಟ್‌ಗಳೊಂದಿಗೆ ಕೆಲಸ ಮಾಡುವುದು** ಕೋಡ್ ಎಷ್ಟೇ ಮುಖ್ಯವಾದರೂ, ಬರೆಯುವುದು ಮಾತ್ರವಲ್ಲ, ನಿರ್ವಹಣೆ ಕೂಡ ಅಗತ್ಯ. ಹೆಚ್ಚಿನ ಪ್ರೊಜೆಕ್ಟ್‌ಗಳು **ಬಗ್ಗೆ ಸಮಸ್ಯೆಗಳಿಗಾಗಿ ಪಬ್ಲಿಕ್ ಟಿಕೆಟ್ ವ್ಯವಸ್ಥೆ** ಹೊಂದಿರುತ್ತವೆ. ಇದನ್ನು ನಿರ್ವಹಿಸುವುದು ಪ್ರೊಜೆಕ್ಟ್‌ಗೆ ಸಹಾಯ ಮಾಡಬಹುದು. ### 4. **ಬಗ್ಗೆ ಪತ್ತೆಹಚ್ಚಿ** ಬಹಳಷ್ಟು ಬಗ್‌ಗಳು ಸರಿಯಾಗಿ ವರದಿ ಆಗಿರುವುದಿಲ್ಲ. "X ಮಾಡಿದಾಗ ವಾಪಸ್ ಕೆಲಸ ಮಾಡುತ್ತಿಲ್ಲ" ಎಂಬ ವರದಿ ಬಂದರೆ, ಅದನ್ನು ಪುನರಾವೃತ್ತಿ ಮಾಡಬಹುದೇ? ಎಲ್ಲಾ ಬ್ರೌಸರ್‌ಗಳಲ್ಲಿ ಒಂದೇ ರೀತಿಯ ಸಮಸ್ಯೆಯೇ? ನೀವು ಆ ರಿಪೋರ್ಟ್‌ನಲ್ಲಿ ಹೆಚ್ಚಿನ ಮಾಹಿತಿಯನ್ನು ಸೇರಿಸಿದರೆ, ಡೆವಲಪರ್‌ಗೆ ಸರಿಪಡಿಸಲು ಸುಲಭವಾಗುತ್ತದೆ. ### 5. **ಸರಿಪಡಿಸಲಾದ ಸಮಸ್ಯೆಗಳನ್ನು ಮುಚ್ಚಿ** ಕೆಲವು ಬಗ್‌ಗಳು ಸರಿಪಡಿಸಲಾಗಿದ್ದರೂ, ಟಿಕೆಟ್‌ನಲ್ಲಿ ಅಪ್‌ಡೇಟ್ ಆಗಿಲ್ಲ. ಪ್ರಸ್ತುತ ಪ್ರೊಜೆಕ್ಟ್‌ ರಿಲೀಸ್ ನೋಟ್‌ಗಳ ಮೂಲಕ ಸಮಸ್ಯೆ ಇನ್ನೂ ಇಡೀದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ. ಹುಡುಕಾಟ ಮಾಡದಿದ್ದರೆ, ಟಿಕೆಟ್ ಮುಚ್ಚಿ. ## **ಕೋಡ್‌ನಲ್ಲಿ ಕೆಲಸ ಮಾಡುವುದು** ಕೋಡಿಂಗ್‌ನಲ್ಲಿ ನಿಮ್ಮ ಅನುಭವದ ಮಟ್ಟವೇನಾದರೂ ಇರಲಿ, ನೀವು ಸಹಾಯ ಮಾಡಬಹುದು. ನೀವು ಮೊದಲೇ ತಿಳಿದುಕೊಳ್ಳಬೇಕಾದದ್ದು **ಪ್ರೊಜೆಕ್ಟ್‌ ರೀತಿ ಸಂಪ್ರದಾಯ** ಹೇಗೆ ಇದೆ ಎಂಬುದು. ### 6. **ಬೀಟಾ ಅಥವಾ ರಿಲೀಸ್ ಕ್ಯಾಂಡಿಡೇಟ್‌ ಪರೀಕ್ಷಿಸಿ** ನೀವು ಅಸಾಮಾನ್ಯವಾದ ಪ್ಲಾಟ್‌ಫಾರ್ಮ್ ಅಥವಾ ಹಾರ್ಡ್‌ವೇರ್ ಬಳಸುತ್ತಿದ್ದರೆ, ಪರೀಕ್ಷೆ ಮಾಡಿ ಮತ್ತು ಡೆವಲಪರ್‌ಗಳಿಗೆ ನಿಮ್ಮ ಫಲಿತಾಂಶವನ್ನು ತಿಳಿಸಿ. ### 7. **ಒಂದು ಬಗ್ ಸರಿಪಡಿಸಿ** ಬಗ್‌ಗಳನ್ನು ಸರಿಪಡಿಸುವುದು ಪ್ರೊಜೆಕ್ಟ್‌ಗೆ ಪ್ರವೇಶಿಸಲು ಉತ್ತಮ ಮಾರ್ಗ. ಬಗ್ ಅನ್ನು ಪತ್ತೆಹಚ್ಚಿ, ಅದನ್ನು ಫಿಕ್ಸ್ ಮಾಡಲು ಪ್ರಯತ್ನಿಸಿ, ಹಾಗೂ ನಿಮ್ಮ ಪ್ರಯತ್ನವನ್ನು ಟಿಕೆಟ್‌ನಲ್ಲಿ ದಾಖಲಿಸಿ. ### 8. **ಟೆಸ್ಟ್‌ ಬರೆಯಿರಿ** ಹೆಚ್ಚಿನ ಪ್ರೊಜೆಕ್ಟ್‌ಗಳಿಗೆ ಹೆಚ್ಚು ಟೆಸ್ಟ್‌ಗಳು ಬೇಕಾಗುತ್ತವೆ. `gcov` (C), `Devel::Cover` (Perl) ಮುಂತಾದ ಟೂಲ್ಸ್ ಬಳಸಿಕೊಂಡು, ಪರೀಕ್ಷಿಸದ ಕೋಡ್ ಭಾಗಗಳನ್ನು ಪತ್ತೆಹಚ್ಚಿ ಮತ್ತು ಹೊಸ ಟೆಸ್ಟ್ ಸೇರಿಸಿ. ### 9. **ಕಂಪೈಲರ್ ವಾರ್ನಿಂಗ್‌ಗಳನ್ನು ಸರಿಪಡಿಸಿ** ಹೆಚ್ಚಿನ C ಪ್ರೊಜೆಕ್ಟ್‌ಗಳಲ್ಲಿ ವಾರ್ನಿಂಗ್‌ಗಳು ತೋರುತ್ತವೆ. ಇವು ತಾತ್ಕಾಲಿಕ ಸಮಸ್ಯೆಗಳಾದರೂ, ಹೆಚ್ಚಿನವು ನಿಜವಾದ ಸಮಸ್ಯೆಗಳಲ್ಲ. ನೀವು ಇವುಗಳನ್ನು ಸರಿಪಡಿಸಿದರೆ, ಇತರರು ಸುಲಭವಾಗಿ ಓದಬಹುದು. ### 10. **ಕೋಡ್‌ನಲ್ಲಿ ಕಾಮೆಂಟ್ ಸೇರಿಸಿ** ನೀವು ತಿಳಿಯದ ಕೋಡ್ ಭಾಗವನ್ನು ನೋಡಿದರೆ, ಇತರರು ಸಹ ಅರ್ಥಮಾಡಿಕೊಳ್ಳಲು ಕಷ್ಟವಾಗಬಹುದು. ಅದು ಏನು ಮಾಡುತ್ತದೆ ಎಂಬುದನ್ನು ಕಾಮೆಂಟ್‌ನಲ್ಲಿ ಬರೆಯಿರಿ. ## **ದಸ್ತಾವೇಜುಗಳಲ್ಲಿ ಕೆಲಸ ಮಾಡುವುದು** ಹೆಚ್ಚಿನ ಪ್ರೊಜೆಕ್ಟ್‌ಗಳಲ್ಲಿ **documentation** ಹೆಚ್ಚು ನಿರ್ಲಕ್ಷ್ಯಗೊಳ್ಳುತ್ತದೆ. ### 11. **ಉದಾಹರಣೆ ಬರೆಯಿರಿ** ಪ್ರತಿ ಪ್ರೊಜೆಕ್ಟ್‌ಗೂ ಹೆಚ್ಚು ಉದಾಹರಣೆಗಳು ಅಗತ್ಯ. ಸಾಮಾನ್ಯ ಬಳಕೆಗಾರರು ತ್ವರಿತವಾಗಿ ಅರ್ಥಮಾಡಿಕೊಳ್ಳಲು, ಹಲವು `how-to` ಉದಾಹರಣೆಗಳನ್ನು ಸೇರಿಸಿ. ## **ಸಮುದಾಯದೊಂದಿಗೆ ಕೆಲಸ ಮಾಡುವುದು** ಓಪನ್ ಸೋರ್ಸ್ ಕೋಡ್‌ ಮಾತ್ರವಲ್ಲ, ಸಮುದಾಯ ಕೂಡ ಮುಖ್ಯ. ### 12. **ಪ್ರಶ್ನೆಗೆ ಉತ್ತರಿಸಿ** ಯಾವುದೇ ಹೊಸ ಬಳಕೆದಾರನಿಗೆ ಸಹಾಯ ಮಾಡುವುದು, ಪ್ರೊಜೆಕ್ಟ್ ಬೆಳೆಯಲು ತುಂಬಾ ಮುಖ್ಯ. ಅವರ ಪ್ರಶ್ನೆ ಕೇಳಿ, ಉತ್ತರಿಸಿ, RTFM (Read The Manual) ಎಂದೂ ಹೇಳಬೇಡಿ. ### 13. **ಬ್ಲಾಗ್ ಪೋಸ್ಟ್ ಬರೆಯಿರಿ** ನಿಮ್ಮ ಅನುಭವವನ್ನು ಬ್ಲಾಗ್‌ನಲ್ಲಿ ಹಂಚಿಕೊಳ್ಳಿ. ಸಮಸ್ಯೆ ಎದುರಾದರೆ, ಅದನ್ನು ಹೇಗೆ ಪರಿಹರಿಸಿದ್ದೀರಿ ಎಂಬುದನ್ನು ವಿವರಿಸಿ. ಇದು ಮುಂದಿನ ತಲೆಮಾರಿನವರಿಗೆ ಸಹಾಯ ಮಾಡಬಹುದು. ### 14. **ಒಂದು ವೆಬ್‌ಸೈಟ್ ಸುಧಾರಿಸಿ** ನೀವು ವೆಬ್ ಡಿಸೈನ್‌ಗೆ ಪರಿಣಿತರಾಗಿದ್ದರೆ, ಪ್ರೊಜೆಕ್ಟ್ ವೆಬ್‌ಸೈಟ್‌ ಅನ್ನು ಉತ್ತಮಗೊಳಿಸಬಹುದು. ಗ್ರಾಫಿಕ್, ಲೋಗೋ ಅಥವಾ ಬಳಕೆದಾರ ಅನುಭವವನ್ನು ಸುಧಾರಿಸಬಹುದು. ### 15. **ತಾಂತ್ರಿಕ ದಸ್ತಾವೇಜು ಬರೆಯಿರಿ** ನೀವು ಕೋಡರ್‌ ಅಲ್ಲದಿದ್ದರೂ, ಪ್ರೊಜೆಕ್ಟ್ ಬಗ್ಗೆ ಬರೆಯಬಹುದು. ಸ್ಪಷ್ಟ **documentation** ಬರೆಯುವುದು ಬಹಳ ಮುಖ್ಯ. ಕೋಡ್ ಹೇಗೆ ಕೆಲಸ ಮಾಡುತ್ತದೆ ಎಂಬುದನ್ನು ಸರಳವಾಗಿ ವಿವರಿಸಿ. ### 16. **ಹೆಚ್ಚುಮಂದಿಗೆ ಕಲಿಸಿ ಮತ್ತು ಸಹಾಯ ಮಾಡಿ** ಯಾವುದೇ ವಿಷಯವನ್ನು ಕಲಿಯಲು ಅದನ್ನು ಬೇರೆ ಒಬ್ಬರಿಗೆ ಕಲಿಸಬೇಕು. ಸರಳ ಉದಾಹರಣೆಗಳ ಮೂಲಕ ದೊಡ್ಡ ವಿಚಾರವನ್ನು ವಿವರಿಸುವುದು ಉತ್ತಮ ಶಿಕ್ಷಕರ ಲಕ್ಷಣ. ನೀವು ಕಲಿತದ್ದನ್ನು ಇತರರೊಂದಿಗೆ ಹಂಚಿಕೊಳ್ಳಿ, ಇದು ನಿಮ್ಮ ಜ್ಞಾನವನ್ನು ಮತ್ತಷ್ಟು ಹೆಚ್ಚಿಸುತ್ತದೆ. --- **ಸಾರಾಂಶ:** ಓಪನ್ ಸೋರ್ಸ್‌ಗೆ ಕೊಡುಗೆ ನೀಡಲು ಪ್ರೋಗ್ರಾಮರ್ ಆಗಬೇಕಾಗಿಲ್ಲ. ಕೇಳಿ, ಕಲಿಯಿರಿ, ಸಹಾಯ ಮಾಡಿ, ಹಾಗೆಯೇ ಸಮುದಾಯದ ಭಾಗವಾಗಿರಿ! 🚀 ================================================ FILE: docs/additional-material/translations/Kannada/additional-material.ka.md ================================================ # ಹೆಚ್ಚುವರಿ ಮಾಹಿತಿ ನಾವು ನೀವು ಮೂಲಭೂತ ಟ್ಯುಟೋರಿಯಲ್ ಅನ್ನು ಪೂರ್ಣಗೊಳಿಸಿದ್ದೀರಿ ಎಂದು ಊಹಿಸುತ್ತೇವೆ. ಹೆಚ್ಚುವರಿ ಮಾಹಿತಿಯು ಗಿಟ್‌ನ ಹೆಚ್ಚಿನ ತಂತ್ರಗಳ ಕುರಿತು ವಿವರಗಳನ್ನು ಒದಗಿಸುತ್ತದೆ. ### [ಒಂದು ಕಮಿಟ್ ಪರಿಷ್ಕರಿಸುವುದು](../git_workflow_scenarios/amending-a-commit.md) ಈ ದಸ್ತಾವೇಜು ರಿಮೋಟ್ ರೆಪೊಸಿಟರಿಯಲ್ಲಿ ಒಂದು ಕಮಿಟ್ ಅನ್ನು ಪರಿಷ್ಕರಿಸುವ ಬಗ್ಗೆ ಮಾಹಿತಿ ನೀಡುತ್ತದೆ. > ನೀವು ಈಗಾಗಲೇ ಮಾಡಿರುವ ಕಮಿಟ್ ಅನ್ನು ಸರಿಪಡಿಸಲು ಈ ವಿಧಾನವನ್ನು ಬಳಸಿ. ### [Git ಸಂರಚನೆ](../git_workflow_scenarios/configuring-git.md) ಈ ದಸ್ತಾವೇಜು ಬಳಕೆದಾರ ವಿವರಗಳು ಮತ್ತು ಇತರ Git ಆಯ್ಕைகளை ಹೇಗೆ ಸಂರಚಿಸಬೇಕು ಎಂಬುದರ ಬಗ್ಗೆ ಮಾಹಿತಿ ನೀಡುತ್ತದೆ. > ನಿಮ್ಮ Git ಸೆಟ್ಟಿಂಗ್‌ಗಳನ್ನು ಉತ್ತಮವಾಗಿ ನಿಯಂತ್ರಿಸಲು ಇದನ್ನು ಬಳಸಿ. ### [ನಿಮ್ಮ ಫೋರ್ಕ್ ಅನ್ನು ಮೂಲ ರೆಪೊಸಿಟರಿಯೊಂದಿಗೆ ಸಿಂಕ್ ಮಾಡುವುದು](../git_workflow_scenarios/keeping-your-fork-synced-with-this-repository.md) ಈ ದಸ್ತಾವೇಜು ನಿಮ್ಮ ಫೋರ್ಕ್ ಅನ್ನು ಬೇಸ್ ರೆಪೊಸಿಟರಿಯೊಂದಿಗೆ ನವೀಕರಿಸುವ ಬಗ್ಗೆ ಮಾಹಿತಿ ನೀಡುತ್ತದೆ. ಇದು ಮುಖ್ಯವಾಗಿದೆ ಏಕೆಂದರೆ ನೀವು ಮತ್ತು ಅನೇಕ ಜನರು ಈ ಪ್ರಾಜೆಕ್ಟ್‌ಗೆ ಕೊಡುಗೆ ನೀಡುತ್ತಾರೆ. > ನಿಮ್ಮ ಫೋರ್ಕ್ ಮೂಲ ರೆಪೊಸಿಟರಿಯ ಹೊಸ ಬದಲಾವಣೆಗಳನ್ನು ಹೊಂದಿಲ್ಲದಿದ್ದರೆ ಈ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ. ### [ಒಂದು ಕಮಿಟ್ ಅನ್ನು ಬೇರೆ ಶಾಖೆಗೆ ಸ್ಥಳಾಂತರಿಸುವುದು](../git_workflow_scenarios/moving-a-commit-to-a-different-branch.md) ಈ ದಸ್ತಾವೇಜು ಒಂದು ಕಮಿಟ್ ಅನ್ನು ಬೇರೆ ಶಾಖೆಗೆ ಹೇಗೆ ಸ್ಥಳಾಂತರಿಸಬೇಕು ಎಂಬುದರ ಬಗ್ಗೆ ಮಾಹಿತಿ ನೀಡುತ್ತದೆ. > ನೀವು ಒಂದು ಕಮಿಟ್ ಅನ್ನು ಬೇರೆ ಶಾಖೆಗೆ ಸ್ಥಳಾಂತರಿಸಲು ಈ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ. ### [ಒಂದು ಕಡತವನ್ನು ತೆಗೆದುಹಾಕುವುದು](../git_workflow_scenarios/removing-a-file.md) ಈ ದಸ್ತಾವೇಜು ನಿಮ್ಮ ಸ್ಥಳೀಯ ರೆಪೊಸಿಟರಿಯಿಂದ ಒಂದು ಕಡತವನ್ನು ಹೇಗೆ ತೆಗೆದುಹಾಕುವುದು ಎಂಬುದರ ಬಗ್ಗೆ ಮಾಹಿತಿ ನೀಡುತ್ತದೆ. > ನಿಮ್ಮ ಸ್ಥಳೀಯ ರೆಪೊಸಿಟರಿಯಿಂದ ಒಂದು ಕಡತವನ್ನು ತೆಗೆದುಹಾಕಲು ಈ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ. ### [ಶಾಖೆಯನ್ನು ನಿಮ್ಮ ರೆಪೊಸಿಟರಿಯಿಂದ ತೆಗೆದುಹಾಕುವುದು](../git_workflow_scenarios/removing-branch-from-your-repository.md) ಈ ದಸ್ತಾವೇಜು ನಿಮ್ಮ ರೆಪೊಸಿಟರಿಯಿಂದ ಒಂದು ಶಾಖೆಯನ್ನು ಹೇಗೆ ಅಳಿಸಬೇಕು ಎಂಬುದರ ಬಗ್ಗೆ ಮಾಹಿತಿ ನೀಡುತ್ತದೆ. > ನಿಮ್ಮ ಪುಲ್ ವಿನಂತಿಯನ್ನು ಮರ್ಜ್ ಮಾಡಿದ ನಂತರ ಮಾತ್ರ ಈ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ. ### [ಮರ್ಜ್ ಸಂಘರ್ಷಗಳನ್ನು ಪರಿಹರಿಸುವುದು](../git_workflow_scenarios/resolving-merge-conflicts.md) ಈ ದಸ್ತಾವೇಜು ಮರ್ಜ್ ಸಂಘರ್ಷಗಳನ್ನು ಹೇಗೆ ಪರಿಹರಿಸಬೇಕು ಎಂಬುದರ ಬಗ್ಗೆ ಮಾಹಿತಿ ನೀಡುತ್ತದೆ. > ಈ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ כדי ಅನಾವಶ್ಯಕ ಮರ್ಜ್ ಸಂಘರ್ಷಗಳನ್ನು ಪರಿಹರಿಸಲು. ### [ಒಂದು ಕಮಿಟ್ ಅನ್ನು ಹಿಂತೆಗೆದುಹಾಕುವುದು](../git_workflow_scenarios/reverting-a-commit.md) ಈ ದಸ್ತಾವೇಜು ರಿಮೋಟ್ ರೆಪೊಸಿಟರಿಯಲ್ಲಿ ಮಾಡಿದ ಒಂದು ಕಮಿಟ್ ಅನ್ನು ಹೇಗೆ ಹಿಂತೆಗೆದುಹಾಕುವುದು ಎಂಬುದರ ಬಗ್ಗೆ ಮಾಹಿತಿ ನೀಡುತ್ತದೆ. ಇದು GitHub ನಲ್ಲಿ ಪ್ರಕಟಿಸಿರುವ ಕಮಿಟ್ ಅನ್ನು ಹಿಂತೆಗೆದುಹಾಕಬೇಕಾದಾಗ ತುಂಬಾ ಉಪಯುಕ್ತವಾಗಿದೆ. > ನೀವು ಒಂದು ಕಮಿಟ್ ಅನ್ನು ಹಿಂತೆಗೆದುಹಾಕಲು ಈ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ. ### [ಕಮಿಟ್‌ಗಳನ್ನು ಒಟ್ಟುಗೂಡಿಸುವುದು](../git_workflow_scenarios/squashing-commits.md) ಈ ದಸ್ತಾವೇಜು ಬಹು ಕಮಿಟ್‌ಗಳನ್ನು ಒಂದರೊಂದಿಗೆ ಒಟ್ಟುಗೂಡಿಸುವ (rebase) ವಿಧಾನವನ್ನು ವಿವರಿಸುತ್ತದೆ. > ನೀವು open-source ಪ್ರಾಜೆಕ್ಟ್‌ಗೆ PR ಸಲ್ಲಿಸಿದಾಗ ಮತ್ತು ವಿಮರ್ಶಕ ಎಲ್ಲಾ ಕಮಿಟ್‌ಗಳನ್ನು ಒಂದರೊಂದಿಗೆ ಸಂಯೋಜಿಸಲು ಕೋರಿದರೆ ಈ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ. ### [ಸ್ಥಳೀಯ ಕಮಿಟ್ ಅನ್ನು ಹಿಂತೆಗೆದುಹಾಕುವುದು](../git_workflow_scenarios/undoing-a-commit.md) ಈ ದಸ್ತಾವೇಜು ನಿಮ್ಮ ಸ್ಥಳೀಯ ರೆಪೊಸಿಟರಿಯಲ್ಲಿ ಕಮಿಟ್ ಅನ್ನು ಹೇಗೆ ಹಿಂತೆಗೆದುಹಾಕುವುದು ಎಂಬುದರ ಬಗ್ಗೆ ವಿವರಿಸುತ್ತದೆ. ನೀವು ತಪ್ಪು ಮಾಡಿದಂತೆ ಅನಿಸಿದಾಗ ಮತ್ತು ಅದನ್ನು ಹಿಂತೆಗೆದುಹಾಕಲು ಬಯಸಿದರೆ ಇದು ಉಪಯುಕ್ತವಾಗಿದೆ. > ನೀವು ಸ್ಥಳೀಯ ಕಮಿಟ್ ಅನ್ನು ಹಿಂತೆಗೆದುಹಾಕಲು/ಮರುಹೊಂದಿಸಲು ಈ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ. ### [ಉಪಯುಕ್ತ ಲಿಂಕ್‌ಗಳು](../git_workflow_scenarios/Useful-links-for-further-learning.md) ಈ ದಸ್ತಾವೇಜು ಉಪಯುಕ್ತ ಬ್ಲಾಗ್‌ಗಳು, ಪೋಸ್ಟ್‌ಗಳು, ವೆಬ್‌ಸೈಟ್‌ಗಳು, ಸಲಹೆಗಳು ಮತ್ತು ಉಪಾಯಗಳಿಗೆ ಮೀಸಲಾಗಿರುತ್ತದೆ, ಇದು ನಮ್ಮ ಜೀವನವನ್ನು ಸುಲಭಗೊಳಿಸುತ್ತದೆ. ನೀವು ತಜ್ಞರಾಗಿರಲಿ ಅಥವಾ ಪ್ರಾರಂಭಿಕರಾಗಿರಲಿ, ಈ ಪುಟ open-source ಪ್ರಾಜೆಕ್ಟ್‌ಗಳ ಹೊಸ ಬಳಕೆದಾರರಿಗೆ ಅಥವಾ ಇನ್ನಷ್ಟು ಕಲಿಯಲು ಇಚ್ಛಿಸುವವರಿಗೆ ಉಪಯುಕ್ತವಾದ ಲಿಂಕ್‌ಗಳ ಸೂಚಿಯಾಗಿ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ. ================================================ FILE: docs/additional-material/translations/Kannada/amending-a-commit.ka.md ================================================ # ಕಮಿಟ್ ಸರಿಪಡಿಸುವುದು ನೀವು ನಿಮ್ಮ ರಿಮೋಟ್ ರೆಪೊಸಿಟರಿಗೆ ಬದಲಾವಣೆಯನ್ನು ಕಮಿಟ್ ಮಾಡಿದ ನಂತರ, ಅದರಲ್ಲಿ ಕಮಿಟ್ ಸಂದೇಶದಲ್ಲಿ ಒಂದು ದೋಷವಿದೆ ಅಥವಾ ನೀವು ನಿಮ್ಮ ಇತ್ತೀಚಿನ ಕಮಿಟ್‌ನಲ್ಲಿ ಒಂದು ಸಾಲಿನ ಕೋಡ್ ಸೇರಿಸಲು ಮರತುಹೋಗಿದ್ದೀರಿ ಎಂಬುದು ನಿಮಗೆ ನಂತರ ತಿಳಿದರೆ ಏನು ಮಾಡಬೇಕು? ಈ ಪರಿಷ್ಕರಣೆಯನ್ನು ನೀವು ಹೇಗೆ ಮಾಡಬಹುದು? ಈ ಟ್ಯುಟೋರಿಯಲ್ ಅದನ್ನು ಆವೃತ್ತಿಸುತ್ತದೆ. ## GitHub ಗೆ ಪುಶ್ ಮಾಡಿದ ನಂತರ ಇತ್ತೀಚಿನ ಕಮಿಟ್ ಸಂದೇಶವನ್ನು ಪರಿವರ್ತಿಸುವುದು ಇದು ಫೈಲ್ ತೆರೆಯದೆ ಮಾಡುವ ವಿಧಾನ: * ```git commit --amend -m "ನಿಮ್ಮ ಹೊಸ ಕಮಿಟ್ ಸಂದೇಶ"``` ಎಂಬ ಆಜ್ಞೆಯನ್ನು ನಮೂದಿಸಿ. * ```git push origin <ಶಾಖೆಯ-ಹೆಸರು>``` ಆಜ್ಞೆಯನ್ನು ಕಾರ್ಯಗತಗೊಳಿಸಿ, ಬದಲಾವಣೆಗಳನ್ನು ರೆಪೊಸಿಟರಿಗೆ ಕಮಿಟ್ ಮಾಡಲು. ಟಿಪ್ಪಣಿ: ನೀವು ```git commit --amend``` ಮಾತ್ರ ನಮೂದಿಸಿದರೆ, ನಿಮ್ಮ ಟೆಕ್ಸ್ಟ್ ಎಡಿಟರ್ ತೆರೆಯಲಾಗುತ್ತದೆ ಮತ್ತು ನೀವು ಕಮಿಟ್ ಸಂದೇಶವನ್ನು ಸಂಪಾದಿಸಲು ಅವಕಾಶ ಪಡೆಯುತ್ತೀರಿ. ```-m``` ಫ್ಲ್ಯಾಗ್ ಅನ್ನು ಬಳಸುವುದರಿಂದ ಅದು ತಪ್ಪಿಸಲಾಗುತ್ತದೆ. ## ಒಬ್ಬೇ ಒಂದು ಕಮಿಟ್‌ನಲ್ಲಿ ಬದಲಾವಣೆಗಳನ್ನು ಮಾಡುವುದು ನಾವು ಒಬ್ಬೇ ಒಂದು ಶಬ್ದವನ್ನು ಸೇರಿಸುವಂತಾದ ಸಣ್ಣ ಬದಲಾವಣೆಯನ್ನು ಮಾಡಬೇಕಾದರೂ, ಈಗಾಗಲೇ ಅದನ್ನು ರಿಮೋಟ್ ರೆಪೊಸಿಟರಿಗೆ ಪುಶ್ ಮಾಡಿದ್ದರೆ ಏನು ಮಾಡಬೇಕು? ಉದಾಹರಣೆಗೆ, ಇಲ್ಲಿ ನನ್ನ ಕಮಿಟ್ ಲಾಗ್ ಇದೆ: ``` g56123f bot file ನಿರ್ಮಿಸಲಾಯಿತು a2235d contributor.md ಅಪ್‌ಡೇಟ್ ಮಾಡಲಾಗಿದೆ a5da0d bot file ಪರಿಷ್ಕರಿಸಲಾಯಿತು ``` ನಾನು bot file ಗೆ ಒಂದು ಶಬ್ದ ಸೇರಿಸುವುದನ್ನು ಮರತುಹೋಗಿದ್ದೇನೆ ಎಂದು ಊಹಿಸೋಣ. ಈ ಸಮಸ್ಯೆಯನ್ನು ಪರಿಹರಿಸಲು ಎರಡು ವಿಧಾನಗಳಿವೆ. ಮೊದಲನೆಯದು ಹೊಸ ಕಮಿಟ್ ಮಾಡುವುದು: ``` g56123f bot file ನಿರ್ಮಿಸಲಾಯಿತು a2235d contributor.md ಅಪ್‌ಡೇಟ್ ಮಾಡಲಾಗಿದೆ a5da0d bot file ಪರಿಷ್ಕರಿಸಲಾಯಿತು b0ca8f bot file ಗೆ ಶಬ್ದ ಸೇರಿಸಲಾಯಿತು ``` ಇದನ್ನು ಮಾಡುವ ಇನ್ನೊಂದು ವಿಧಾನವೆಂದರೆ, ಹಿಂದಿನ ```a5da0d``` ಕಮಿಟ್ ಅನ್ನು ಪರಿಷ್ಕರಿಸಿ, ಹೊಸ ಶಬ್ದವನ್ನು ಸೇರಿಸಿ ಮತ್ತು GitHub ಗೆ ಒಂದೇ ಕಮಿಟ್‌ನಂತೆ ಪುಶ್ ಮಾಡುವುದು. ಇದು ಉತ್ತಮ ಆಯ್ಕೆಯಾಗಿದೆ ಏಕೆಂದರೆ ಇದು ಕೇವಲ ಸಣ್ಣ ಬದಲಾವಣೆ. ### ಇದನ್ನು ಹೇಗೆ ಮಾಡಬಹುದು? * ಫೈಲ್ ಅನ್ನು ಪರಿಷ್ಕರಿಸಿ. ಈ ಸಂದರ್ಭದಲ್ಲಿ, ನಾನು bot file ಗೆ ಹಿಂದಿನ ಶಬ್ದ ಸೇರಿಸುತ್ತೇನೆ. * ನಂತರ, ```git add <ಫೈಲ್-ಹೆಸರು>``` ಆಜ್ಞೆ ಬಳಸಿ ಸ್ಟೇಜಿಂಗ್ ಏರಿಯಾದಲ್ಲಿ ಸೇರಿಸಿ. ಸಾಧಾರಣವಾಗಿ, ಫೈಲ್‌ಗಳನ್ನು ಸ್ಟೇಜಿಂಗ್ ಏರಿಯಾದಲ್ಲಿ ಸೇರಿಸಿದ ನಂತರ, ನಾವು ```git commit -m "ನಮ್ಮ ಕಮಿಟ್ ಸಂದೇಶ"``` ಬಳಸುತ್ತೇವೆ, ಆದರೆ ಈಗ ನಾವು ಹಿಂದಿನ ಕಮಿಟ್ ಅನ್ನು ಪರಿಷ್ಕರಿಸಲು ಬಯಸುವ ಕಾರಣ, ಬದಲಿಗೆ ಈ ಆಜ್ಞೆಯನ್ನು ಬಳಸಬೇಕು: * ```git commit --amend``` ಇದು ನಿಮ್ಮ ಟೆಕ್ಸ್ಟ್ ಎಡಿಟರ್ ಅನ್ನು ತೆರೆದು, ಕಮಿಟ್ ಸಂದೇಶವನ್ನು ಪರಿಷ್ಕರಿಸಲು ಅನುಮತಿಸುತ್ತದೆ. ನೀವು ಅದನ್ನು ಬದಲಾಯಿಸಬಹುದು ಅಥವಾ ಅದೇ ರೀತಿ ಉಳಿಸಬಹುದು. * ಎಡಿಟರ್ ಅನ್ನು ಸೇವ್ ಮಾಡಿ ಮತ್ತು ಮುಚ್ಚಿ. * ```git push origin <ಶಾಖೆಯ-ಹೆಸರು>``` ಆಜ್ಞೆಯನ್ನು ಬಳಸಿ ಬದಲಾವಣೆಗಳನ್ನು ಪುಶ್ ಮಾಡಿ. ಈ ರೀತಿ, ಎರಡೂ ಬದಲಾವಣೆಗಳು ಒಂದೇ ಕಮಿಟ್‌ನಲ್ಲಿ ಉಳಿಯುತ್ತವೆ. ================================================ FILE: docs/additional-material/translations/Kannada/configuring-git.ka.md ================================================ # GIT ಸಂರಚನೆ ನೀವು ಮೊದಲು Git ಅನ್ನು ಬಳಸಲು ಪ್ರಯತ್ನಿಸಿದಾಗ, ನೀವು ಈ ರೀತಿಯ ಸಂದೇಶವನ್ನು ಸ್ವೀಕರಿಸಿದ್ದೀರಾ: ```bash $ git commit *** ದಯವಿಟ್ಟು ನಿಮ್ಮ ಬಗ್ಗೆ ಮಾಹಿತಿ ನೀಡಿ. ನೀವು ಈ ಕೆಳಗಿನ ಆಜ್ಞೆಯನ್ನು ಕಾರ್ಯಗತಗೊಳಿಸಿ: git config --global user.email "you@example.com" git config --global user.name "Your Name" ನಿಮ್ಮ ಖಾತೆಯ ಪೂರ್ವನಿಯೋಜಿತ ಗುರುತನ್ನು ಹೊಂದಿಸಲು. "--global" ಅನ್ನು ಹೊರತುಪಡಿಸಿ ಈ ಪರಿಚಯವನ್ನು ಮಾತ್ರ ಈ ರೆಪೊಸಿಟರಿಗೆ ಬಳಸಲು. ``` Git ನಲ್ಲಿ commit ಮಾಡಲು ನೀವು ಯಾರು ಎಂಬುದನ್ನು ಅದು ತಿಳಿದುಕೊಳ್ಳಬೇಕಾಗುತ್ತದೆ. ನೀವು ತಂಡವಾಗಿ ಕೆಲಸ ಮಾಡುತ್ತಿರುವಾಗ, ಯಾರು ಯಾವ ಭಾಗವನ್ನು ಪರಿಷ್ಕರಿಸಿದ್ದಾರೆ ಮತ್ತು ಯಾವಾಗ ಎಂಬುದನ್ನು ಗಮನಿಸುವ ಸಾಮರ್ಥ್ಯ ಇರಬೇಕು. ಆದ್ದರಿಂದ Git ಪ್ರತಿಯೊಂದು commit ಅನ್ನು ಹೆಸರು ಮತ್ತು ಇಮೇಲ್ ಗೆ ಲಿಂಕ್ ಮಾಡಲು ವಿನ್ಯಾಸಗೊಳಿಸಲಾಗಿದೆ. Git commit ಆಜ್ಞೆಗೆ ನಿಮ್ಮ ಇಮೇಲ್ ಮತ್ತು ಹೆಸರನ್ನು ಒದಗಿಸುವ ಹಲವಾರು ವಿಧಾನಗಳಿವೆ. ನಾವು ಕೆಲವು ವಿಧಾನಗಳನ್ನು ಇಲ್ಲಿ ನೋಡೋಣ. ### ಜಾಗತಿಕ ಸಂರಚನೆ (Global Configuration) ನೀವು ಜಾಗತಿಕ ಸಂರಚನೆಯಲ್ಲಿ (global configuration) ಏನಾದರೂ ಭದ್ರಗೊಳಿಸಿದರೆ, ಅದು ನೀವು ಬಳಸುವ ಎಲ್ಲಾ ಸಿಸ್ಟಂಗಳಲ್ಲಿ ಮತ್ತು ರೆಪೊಸಿಟರಿಗಳಲ್ಲಿ ಲಭ್ಯವಾಗಿರುತ್ತದೆ. ಇದು ಸಾಮಾನ್ಯವಾಗಿ ಬಳಸುವ ವಿಧಾನ. ಜಾಗತಿಕ ಸಂರಚನೆಯಲ್ಲಿ ಸಂಗ್ರಹಿಸಲು, ನೀವು ಈ ಕೆಳಗಿನ ಆಜ್ಞೆಯನ್ನು ಬಳಸಬಹುದು: ```bash $ git config --global ``` ಬಳಕೆದಾರ ವಿವರಗಳಿಗಾಗಿ: ```bash $ git config --global user.email "you@example.com" $ git config --global user.name "Your Name" ``` ### ರೆಪೊಸಿಟರಿ-ನಿರ್ದಿಷ್ಟ ಸಂರಚನೆ (Repository-specific Configuration) ಈ ಸಂರಚನೆ ನಿರ್ದಿಷ್ಟ ರೆಪೊಸಿಟರಿಯ ಮೇಲೆ ಮಾತ್ರ ಪರಿಣಾಮ ಬೀರುತ್ತದೆ. ಉದಾಹರಣೆಗೆ, ನೀವು ಕೆಲಸಕ್ಕೆ ಸಂಬಂಧಿಸಿದ ಒಬ್ಬ ರೆಪೊಸಿಟರಿಯಲ್ಲಿ ನಿಮ್ಮ ಕಂಪನಿಯ ಇಮೇಲ್ ಅನ್ನು ಬಳಸಲು ಇಚ್ಛಿಸಿದರೆ, ಈ ವಿಧಾನ ಉಪಯುಕ್ತವಾಗಿದೆ. ```bash $ git config user.email "you@alternate.com" $ git config user.name "Your Name" ``` ### ಆಜ್ಞಾ ಸಾಲಿನ ಸಂರಚನೆ (Command-line Configuration) ಈ ಸಂರಚನೆ ಕೇವಲ ಆಜ್ಞೆ ಕಾರ್ಯಗತಗೊಳ್ಳುವ ಸಮಯದಲ್ಲಿ ಮಾತ್ರ ಅನ್ವಯವಾಗುತ್ತದೆ. ಎಲ್ಲ Git ಆಜ್ಞೆಗಳಿಗೂ `-c` ಆರ್ಗ್ಯೂಮೆಂಟ್ ಅನ್ನು ಬಳಸಬಹುದು. ```bash $ git -c = -c = ``` ಉದಾಹರಣೆಗೆ, commit ಆಜ್ಞೆಯನ್ನು ಈ ರೀತಿ ಕಾರ್ಯಗತಗೊಳಿಸಬಹುದು: ```bash git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Your commit message" ``` ### ಆದ್ಯತೆ ಬಗ್ಗೆ ಟಿಪ್ಪಣಿ (Precedence Note) ಮೇಲಿನ ಮೂರು ವಿಧಾನಗಳಲ್ಲಿ, ಆದ್ಯತೆ ಕ್ರಮ ಹೀಗಿದೆ: **ಆಜ್ಞಾ ಸಾಲು (Command-line) > ರೆಪೊಸಿಟರಿ (Repository) > ಜಾಗತಿಕ (Global)** ಹಾಗಾಗಿ, ಒಂದು ಸ್ಟಿಂಗ್ ಅನ್ನು ಆಜ್ಞಾ ಸಾಲಿನಲ್ಲಿ ಮತ್ತು ಜಾಗತಿಕವಾಗಿ ಎರಡೂ ಹೊಂದಿಸಿದರೆ, ಆಜ್ಞಾ ಸಾಲಿನ ಸಂಯೋಜನೆಯು ಪ್ರಸ್ತಾಪಿತ Git ಕಾರ್ಯಾಚರಣೆಗೆ ಅನ್ವಯವಾಗುತ್ತದೆ. ## ಬಳಕೆದಾರ ವಿವರಗಳ ಹೊರತಾಗಿ (Beyond User Details) ನಾವು ಈವರೆಗೆ ಬಳಕೆದಾರ ವಿವರಗಳ ಬಗ್ಗೆ ಮಾತ್ರ ಚರ್ಚಿಸಿದ್ದೇವೆ, ಆದರೆ Git ನಲ್ಲಿ ಹಲವಾರು ಇತರ ಸಂರಚನಾ ಆಯ್ಕೆಗಳೂ ಲಭ್ಯವಿವೆ: 1. `core.editor` - commit ಸಂದೇಶಗಳನ್ನು ಬರೆಯಲು ಬಳಸುವ ಎಡಿಟರ್ ಅನ್ನು ನಿರ್ಧರಿಸಲು. 2. `commit.template` - commit ಸಂದೇಶದ ಮಾದರಿಯನ್ನು ಒದಗಿಸಲು. 3. `color.ui` - Git ಔಟ್‌ಪುಟ್‌ನಲ್ಲಿ ಬಣ್ಣ ಬಳಸುವ ಅಥವಾ ಬಳಸದಿರಬಹುದೆಂಬುದನ್ನು ನಿರ್ಧರಿಸಲು. Git ಸಂರಚನೆ ಬಗ್ಗೆ ಹೆಚ್ಚಿನ ಮಾಹಿತಿಗಾಗಿ, ಈ ಲಿಂಕ್ ಅನ್ನು ಭೇಟಿ ನೀಡಿ: [git-scm.com](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration). ================================================ FILE: docs/additional-material/translations/Kannada/how-to-contribute-open-source-projects-kannada.md ================================================ # ಓಪನ್ ಸೋರ್ಸ್ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿಗೆ ಹೇಗೆ ಕೊಡುಗೆ ನೀಡುವುದು: ಆರಂಭಿಕರಿಗಾಗಿ ಸಂಪೂರ್ಣ ಮಾರ್ಗದರ್ಶಿ **ಸಂಕ್ಷಿಪ್ತವಾಗಿ:** ನೀವು ನಿಮ್ಮ ಮೊದಲ Pull Request ಅನ್ನು ಒಂದು ಓಪನ್‌ಸೋರ್ಸ್ ಪ್ರಾಜೆಕ್ಟ್‌ಗೆ ಸಲ್ಲಿಸಲು ಕಾತರರಾಗಿದ್ದರೆ, ಈ ಸೂಚನೆಗಳನ್ನು ಅನುಸರಿಸಿ: [Readme](https://github.com/firstcontributions/first-contributions) ಓಪನ್‌ಸೋರ್ಸ್ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿಗೆ ಕೊಡುಗೆ ನೀಡುವುದು ಒಬ್ಬ ಪ್ರೋಗ್ರಾಮರ್ ಆಗಿ ಬೆಳೆಯಲು, ನಿಮ್ಮ ಪೋರ್ಟ್‌ಫೋಲಿಯೋವನ್ನು ನಿರ್ಮಿಸಲು ಮತ್ತು ಸಮುದಾಯಕ್ಕೆ ಹಿಂದಿರುಗಿಸಲು ಅತ್ಯುತ್ತಮ ಮಾರ್ಗಗಳಲ್ಲಿ ಒಂದು. ನೀವು ಅನುಭವಸಂಪನ್ನ ಪ್ರೋಗ್ರಾಮರ್ ಆಗಿರಲಿ ಅಥವಾ ಪ್ರಾರಂಭದಲ್ಲೇ ಇರಲಿ, ಓಪನ್‌ಸೋರ್ಸ್ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳು ಕಲಿಯಲು, ಸಹಕರಿಸಲು ಮತ್ತು ಸಕಾರಾತ್ಮಕ ಪರಿಣಾಮವನ್ನುಂಟುಮಾಡಲು ಹಲವಾರು ಅವಕಾಶಗಳನ್ನು ಒದಗಿಸುತ್ತವೆ. ಈ ಮಾರ್ಗದರ್ಶಿಯಲ್ಲಿ, ಸರಿಯಾದ ಪ್ರಾಜೆಕ್ಟ್‌ನ್ನು ಹುಡುಕುವುದರಿಂದ ಹಿಡಿದು ನಿಮ್ಮ ಮೊದಲ ಕೊಡುಗೆಯನ್ನು ನೀಡುವವರೆಗಿನ ಎಲ್ಲಾ ಹಂತಗಳನ್ನು ನೋಡೋಣ. ## ಏಕೆ ಓಪನ್‌ಸೋರ್ಸ್ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಿಗೆ ಕೊಡುಗೆ ನೀಡಬೇಕು? "ಹೇಗೆ" ಎಂಬುದರ ಮೊದಲು, "ಏಕೆ" ಎಂಬುದನ್ನು ತಿಳಿಯೋಣ: * **ಕೌಶಲ್ಯ ಅಭಿವೃದ್ಧಿ:** ನೈಜ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳ ಕೋಡ್‌ಗಳನ್ನು ನೋಡಿ ಕಲಿಯುವ ಮೂಲಕ ನಿಮ್ಮ ಪ್ರೋಗ್ರಾಮಿಂಗ್, ಡಿಬಗ್ಗಿಂಗ್ ಮತ್ತು ಸಹಕಾರದ ಕೌಶಲ್ಯಗಳು ಬೆಳೆಯುತ್ತವೆ. * **ಪೋರ್ಟ್‌ಫೋಲಿಯೋ ನಿರ್ಮಾಣ:** ಪ್ರಸಿದ್ಧ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಲ್ಲಿ ಕೊಡುಗೆ ನೀಡುವುದು ನಿಮ್ಮ CV ಮತ್ತು GitHub ಪ್ರೊಫೈಲ್ ಅನ್ನು ಬಲಪಡಿಸುತ್ತದೆ. * **ನೆಟ್ವರ್ಕಿಂಗ್:** ಜಗತ್ತಿನಾದ್ಯಂತದ ಡೆವಲಪರ್‌ಗಳ ಜೊತೆ ಸಂಪರ್ಕ ಬೆಳೆಸಿ, ತಜ್ಞರಿಂದ ಕಲಿಯಿರಿ ಮತ್ತು ಸಮುದಾಯದ ಭಾಗವಾಗಿರಿ. * **ಹಿಂದಿರುಗಿಸುವುದು:** ನಾವು ಪ್ರತಿದಿನ ಬಳಸುವ ಅನೇಕ ಸಾಫ್ಟ್‌ವೇರ್‌ಗಳ ಆಧಾರ ಓಪನ್‌ಸೋರ್ಸ್ ಆಗಿದೆ. ಕೊಡುಗೆ ನೀಡುವುದು ಧನ್ಯವಾದ ಹೇಳುವ ಮಾರ್ಗ. * **ವೃತ್ತಿ ಅವಕಾಶಗಳು:** ಅನೇಕ ಕಂಪನಿಗಳು ಓಪನ್‌ಸೋರ್ಸ್ ಅನುಭವ ಹೊಂದಿರುವ ಡೆವಲಪರ್‌ಗಳನ್ನು ಹುಡುಕುತ್ತವೆ ಏಕೆಂದರೆ ಇದು ಪ್ರೊಆಕ್ಟಿವಿಟಿ ಮತ್ತು ತಂಡದ ಕೆಲಸವನ್ನು ತೋರಿಸುತ್ತದೆ. ## ಹೇಗೆ ಪ್ರಾರಂಭಿಸಬೇಕು? ### 1. ಸರಿಯಾದ ಪ್ರಾಜೆಕ್ಟ್ ಆಯ್ಕೆಮಾಡಿ ನಿಮ್ಮ ಆಸಕ್ತಿಗಳು ಮತ್ತು ಕೌಶಲ್ಯಗಳಿಗೆ ಹೊಂದಿಕೊಳ್ಳುವ ಪ್ರಾಜೆಕ್ಟ್‌ಗಳನ್ನು ಆರಿಸಿ: * **GitHub ಅನ್ವೇಷಿಸಿ:** `good-first-issue`, `help-wanted` ಮುಂತಾದ ಲೇಬಲ್‌ಗಳಿರುವ ಟಾಸ್ಕ್‌ಗಳನ್ನು ಹುಡುಕಿ. * **ಪ್ರೋಗ್ರಾಂಗಳಲ್ಲಿ ಭಾಗವಹಿಸಿ:** Google Summer of Code, Hacktoberfest ಮುಂತಾದವು ಉತ್ತಮ ಅವಕಾಶಗಳು. * **ನೀವು ಬಳಸುವ ಉಪಕರಣಗಳು:** ನೀವು ಬಳಸುವ ಲೈಬ್ರರಿ ಅಥವಾ ಫ್ರೇಮ್‌ವರ್ಕ್‌ಗಳಲ್ಲಿ ಕೊಡುಗೆ ನೀಡಿ. ### 2. ಪ್ರಾಜೆಕ್ಟ್‌ನ್ನು ಅರ್ಥಮಾಡಿಕೊಳ್ಳಿ * **ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ಓದಿ:** README ಮತ್ತು ಕೊಡುಗೆ ಮಾರ್ಗಸೂಚಿಗಳನ್ನು ಗಮನಿಸಿ. * **ಕೋಡ್‌ನ್ನು ಅಧ್ಯಯನ ಮಾಡಿ:** ಪ್ರಾಜೆಕ್ಟ್‌ನ ರಚನೆ ಮತ್ತು ಕೋಡಿಂಗ್ ಶೈಲಿಯನ್ನು ತಿಳಿದುಕೊಳ್ಳಿ. * **ಸಮುದಾಯಕ್ಕೆ ಸೇರಿ:** Slack, Discord ಅಥವಾ ಫೋರಮ್‌ಗಳಲ್ಲಿ ಚರ್ಚೆಗಳಲ್ಲಿ ಭಾಗವಹಿಸಿ. ### 3. ಚಿಕ್ಕ ಹಂತಗಳಿಂದ ಪ್ರಾರಂಭಿಸಿ * **ಬಗ್‌ಗಳನ್ನು ಸರಿಪಡಿಸಿ:** ಆರಂಭಿಕರಿಗೆ ಅನುಕೂಲಕರವಾದ issues ಹುಡುಕಿ. * **ಡಾಕ್ಯುಮೆಂಟೇಶನ್ ಸುಧಾರಿಸಿ:** ಬಹಳ ಉಪಯುಕ್ತವಾದರೂ ಹೆಚ್ಚಾಗಿ ಗಮನಿಸದೆ ಬಿಡಲಾಗುತ್ತದೆ. * **ಟೆಸ್ಟ್‌ಗಳನ್ನು ಬರೆಯಿರಿ:** ಕೋಡ್ ತಿಳಿಯಲು ಉತ್ತಮ ವಿಧಾನ. ### 4. ಉತ್ತಮ ಅಭ್ಯಾಸಗಳನ್ನು ಅನುಸರಿಸಿ * **Fork ಮತ್ತು Clone ಮಾಡಿ** * **ಪ್ರತ್ಯೇಕ branch ನಲ್ಲಿ ಕೆಲಸ ಮಾಡಿ** * **ಸ್ವಚ್ಛ ಕೋಡ್ ಬರೆಯಿರಿ** * **ನಿಮ್ಮ ಬದಲಾವಣೆಗಳನ್ನು ಪರೀಕ್ಷಿಸಿ** * **Pull Request ಕಳುಹಿಸಿ:** ಸ್ಪಷ್ಟ ವಿವರಣೆ ನೀಡಿ, ಸಂಬಂಧಿತ issue‌ಗಳನ್ನು ಉಲ್ಲೇಖಿಸಿ ಮತ್ತು feedback ಸ್ವೀಕರಿಸಲು ತೆರೆದಿರಲಿ. ## ಯಶಸ್ಸಿಗೆ ಸಲಹೆಗಳು * **ಸಮರ್ಪಕ ಸಂವಹನ ಮಾಡಿ:** ಗೌರವಪೂರ್ವಕವಾಗಿ ವರ್ತಿಸಿ ಮತ್ತು ಸ್ಪಷ್ಟವಾಗಿ ಪ್ರಶ್ನೆ ಮಾಡಿ. * **ಸ್ಥಿರತೆಯಿಂದಿರಿ:** ಸಣ್ಣ ಕೊಡುಗೆಗಳೂ ಸಮಯದೊಂದಿಗೆ ದೊಡ್ಡ ಪರಿಣಾಮ ಬೀರುತ್ತವೆ. * **ಫೀಡ್ಬ್ಯಾಕ್‌ನಿಂದ ಕಲಿಯಿರಿ:** ಕೋಡ್ ರಿವ್ಯೂ ಒಳ್ಳೆಯ ಕಲಿಕೆಯ ಅವಕಾಶ. * **ಇತರರಿಗೆ ಸಹಾಯ ಮಾಡಿ:** ನೀವು ಅನುಭವ ಹೊಂದಿದ ಮೇಲೆ ಹೊಸಬರಿಗೆ ಮಾರ್ಗದರ್ಶನ ನೀಡಿ. ## ಸಾಮಾನ್ಯ ಸವಾಲುಗಳು ಮತ್ತು ಪರಿಹಾರಗಳು * **Impostor Syndrome:** ಚಿಕ್ಕ ಕೊಡುಗೆಗಳೂ ಮುಖ್ಯ. ಎಲ್ಲರೂ ಎಲ್ಲಿಂದೋ ಆರಂಭಿಸಿದ್ದಾರೆ. * **ಸಮಯದ ಕೊರತೆ:** ಸಣ್ಣ ಟಾಸ್ಕ್‌ಗಳಿಂದ ಪ್ರಾರಂಭಿಸಿ. ವಾರಕ್ಕೆ 30 ನಿಮಿಷ ಕೂಡ ಸಾಕು. * **ದೊಡ್ಡ ಕೋಡ್‌ಬೇಸ್‌ ಅನ್ನು ನಾವಿಗೇಟ್ ಮಾಡುವುದು:** ಒಂದೊಂದೇ ಘಟಕ concentrate ಮಾಡಿ, documentation ಓದಿ, ಪ್ರಶ್ನೆಗಳನ್ನು ಕೇಳಿ. ## ಸಮಾರೋಪ ಓಪನ್‌ಸೋರ್ಸ್‌ಗೆ ಕೊಡುಗೆ ನೀಡುವುದು ವೈಯಕ್ತಿಕ ಮತ್ತು ವೃತ್ತಿಪರ ಬೆಳವಣಿಗೆಗೆ ದೊಡ್ಡ ಅವಕಾಶ. ಸಣ್ಣ ಹಂತಗಳಿಂದ ಆರಂಭಿಸಿ, ನಿಯಮಿತವಾಗಿರಿ, ಸಮುದಾಯದೊಂದಿಗೆ ಸಂವಹನ ಮಾಡಿ — ಹೀಗೆ ನಿಮ್ಮ ಕೌಶಲ್ಯಗಳನ್ನು ಬೆಳೆಸುತ್ತಾ ಪರಿಣಾಮಕಾರಿ ಕೊಡುಗೆಗಳನ್ನು ನೀಡಬಹುದು. ಪ್ರತಿಯೊಂದು ಕೊಡುಗೆಯೂ ಮಹತ್ವದ್ದೇ. ಇಂದೇ ಪ್ರಾರಂಭಿಸಿ — ನಿಮಗೆ ಇಷ್ಟವಾದ ಪ್ರಾಜೆಕ್ಟ್ ಹುಡುಕಿ, ಮೊದಲ ಕೊಡುಗೆ ನೀಡಿ ಮತ್ತು ಜಾಗತಿಕ ಓಪನ್‌ಸೋರ್ಸ್ ಚಳುವಳಿಯ ಭಾಗವಾಗಿರಿ! ================================================ FILE: docs/additional-material/translations/Kannada/keeping-your-fork-synced-with-this-repo.ka.md ================================================ ## ನಿಮ್ಮ Fork ಅನ್ನು ಈ ರೆಪೊಸಿಟರಿಯೊಂದಿಗೆ ಸಮನ್ವಯಗೊಳಿಸುವುದು ಮೊದಲು, ಪೂರ್ಣ ಸಮನ್ವಯದ ಪ್ರಕ್ರಿಯೆಯನ್ನು ಅರ್ಥಮಾಡಿಕೊಳ್ಳಬೇಕು. ಈ ಸಂದರ್ಭದಲ್ಲಿ, ನಮ್ಮಲ್ಲಿ ಮೂರು ಭಿನ್ನವಾದ ರೆಪೊಸಿಟರಿಗಳು ಇವೆ: ನನ್ನ ಸಾರ್ವಜನಿಕ ರೆಪೊಸಿಟರಿ GitHub ನಲ್ಲಿ `github.com/Roshanjossey/first-contributions/`, ನಿಮ್ಮ Fork GitHub ನಲ್ಲಿ `github.com/Your-Username/first-contributions/` ಮತ್ತು ನೀವು ಕೆಲಸ ಮಾಡುತ್ತಿರುವ ಸ್ಥಳೀಯ ರೆಪೊಸಿಟರಿ. ಈ ರೀತಿಯ ಸಹಯೋಗವನ್ನು *open source* (ಮುಕ್ತ ಆಕರ) ಪ್ರಾಜೆಕ್ಟ್‌ಗಳಲ್ಲಿ ಸಾಮಾನ್ಯವಾಗಿ `Triangle Workflow` ಎಂದು ಕರೆಯುತ್ತಾರೆ. triangle workflow ನಿಮ್ಮ ಎರಡು ರೆಪೊಸಿಟರಿಗಳನ್ನು ನನ್ನ ಸಾರ್ವಜನಿಕ ರೆಪೊಸಿಟರಿಯೊಂದಿಗೆ ನವೀಕರಿಸಲು, ಮೊದಲು ನೀವು ನನ್ನ ರೆಪೊಸಿಟರಿಯಿಂದ ನಿಮ್ಮ ಸ್ಥಳೀಯ ರೆಪೊಸಿಟರಿಗೆ `Fetch` ಮತ್ತು `Merge` ಮಾಡಬೇಕು. ಹಿಂದಿನ ಹಂತದ ನಂತರ, ನೀವು ನಿಮ್ಮ Fork ಗೆ ಸ್ಥಳೀಯ ಬದಲಾವಣೆಗಳನ್ನು `Push` ಮಾಡಬೇಕು. ನೀವು `Pull Request` ಅನ್ನು ಕೇವಲ ನಿಮ್ಮ Fork ನಿಂದ ಮಾತ್ರ ಮಾಡಬಹುದು, ಆದ್ದರಿಂದ Fork ನವೀಕರಿಸುವುದು ಅಂತಿಮ ಹಂತ. ### ಈ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ: #### 1. ನಿಮ್ಮ `master` ಶಾಖೆಯಲ್ಲಿ ಇರುವುದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ ನೀವು ಯಾವ ಶಾಖೆಯಲ್ಲಿ ಇರುವಿರಿ ಎಂಬುದನ್ನು ಪರಿಶೀಲಿಸಲು: ```bash git status ``` `master` ನಲ್ಲಿ ಇಲ್ಲದಿದ್ದರೆ, ಅದಕ್ಕೆ ಬದಲಾಯಿಸಿ: ```bash git checkout master ``` #### 2. ನನ್ನ ರೆಪೊಸಿಟರಿಯನ್ನು `upstream` ಎಂದು ಸೇರಿಸಿ ```bash git remote add upstream https://github.com/Roshanjossey/first-contributions ``` ಇದರಿಂದ Git ಗೆ ಈ URL ನಲ್ಲಿ ಇನ್ನೊಂದು ಆವೃತ್ತಿಯಿದೆ ಮತ್ತು ಅದನ್ನು `upstream` ಎಂದು ಕರೆಯುತ್ತೇವೆ ಎಂದು ತಿಳಿಯುತ್ತದೆ. #### 3. `upstream` ರೆಪೊಸಿಟರಿಯಿಂದ ಬದಲಾವಣೆಗಳನ್ನು ಪಡೆಯುವುದು ```bash git fetch upstream ``` ಇದು `upstream` ರೆಪೊಸಿಟರಿಯ ಎಲ್ಲಾ ಬದಲಾವಣೆಗಳನ್ನು ಪಡೆಯುತ್ತದೆ. #### 4. ಬದಲಾವಣೆಗಳನ್ನು ನಿಮ್ಮ `master` ಶಾಖೆಯಲ್ಲಿ ಪರಿಷ್ಕರಿಸುವುದು ```bash git rebase upstream/master ``` ಇದರಿಂದ ನೀವು `upstream` ನ ಬದಲಾವಣೆಗಳನ್ನು ನಿಮ್ಮ ಸ್ಥಳೀಯ `master` ಶಾಖೆಗೆ ಅನ್ವಯಿಸುತ್ತೀರಿ. #### 5. ಬದಲಾವಣೆಗಳನ್ನು ನಿಮ್ಮ GitHub Fork ಗೆ ಅಪ್‌ಲೋಡ್ ಮಾಡುವುದು ```bash git push origin master ``` ಇದು ನಿಮ್ಮ Fork (`origin`) ನಲ್ಲಿ ನಿಮ್ಮ `master` ಶಾಖೆಯನ್ನು ನವೀಕರಿಸುತ್ತದೆ. ಈಗ, ನಿಮ್ಮ Fork ಮತ್ತು ಸ್ಥಳೀಯ ರೆಪೊಸಿಟರಿ ಅಪ್‌ಡೇಟ್ ಆಗಿದೆ! ನಿಮಗೆ ಶುಭವಾಗಲಿ! ಪ್ರತಿಯೊಮ್ಮೆ ನಿಮ್ಮ GitHub Fork `commits behind` ಎಂಬ ಸಂದೇಶ ತೋರಿಸಿದಾಗ ಈ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ. ================================================ FILE: docs/additional-material/translations/Kannada/moving-a-commit-to-a-different-branch.ka.md ================================================ # commit ಅನ್ನು ಬೇರೆ branch ಗೆ ಸ್ಥಳಾಂತರಿಸುವುದು ನೀವು commit ಮಾಡಿದ್ದ ನಂತರ, ಅದು ತಪ್ಪಾಗಿ ಬೇರೆ branch ನಲ್ಲಿ ಆಗಿದೆ ಎಂದು ಗಮನಿಸಿದರೆ ಏನು ಮಾಡಬೇಕು? ಈ ಟ್ಯುಟೋರಿಯಲ್ ಇದನ್ನು ಸರಿಪಡಿಸುವ ಬಗ್ಗೆ. ## ಈಗಾಗಲೇ ಅಸ್ತಿತ್ವದಲ್ಲಿರುವ branch ಗೆ commit ಸ್ಥಳಾಂತರಿಸುವುದು ಈ ಕೆಳಗಿನ ಆಜ್ಞೆಗಳನ್ನು ಬಳಸಿ: ```bash git reset HEAD~ --soft # ಕೊನೆಯ commit ಅನ್ನು ಹಿಂದಕ್ಕೆ ಕೊಂಡು ಬರುತ್ತದೆ, ಆದರೆ ಪರಿಷ್ಕರಣೆಗಳನ್ನು ಉಳಿಸುತ್ತದೆ. git stash # ಪ್ರಸ್ತುತ ಸ್ಥಿತಿಯನ್ನು ಸಂಗ್ರಹಿಸುತ್ತದೆ. git checkout name-of-the-correct-branch # ಸರಿಯಾದ branch ಗೆ ತೆರಳುತ್ತದೆ. git stash pop # ಹಿಂದಿನ ಸ್ಥಿತಿಯನ್ನು ಪುನಃ ಪ್ರಸ್ತಾಪಿಸುತ್ತದೆ. git add . # ಎಲ್ಲಾ ಪರಿಷ್ಕರಣೆಗಳನ್ನು stage ಮಾಡುತ್ತದೆ. git commit -m "your message here" # commit ಮಾಡುತ್ತದೆ. ``` ಈಗ ನಿಮ್ಮ ಪರಿಷ್ಕರಣೆಗಳು ಸರಿಯಾದ branch ನಲ್ಲಿ ಇವೆ. ## ಹೊಸ branch ಗೆ commit ಸ್ಥಳಾಂತರಿಸುವುದು ```bash git branch newbranch # ಹೊಸ branch ರಚಿಸುತ್ತದೆ. git reset --hard HEAD~# # # ಗಿಂತ ಹಳೆಯ commit ಗಳನ್ನು ಹಿಂದಕ್ಕೆ ತೆಗೆದುಕೊಳ್ಳುತ್ತದೆ (ಈಗಿನ branch ನಿಂದ ಅಳಿಸಿಬಿಡುತ್ತದೆ!). git checkout newbranch # ಹೊಸ branch ಗೆ ಸ್ಥಳಾಂತರವಾಗುತ್ತದೆ. ``` **ಗಮನಿಸಿ:** ಯಾವುದೇ commit ಆಗದ ಪರಿಷ್ಕರಣೆಗಳು ಇಲ್ಲವಾಗುತ್ತವೆ! ================================================ FILE: docs/additional-material/translations/Kannada/removing-a-file.ka.md ================================================ # commit ಅನ್ನು ಬೇರೆ branch ಗೆ ಸ್ಥಳಾಂತರಿಸುವುದು ನೀವು commit ಮಾಡಿದ್ದ ನಂತರ, ಅದು ತಪ್ಪಾಗಿ ಬೇರೆ branch ನಲ್ಲಿ ಆಗಿದೆ ಎಂದು ಗಮನಿಸಿದರೆ ಏನು ಮಾಡಬೇಕು? ಈ ಟ್ಯುಟೋರಿಯಲ್ ಇದನ್ನು ಸರಿಪಡಿಸುವ ಬಗ್ಗೆ. ## ಈಗಾಗಲೇ ಅಸ್ತಿತ್ವದಲ್ಲಿರುವ branch ಗೆ commit ಸ್ಥಳಾಂತರಿಸುವುದು ಈ ಕೆಳಗಿನ ಆಜ್ಞೆಗಳನ್ನು ಬಳಸಿ: ```bash git reset HEAD~ --soft # ಕೊನೆಯ commit ಅನ್ನು ಹಿಂದಕ್ಕೆ ಕೊಂಡು ಬರುತ್ತದೆ, ಆದರೆ ಪರಿಷ್ಕರಣೆಗಳನ್ನು ಉಳಿಸುತ್ತದೆ. git stash # ಪ್ರಸ್ತುತ ಸ್ಥಿತಿಯನ್ನು ಸಂಗ್ರಹಿಸುತ್ತದೆ. git checkout name-of-the-correct-branch # ಸರಿಯಾದ branch ಗೆ ತೆರಳುತ್ತದೆ. git stash pop # ಹಿಂದಿನ ಸ್ಥಿತಿಯನ್ನು ಪುನಃ ಪ್ರಸ್ತಾಪಿಸುತ್ತದೆ. git add . # ಎಲ್ಲಾ ಪರಿಷ್ಕರಣೆಗಳನ್ನು stage ಮಾಡುತ್ತದೆ. git commit -m "your message here" # commit ಮಾಡುತ್ತದೆ. ``` ಈಗ ನಿಮ್ಮ ಪರಿಷ್ಕರಣೆಗಳು ಸರಿಯಾದ branch ನಲ್ಲಿ ಇವೆ. ## ಹೊಸ branch ಗೆ commit ಸ್ಥಳಾಂತರಿಸುವುದು ```bash git branch newbranch # ಹೊಸ branch ರಚಿಸುತ್ತದೆ. git reset --hard HEAD~# # # ಗಿಂತ ಹಳೆಯ commit ಗಳನ್ನು ಹಿಂದಕ್ಕೆ ತೆಗೆದುಕೊಳ್ಳುತ್ತದೆ (ಈಗಿನ branch ನಿಂದ ಅಳಿಸಿಬಿಡುತ್ತದೆ!). git checkout newbranch # ಹೊಸ branch ಗೆ ಸ್ಥಳಾಂತರವಾಗುತ್ತದೆ. ``` **ಗಮನಿಸಿ:** ಯಾವುದೇ commit ಆಗದ ಪರಿಷ್ಕರಣೆಗಳು ಇಲ್ಲವಾಗುತ್ತವೆ! --- # Git ನಿಂದ ಫೈಲ್ ಅನ್ನು ತೆಗೆದುಹಾಕುವುದು ಕಾಲಕಾಲಕ್ಕೆ, Git ನಿಂದ ಫೈಲ್ ಅನ್ನು ತೆಗೆದುಹಾಕಬೇಕು, ಆದರೆ ಅದನ್ನು ನಿಮ್ಮ ಕಂಪ್ಯೂಟರ್ ನಿಂದ ಅಳಿಸಬಾರದು. ಇದನ್ನು ಈ ಕೆಳಗಿನ ಆಜ್ಞೆಯ ಮೂಲಕ ಮಾಡಬಹುದು: ```bash git rm --cached ``` ## ಆಗಿದ್ದು ಏನು? Git ಫೈಲ್ ಅನ್ನು ಟ್ರ್ಯಾಕ್ ಮಾಡುವುದನ್ನು ನಿಲ್ಲಿಸುತ್ತದೆ. Git ಗೆ, ಅದು ಅಳಿಸಿದಂತೆ ಕಾಣುತ್ತದೆ, ಆದರೆ ನಿಮ್ಮ ಕಂಪ್ಯೂಟರ್ ನಲ್ಲಿ ಅದು ಇನ್ನೂ ಇರುತ್ತದೆ. **ಗಮನಿಸಿ:** `--cached` ಆಯ್ಕೆಯನ್ನು ಬಳಸಿದರೆ ಮಾತ್ರ ಫೈಲ್ ಅನ್ನು Git ನಿಂದ ತೆಗೆದುಹಾಕಿ, ಆದರೆ ನಿಮ್ಮ ಸಿಸ್ಟಮ್ ನಲ್ಲೇ ಇರಿಸಿಕೊಳ್ಳಬಹುದು. ಈ ಆಯ್ಕೆಯನ್ನು ಬಳಸದೆ `git rm ` ಮಾಡಿದರೆ, ಅದು ನಿಮ್ಮ ಕಂಪ್ಯೂಟರ್ ನಿಂದಲೂ ಫೈಲ್ ಅನ್ನು ಅಳಿಸಿಬಿಡುತ್ತದೆ. ನೀವು ಈ ಬದಲಾವಣೆಯನ್ನು commit ಮಾಡಿ, `git push origin master` ಬಳಸಿದರೆ, ಫೈಲ್ ನಿಮ್ಮ ರಿಮೋಟ್ ರೆಪೊಸಿಟರಿಯಿಂದಲೂ ಅಳಿಸಿಬಿಡುತ್ತದೆ. ## ಹೆಚ್ಚುವರಿ ವಿಶೇಷತೆಗಳು - ಹಲವಾರು ಫೈಲ್ ಗಳನ್ನು ಒಂದೇ ಆಜ್ಞೆಯಲ್ಲಿ ತೆಗೆದುಹಾಕಲು: ```bash git rm file1.js file2.js file3.js --cached ``` - ಫೈಲ್ ಮಾದರಿಗಳನ್ನು ಬಳಸಿ ಫೈಲ್ ಗಳನ್ನು ತೆಗೆದುಹಾಕಲು: ```bash git rm *.txt --cached # ಎಲ್ಲಾ .txt ಫೈಲ್ ಗಳನ್ನು Git ನಿಂದ ತೆಗೆದುಹಾಕುತ್ತದೆ. ``` ================================================ FILE: docs/additional-material/translations/Kannada/removing-branch-from-your-repo.ka.md ================================================ ## ನಿಮ್ಮ ರೆಪೊಸಿಟರಿಯಿಂದ ಬ್ರಾಂಚ್ ಅನ್ನು ತೆಗೆದುಹಾಕುವುದು ನೀವು ಈ ಟ್ಯುಟೋರಿಯಲ್ ಅನ್ನು ಇದುವರೆಗೆ ಅನುಸರಿಸಿದ್ದರೆ, ನಿಮ್ಮ ಬ್ರಾಂಚ್ `` ತನ್ನ ಗುರಿಯನ್ನು ಪೂರ್ಣಗೊಳಿಸಿದೆ, ಮತ್ತು ಅದನ್ನು ನಿಮ್ಮ ಸ್ಥಳೀಯ ರೆಪೊಸಿಟರಿಯಿಂದ ಅಳಿಸುವ ಸಮಯವಾಗಿದೆ. ಇದು ಅಗತ್ಯವಿಲ್ಲ, ಆದರೆ ಆ ಬ್ರಾಂಚ್‌ನ ಹೆಸರೇ ಅದರ ಉದ್ದೇಶವನ್ನು ಸ್ಪಷ್ಟಪಡಿಸುತ್ತದೆ. ಅದರ ಅವಧಿ ಈ ನಿರ್ದಿಷ್ಟತೆಯಿಂದ ಸ್ವಲ್ಪ ಕಾಲ ಮಾತ್ರ ಇರಬಹುದು. ಮೊದಲು, `` ಬ್ರಾಂಚ್ ಅನ್ನು ನಿಮ್ಮ ಮುಖ್ಯ ಬ್ರಾಂಚ್ (master) ಗೆ ವಿಲೀನಗೊಳಿಸೋಣ, ಆದ್ದರಿಂದ ಅದಕ್ಕೆ ಹೋಗೋಣ: ``` git checkout master ``` `` ಅನ್ನು master ಗೆ ವಿಲೀನಗೊಳಿಸಿ: ``` git merge master ``` `` ಅನ್ನು ನಿಮ್ಮ ಸ್ಥಳೀಯ ರೆಪೊಸಿಟರಿಯಿಂದ ತೆಗೆದುಹಾಕಿ: ``` git branch -d ``` ಈಗ ನೀವು ನಿಮ್ಮ ಸ್ಥಳೀಯ `` ಬ್ರಾಂಚ್ ಅನ್ನು ಅಳಿಸಿದ್ದೀರಿ, ಮತ್ತು ಎಲ್ಲವೂ ಸ್ವಚ್ಛ ಮತ್ತು ಕ್ರಮಬದ್ಧವಾಗಿದೆ. ಈ ಹಂತದಲ್ಲಿ, ನೀವು ಇನ್ನೂ ನಿಮ್ಮ ಫೋರ್ಕ್‌ನಲ್ಲಿ `` ಬ್ರಾಂಚ್ ಅನ್ನು ಹೊಂದಿರಬಹುದು. ಅದನ್ನು ಅಳಿಸುವ ಮೊದಲು, ನೀವು ಈ ಬ್ರಾಂಚ್‌ನಿಂದ ನನ್ನ ರೆಪೊಸಿಟರಿಗೆ ಪುಲ್ ರಿಕ್ವೆಸ್ಟ್ ಕಳುಹಿಸಿದ್ದೀರಾ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ. ಹೀಗಾಗಿ ನಾನು ಇದನ್ನು ಈಗಾಗಲೇ ವಿಲೀನಗೊಳಿಸಿಲ್ಲದಿದ್ದರೆ, ಅದನ್ನು ಅಳಿಸಬೇಡಿ. ಆದರೆ, ನಾನು ಈಗಾಗಲೇ ನಿಮ್ಮ ಬ್ರಾಂಚ್ ಅನ್ನು ವಿಲೀನಗೊಳಿಸಿದ್ದರೆ ಮತ್ತು ನೀವು ರಿಮೋಟ್ ಬ್ರಾಂಚ್ ಅನ್ನು ಅಳಿಸಲು ಬಯಸಿದರೆ, ಈ ಆಜ್ಞೆಯನ್ನು ಬಳಸಿ: ``` git push origin --delete ``` ಇತ್ತೀಚಿನ ಬ್ರಾಂಚ್‌ಗಳನ್ನು ನೀವು ಹೇಗೆ ನಿರ್ವಹಿಸಬಹುದು ಎಂಬುದನ್ನು ನೀವು ಈಗ ತಿಳಿದಿದ್ದೀರಿ. ಕಾಲಾಂತರದಲ್ಲಿ, ನನ್ನ ಸಾರ್ವಜನಿಕ ರೆಪೊಸಿಟರಿಯಲ್ಲಿ ಅನೇಕ ಕಮಿಟ್‌ಗಳು ಸೇರಿಕೊಳ್ಳುತ್ತವೆ. ನಿಮ್ಮ ಲ್ಯಾಪ್‌ಟಾಪ್‌ನಲ್ಲಿನ ಮತ್ತು ಫೋರ್ಕ್‌ನಲ್ಲಿನ ಮುಖ್ಯ ಬ್ರಾಂಚ್‌ಗಳು ಇನ್ನಷ್ಟು ಅಪ್‌ಡೇಟ್ ಆಗಿರುವುದಿಲ್ಲ. ಹೀಗಾಗಿ, ನಿಮ್ಮ ರೆಪೊಸಿಟರಿಗಳನ್ನು ನನ್ನದೊಂದಿಗೆ ಸಿಂಕ್ರೀನೈಸ್ ಮಾಡುವುದಕ್ಕಾಗಿ, ಕೆಳಗಿನ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ. #### [ನಿಮ್ಮ ಫೋರ್ಕ್ ಅನ್ನು ಈ ರೆಪೊಸಿಟರಿಯೊಂದಿಗೆ ಸಿಂಕ್ರೊನೈಸ್ ಮಾಡುವುದು](keeping-your-fork-synced-with-this-repository.pt_br.md) ================================================ FILE: docs/additional-material/translations/Korean/Things a non Programmer can do.kr.md ================================================ ## 오픈소스 프로젝트는 프로그래머만 기여할 수 있는 것이 아닙니다. 코딩 실력이 없어도 오픈소스 프로젝트에 참여하고 기여할 수 있는 다양한 방법들이 있습니다. ## 경청하기 오픈소스의 모든 것은 다른 사람들과의 상호작용을 포함합니다. 여러분은 팀에 합류하려는 것이므로, 커뮤니티와 그 작동 방식을 이해하는 것이 중요합니다. 프로젝트에 불쑥 끼어들어 "안녕하세요, 이 프로젝트는 이렇게 해야 한다고 생각합니다"라고 말하는 것은 일반적으로 좋게 받아들여지지 않습니다. 그런 접근 방식을 환영하는 프로젝트도 있겠지만, 프로젝트가 오랫동안 진행되어 온 경우 그러한 태도가 받아들여질 가능성은 적습니다. **경청하는 것이 프로젝트에 필요한 것을 아는 가장 좋은 방법입니다.** 1. **메일링 리스트 가입하기**: 많은 프로젝트에서 메일링 리스트는 프로젝트 개발에 대한 주요 커뮤니케이션 수단입니다. 대규모 프로젝트에는 선택할 수 있는 메일링 리스트가 많습니다. 예를 들어, PostgreSQL 프로젝트는 메일링 리스트 페이지에 사용자 중심 리스트 12개 이상과 개발자 리스트 6개를 보유하고 있습니다. 시작하려면 주요 사용자 중심 리스트와 핵심 개발자 리스트를 팔로우하여 경청하는 것을 추천합니다. 2. **블로그 팔로우하기**: 핵심 개발자들이 운영하는 블로그는 종종 향후 릴리스에 대한 정보와 그 과정에 대한 정보를 제공합니다. 플래닛 사이트는 프로젝트와 관련된 여러 출처의 뉴스 및 블로그 게시물을 모아 보여줍니다. planet.gnome.org나 planet.mysql.com과 같은 플래닛 사이트가 있다면 거기서부터 시작하세요. Google에서 "planet <프로젝트 이름>"으로 검색해보세요. 3. **IRC 채널 가입하기**: 많은 오픈소스 프로젝트에는 개발자와 사용자가 문제 및 개발에 대해 논의하는 전용 IRC(Internet Relay Chat) 채널이 있습니다. 프로젝트 웹사이트에서 채널 이름과 IRC 네트워크 세부 정보를 확인하세요. ## 티켓 작업하기 코드는 모든 오픈소스 프로젝트의 핵심이지만, 코드를 작성하는 것만이 기여하는 유일한 방법이라고 생각하지 마세요. 코드 유지 보수 및 코드를 둘러싼 시스템은 새로운 기능을 만들고 버그를 수정하는 데 급급하여 종종 소홀히 다루어집니다. 이러한 영역을 프로젝트에 발을 들여놓을 수 있는 쉬운 방법으로 살펴보세요. 대부분의 프로젝트에는 프로젝트 웹사이트 첫 페이지에 링크되어 있고 문서에 포함된 공개적으로 볼 수 있는 문제 티켓 시스템이 있습니다. 이는 사용자와 개발자 간의 주요 커뮤니케이션 수단입니다. 이를 최신 상태로 유지하는 것은 프로젝트를 돕는 좋은 방법입니다. 티켓 시스템에서 특별한 권한을 얻어야 할 수도 있는데, 대부분의 프로젝트 리더는 티켓 정리를 돕고 싶다고 말하면 기꺼이 권한을 부여할 것입니다. 4. **버그 진단하기**: 버그는 종종 제대로 보고되지 않습니다. 버그를 진단하고 분류하는 것은 개발자가 문제의 세부 사항을 파악하는 데 드는 수고를 덜어줄 수 있습니다. 사용자가 "X를 하면 소프트웨어가 작동하지 않습니다"라고 보고했다면, 그 문제의 구체적인 내용이 무엇인지 파악하는 데 시간을 투자하세요. 반복 가능한가요? 문제를 반복적으로 발생시킬 수 있는 일련의 단계를 만들 수 있나요? 특정 브라우저에서만 발생하거나 특정 배포판에서만 발생하는 등 문제를 좁힐 수 있나요? 문제의 원인을 모르더라도, 상황을 좁히기 위해 기울인 노력은 다른 사람이 문제를 해결하는 것을 더 쉽게 만듭니다. 발견한 모든 것을 모든 사람이 볼 수 있도록 버그 시스템의 티켓에 추가하세요. 5. **수정된 버그 닫기**: 종종 버그는 코드베이스에서 수정되지만, 이에 대해 보고된 티켓은 티켓 시스템에서 업데이트되지 않습니다. 이러한 불필요한 것들을 정리하는 것은 시간이 많이 걸릴 수 있지만, 전체 프로젝트에 매우 중요합니다. 먼저 1년 이상 된 티켓을 티켓 시스템에서 쿼리하여 버그가 여전히 존재하는지 확인하세요. 프로젝트의 릴리스 변경 로그를 확인하여 버그가 수정되었고 닫을 수 있는지 확인하세요. 수정된 것으로 알려져 있다면 티켓에 버전 번호를 기록하고 닫으세요. 소프트웨어의 최신 버전으로 버그를 재현해보세요. 최신 버전으로 재현할 수 없다면 티켓에 기록하고 닫으세요. 여전히 존재한다면 티켓에 기록하고 열어 두세요. ## 코드 작업하기 모든 경험 수준의 프로그래머가 프로젝트의 코드를 도울 수 있습니다. 좋아하는 프로젝트에 실질적인 기여를 하기 위해 코딩 천재가 되어야 한다고 생각하지 마세요. 작업에 코드 수정이 포함된다면, 프로젝트가 기여자로부터 코드를 받는 데 사용하는 방법을 조사하세요. 각 프로젝트마다 고유한 워크플로우가 있으므로, 코드를 제출하기 전에 어떻게 해야 하는지 물어보세요. 예를 들어, PostgreSQL 프로젝트는 매우 엄격한 프로세스를 따릅니다. 코드 수정은 핵심 개발자들이 변경 사항의 모든 측면을 면밀히 조사하는 메일링 리스트에 패치 형태로 전송됩니다. 반대편에는 Parrot과 같이 코드베이스에 커밋 권한을 쉽게 얻을 수 있는 프로젝트도 있습니다. 프로젝트가 GitHub를 사용하는 경우, GitHub의 풀 리퀘스트 기능을 사용하는 워크플로우가 있을 수 있습니다. 어떤 프로젝트도 똑같지 않습니다. 코드를 수정할 때마다 커뮤니티의 책임 있는 구성원으로서 행동하고 코드 스타일을 나머지 코드베이스와 일치시키도록 하세요. 추가하거나 수정하는 코드는 다른 코드와 같아야 합니다. 중괄호 스타일이나 들여쓰기를 위한 공백 처리가 마음에 들지 않을 수도 있지만, 기존 표준과 일치하지 않는 코드 변경을 제출하는 것은 무례한 행동입니다. 이는 "당신의 스타일이 마음에 들지 않고 내 스타일이 더 낫다고 생각하므로 내 방식대로 해야 합니다"라고 말하는 것과 같습니다. 6. **베타 또는 릴리스 후보 테스트하기**: 여러 플랫폼에서 실행되도록 설계된 모든 프로젝트는 온갖 종류의 이식성 문제를 겪을 수 있습니다. 릴리스가 다가오고 베타 또는 릴리스 후보가 게시되면 프로젝트 리더는 많은 다른 사람들이 많은 다른 플랫폼에서 테스트하기를 바랍니다. 여러분은 그 사람들 중 한 명이 되어 패키지가 자신의 플랫폼에서 작동하는지 확인하는 데 도움을 줄 수 있습니다. 일반적으로 소프트웨어를 다운로드, 빌드 및 테스트하기만 하면 되지만, 흔하지 않은 배포판이나 하드웨어를 사용하고 있다면 프로젝트에 엄청난 가치를 제공할 수 있습니다. 빌드 및 테스트가 작동한다고 보고하는 것만으로도 프로젝트 리더는 임박한 릴리스가 견고하다는 것을 알 수 있습니다. 7. **버그 수정하기**: 이것은 일반적으로 코드 작업을 시작하려는 기여자들의 시작점입니다. 간단합니다. 티켓 시스템에서 흥미롭게 들리는 버그를 찾아 코드에서 수정하려고 시도하세요. 적절하다면 코드에 수정 사항을 문서화하세요. 수정한 코드 부분을 테스트하기 위해 테스트 스위트에 테스트를 추가하는 것이 좋습니다. 일부 프로젝트에서는 버그 수정에 테스트를 포함하도록 요구합니다. 이 익숙하지 않은 코드베이스를 살펴보면서 메모를 계속 작성하세요. 버그를 수정할 수 없더라도 수정 시도의 일환으로 발견한 내용을 티켓에 문서화하세요. 여러분이 발견한 내용은 다음에 오는 사람들에게 도움이 됩니다. 8. **테스트 작성하기**: 대부분의 프로젝트에는 코드를 테스트하는 테스트 스위트가 있지만, 더 많은 테스트를 추가할 수 없는 테스트 스위트는 상상하기 어렵습니다. C 언어용 gcov 또는 Perl용 Devel::Cover와 같은 테스트 커버리지 도구를 사용하여 테스트 스위트에서 테스트되지 않는 소스 코드 영역을 식별하세요. 그런 다음, 테스트를 스위트에 추가하여 해당 영역을 커버하세요. 9. **컴파일러 경고 잠재우기**: 많은 C 기반 프로젝트의 빌드 프로세스는 종종 이상한 컴파일러 경고 플래그를 화면에 뿜어냅니다. 이러한 경고는 일반적으로 문제의 지표는 아니지만 그렇게 보일 수 있습니다. 너무 많은 경고는 컴파일러가 거짓 경고를 하는 것처럼 들리게 할 수 있습니다. 코드가 실제로 버그를 숨기고 있는지 확인하세요. 그렇지 않다면, 소스를 수정하여 잠재우는 것은 이러한 오탐을 숨기는 데 도움이 됩니다. 10. **주석 추가하기**: 코드를 살펴보는 동안 혼란스러운 부분이 있을 수 있습니다. 여러분이 혼란스러웠다면 다른 사람들도 마찬가지일 가능성이 높습니다. 코드에 문서화하고 패치를 제출하세요. ## 문서 작업하기 문서는 일반적으로 프로젝트에서 소홀히 다루어지는 부분입니다. 또한 프로젝트에 익숙한 사람들의 관점에서 작성되어, 막 시작하는 사람의 관점이 아닌 경우도 있습니다. "이 매뉴얼은 내가 이미 이 패키지를 사용하는 방법을 알고 있다고 기대하는 것 같아"라고 생각한 적이 있다면 제가 무슨 말을 하는지 아실 겁니다. 종종 새로운 시선은 프로젝트와 가까운 사람들이 알아차리지 못하는 문서의 결함을 지적할 수 있습니다. 11. **예시 만들기**: 예시가 너무 많은 프로젝트는 없습니다. 웹 API든, 루틴 라이브러리든, Gimp와 같은 GUI 앱이든, 명령줄 도구든, 올바른 사용법에 대한 좋은 예시는 수백 페이지의 문서보다 더 명확하고 빠르게 소프트웨어의 올바른 사용법을 설명할 수 있습니다. API나 라이브러리의 경우, 도구를 사용하는 예시 프로그램을 만드세요. 이는 여러분이 작성한 코드에서 최소한의 필수적인 부분만 추출하여 만들 수도 있습니다. 도구의 경우, 일상생활에서 어떻게 사용했는지에 대한 실제 사례를 보여주세요. 시각적인 것을 선호한다면, 애플리케이션 설치 방법과 같은 중요한 프로세스의 화면 캡처를 만드는 것을 고려해 보세요. ## 커뮤니티와 함께 작업하기 오픈소스는 코드에 관한 것만이 아닙니다. 커뮤니티가 오픈소스가 작동하도록 만듭니다. 커뮤니티를 구축하는 데 도움을 줄 수 있는 방법은 다음과 같습니다. 12. **질문에 답하기**: 커뮤니티를 구축하는 가장 좋은 방법은 다른 사람들을 돕는 것입니다. 특히 막 시작하는 사람들의 질문에 답하는 것은 프로젝트가 성장하고 번성하는 데 매우 중요합니다. 초보자를 돕는 데 시간을 투자하는 것은, 비록 "RTFM(매뉴얼을 읽으세요)"이라고 간단히 대답할 수 있는 질문일지라도, 나중에 또 다른 활발한 커뮤니티 구성원을 얻는 데 도움이 됩니다. 모든 사람은 어디서든 시작하며, 프로젝트는 활력을 유지하려면 꾸준한 인력 유입이 필요합니다. 13. **블로그 게시물 작성하기**: 블로그가 있다면, 사용하고 있는 프로젝트에 대한 경험에 대해 글을 써보세요. 소프트웨어를 사용하면서 직면했던 문제와 그것을 해결하기 위해 무엇을 했는지 이야기해 주세요. 이렇게 하면 두 가지 방식으로 도움이 됩니다. 하나는 프로젝트를 주변 사람들의 마음에 계속 각인시키는 데 도움이 되고, 다른 하나는 미래에 여러분과 같은 문제를 겪고 웹에서 해결책을 검색하는 모든 사람을 위한 기록을 만드는 데 도움이 됩니다. (기술적인 모험에 대한 블로그는 나중에 해당 소프트웨어를 사용하는 직업을 찾을 때 실제 경험을 보여주는 훌륭한 방법이기도 합니다.) 14. **웹사이트 개선하기**: 웹 디자인 기술이 있고 웹사이트를 개선하여 프로젝트의 대중적인 이미지를 향상시킬 수 있다면, 이는 잘 보낸 시간입니다. 아마도 프로젝트는 그래픽 전면 개편이나 프로젝트를 식별할 로고가 필요할 수도 있습니다. 이러한 기술은 커뮤니티에 부족할 수 있습니다. 저도 제 프로젝트 웹사이트에 그래픽 디자인 지원을 받을 수 있다면 좋을 것 같습니다. 15. **기술 문서 작성하기**: 애플리케이션이나 소프트웨어가 어떻게 작동하는지 설명할 수 있다면, 그것에 대한 기술 문서를 작성할 수 있습니다. 특히 일반 대중이 읽을 수 있도록 기술 문서를 업데이트, 개편, 확장 또는 만들고자 하는 오픈소스 프로젝트라면 더욱 그렇습니다. 일반 영어로 더 많이 쓸수록 좋습니다. 가장 좋은 점은 기술 문서를 작성하기 위해 프로그래머가 될 필요가 없다는 것입니다. 무엇보다도, 주변 사람들이 논의하는 내용을 경청하세요. 절실한 필요를 알아볼 수 있는지 살펴보세요. 예를 들어, 최근 Parrot 개발자 메일링 리스트에서 기존 Trac 설치를 버리고 GitHub를 문제 티켓 시스템으로 사용하기로 결정했습니다. 일부 사람들은 티켓을 GitHub 시스템으로 변환할 방법이 없었기 때문에 이 결정에 반대했습니다. 하루 동안 논쟁이 오고 간 후, 제가 끼어들어 "제가 변환기를 작성하면 어떨까요?"라고 말했습니다. 사람들은 그 아이디어에 열광했습니다. 저는 450개 이상의 티켓에 대한 변환 프로그램을 작성하는 데 시간을 보냈고, 그래서 티켓 기록을 하나도 잃지 않았습니다. 큰 성공이었습니다. 저는 참여할 수 있었고, 핵심 개발자들은 Parrot 작업에 집중할 수 있었습니다. 16. **다른 사람들을 가르치고 돕기**: 어떤 주제에 대해 더 많이 배우는 가장 좋은 방법은 그것을 가르치려고 노력하는 것입니다. 최고의 교사는 복잡한 내용을 간단한 예시로 설명할 수 있는 사람입니다. 따라서 최고의 학습자가 되고 프로그래밍 세계에서 최고가 되려면 최고의 교사가 되기 위해 노력해야 합니다. 다른 사람들을 가르치는 것은 자신에 대해 더 나은 기분을 느끼게 하고 직업에서 더 나은 기술과 지식을 얻는 데 도움이 될 것입니다. 누군가에게 도움을 받으면 혼자 간직하지 말고 다른 사람들과 공유하세요. 세상을 더 살기 좋은 곳으로 만드세요. ================================================ FILE: docs/additional-material/translations/Korean/additional-material.ko.md ================================================ # 추가 정보 여러분이 여기에 오기 전에 기본실습 과정을 이미 완료했다고 가정합니다. 이 문서는 고급 Git 기술에 대한 추가적인 정보를 제공합니다. ### [커밋 수정하기](amending-a-commit.ko.md) 이 문서는 원격 저장소의 커밋을 수정하는 방법에 대한 정보를 제공합니다. 커밋을 수정하는 것은 당신의 현재 브랜치 내 가장 최근의 커밋을 변경하는 한 방법입니다. 이는 커밋 메세지를 수정해야 하거나 커밋에 변경사항을 포함하지 않은 경우에 유용합니다. 당신은 원격 저장소에 커밋을 푸시하기 전까지 커밋을 계속해서 수정할 수 있습니다. > 당신이 만든 커밋을 수정해야 할 경우 사용하십시오. ### [git 설정하기](configuring-git.md) 이 문서는 git에서 사용자 정보 및 기타 옵션을 구성하는 방법에 대한 정보를 제공합니다. > git 설정을 더 잘 다루려면 이 단계를 수행하십시오. ### [여러분이 포크한 저장소와 싱크상태 유지하기](keeping-your-fork-synced-with-this-repository.ko.md) 이 문서는 포크 된 저장소를 기본 저장소로 최신 상태로 유지하는 방법에 대한 정보를 제공합니다. 여러분과 다른 많은 사람들이 프로젝트에 기여하기를 바랍니다. > 포크 된 상위 저장소가 변경되지 않은 경우 다음 단계를 수행하십시오. ### [커밋을 다른 브랜치로 이동하기](moving-a-commit-to-a-different-branch.ko.md) 이 문서는 커밋을 다른 브랜치로 이동하는 방법에 대한 정보를 제공합니다. > 이 단계를 수행하여 커밋을 다른 브랜치로 이동하십시오. ### [파일 삭제하기](removing-a-file.ko.md) 이 문서는 로컬 저장소에서 파일을 지우는 방법에 대한 정보를 제공합니다. > 커밋 전에 파일을 삭제하는 방법을 배우려면 다음의 과정을 수행하십시오. ### [여러분의 저장소에서 브랜치 삭제하기](removing-branch-from-your-repository.ko.md) 이 문서는 저장소에서 브랜치를 삭제하는 방법에 대한 정보를 제공합니다. > PR(pull request) 요청이 병합 된 후에 본 단계를 수행하십시오. ### [병합 충돌 해결하기](resolving-merge-conflicts.ko.md) 이 문서는 병합 충돌을 해결하는 방법에 대한 정보를 제공합니다. > 이 단계를 수행하여 곤란한 병합 충돌을 해결하십시오. ### [커밋 되돌리기](reverting-a-commit.ko.md) 이 문서는 원격 저장소에서 커밋을 되돌리는 방법에 대한 정보를 제공합니다. 이미 Github에 푸시 된 커밋을 되돌리려는 경우 유용합니다. > 커밋을 되돌리려면 이 단계를 수행하십시오. ### [스쿼시 커밋하기](../squashing-commits.md) 이 문서는 대화형 리베이스로 커밋을 스쿼시하는 방법에 대한 정보를 제공합니다. > 오픈 소스 프로젝트에서 PR을 보낼 때 리뷰어가 모든 커밋을 하나로 스쿼시하도록 요청하는 경우 유익한 커밋 메시지와 함께 이것을 사용하십시오. ### [로컬 커밋 되돌리기](undoing-a-commit.ko.md) 이 문서는 로컬 저장소에서 커밋을 실행 취소하는 방법에 대한 정보를 제공합니다. 로컬 저장소가 엉망이라고 느껴 당신이 로컬 저장소를 리셋하고자 할 때 당신이 해야 할 일입니다. > 로컬 커밋을 취소하려면 이 단계를 수행하십시오. ### [유용한 링크](../Useful-links-for-further-learning.md) 이 문서는 모든 블로그 게시물, 유용한 사이트, 유용한 정보 및 웹 사이트에 대한 내용을 담고 있습니다. 우리가 모든 필요를 위해 참조하는 것은 초심자 또는 전문가 일 것입니다. 이 페이지는 오픈 소스 도메인을 처음 접하거나 더 많은 것을 배우고자 하는 사람들을 돕는 지표 역할을 해야 합니다. ### [.gitignore 파일 생성하기](creating-a-gitignore-file.ko.md) 이 문서는 .gitignore 파일의 역할, 사용 이유 및 .gitignore 파일 생성 방법을 설명합니다. 이 파일은 거의 모든 git 프로젝트에 사용됩니다. 이는 필요한 파일만 git에 커밋하도록 돕습니다. ### [크리덴셜 저장하기](storing-credentials.ko.md) 이 문서는 저장소들의 크리덴셜을 저장하는 방법을 설명합니다. 이는 보안 관련 문제가 될 수 있으므로, 당신의 직장/ 학업 에 알맞은 보안 정책을 따르십시오. ================================================ FILE: docs/additional-material/translations/Korean/amending-a-commit.ko.md ================================================ ## 커밋 수정하기 만약 커밋 메시지에 오타가 있거나 가장 최근의 커밋에서 몇줄을 빼먹은 걸 나중에 깨닫고 원격 저장소로 커밋을 수정하고자 하는 경우 어떻게 할까요? 이 자습서는 이러한 내용을 다룹니다. ### Github에 이미 푸시한 후에 최근 커밋 메시지 변경하기 파일을 열지 않고 수행할 경우: * 다음을 타이핑합니다. ```git commit --amend -m "followed by your new commit message"``` * 변경사항을 저장소에 커밋하려면 다음을 실행합니다. ```git push origin ``` 참고: 단지 ```git commit --amend``` 이것만 입력한다면, 텍스트 편집기가 커밋 메시지를 입력하라고 할 것입니다. ``-m`` 플래그를 추가하면 이것을 막을 수 있습니다. ### Modifying on a single commit 그럼 한 단어를 변경하는 것과 같이 사소한 변경사항을 깜빡하고 커밋을 이미 원격 저장소에 푸시했다면 어떻게 해야 할까요? 이를 설명하기 위해 여기 제 커밋 로그가 있습니다: ``` g56123f create file bot file a2235d updated contributor.md a5da0d modified bot file ``` 봇 파일에 한 단어를 추가하는 것을 깜빡했다고 해 봅시다. 이 경우 두가지 방법이 있습니다. 첫번째는 다음과 같이 변경사항을 포함하는 완전히 새로운 커밋을 수행하는 것입니다: ``` g56123f create file botfile a2235d updated contributor.md a5da0d modified botfile b0ca8f added single word to botfile ``` 두번째 방법은 a5da0d 커밋을 수정하고, 새 단어를 추가하고 이를 하나의 커밋으로 Github에 푸시하는 것 입니다. 이 방법은 사소한 변화이기 때문에 더 나을수도 있습니다. 이를 위해 다음을 수행하십시오: * 파일을 수정하십시오. 이 경우, 이전에 빠뜨린 단어를 포함하여 봇 파일을 수정합니다. * 그 다음, ```git add ``` 을 실행하여 파일을 스테이징 영역으로 추가합니다. 보통 파일을 스테이징 영역에 추가하고 나면, 다음으로 우리가 해야할 일은 git commit -m "our commit message" 입니다. 그러나 여기서 우리가 원하는 것은 이전 커밋을 수정하는 것이므로, 다음을 실행합니다: * ```git commit --ammend``` 그러면 텍스트 편집기가 뜨고 메시지를 수정하라는 프롬프트가 뜰 것입니다. 이전 그대로 메시지를 두거나 변경할 수 있습니다. * 에디터를 빠져나오십시오. * ```git push origin check-commit-log-ko, upstream/main, origin/main, origin/HEAD, main) Author: Dan Yunheum Seol Date: Tue Jun 4 01:07:25 2024 -0400 Add dan-seol to Contributors list (#84962) commit 4af4ec8a56e057ce8768af77eda528453974d0bc Author: Edgar Humberto Tijerina Tamez <168693312+EdgarHTT@users.noreply.github.com> Date: Mon Jun 3 23:06:05 2024 -0600 Add Edgar Tijerina to Contributors list (#84961) ``` ## 명령어 변형(바리에이션) 및 선택 사항(옵션) - 하나 혹은 여러 개의 특정 커밋 식별자(아이디)를 기준으로 접근 가능한 커밋 로그를 보고 싶으시다면 다음 명령어를 활용하세요: (`foo`나 `bar`를 예시로 들겠습니다)
`git log foo bar` - 반대로 특정 커밋 식별자를 기준으로 접근 가능한 커밋 로그를 출력에서 제외할 수도 있습니다. 커밋 식별자 앞에 삿갓표(캐럿 기호) `^`를 붙여 주세요: (`baz`를 예시로 들자면)
`git log foo bar ^baz` - 특정 파일과 관련된 커밋 로그를 볼 수도 있습니다. 아래 명령어를 사용해 보세요:
`git log --all ` - 커밋 로그 목록의 항목 수를 제한 할 수도 있습니다: (예를 들어 `5` 항목으로 줄여보겠습니다)
`git log -n 5` ## 참조 및 더 알아보기 - [Official documentation](https://git-scm.com/docs/git-log) ================================================ FILE: docs/additional-material/translations/Korean/delete-branch-locally.ko.md ================================================ # 이 문서는 로컬 저장소에서 브랜치를 삭제하는법을 제공합니다. 브랜치 이름을 실수로 잘못 입력했을대 유용합니다. 이것은 *3*가지 방법으로 할 수 있습니다. ``` git branch -D <브랜치 이름> ``` ``` git branch --delete --force <브랜치 이름> # 위에 -D와 동일합니다. ``` ``` git branch --delete <브랜치 이름> # unmerge 에러 ``` -D는 --delete --force를 의미하며, 브랜치가 병합(merge)되지 않았더라도 강제로 삭제합니다. 하지만 -d 또는 --delete 옵션을 사용하면 브랜치의 병합(merge) 상태에 따라 오류가 발생할 수 있습니다... ================================================ FILE: docs/additional-material/translations/Korean/keeping-your-fork-synced-with-this-repository.ko.md ================================================ # 여러분이 포크한 저장소와 싱크상태 유지하기 먼저, 전체 싱크과정을 이해해야합니다. 본 스키마에는 3개의 저장소들이 있습니다. 저의 GitHub에 있는 제 공개저장소인 `github.com/Roshanjossey/first-contributions/`와 여러분의 포크된 저장소인 `github.com/Your-Name/first-contributions/`, 그리고 로컬 머신에 위치해서 현재 작업중인 저장소가 있습니다. 오픈 소스 프로젝트에 특화된 이러한 조합을 `트라이앵글 워크플로우`라고 부릅니다. triangle workflow 여러분의 두 개의 저장소들을 제 공개 저장소의 최신 상태와 싱크상태를 유지하기 위해서는 제일 먼저여러분의 로컬머신에 위치한 저장소를 제 공개 저장소와 fetch와 merge를 해야합니다. 두번째는 여러분의 로컬 저장소를 포크된 GitHub의 저장소에 push하는 것 입니다. 이전 과정에서 봤듯이 "pull request"를 요청할 수 있는 곳은 오직 포크된 저장소에서만 가능합니다. 따라서 마지막으로 업데이트 되어야하는 저장소는 포크된 GitHub입니다. 자, 어떻게하는지 보겠습니다: 먼저 여러분은 main 브랜치에 위치해 있어야합니다. 현재 어떤 브래치에 있는지 확인합니다.: ``` git status ``` 현재 main 브랜치가 아니라면 변경합니다.: ``` git checkout main ``` 제 공개 저장소를 아직 여러분의 git에 추가하지 않았다면 다음 명령으로 추가합니다. `add upstream remote-url`: ``` git remote add upstream https://github.com/Roshanjossey/first-contributions ``` 지정한 URL을 이용해 현재 프로젝트의 또 다른 최신 버전이 있는지 git에게 확인을 요청하는 방법입니다. 그리고 우리는 이를 `upstream` 이라고 부르기로합니다. 일단 git이 이러한 이름을 가지고 있다면 다음과 같이 공개 저장소의 최진 버전을 가지고 옵니다. : ``` git fetch upstream ``` 여러분은 이제 제 포크(upstream remote)에서 최신 버전을 내려 받았습니다. 이제 공개 저장소의 변경된 내용을 여러분의 main 브랜치에 병합해야합니다. ``` git rebase upstream/main ``` 여러분의 main 브랜치와 공개 저장소를 병합하고 나면 이제 여러분의 로컬머신의 main 브랜치는 최신 상태입니다. 마지막으로 여러분의 main 브랜치를 여러분의 포크에 push하게 되면 포크한 GitHub 또한 변경사항들이 반영됩니다.: ``` git push origin main ``` origin으로 명명된 리모트에 push하는 것에 주의하세요. 이제 여러분의 모든 저장소가 최신 상태를 유지하게 되었습니다. 잘 하셨습니다! GitHub 저장소에 커밋이 추가적으로 발생할 때마다 이러한 작업을 해야합니다. ================================================ FILE: docs/additional-material/translations/Korean/moving-a-commit-to-a-different-branch.ko.md ================================================ ## 커밋을 다른 브랜치로 옮기기 What if you commit a change, and then realize that you committed to a different branch? How can you change that? This is what this tutorial covers. 만일 변경사항을 반영했는데 전혀 다른 브랜치에 커밋한 사실을 알았다면 어떻게할까요? 이걸 어떻게 바로잡을 수 있을까요? 바로 이 장에서 다룰 내용입니다. ### 가장 최근 커밋들을 기존에 있는 브랜치로 이동시키기 사용예: ```git reset HEAD~ --soft``` - 마지막 커밋을 되돌립니다. 물론 수정한 내용은 그대로 남아있습니다. ```git stash``` - 현재까지 수정한 모든 작업내용들의 상태를 저장합니다. ```git checkout name-of-the-correct-branch``` - 실제 반영하고자하는 브랜치를 체크아웃합니다. ```git stash pop``` - 마지막으로 저장한(stash) 변경내역들을 현재 브랜치에 반영하고 저장한 내역에서 삭제합니다. ```git add .``` - 또는 커밋에 반영할 변경내역들을 개별적으로 추가합니다. ```git commit -m "your message here"``` - 저장하고 변경내역을 커밋합니다. 자 이제 변경사항이 올바른 브랜치에 반영되었습니다. ### 가장 최근 커밋들을 신규 브랜치를 생성하여 이동시키기 사용예: ```git branch newbranch``` - 신규 브랜치를 생성하고 모든 커밋들을 저장합니다. ```git reset --hard HEAD~#``` - master 브랜치의 #번째 커밋을 되돌립니다. 되돌린 커밋들은 master에서 완전히 삭제되므로 주의하세요. ```git checkout newbranch``` - 생성한 브랜치로 이동합니다. 모든 커밋들을 가지고 있을겁니다. 주의: 커밋하지 않은 변경사항들은 사라집니다. ================================================ FILE: docs/additional-material/translations/Korean/removing-branch-from-your-repository.ko.md ================================================ ## 여러분의 저장소에서 브랜치 삭제하기 지금까지의 튜토리얼을 수행했다면, 우리의 `` 브랜치가 목적을 완료했습니다. 이제는 로컬 저장소에서 삭제할 차례입니다. 필수사항은 아니지만 이 브랜치의 이름은 다소 특별한 목적을 나타내므로 이미 병합되었다면 그 수명을 다했다고 할 수 있습니다. First, let's merge your `` to your master, so to go your master branch: 먼저, ``을 마스터에 합쳐야합니다. 마스터 브랜치로 이동합니다.: ``` git checkout master ``` ``를 마스터에 병합합니다.: ``` git merge master ``` ``를 로컬 저장소에서 삭제합니다.: ``` git branch -d ``` 이제 로컬 머신의 ``브랜치를 삭제했고 모든 것이 깔끔하게 보입니다. 이 시점에서 GitHub 포크에 여전히 `` 브랜치가 있어야합니다. 그러나 이것을 삭제하기 전에 이 원격지의 브랜치에서 상위 저장소로 "PR(Pull request)"을 보냈음을 기억하십시오. 따라서 아직 병합되지 않았다면이 브랜치를 삭제하지 마십시오. 그러나 해당 브래치를 이미 병합했고 원격 브랜치를 삭제하려면 다음을 사용하십시오.: ``` git push origin --delete ``` 자, 여러분은 이제 자신의 브래치를 정리하는 법을 배웠습니다. 시간이 지나면 많은 커밋이 저장소에 추가됩니다. 그리고 로컬 머신과 GitHub 포크의 마스터 브랜치는 최신 버전이 아닙니다. 따라서 저장소를 내 것과 동기화 된 상태로 유지하려면 아래 단계를 따르십시오. #### [여러분이 포크한 저장소와 싱크상태 유지하기](keeping-your-fork-synced-with-this-repository.ko.md) ================================================ FILE: docs/additional-material/translations/Korean/resolving-merge-conflicts.ko.md ================================================ # 병합 충돌이 무엇인가요? 여러분이 또 다른 브랜치에서 현재 작업중인 브랜치로 병합하고자할 때, 또 다른 변경사항들도 같이 반영되어야 하므로 여러분의 현재 작업중인 파일들에 같이 결합이 이루어지게 됩니다. 만일 이때 두 사람이 같은 파일의 똑 같은 라인을 (각자 다르게)변경했거나 다른 사람이 수정 반영한 곳을 삭제하려고 한다면 Git은 어느 변경사항이 옳은 것인지 쉽게 판단할 수 없습니다. 이때 Git은 여러분 스스로 이 문제를 반드시 해결하도록 충돌이 있음을 파일에 표시합니다. # 병합 충돌은 어떻게 해결하나요? 병합 충돌이 발생하면 Git은 문제가 되는 부분에 “<<<<<<<< HEAD” 와 “>>>>>>>>>>[other branch name]” 으로 감싸서 표시합니다. 이때 여러분이 현재 작업중인 브랜치가 먼저 표기됩니다. 꺽쇠기호 뒤를 보면 어느 브랜치에서 변경사항이 반영되었는지 알 수 있습니다. "=======" 기호는 충돌이 발생한 부분을 각각 구분해줍니다. 여러분이 해야할 일은 바로 위와 같은 충돌표시들을 원하는 코드만 보이도록 깨끗하게 정리하는 것입니다. 따라서 충돌을 발생케한 여러분의 동료와 어느 변경사항이 옳은 것인지 서로 이야기를 나눠야합니다. 여러분의 변경사항이 옳을 수도 있고 그렇지 않을 수도 있습니다. 아니면 양자 모두의 변경사항을 합쳐야만 하는 경우도 있을 수 있겠죠. 예시: ``` <<<<<<< HEAD:mergetest This is my third line ======= This is a fourth line I am adding >>>>>>> 4e2b407f501b68f8588aa645acafffa0224b9b78:mergetest ``` <<<<<<<: 병합 충돌이 시작되는 곳을 표시합니다. 여러분이 병합하고자하는 변경한 라인들로 이루어진 부분이 첫번째로 표기됩니다. =======: 비교하기 위한 구분선을 나타냅니다. 쉽게 차이를 파악할 수 있도록 사용자가 커밋한 변경사항(위)과 병합을 위해 로드된 부분(아래)으로 구분되어 있습니다. >>>>>>>: 병합 충돌이 발생한 마지막 위치를 표시합니다. Git에서 병합하는 것에 문제가 있는 부분을 일일이 수작업으로 편집해서 병합하면서 충돌문제를 해결합니다. 이는 여러분의 수정사항을 삭제하거나 다른 누군가의 변경사항을 지우는 일이며 또는 이 두 부분을 하나로 합치는 것을 의미합니다. 그리고 해당 파일에서 '<<<<<<<', '=======', 그리고 '>>>>>>>'을 지워야합니다. 일단 충돌을 해결했다면 `git add`를 실행합니다. 아울러 충돌이 올바르게 해결되었는지 확인하기 위해 반드시 테스트를 수행하는 것을 잊지마십시요. 병합 충돌을 보다 쉽게 해결하려면 여러분이 사용하는 각각의 IDE에 맞는 적절한 플러그인을 다운로드 받아 설치하세요. # 병합을 어떻게 되돌리나요? 병합을 취소하려면 `git merge —abort` 명령을 실행하세요. ================================================ FILE: docs/additional-material/translations/Korean/reverting-a-commit.ko.md ================================================ ## 커밋 되돌리기 커밋을 되돌리려면 이전 커밋에서 수행 된 모든 변경 사항을 취소하는 새로운 커밋을 만드는 것입니다. 그것은 git에서 ```CTRL + Z ``` 를 실행하는 것과 같습니다. 원격 저장소에 푸시하는 모든 커밋에는 SHA(Secure Hash Algorithm)라고 하는 고유한 알파벳 키가 있으므로 git에서 되돌리기가 쉬워집니다. 즉, SHA를 사용하는 한 언제든지 커밋을 되돌릴 수 있습니다. 하지만 그렇게 하면, 당신의 저장소가 엉망이 되지 않도록 조심스럽게 순서대로 배열해야 합니다. 실행 취소하려는 특정 커밋의 SHA를 선택하려면 지금까지 작성한 모든 커밋의 로그가 도움이 될 것입니다. 이를 위해 다음 명령을 실행합니다: ```git log --oneline ``` ```git log``` 명령만 실행하면 SHA(긴 형식)을 얻을 수 있지만 ```--oneline ``` 플래그를 사용하면 보다 가독성이 좋은(한줄) 방식으로 표시할 수 있습니다. 이 명령을 실행할 때 표시되는 첫번째 7개의 문자는 축약 커밋 해시라고 합니다. 예를 들어, 이 저장소에서 ```git log --oneline ``` 을 실행하면 다음과 같은 결과를 얻을 수 있습니다: ``` 389004d added spacing in title c1b9fc1 Merge branch 'master' into tutorials 77eaafd added tutorial for reverting a commit ``` 따라서 ```git log --oneline``` 을 사용하면 SHA의 처음 7개의 문자와 함께 저장소에서 작성한 모든 커밋 목록을 가져올 수 있습니다. 이제 "added spacing in title"에 대한 커밋을 취소하고 싶다고 가정하고, 다음 단계를 수행하겠습니다. * 커밋의 SHA를 복사합니다. 여기서는 ```389004d``` 입니다. * 그리고 나서 ```git revert 389004d``` 명령을 싱행합니다. 이렇게 하면 텍스트 편집기가 열리고 커밋 메시지를 편집하라는 메시지가 표시됩니다. 커밋 메시지를 `Revert` 라는 단어로 시작하는 기본 git 메시지로 남겨두거나 원하는대로 메시지를 작성할 수도 있습니다. * 다음으로, 텍스트 편집기를 저장하고 닫습니다. * 커맨드 라인으로 돌아갑니다. * ```git push origin ``` 을 실행하여 되돌린 변경사항을 Github에 푸시하십시오. 그리고 바로 변경사항이 원상태로 돌아갈 것입니다. 이 경우에 저장소가 ```c1b9fc1``` 의 상태로 되돌아갑니다. ================================================ FILE: docs/additional-material/translations/Korean/undoing-a-commit.ko.md ================================================ ## 로컬 커밋 되돌리기 로컬에서 커밋을 위해 스테이징 영역에 추가한 작업 내용을 되돌리기 위해서는 다음 명령을 실행합니다. ``` git reset ``` 위 명령어는 수정한 코드가 반영된 스테이징 영역을 가장 최근에 반영한 커밋상태로 되돌립니다. 하지만 여러분의 작업 디렉토리에 수정한 내용들은 변경되지 않습니다. 따라서 여러분이 수정한 소스를 다시 커밋할 수 있습니다. 만일 이미 스테이징 영역에 반영된 수정한 파일들 중에서 하나의 파일만 커밋에서 제거하기를 원할 경우, 아래 명령을 실행합니다. ``` git reset ``` 이 명령어는 스테이징 영역에서 해당 파일만 제거합니다. 그러나 작업 디렉토리에는 변경된 파일 상태 그대로 남아 있습니다. 다음은 ```git reset``` 사용법에 관한 예제입니다. ``` # 먼저 index.php 와 tutorial.php 파일을 수정합니다. # 스테이징 영역에 파일을 추가합니다. $ git add . # 두 파일을 각각 커밋해야하므로 # tutorial.php 파일을 스테이징 영역에서 제거합니다. $ git reset tutorial.php # index.php 파일을 먼저 커밋합니다. $ git commit -m "Changed index.php" # 다음으로 tutorial.php 파일을 커밋합니다. $ git add tutorial.php $ git commit -m "Changed tutorial.php" ``` 로컬 저장소에 문제가 생겨 여러분의 코드를 마지막 커밋 상태로 모두 되돌리고 싶다면 아래 명령을 실행할 수 있습니다. ``` git reset --hard ``` 이 명령어는 스테이징 영역을 마지막 커밋 상태로 되돌리는 것 뿐만 아니라 여러분의 로컬에 변경된 파일도 되돌릴 수 있습니다. ```--hard``` 모드는 Git으로 하여금 작업 디렉토리에 대한 변경들도 되돌릴 수 있도록 합니다. 따라서 로컬에서 개발한 모든 개발 내용을 초기화해도 되는지 반드시 확인 후 실행하셔야 합니다. 다음은 ```git reset --hard``` 사용에 관한 예제입니다. ``` # 엉뚱한 실험을 시작하기로 결정했습니다. # 먼저 'crazy.php' 파일을 만들고 코드를 추가합니다. # 그리고 crazy.php 파일을 커밋합니다. $ git add crazy.php $ git commit -m "Started a crazy dev" # crazy.php 파일을 다시 수정하고 기타 여러 파일들을 생성하고 수정합니다. # 그리고 수정한 모든 파일을 스테이징 영역에 추가하고 커밋합니다. $ git add . $ git commit -m "Continued dev" # 테스트하고 마칩니다. # 실험하기 전 상태로 되돌리기 위해 모든 수정사항을 제거합니다. $ git reset --hard HEAD~2 ``` ```git reset --hard HEAD~2``` 명령어는 현재 브랜치에서 여러분이 수정한 이전의 커밋들 중에 2번째 커밋 포인트 상태로 이동함과 동시에 해당 커밋들에 대한 변경사항들이 이전 상태로 복구됩니다. 그리고 프로젝트 히스토리에서 이전에 추가된 2개의 스냅샷이 제거됩니다. P.s. 만일 여러분의 공유 저장소로 이미 push를 완료한 상태에서 ```git reset --hard``` 명령을 실행할 경우, 해당 저장소를 사용하는 모든 사람들에게 문제를 일으킬 수 있으므로 절대 실행해서는 안됩니다. ================================================ FILE: docs/additional-material/translations/Malayalam/Things-a-non-programmer-can-do.ml.md ================================================ # പ്രോഗ്രാമർ അല്ലാത്ത ഒരാൾക്ക് ചെയ്യാൻ കഴിയുന്ന കാര്യങ്ങൾ ## ശ്രദ്ധിക്കാൻ തുടങ്ങുക ഓപ്പൺ സോഴ്‌സിലെ എല്ലാം മറ്റുള്ളവരെ ഉൾക്കൊള്ളുന്നു. നിങ്ങൾ ഒരു ടീമിൽ ചേരാൻ നോക്കുകയാണ്, അതിനർത്ഥം കമ്മ്യൂണിറ്റിയെക്കുറിച്ചും അത് എങ്ങനെ പ്രവർത്തിക്കുന്നുവെന്നും മനസ്സിലാക്കുക എന്നാണ്. ഒരു പ്രോജക്‌റ്റിലേക്ക് ചെന്ന് "ഹായ്, ഈ പ്രോജക്‌റ്റ് ഇങ്ങനെ പ്രവർത്തിക്കണം എന്നാണു ഞാൻ കരുതുന്നത് " എന്ന് പറയുന്നത് ഒരു നല്ല കാര്യമായി കണക്കാക്കില്ല. ചില പ്രോജക്‌റ്റുകൾ അത്തരം സമീപനത്തെ സ്വാഗതം ചെയ്‌തേക്കാം, എന്നാൽ പ്രോജക്‌റ്റ് കുറച്ച് കാലമായി പ്രവർത്തിക്കുന്നതാണെങ്കിൽ , അങ്ങനെ ഒരു മനോഭാവം സ്വീകരിക്കാനുള്ള സാധ്യത കുറവാണു . **പ്രോജക്റ്റിന് എന്താണ് വേണ്ടതെന്ന് അറിയാനുള്ള ഏറ്റവും നല്ല മാർഗം ശ്രദ്ധിച്ചു കേൾക്കുക എന്നതാണ് .** 1. **ഒരു മെയിലിംഗ് ലിസ്റ്റിൽ ചേരുക**: പല പ്രോജക്‌റ്റുകൾക്കും, പ്രോജക്‌റ്റിൻ്റെ വികസനത്തെക്കുറിച്ചുള്ള ആശയവിനിമയത്തിൻ്റെ പ്രധാന മാർഗമാണ് മെയിലിംഗ് ലിസ്റ്റ്. വലിയ പ്രോജക്റ്റുകളിൽ, തിരഞ്ഞെടുക്കാൻ നിരവധി മെയിലിംഗ് ലിസ്റ്റുകൾ ഉണ്ട്. ഉദാഹരണത്തിന്, PostgreSQL പ്രോജക്റ്റിന് അതിൻ്റെ മെയിലിംഗ് ലിസ്റ്റ് പേജിൽ 12 ഉപയോക്തൃ-അധിഷ്ഠിത ലിസ്റ്റുകളും ആറ് ഡെവലപ്പർ ലിസ്റ്റുകളും ഉണ്ട്. പ്രധാന ഉപയോക്തൃ-അധിഷ്‌ഠിത ലിസ്‌റ്റും പ്രധാന ഡെവലപ്പർ ലിസ്റ്റും പിന്തുടരാനാണു ഞാൻ നിർദേശിക്കുന്നത് . 2. **ഒരു ബ്ലോഗ് പിന്തുടരുക**: കോർ ഡെവലപ്പർമാർ പരിപാലിക്കുന്ന ബ്ലോഗുകൾ ഭാവിയിലെ റിലീസുകളിൽ വരാനിരിക്കുന്നതിനെക്കുറിച്ചുള്ള വിവരങ്ങൾ പലപ്പോഴും നൽകുന്നു, അവിടെ എത്താൻ എന്തൊക്കെ ചെയ്തുവെന്നും . പ്രൊജെക്ടുമായി ബന്ധപ്പെട്ട നിരവധി ഉറവിടങ്ങളിൽ നിന്നുള്ള വാർത്തകളും ബ്ലോഗ് എൻട്രികളും ഒരു പ്ലാനറ്റ് സൈറ്റ് സമാഹരിക്കുന്നു. planet.gnome.org അല്ലെങ്കിൽ planet.mysql.com പോലുള്ള ഒരു പ്ലാനറ്റ് സൈറ്റ് ഉണ്ടെങ്കിൽ, അവിടെ ആരംഭിക്കുക. "planet " എന്നതിനായി ഗൂഗിളിൽ തിരയുക. 3. **ഒരു IRC ചാനലിൽ ചേരുക**: പല ഓപ്പൺ സോഴ്‌സ് പ്രോജക്‌റ്റുകൾക്കും സമർപ്പിത ഇൻ്റർനെറ്റ് റിലേ ചാറ്റ് (IRC) ചാനലുകൾ ഉണ്ട്, അവിടെ ഡവലപ്പർമാരും ഉപയോക്താക്കളും പ്രശ്‌നങ്ങളും വികസനവും ചർച്ചചെയ്യുന്നു. ചാനലിനെ എന്താണ് വിളിക്കുന്നതെന്നും അത് ഏത് ഐആർസി നെറ്റ്‌വർക്കിലാണെന്നും വിശദാംശങ്ങൾക്കായി പ്രോജക്റ്റിൻ്റെ വെബ്‌സൈറ്റ് പരിശോധിക്കുക. **ടിക്കറ്റുകൾ ഉപയോഗിച്ച് പ്രവർത്തിക്കുക** ഏതൊരു ഓപ്പൺ സോഴ്‌സ് പ്രോജക്റ്റിൻ്റെയും ഹൃദയമാണ് കോഡ്, എന്നാൽ കോഡ് എഴുതുന്നത് സംഭാവന നൽകാനുള്ള ഏക മാർഗമാണെന്ന് കരുതരുത്. പുതിയ സവിശേഷതകൾ സൃഷ്ടിക്കുന്നതിനും ബഗുകൾ പരിഹരിക്കുന്നതിനുമുള്ള തിരക്കിൽ കോഡിൻ്റെ പരിപാലനവും കോഡിന് ചുറ്റുമുള്ള സിസ്റ്റങ്ങളും പലപ്പോഴും അവഗണിക്കപ്പെടുന്നു. ഒരു പ്രോജക്റ്റിലേക്ക് നിങ്ങളുടെ കാൽ എത്തിക്കുന്നതിനുള്ള എളുപ്പമാർഗ്ഗമായി ഈ മേഖലകൾ നോക്കുക. മിക്ക പ്രോജക്റ്റുകൾക്കും പൊതുവായി കാണാവുന്ന ട്രബിൾ ടിക്കറ്റ് സംവിധാനമുണ്ട്, അത് പ്രോജക്റ്റിൻ്റെ വെബ്‌സൈറ്റിൻ്റെ മുൻ പേജിൽ നിന്ന് ലിങ്ക് ചെയ്‌ത് ഡോക്യുമെൻ്റേഷനിൽ ഉൾപ്പെടുത്തിയിട്ടുണ്ട്. ഉപയോക്താക്കളും ഡെവലപ്പർമാരും തമ്മിലുള്ള ആശയവിനിമയത്തിൻ്റെ പ്രാഥമിക മാർഗമാണിത്. അത് പുതുക്കി നിലനിർത്തുന്നത് പ്രോജെക്ടിനെ സഹായിക്കാനുള്ള മികച്ച മാർഗമാണ്. ടിക്കറ്റിംഗ് സമ്പ്രദായത്തിൽ , നിങ്ങൾക്ക് പ്രത്യേക അനുമതികൾ ആവശ്യമായി വന്നേക്കാം, ടിക്കറ്റുകൾ വൃത്തിയാക്കാൻ സഹായിക്കണമെന്ന് നിങ്ങൾ പറയുമ്പോൾ , മിക്ക പ്രൊജക്‌റ്റ് നേതാക്കളും നിങ്ങൾക്ക് അനുമതി നൽകുന്നതിൽ സന്തോഷിക്കും. 4. **ഒരു ബഗ് ഡയഗ്നോസ് ചെയ്യുക**: ബഗുകൾ പലപ്പോഴും മോശമായി റിപ്പോർട്ട് ചെയ്യപ്പെടുന്നു. ഒരു ബഗ് കണ്ടുപിടിക്കുന്നതും പരീക്ഷിക്കുന്നതും പ്രശ്നത്തിൻ്റെ പ്രത്യേകതകൾ കണ്ടെത്തുന്നതിനുള്ള ലെഗ് വർക്ക് ഉപയോഗിച്ച് ഡവലപ്പർമാരുടെ സമയം ലാഭിക്കാൻ സഹായിക്കും. "ഞാൻ X ചെയ്യുമ്പോൾ സോഫ്‌റ്റ്‌വെയർ പ്രവർത്തിക്കുന്നില്ല" എന്ന് ഒരു ഉപയോക്താവ് റിപ്പോർട്ട് ചെയ്‌താൽ, ആ പ്രശ്‌നത്തിൻ്റെ പ്രത്യേകതകൾ മനസിലാക്കാൻ കുറച്ച് സമയം ചെലവഴിക്കുക. ഇത് ആവർത്തിച്ചുള്ളതാണോ? ആവർത്തിച്ച് പ്രശ്‌നമുണ്ടാക്കാൻ നിങ്ങൾക്ക് ഒരു കൂട്ടം ഘട്ടങ്ങൾ സൃഷ്ടിക്കാനാകുമോ? ഒരു ബ്രൗസറിൽ മാത്രം സംഭവിക്കുന്നത് മറ്റൊന്നല്ല, അല്ലെങ്കിൽ ഒരു ഡിസ്ട്രോ എന്നാൽ മറ്റൊന്ന് അല്ലാത്തത് പോലെയുള്ള പ്രശ്നം നിങ്ങൾക്ക് ചുരുക്കാനാകുമോ? പ്രശ്‌നത്തിൻ്റെ കാരണം എന്താണെന്ന് നിങ്ങൾക്കറിയില്ലെങ്കിൽപ്പോലും, സാഹചര്യങ്ങൾ ചുരുക്കാൻ നിങ്ങൾ നടത്തുന്ന പരിശ്രമം അത് പരിഹരിക്കുന്നത് മറ്റൊരാൾക്ക് എളുപ്പമാക്കുന്നു. നിങ്ങൾ കണ്ടെത്തുന്നതെന്തും, എല്ലാവർക്കും കാണുന്നതിനായി ബഗ് സിസ്റ്റത്തിലെ ടിക്കറ്റിൽ ചേർക്കുക. 5. **ഫിക്സഡ് ബഗുകൾ അടയ്ക്കുക**: പലപ്പോഴും ബഗുകൾ കോഡ്ബേസിൽ പരിഹരിച്ചിട്ടുണ്ടെങ്കിലും അവയെക്കുറിച്ച് റിപ്പോർട്ട് ചെയ്യുന്ന ടിക്കറ്റുകൾ ടിക്കറ്റിംഗ് സിസ്റ്റത്തിൽ അപ്ഡേറ്റ് ചെയ്യപ്പെടില്ല. ഈ ക്രാഫ്റ്റ് വൃത്തിയാക്കുന്നത് സമയമെടുക്കും, പക്ഷേ ഇത് മുഴുവൻ പ്രോജക്റ്റിനും വിലപ്പെട്ടതാണ്. ഒരു വർഷത്തിലേറെ പഴക്കമുള്ള ടിക്കറ്റുകൾക്കായുള്ള ടിക്കറ്റ് സംവിധാനം അന്വേഷിച്ച് ആരംഭിക്കുക, ബഗ് ഇപ്പോഴും നിലവിലുണ്ടോ എന്ന് നോക്കുക. ബഗ് പരിഹരിച്ചിട്ടുണ്ടോ എന്നും അത് അടയ്ക്കാൻ കഴിയുമോ എന്നും അറിയാൻ പ്രോജക്റ്റിൻ്റെ റിലീസ് മാറ്റ ലോഗ് പരിശോധിക്കുക. അത് പരിഹരിച്ചതായി അറിയാമെങ്കിൽ, ടിക്കറ്റിലെ പതിപ്പ് നമ്പർ ശ്രദ്ധിക്കുകയും അത് അടയ്ക്കുകയും ചെയ്യുക. സോഫ്റ്റ്‌വെയറിൻ്റെ ഏറ്റവും പുതിയ പതിപ്പ് ഉപയോഗിച്ച് ബഗ് പുനഃസൃഷ്ടിക്കാൻ ശ്രമിക്കുക. ഏറ്റവും പുതിയ പതിപ്പ് ഉപയോഗിച്ച് ഇത് പുനർനിർമ്മിക്കാൻ കഴിയുന്നില്ലെങ്കിൽ, അത് ടിക്കറ്റിൽ ശ്രദ്ധിക്കുകയും അത് അടയ്ക്കുകയും ചെയ്യുക. അത് ഇപ്പോഴും നിലവിലുണ്ടെങ്കിൽ, ടിക്കറ്റിൽ അത് ശ്രദ്ധിക്കുകയും തുറന്നിടുകയും ചെയ്യുക. കോഡ് ഉപയോഗിച്ച് പ്രവർത്തിക്കുന്നു എല്ലാ അനുഭവ തലങ്ങളിലുമുള്ള പ്രോഗ്രാമർമാർക്ക് പ്രോജക്റ്റിലെ കോഡ് ഉപയോഗിച്ച് സഹായിക്കാനാകും. നിങ്ങളുടെ പ്രിയപ്പെട്ട പ്രോജക്റ്റിലേക്ക് യഥാർത്ഥ സംഭാവനകൾ നൽകാൻ നിങ്ങൾ ഒരു കോഡിംഗ് ജീനിയസ് ആയിരിക്കണമെന്ന് കരുതരുത്. നിങ്ങളുടെ ജോലിയിൽ കോഡിലെ മാറ്റം ഉൾപ്പെടുന്നുവെങ്കിൽ, സംഭാവകരിൽ നിന്ന് കോഡ് ലഭിക്കുന്നതിന് പ്രോജക്റ്റ് ഉപയോഗിക്കുന്ന രീതി അന്വേഷിക്കുക. ഓരോ പ്രോജക്ടിനും അതിൻ്റേതായ വർക്ക്ഫ്ലോ ഉണ്ട്, അതിനാൽ നിങ്ങൾ കോഡ് സമർപ്പിക്കുന്നതിന് മുമ്പ് അത് എങ്ങനെ ചെയ്യണമെന്ന് ചോദിക്കുക. ഉദാഹരണത്തിന്, PostgreSQL പ്രോജക്റ്റ് അതിൻ്റെ പ്രക്രിയയിൽ വളരെ കർക്കശമാണ്: കോഡ് പരിഷ്ക്കരണങ്ങൾ ഒരു മെയിലിംഗ് ലിസ്റ്റിലേക്ക് പാച്ച് രൂപത്തിൽ അയയ്‌ക്കുന്നു, അവിടെ പ്രധാന ഡെവലപ്പർമാർ മാറ്റത്തിൻ്റെ എല്ലാ വശങ്ങളും സൂക്ഷ്മമായി പരിശോധിക്കുന്നു. മറുവശത്ത് പാരറ്റ് പോലെയുള്ള ഒരു പ്രോജക്റ്റ് ഉണ്ട്, അവിടെ കോഡ്ബേസിലേക്ക് കമ്മിറ്റ് പ്രിവിലേജുകൾ ലഭിക്കുന്നത് എളുപ്പമാണ്. പ്രോജക്റ്റ് GitHub ഉപയോഗിക്കുന്നുവെങ്കിൽ, GitHub-ൻ്റെ പുൾ അഭ്യർത്ഥന സവിശേഷത ഉപയോഗിക്കുന്ന ഒരു വർക്ക്ഫ്ലോ ഉണ്ടായിരിക്കാം. എല്ലാ പ്രോജെക്ടറും വൈവിധ്യമേറിയതാണ് . നിങ്ങൾ കോഡ് പുതുക്കുമ്പോഴെല്ലാം , കമ്മ്യൂണിറ്റിയുടെ ഉത്തരവാദിത്തമുള്ള ഒരു അംഗമായി നിങ്ങൾ പ്രവർത്തിക്കുന്നുവെന്നും ബാക്കി കോഡ്‌ബേസുമായി പൊരുത്തപ്പെടുന്നതിന് നിങ്ങളുടെ കോഡ് ശൈലി നിലനിർത്തുന്നുവെന്നും ഉറപ്പാക്കുക. നിങ്ങൾ ചേർക്കുന്നതോ പരിഷ്ക്കരിക്കുന്നതോ ആയ കോഡ് ബാക്കിയുള്ളത് പോലെയായിരിക്കണം. ബ്രേസിംഗ് ശൈലിയോ ഇന്റേൺഡേഷൻ സ്‌പെയ്‌സുകൾ കൈകാര്യം ചെയ്യുന്നതോ ആയ രീതി നിങ്ങൾക്ക് ഇഷ്ടപ്പെട്ടേക്കില്ല.എന്തിരുന്നാലും ആ സ്റ്റാൻഡേർഡുകളുമായി ഒത്തുചേരാത്ത കോഡ് സമർപികുനത് വളരെ അധികം മോശമായ ഒരു കാര്യം ആണ് . "എനിക്ക് നിന്റെ രീതികൾ ഇഷ്ടമല്ല,എന്റെ രീതികൾ ആണ് നല്ലത്,അതുകൊണ്ട് ഞാൻ ചെയുന്ന പോലെ ചെയുക" എന്ന് പറയുന്നത് പോലെ തന്നെ ആണ് ഇതും . 6. **ഒരു ബീറ്റാ അഥവാ റീലീസ് ക്യാൻഡിഡേറ്റ് നെ പരീക്ഷിക്കുക**: ഒന്നിലധികം പ്ലാറ്റ്‌ഫോമുകളിൽ പ്രവർത്തിക്കാൻ രൂപകൽപ്പന ചെയ്‌തിരിക്കുന്ന ഏതൊരു പ്രോജക്റ്റിനും എല്ലാത്തരം പോർട്ടബിലിറ്റി പ്രശ്‌നങ്ങളും ഉണ്ടാകാം. ഒരു റിലീസ് സമീപിക്കുകയും ഒരു ബീറ്റ അല്ലെങ്കിൽ റിലീസ് കാൻഡിഡേറ്റ് പ്രസിദ്ധീകരിക്കുകയും ചെയ്യുമ്പോൾ, അത് പല പ്ലാറ്റ്‌ഫോമുകളിൽ നിരവധി ആളുകൾ പരീക്ഷിക്കുമെന്ന് പ്രോജക്റ്റ് ലീഡർ പ്രതീക്ഷിക്കുന്നു. നിങ്ങൾക്ക് അത്തരം ആളുകളിൽ ഒരാളാകാനും നിങ്ങളുടെ പ്ലാറ്റ്‌ഫോമിൽ പാക്കേജ് പ്രവർത്തിക്കുന്നുവെന്ന് ഉറപ്പാക്കാനും സഹായിക്കാനാകും. സാധാരണയായി നിങ്ങൾ സോഫ്റ്റ്‌വെയർ ഡൗൺലോഡ് ചെയ്യാനും നിർമ്മിക്കാനും പരിശോധിക്കാനും മാത്രമേ ആവശ്യമുള്ളൂ, എന്നാൽ നിങ്ങൾ അസാധാരണമായ വിതരണത്തിലോ ഹാർഡ്‌വെയറിലോ ആണെങ്കിൽ പ്രോജക്റ്റിൻ്റെ മൂല്യം വളരെ വലുതായിരിക്കും. ബിൽഡ്, ടെസ്റ്റ് വർക്കുകൾ എന്നിവ റിപ്പോർട്ട് ചെയ്യുന്നത്, വരാനിരിക്കുന്ന റിലീസ് ദൃഢമാണെന്ന് പ്രോജക്റ്റ് ലീഡർമാരെ അറിയാൻ സഹായിക്കുന്നു. 7. **ഒരു ബഗ് പരിഹരിക്കുക**: സാധാരണയായി ഇവിടെയാണ് കോഡ് ആരംഭിക്കാൻ ആഗ്രഹിക്കുന്ന സഹകാരികൾ. ഇത് ലളിതമാണ്: ടിക്കറ്റ് സിസ്റ്റത്തിൽ രസകരമായ ഒരു ബഗ് കണ്ടെത്തി കോഡിൽ അത് പരിഹരിക്കാൻ ശ്രമിക്കുക. ഉചിതമെങ്കിൽ കോഡിൽ തിരുത്തൽ രേഖപ്പെടുത്തുക. നിങ്ങൾ ഉറപ്പിച്ച കോഡിൻ്റെ സ്പോട്ട് പരിശോധിക്കാൻ ടെസ്റ്റ് സ്യൂട്ടിലേക്ക് ഒരു ടെസ്റ്റ് ചേർക്കുന്നത് നല്ലതാണ്; ചില പ്രോജക്റ്റുകൾക്ക് ടെസ്റ്റുകൾ ഉൾപ്പെടുത്തുന്നതിന് ബഗ് പരിഹരിക്കലുകൾ ആവശ്യമാണ്. അപരിചിതമായ ഈ കോഡ്ബേസിന് ചുറ്റും നോക്കുമ്പോൾ കുറിപ്പുകൾ സൂക്ഷിക്കുക. ബഗ് പരിഹരിക്കാൻ നിങ്ങൾക്ക് കഴിയുന്നില്ലെങ്കിലും, പരിഹരിക്കാനുള്ള ശ്രമത്തിൻ്റെ ഭാഗമായി നിങ്ങൾ കണ്ടെത്തിയ കാര്യങ്ങൾ ടിക്കറ്റിൽ രേഖപ്പെടുത്തുക. നിങ്ങൾ കണ്ടെത്തുന്നത് നിങ്ങളുടെ പിന്നാലെ വരുന്നവരെ സഹായിക്കുന്നു. 8. **ഒരു ടെസ്റ്റ് എഴുതുക**: മിക്ക പ്രോജക്റ്റുകൾക്കും കോഡ് പരിശോധിക്കുന്ന ഒരു ടെസ്റ്റ് സ്യൂട്ട് ഉണ്ട്, എന്നാൽ അതിൽ കൂടുതൽ ടെസ്റ്റുകൾ ചേർക്കാൻ കഴിയാത്ത ഒരു ടെസ്റ്റ് സ്യൂട്ട് സങ്കൽപ്പിക്കാൻ പ്രയാസമാണ്. ടെസ്റ്റ് സ്യൂട്ട് പരിശോധിക്കാത്ത സോഴ്‌സ് കോഡിലെ ഏരിയകൾ തിരിച്ചറിയാൻ, C-നുള്ള gcov അല്ലെങ്കിൽ Devel::Cover-നുള്ള ഒരു ടെസ്റ്റ് കവറേജ് ടൂൾ ഉപയോഗിക്കുക. തുടർന്ന്, അത് മറയ്ക്കാൻ സ്യൂട്ടിലേക്ക് ഒരു ടെസ്റ്റ് ചേർക്കുക. 9. **ഒരു കംപൈലർ മുന്നറിയിപ്പ് നിർത്തലാക്കുക**: പല സി-അധിഷ്‌ഠിത പ്രോജക്‌റ്റുകൾക്കായുള്ള ബിൽഡ് പ്രോസസ്സ് പലപ്പോഴും വിചിത്രമായ കംപൈലർ മുന്നറിയിപ്പ് ഫ്ലാഗ് സ്‌ക്രീനിലേക്ക് തുപ്പുന്നു. ഈ മുന്നറിയിപ്പുകൾ സാധാരണയായി ഒരു പ്രശ്നത്തിൻ്റെ സൂചകങ്ങളല്ല, പക്ഷേ അവയ്ക്ക് അത് പോലെ കാണാനാകും. വളരെയധികം മുന്നറിയിപ്പുകൾ ഉള്ളത് അരൗചകം ആണ് . കോഡ് യഥാർത്ഥത്തിൽ ഒരു ബഗ് ഉണ്ടോ എന്ന് പരിശോധിക്കുക. ഇല്ലെങ്കിൽ, ഉറവിടത്തെ നിശബ്ദമാക്കുന്ന ഈ തെറ്റായ പോസിറ്റീവുകൾ മറയ്ക്കാൻ സഹായിക്കുന്നു. 10. **ഒരു കമന്റ് ചേർക്കുക**: നിങ്ങൾ കോഡ് പരിശോധിക്കുമ്പോൾ, ആശയക്കുഴപ്പമുണ്ടാക്കുന്ന ചില സ്ഥലങ്ങൾ നിങ്ങൾ കണ്ടെത്തിയേക്കാം. നിങ്ങൾ ആശയക്കുഴപ്പത്തിലാണെങ്കിൽ, മറ്റുള്ളവരും അങ്ങനെയാകാൻ സാധ്യതയുണ്ട്. അവ കോഡിൽ രേഖപ്പെടുത്തി ഒരു പാച്ച് സമർപ്പിക്കുക. ഡോക്യുമെൻ്റേഷനുമായി പ്രവർത്തിക്കുക ഡോക്യുമെൻ്റേഷൻ സാധാരണയായി ഒരു പ്രോജക്റ്റിൻ്റെ ഭാഗമാണ്, അത് ഷോർട്ട് ഷ്രിഫ്റ്റ് ലഭിക്കുന്നു. ആരുടെയെങ്കിലും കണ്ണിലൂടെ അതിൽ പ്രവേശിക്കുന്നതിനുപകരം, പ്രോജക്റ്റുമായി പരിചയമുള്ളവരുടെ വീക്ഷണകോണിൽ നിന്ന് എഴുതിയതും ഇത് കഷ്ടപ്പെടാം. നിങ്ങൾ എപ്പോഴെങ്കിലും ഒരു പ്രോജക്‌റ്റിനായി ഡോക്‌സ് വായിച്ചിട്ടുണ്ടെങ്കിൽ, "ഈ മാനുവൽ പ്രതീക്ഷിക്കുന്നത് പോലെയാണ് എനിക്ക് പാക്കേജ് എങ്ങനെ ഉപയോഗിക്കണമെന്ന് ഇതിനകം അറിയാമെന്ന്", ഞാൻ എന്താണ് സംസാരിക്കുന്നതെന്ന് നിങ്ങൾക്കറിയാം. പ്രൊജക്‌റ്റിനോട് അടുപ്പമുള്ളവർ ശ്രദ്ധിക്കാത്ത ഡോക്യുമെൻ്റേഷനിലെ പോരായ്മകൾ പലപ്പോഴും ഒരു കൂട്ടം പുതിയ കണ്ണുകൾക്ക് ചൂണ്ടിക്കാണിക്കാൻ കഴിയും. 11. **ഒരു ഉദാഹരണം സൃഷ്‌ടിക്കുക**: വളരെയധികം ഉദാഹരണങ്ങളുള്ള ഒരു പ്രോജക്‌റ്റും ഇല്ല. അതൊരു വെബ് API ആയാലും, ദിനചര്യകളുടെ ഒരു ലൈബ്രറി ആയാലും, Gimp പോലെയുള്ള GUI ആപ്പ് ആയാലും അല്ലെങ്കിൽ ഒരു കമാൻഡ് ലൈൻ ടൂളായാലും, ശരിയായ ഉപയോഗത്തിൻ്റെ നല്ല ഉദാഹരണം ഡോക്യുമെൻ്റേഷൻ്റെ പേജുകളേക്കാൾ കൂടുതൽ വ്യക്തമായും വേഗത്തിലും സോഫ്റ്റ്വെയറിൻ്റെ ശരിയായ ഉപയോഗം വിശദീകരിക്കാൻ കഴിയും. ഒരു API അല്ലെങ്കിൽ ലൈബ്രറിക്ക്, ഉപകരണം ഉപയോഗിക്കുന്ന ഒരു ഉദാഹരണ പ്രോഗ്രാം സൃഷ്ടിക്കുക. നിങ്ങൾ എഴുതിയ കോഡിൽ നിന്ന് പോലും ഇത് എക്‌സ്‌ട്രാക്‌റ്റ് ചെയ്‌തേക്കാം, അവശ്യസാധനങ്ങൾക്കായി ട്രിം ചെയ്യുക. ഒരു ഉപകരണത്തിന്, നിങ്ങളുടെ ദൈനംദിന ജീവിതത്തിൽ നിങ്ങൾ അത് എങ്ങനെ ഉപയോഗിച്ചു എന്നതിൻ്റെ യഥാർത്ഥ ലോക ഉദാഹരണങ്ങൾ കാണിക്കുക. നിങ്ങൾ കാഴ്ച്ചാധിഷ്ഠിതനാണെങ്കിൽ, ആപ്ലിക്കേഷൻ എങ്ങനെ ഇൻസ്റ്റാൾ ചെയ്യാം എന്നതുപോലുള്ള ഒരു പ്രധാന പ്രക്രിയയുടെ സ്ക്രീൻ ക്യാപ്ചർ സൃഷ്ടിക്കുന്നത് പരിഗണിക്കുക. കമ്മ്യൂണിറ്റിയുമായി പ്രവർത്തിക്കുക ഓപ്പൺ സോഴ്‌സ് ഭാഗികമായി കോഡിനെക്കുറിച്ചാണ്. കമ്മ്യൂണിറ്റി ഓപ്പൺ സോഴ്‌സ് വർക്ക് ചെയ്യുന്നു. അത് കെട്ടിപ്പടുക്കാൻ നിങ്ങളെ സഹായിക്കുന്ന വഴികൾ ഇതാ. 12. **ഒരു ചോദ്യത്തിന് ഉത്തരം നൽകുക**: സമൂഹത്തെ കെട്ടിപ്പടുക്കാൻ സഹായിക്കുന്നതിനുള്ള ഏറ്റവും നല്ല മാർഗം മറ്റുള്ളവരെ സഹായിക്കുക എന്നതാണ്. ഒരു ചോദ്യത്തിന് ഉത്തരം നൽകുന്നത്, പ്രത്യേകിച്ച് തുടക്കക്കാരെ , പ്രോജക്റ്റ് വളരാനും അഭിവൃദ്ധിപ്പെടാനും സഹായിക്കുന്നതിന് അത് നിർണായകമാണ്. ഒരു തുടക്കക്കാരനെ സഹായിക്കാൻ നിങ്ങൾ എടുക്കുന്ന സമയം, അവർ ഒരു ചോദ്യം ചോദിക്കുന്നുണ്ടെങ്കിൽ പോലും, പിനീട് അത് കമ്മ്യൂണിറ്റിക്കു വിലമതിക്കാനാവാത്ത സംഭാവന നൽകുന്ന ഒരാൾ ആയി മാറിയേക്കാം . 13. **ഒരു ബ്ലോഗ് പോസ്റ്റ് എഴുതുക**: നിങ്ങൾക്ക് ഒരു ബ്ലോഗ് ഉണ്ടെങ്കിൽ, നിങ്ങൾ ഉപയോഗിക്കുന്ന പ്രോജക്റ്റിലെ നിങ്ങളുടെ അനുഭവങ്ങളെക്കുറിച്ച് എഴുതുക. സോഫ്‌റ്റ്‌വെയർ ഉപയോഗിച്ച് നിങ്ങൾ നേരിട്ട ഒരു പ്രശ്‌നത്തെക്കുറിച്ചും അത് പരിഹരിക്കാൻ നിങ്ങൾ എന്താണ് ചെയ്‌തതെന്നും പറയുക. നിങ്ങളുടെ ചുറ്റുമുള്ള മറ്റുള്ളവരുടെ മനസ്സിൽ പ്രോജക്റ്റ് നിലനിർത്താൻ സഹായിക്കുന്നതിലൂടെ നിങ്ങൾ രണ്ട് തരത്തിൽ സഹായിക്കും. ഭാവിയിൽ നിങ്ങളുടെ പ്രശ്‌നമുള്ള മറ്റാരെങ്കിലും ഒരു റെക്കോർഡ് സൃഷ്‌ടിക്കുകയും ഉത്തരത്തിനായി വെബിൽ തിരയുകയും ചെയ്യുക. (നിങ്ങളുടെ സാങ്കേതിക സാഹസങ്ങളുടെ ഒരു ബ്ലോഗ്, അടുത്ത തവണ നിങ്ങൾ ജോലിക്കായി വേട്ടയാടാൻ പോകുമ്പോൾ, സംശയാസ്‌പദമായ സോഫ്‌റ്റ്‌വെയർ ഉപയോഗിച്ച് യഥാർത്ഥ ലോകാനുഭവം കാണിക്കുന്നതിനുള്ള മികച്ച മാർഗം കൂടിയാണ്.) 14. **ഒരു വെബ്‌സൈറ്റ് മെച്ചപ്പെടുത്തുക**: നിങ്ങൾക്ക് വെബ് ഡിസൈനിംഗിൽ വൈദഗ്ദ്ധ്യം ഉണ്ടെങ്കിൽ, വെബ്‌സൈറ്റ് മെച്ചപ്പെടുത്താൻ സഹായിക്കുകയും അതുവഴി പ്രോജക്റ്റിൻ്റെ പൊതുജനങ്ങൾ അഭിമുഖീകരിക്കുന്ന ഇമേജ് മെച്ചപ്പെടുത്തുകയും ചെയ്യുന്നുവെങ്കിൽ, അത് നന്നായി ചെലവഴിച്ച സമയം. ഒരുപക്ഷേ പ്രോജക്റ്റ് തിരിച്ചറിയാൻ ഒരു ഗ്രാഫിക് ഓവർഹോൾ അല്ലെങ്കിൽ ഒരു ലോഗോ ഉപയോഗിച്ചേക്കാം. ഇത് സമൂഹത്തിൽ ഇല്ലാത്ത കഴിവുകളായിരിക്കാം. എൻ്റെ പ്രോജക്‌റ്റുകളുടെ വെബ്‌സൈറ്റുകളിൽ എന്തെങ്കിലും ഗ്രാഫിക് ഡിസൈൻ സഹായം ലഭിച്ചാൽ എനിക്കത് ഇഷ്ടമാകുമെന്ന് എനിക്കറിയാം. 15. **സാങ്കേതിക ഡോക്യുമെൻ്റേഷൻ എഴുതുക** ഒരു ആപ്ലിക്കേഷനോ സോഫ്‌റ്റ്‌വെയറോ എങ്ങനെ പ്രവർത്തിക്കുന്നു എന്നതിനെക്കുറിച്ച് നിങ്ങൾക്ക് എഴുതാൻ കഴിയുമെങ്കിൽ, അതിനെക്കുറിച്ചുള്ള സാങ്കേതിക ഡോക്യുമെൻ്റേഷൻ നിങ്ങൾക്ക് എഴുതാം. പ്രത്യേകിച്ച് ഓപ്പൺ സോഴ്‌സ് പ്രോജക്‌റ്റുകൾ അപ്‌ഡേറ്റ് ചെയ്യാനോ നവീകരിക്കാനോ വിപുലീകരിക്കാനോ പൊതുജനങ്ങൾക്ക് വായിക്കാൻ സാങ്കേതിക ഡോക്‌സ് സൃഷ്‌ടിക്കാനോ ശ്രമിക്കുന്നു. നിങ്ങൾ പ്ലെയിൻ ഇംഗ്ലീഷിൽ എത്രയധികം എഴുതുന്നുവോ അത്രയും നല്ലത്. ഏറ്റവും നല്ല ഭാഗം, സാങ്കേതിക ഡോക്‌സ് എഴുതാൻ നിങ്ങൾ ഒരു പ്രോഗ്രാമർ ആകണമെന്നില്ല. എല്ലാറ്റിനുമുപരിയായി, നിങ്ങളുടെ ചുറ്റുമുള്ള ആളുകൾ ചർച്ച ചെയ്യുന്നത് ശ്രദ്ധിക്കുക. നിങ്ങൾക്ക് ഒരു പ്രധാന ആവശ്യം തിരിച്ചറിയാൻ കഴിയുമോ എന്ന് നോക്കുക. ഉദാഹരണത്തിന്, അടുത്തിടെ പാരറ്റ് ഡെവലപ്പർമാരുടെ മെയിലിംഗ് ലിസ്റ്റിൽ, അവരുടെ പഴയ ട്രാക്ക് ഇൻസ്റ്റാളേഷൻ ഉപേക്ഷിച്ച് ട്രബിൾ ടിക്കറ്റ് സിസ്റ്റമായി GitHub ഉപയോഗിക്കാൻ തീരുമാനിച്ചു. ടിക്കറ്റുകൾ GitHub-ൻ്റെ സംവിധാനത്തിലേക്ക് മാറ്റാൻ മാർഗമില്ലാത്തതിനാൽ ചിലർ ഈ നീക്കത്തെ എതിർത്തിരുന്നു. ഒരു ദിവസത്തെ അങ്ങോട്ടുമിങ്ങോട്ടും തർക്കിച്ചതിന് ശേഷം, ഞാൻ പൈപ്പ് ചെയ്തു, "ഞാൻ ഒരു കൺവെർട്ടർ എഴുതിയാൽ എങ്ങനെ?" ആളുകൾ ആശയത്തിൽ ആവേശഭരിതരായി. 450+ ടിക്കറ്റുകൾക്കായി ഒരു കൺവേർഷൻ പ്രോഗ്രാം എഴുതാൻ ഞാൻ സമയം ചെലവഴിച്ചു, അതിനാൽ ഞങ്ങളുടെ ടിക്കറ്റ് ചരിത്രമൊന്നും നഷ്‌ടപ്പെട്ടില്ല. അത് വലിയ വിജയമായിരുന്നു. ഞാൻ ഇടപെട്ടു, പ്രധാന ഡെവലപ്പർമാർ തത്തയിൽ ജോലി ചെയ്യുന്ന ബിസിനസിൽ ശ്രദ്ധ കേന്ദ്രീകരിച്ചു. 15. **മറ്റുള്ളവരെ പഠിപ്പിക്കുകയും സഹായിക്കുകയും ചെയ്യുക**: ഒരു വിഷയത്തെക്കുറിച്ച് കൂടുതലറിയാനുള്ള ഏറ്റവും നല്ല മാർഗം അത് പഠിപ്പിക്കാൻ ശ്രമിക്കുക എന്നതാണ്. സങ്കീർണ്ണമായ കാര്യങ്ങൾ ലളിതമായ ഉദാഹരണങ്ങളിലൂടെ വിശദീകരിക്കാൻ കഴിയുന്നവനാണ് മികച്ച അധ്യാപകൻ. അതിനാൽ നിങ്ങളുടെ പ്രോഗ്രാമിംഗ് ലോകത്തിലെ ഏറ്റവും മികച്ച പഠിതാവാകാനും മികച്ച അധ്യാപകനാകാനും നിങ്ങൾ ശ്രമിക്കേണ്ടതുണ്ട്. മറ്റുള്ളവരെ പഠിപ്പിക്കുന്നത് നിങ്ങളെക്കുറിച്ച് നിങ്ങൾക്ക് കൂടുതൽ മെച്ചമുണ്ടാക്കും കൂടാതെ നിങ്ങളുടെ തൊഴിലിൽ മികച്ച വൈദഗ്ധ്യവും അറിവും നേടാൻ ഇത് നിങ്ങളെ സഹായിക്കും. നിങ്ങൾക്ക് ഒരാളിൽ നിന്ന് സഹായം ലഭിക്കുമ്പോൾ, അത് സ്വയം സൂക്ഷിക്കരുത്, അത് മറ്റുള്ളവരുമായി പങ്കിടുക. ലോകത്തെ ജീവിക്കാനുള്ള മികച്ച സ്ഥലമാക്കി മാറ്റുക. ================================================ FILE: docs/additional-material/translations/Marathi/Removing-a-file.ma.md ================================================ # गिटमधून फाइल काढून टाकणे कधीकधी, आपण कुठलीक फाइल गिटमधून काढून टाकायला इच्छिता, परंतु ती आपल्या संगणकावरून काढून टाकायला इच्छित नाही. आपण खालील आदेशाचा वापर करून ती मिळवू शकता: ``git rm --cached`` ## तर काय झालं? Git आता काढून टाकलेल्या फाइलमधील बदलांची ट्रॅकिंग करत नाही. ज्यामुळे Gitला वाटतं, आपण फाइल काढून टाकली आहे. आपल्याला जर आपल्या फाइल सिस्टिममध्ये त्याची स्थिती शोधायची होती, तर आपण पाहील की ती आत्ता तेथी आहे. यात द्यान द्या की उपरोक्त उदाहरणात, ``--cached`` ध्वज वापरला गेला आहे. जर आपल्याला हे ध्वज जोडण्यात येत नसेल, तर Gitला केवळ रेपोमधून नविन दूरस्थ, तर आपल्या फाइल सिस्टिममध्ये फाइल काढून टाकेल. जर आप git commit ``-m "Remove file1.js"`` साठी बदल करता आणि हे ``git push origin master`` वापरून दूरस्थ रेपॉजिटरीमध्ये दाखविता तर दूरस्थ रेपॉजिटरी तुमच्या फाइलला काढून टाकेल. ## अतिरिक्त सुविधा - जर आपल्या अनेक फाइल नकाल करायला इच्छिता, तर आप त्यांची सर्व एकाच कमांडमध्ये समाविष्ट करू शकता: ``git rm file1.js file2.js file3.js --cached`` - तुम्ही वाइल्डकार्ड (*) वापरून एकसारख्या फाइल काढू शकता. उदाहरणार्थ, जर तुम्हाला आपल्या स्थानिक संग्रहामध्ये सर्व .txt फाइल काढू शकता: ``git rm *.txt --cached`` ================================================ FILE: docs/additional-material/translations/Marathi/additional-material.ma.md ================================================ # अतिरिक्त माहिती येथे आपण असे गृहीत धरू की आपण आधीच मूलभूत सूचनांमध्ये प्रभुत्व मिळवले आहे. पूरक माहितीमध्ये GIT आदेशांबद्दल काही माहिती असते, जी अधिक जटिल परिस्थितींमध्ये आवश्यक असते. ### [कमिटमधील बदल](amending-a-commit.md) दस्तऐवजात रिमोट रिपॉझिटरीमध्ये कमिट कसे सुधारायचे याबद्दल माहिती आहे. > तुम्ही पूर्वी केलेली वचनबद्धता बदलायची असेल तेव्हा ते आवश्यक असते. ### [गिट कॉन्फिगर करणे](configuring-git.md) दस्तऐवजात वापरकर्ता माहिती आणि इतर GIT सेटिंग्ज कशी बदलायची याबद्दल माहिती आहे. > जीआयटी इन्स्टॉलेशन अधिक सोयीस्कर बनवायचे असल्यास ते उपयुक्त ठरेल. ### [तुमचा फोर्क मुख्य रेपॉजिटरीसह सिंक्रोनाइझ करणे](keeping-your-fork-synced-with-this-repository.md) दस्तऐवज मुख्य रेपॉजिटरीसह आपला काटा कसा समक्रमित ठेवायचा याबद्दल बोलतो. सिंक्रोनाइझेशन आवश्यक आहे कारण, आशा आहे की, तुम्ही एकट्या प्रकल्पावर काम करणार नाही, तर इतर योगदानकर्त्यांसह त्यात बदल कराल. > तुमच्या शाखेत रिपॉझिटरीच्या मास्टर शाखेत कोणतेही बदल नसल्यास या चरणांचे अनुसरण करा. ### [कमिट दुसऱ्या शाखेत हलवणे](moving-a-commit-to-a-different-branch.md) दस्तऐवजात कमिट दुसर्‍या शाखेत कसे हलवायचे याबद्दल माहिती आहे. > कमिट दुसर्‍या शाखेत हलवण्यासाठी दिलेल्या स्टेप्स फॉलो करा. ### [फाइल काढून टाकत आहे](removing-a-file.md) दस्तऐवज तुमच्या स्थानिक भांडारातून फाइल कशी काढायची याचे वर्णन करते. > कमिट करण्यापूर्वी फाइल कशी काढायची हे समजून घेण्यासाठी या कमांडचे पुनरावलोकन करा. ### [तुमच्या भांडारातून शाखा काढून टाकत आहे](removing-branch-from-your-repository.md) दस्तऐवजात तुमच्या भांडारातून शाखा कशी काढायची याबद्दल माहिती आहे. > तुमची पुल विनंती मंजूर झाल्यानंतरच या कमांड्स वापरा. ### [शाखा विलीन करताना संघर्ष सोडवणे](resolving-merge-conflicts.md) दस्तऐवजात शाखांचे विलीनीकरण करताना उद्भवणारे संघर्ष कसे सोडवायचे याबद्दल माहिती आहे. > येथे सुचविलेल्या पायर्‍या शाखांचे विलीनीकरण करताना उद्भवणाऱ्या संघर्षाच्या किरकोळ प्रकरणांना सामोरे जाण्यास मदत करतील. ### [कमिट परत करणे](reverting-a-commit.md) दस्तऐवज रिमोट रिपॉजिटरीमध्ये कमिट कसे पूर्ववत करायचे याचे निर्देश देते. असे ऑपरेशन अशा प्रकरणांमध्ये उपयुक्त ठरेल जेव्हा तुम्हाला गिथबवर आधीच ढकललेले कमिट प्ले बॅक करावे लागेल. > कमिट पूर्ववत करण्यासाठी येथे चरणांचे अनुसरण करा. ### [स्क्वॅशिंग कमिट (स्क्वॅशिंग)](squashing-commits.md) दस्तऐवज परस्परसंवादी रीबेसेस वापरून कमिट कसे एकत्र करायचे याचे वर्णन करते. > तुम्ही ओपन सोर्स प्रोजेक्टवर पुल रिक्वेस्ट तयार केली असल्यास या सूचना वापरा, परंतु प्रोजेक्ट एक्सपर्ट तुम्हाला तुमच्या सर्व कमिट एका अर्थपूर्ण टिप्पणीसह एकत्र करण्यास सांगतात. ### [स्थानिक कमिट पूर्ववत करणे](undoing-a-commit.md) दस्तऐवज तुम्हाला तुमच्या स्थानिक रेपॉजिटरीमध्ये कमिट कसे परत करायचे याची माहिती देतो. जर तुम्ही ठरवले की तुम्ही तुमच्या भांडारात गडबड केली आहे आणि त्यातील मजकूर त्यांच्या मूळ स्थितीत पुनर्संचयित करू इच्छित असाल तर तुम्हाला या माहितीची आवश्यकता असेल. > तुम्हाला शेवटच्या स्थानिक कमिटने केलेले बदल पूर्ववत करायचे असल्यास या सूचनांचे अनुसरण करा. ### [उपयोगी दुवे](उपयोगी-लिंक-फॉर-further-learning.md) या फाइलमध्ये ब्लॉग पोस्ट्स, उपयुक्त वेबसाइट्स, वेबसाइट्सची सूची असलेल्या टिप्स आणि युक्त्या आहेत ज्या अनेकदा आमचे जीवन सुलभ करतात. नवशिक्यांसाठी आणि तज्ञांसाठी, आवश्यकतेनुसार आम्ही त्यांच्याशी संपर्क साधण्याची शिफारस करतो. या फाइलमध्ये उपयुक्त लिंक्सची सूची आहे जी ओपन सोर्समध्ये पहिले पाऊल टाकणाऱ्यांना आणि या क्षेत्रातील त्यांचे ज्ञान वाढवू इच्छिणाऱ्यांना नक्कीच मदत करेल. ================================================ FILE: docs/additional-material/translations/Nepali/additional-material.np.md ================================================ # थप जानकारी हामी मान्दछौं कि तपाईंले यहाँ जानु अघि आधारभूत ट्यूटोरियल पढिसक्नुभएको छ। यो कागजातले तपाईंलाई Git प्रविधिहरूमा थप जानकारी दिनेछ उन्नत । ### [प्रतिबद्धता सम्पादन गर्नुहोस्](amending-a-commit.np.md) यो पृष्ठले तपाईंलाई रिमोट डाइरेक्टरीमा कमिट परिमार्जन गर्न आवश्यक जानकारी दिनेछ: > तपाईंले गर्नुभएको प्रतिबद्धता ठीक गर्न यो प्रयोग गर्नुहोस्। ### [git कन्फिगर गर्नुहोस्](configuring-git.np.md) यो पृष्ठले तपाइँलाई तपाइँको प्रयोगकर्ता विवरणहरू र git मा अन्य विकल्पहरू कन्फिगर गर्न आवश्यक जानकारी दिनेछ: > तपाईंको git कन्फिगरेसनको राम्रो नियन्त्रणको लागि प्रयोग गर्नुहोस्। ### [डाइरेक्टरी संग सिंक मा आफ्नो फोर्क राख्नुहोस्](keeping-your-fork-synced-with-this-repository.np.md) यो कागजातले तपाईंलाई स्रोत डाइरेक्टरीसँग "फोर्क" डाइरेक्टरीलाई अद्यावधिक राख्नको लागि जानकारी दिन्छ। यो महत्त्वपूर्ण छ र हामी आशा गर्छौं कि तपाईं र अरू धेरैले यस परियोजनामा ​​योगदान गर्नुहुनेछ। > यदि तपाईंले अभिभावक डाइरेक्टरीमा आफ्नो शाखामा कुनै परिवर्तनहरू देख्नुभएन भने यी चरणहरू पालना गर्नुहोस्। ### [एउटा कमिटलाई फरक शाखामा सार्नुहोस्](moving-a-commit-to-a-different-branch.np.md) यो पृष्ठले तपाईंलाई फरक शाखामा प्रतिबद्धता सार्न आवश्यक जानकारी दिनेछ: > कमिटलाई फरक खुट्टामा सार्न यी चरणहरू पालना गर्नुहोस्। ### [फाइल मेटाउनुहोस्](removing-a-file.np.md) यो पृष्ठले तपाईंलाई आफ्नो स्थानीय डाइरेक्टरीबाट फाइल मेटाउन आवश्यक जानकारी दिनेछ: > कमिट गर्नु अघि फाइल कसरी मेटाउने भनेर सिक्नको लागि यी चरणहरू पालना गर्नुहोस्। ### [तपाईंको डाइरेक्टरीमा एउटा शाखा मेटाउनुहोस्](removing-branch-from-your-repository.np.md) यस पृष्ठले तपाइँलाई तपाइँको निर्देशिकाबाट शाखा मेटाउन आवश्यक जानकारी दिनेछ: > तपाईंको पुल अनुरोध मर्ज भएपछि मात्र यी चरणहरू पालना गर्नुहोस्। ### [मर्ज विवादहरू समाधान गर्नुहोस्](resolving-merge-conflicts.np.md) यो पृष्ठले तपाईंलाई मर्ज मुद्दाहरूको समस्या निवारण गर्न आवश्यक जानकारी दिनेछ: > यी (प्रायः कष्टप्रद) मिश्रण समस्याहरू समाधान गर्न यी चरणहरू पालना गर्नुहोस्। ### [प्रतिबद्धतामा फर्कनुहोस्](reverting-a-commit.np.md) यदि तपाइँ रिमोट डाइरेक्टरीमा अघिल्लो कमिटमा फर्कन आवश्यक छ भने यो पृष्ठले तपाइँलाई मद्दत गर्नेछ। तपाईले पहिले नै Github मा धकेल्नु भएको कमिटलाई अन्डू गर्न आवश्यक छ भने यो उपयोगी छ। > यदि तपाइँ कमिट उल्टाउन चाहनुहुन्छ भने यी चरणहरू पालना गर्नुहोस्। ### [सपाट कमिटहरू](squashing-commits.np.md) यस पृष्ठले तपाइँलाई सिकाउनेछ कि कसरी एकमा धेरै कमिटहरू समतल गर्ने। > यदि तपाइँ पुल अनुरोध खोल्न चाहनुहुन्छ भने प्रयोग गर्नुहोस् र समीक्षकले तपाइँलाई समग्र जानकारी सन्देश सहित सबै कमिटहरूलाई "फ्लैट" गर्न सोध्छन्। ### [उपयोगी लिङ्कहरू](undoing-a-commit.np.md) यो पृष्ठले तपाइँलाई तपाइँको स्थानीय डाइरेक्टरीमा कमिट अनडू गर्न आवश्यक जानकारी दिन्छ। यदि तपाईंले आफ्नो स्थानीय डाइरेक्टरीमा गल्ती गरेको महसुस गर्नुभयो र अघिल्लो अवस्थामा फर्कन चाहनुहुन्छ भने तपाईंले यो गर्न आवश्यक छ। > यदि तपाइँ स्थानीय कमिटमा पूर्वस्थितिमा पूर्ववत/उल्टाउन चाहनुहुन्छ भने यी निर्देशनहरू पालना गर्नुहोस्। ### [उपयोगी लिङ्कहरू](Useful-links-for-further-learning.np.md) यो पृष्ठ सबै टिप्स र ट्रिक्स साइटहरू, ब्लगहरू, र सामान्य साइटहरूमा समर्पित छ जसले हामीलाई हाम्रो जीवन सजिलो बनाउन मद्दत गर्दछ। तिनीहरू तपाइँका सबै आवश्यकताहरू पूरा गर्न उत्कृष्ट सन्दर्भहरू हुन्, चाहे तपाइँ शुरुवात वा विशेषज्ञ हुनुहुन्छ। यो पृष्ठ ती सबै उपयोगी लिङ्कहरूको अनुक्रमणिका हुनुपर्छ जसले खुला स्रोतमा नयाँ भएका वा आफ्नो ज्ञानलाई अझ गहिरो बनाउन चाहने जो कोहीलाई मद्दत गर्नेछ। ### [एउटा .gitignore फाइल सिर्जना गर्नुहोस्](creating-a-gitignore-file.np.md) यो कागजातले .gitignore फाइल केका लागि हो, यसलाई किन प्रयोग गर्ने र कसरी सिर्जना गर्ने भनेर बताउँछ। यो फाइल लगभग सबै git परियोजनाहरूमा प्रयोग गरिन्छ। यसले कमिटहरूमा मात्र आवश्यक फाइलहरू विचार गर्न मद्दत गर्दछ। ================================================ FILE: docs/additional-material/translations/Nepali/amending-a-commit.np.md ================================================ # प्रतिबद्धता सम्पादन गर्नुहोस् मानौं कि तपाईंले आफ्नो रिमोट डाइरेक्टरीमा प्रतिबद्धता गर्नुभयो र पछि यो महसुस गर्नुहोस् कमिट सन्देशमा टाइपो छ वा तपाईंले आफ्नो अन्तिम कमिटमा लाइन थप्न बिर्सनुभयो। यो त्रुटि कसरी सच्याउने? यो यस ट्यूटोरियल को विषय हो। ## Github मा धक्का दिए पछि भर्खरको प्रतिबद्ध सन्देश परिवर्तन गर्नुहोस् फाइल नखोली नै यो गर्नका लागि: * आदेश टाइप गर्नुहोस् ```git कमिट --amend -m "तपाईँको नयाँ प्रतिबद्ध सन्देश पछि"``` * निर्देशिकामा कमिट गर्न ```git push origin ``` आदेश चलाउनुहोस्। NB: यदि तपाइँ केवल ```git कमिट --amend``` टाइप गर्नुहुन्छ भने, पाठ सम्पादक खुल्छ र तपाइँलाई परिमार्जन गर्न सोध्छ। सन्देश पठाउनुहोस्। पाठ सम्पादक प्रयोग गर्नबाट बच्न ``-m`` विकल्प थप्नुहोस्। ## एक विशिष्ट प्रतिबद्धता परिमार्जन गर्नुहोस् त्यसोभए के हुन्छ यदि तपाईंले फाइलमा सानो परिवर्तन गर्न बिर्सनुभयो, जस्तै शब्द परिवर्तन गर्नुहोस् र तपाईंले पहिले नै हाम्रो रिमोट डाइरेक्टरीमा यो प्रतिबद्धता पुश गरिसक्नुभएको छ? यस बिन्दुलाई चित्रण गर्न, यहाँ मेरो प्रतिबद्धताहरूको लग छ; ``` g56123f बोट फाइल सिर्जना गर्दै contributor.md बाट a2235d अपडेट a5da0d बोट फाइल सम्पादन गर्नुहोस् ``` कल्पना गरौं कि मैले बोट फाइलमा एउटा शब्द थप्न बिर्सें। यो समस्या समाधान गर्न दुई तरिकाहरू छन्। पहिलो भनेको नयाँ प्रतिबद्धता बनाउनु हो जसमा परिवर्तन समावेश छ: ``` g56123f बोट फाइल सिर्जना गर्दै contributor.md बाट a2235d अपडेट a5da0d बोट फाइल सम्पादन गर्नुहोस् b0ca8f बोट फाइलमा शब्द थप्नुहोस् ``` दोस्रो तरिका भनेको a5da0d कमिट परिमार्जन गर्नु हो र यो नयाँ शब्द थप्नुहोस् र यसलाई Github मा सबै एक कमिटमा पुश गर्नुहोस्। यो दोस्रो विकल्प बढी उपयुक्त देखिन्छ, यो एक सानो परिवर्तन हो। त्यसो गर्न, यी चरणहरू पालना गर्नुहोस्: * फाइल सम्पादन गर्नुहोस्। हाम्रो अवस्थामा, हामी बिर्सिएको शब्द समावेश गर्न बोट फाइल परिमार्जन गर्छौं। * त्यसपछि फाइललाई स्टेजिङ क्षेत्रमा ```git add ``` आदेशको साथ थप्नुहोस् सामान्यतया, स्टेजिङ क्षेत्रमा फाइलहरू थपेपछि, अर्को चरण आदेश चलाउन हो git कमिट -एम "हाम्रो प्रतिबद्ध सन्देश", हैन? तर हामी यहाँ के चाहन्छौं भने प्रतिबद्धता परिमार्जन गर्नु हो अघिल्लो, हामी यसको सट्टा आदेशहरू चलाउनेछौं: * ``git कमिट -- amend``` यसले पाठ सम्पादक ल्याउनेछ जसले तपाईंलाई सन्देश सम्पादन गर्न सोध्छ। तपाईं छोड्ने निर्णय गर्न सक्नुहुन्छ सन्देश जस्तो छ वा परिवर्तन गर्नुहोस्। * सम्पादकबाट बाहिर निस्कनुहोस् * आफ्ना परिवर्तनहरूलाई ```git push origin ``` सँग पुश गर्नुहोस् यसरी दुबै परिवर्तनहरू एउटै कमिटमा छन्। ================================================ FILE: docs/additional-material/translations/Nepali/configuring-git.np.md ================================================ # Git वातावरण सेट अप गर्दै पहिलो पटक तपाईंले Git सँग कमिट गर्ने प्रयास गर्नुभयो, तपाईंले निम्न सन्देश देख्न सक्नुहुन्छ: ```bash $ git commit *** Please tell me who you are. Run git config --global user.email "you@example.com" git config --global user.name "Your Name" to set your account's default identity. config --global to set the identity only in this repository. ``` Git लाई कमिट सिर्जना गर्न को लागी तपाई को हुनुहुन्छ भनेर जान्न आवश्यक छ। जब तपाइँ धेरै व्यक्तिहरूसँग समूहमा काम गर्नुहुन्छ, तपाइँलाई सधैं थाहा हुनुपर्छ कि कसले परियोजनामा ​​​​कुन परिवर्तन गर्यो र उनीहरूले यो कहिले गरे। यस अन्तको लागि, Git सिर्जना गरिएको थियो ताकि कमिटहरू नाम र ईमेलमा बाँधिएका छन्। त्यहाँ 'git कमिट' आदेशमा तपाईंको नाम र इमेल प्रदान गर्ने धेरै तरिकाहरू छन्, र हामी ती मध्ये केहीलाई निम्न लाइनहरूमा जानेछौं। ### ग्लोबल कन्फिगरेसन जब हामीले ग्लोबल कन्फिगरेसन (ग्लोबल कन्फिगरेसन) मा केहि बचत गर्छौं, यो सेटिङ तपाईंले काम गर्ने सबै भण्डारहरूमा उपलब्ध हुन्छ। यो विधि सिफारिस गरिएको छ र अधिकतर अवस्थामा काम गर्दछ। ग्लोबल कन्फिगरेसनमा केहि बचत गर्न, 'config' आदेश प्रयोग गर्नुहोस्: `$ git config --global ` प्रयोगकर्ता डेटा को मामला मा: ``` $ git config --global user.email "you@example.com" $ git config --global user.name "Your Name" ``` ### भण्डार कन्फिगरेसन नामले नै हामीलाई बताउँछ, यी कन्फिगरेसनहरू केवल एउटा भण्डारमा सीमित छन्। यदि तपाइँ एक विशेष भण्डारमा प्रतिबद्ध गर्न चाहनुहुन्छ भने, तपाइँको कामको इ-मेलको साथ कार्य परियोजना भन्नुहोस्, त्यसपछि हामी यो विधि प्रयोग गर्दछौं। भण्डार कन्फिगरेसनमा केहि बचत गर्न, `config` आदेश प्रयोग गर्नुहोस् र `--global` झण्डा छोड्नुहोस्: `$ git config ` प्रयोगकर्ता डेटा को मामला मा: ``` $ git config user.email "you@alternate.com" $ git config user.name "Your Name" ``` ### कमाण्ड लाइन कन्फिगरेसन यी कन्फिगरेसनहरू हालको आदेश रेखामा मात्र सीमित छन्। सबै Git आदेशहरूले आदेश क्रियाको अगाडि `-c` उपसर्ग स्वीकार गर्दछ। यसले अस्थायी कन्फिगरेसन सिर्जना गर्दछ। आदेश रेखा कन्फिगरेसनमा केहि बचत गर्न: `$ git -c = -c = ` हाम्रो उदाहरणमा, हामी कमिट आदेशलाई यसरी प्रयोग गर्नेछौं: `git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Your commit message"` ### फाइदाको बारेमा माथि उल्लिखित विधिहरू बीच प्रयोगको क्रम निम्नानुसार छ `command-line > repository > global`. यसको मतलब यदि चर कमाण्ड लाइन र ग्लोबलमा भण्डार गरिएको छ भने, कमाण्ड लाइन कन्फिगरेसनमा मान प्रयोग गरिनेछ। ## साथै अहिलेसम्म हामीले प्रयोगकर्ता सेटिङहरूमा मात्र काम गरेका छौं, तर त्यहाँ केही अन्य कन्फिगरेसनहरू छन्। ती मध्ये केही हुन्: 1. `core.editor` - टिप्पणी लेख्न प्रयोग गर्न पाठ सम्पादक निर्दिष्ट गर्न, आदि। 2. `commit.template` - प्रारम्भिक कमिट टेम्प्लेटको रूपमा प्रयोग गर्न प्रणालीमा फाइल निर्दिष्ट गर्न 3. `color.ui` - Git को आउटपुटमा रङहरू प्रयोग गर्न बुलियन मान निर्दिष्ट गर्न। हामीले सजिलै बुझ्नको लागि केही विवरणहरू सरलीकृत गरेका छौं। तपाईं मा थप पढ्न सक्नुहुन्छ [git-scm.com](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration). ================================================ FILE: docs/additional-material/translations/Portugues/Things a non Programmer can do.pt-br.md ================================================ # Coisas Que Não-Programadores Podem Fazer ## Começar escutando Tudo em código aberto envolve outras pessoas. Você está procurando se juntar a um time, e isso significa entender a comunidade e como ela funciona. Entrar num projeto e dizer: "Ei, é isso o que eu acho que deveriam fazer", não é visto com bons olhos. Alguns projetos talvez tolerem esse tipo de abordagem mas, se o projeto já existe há algum tempo, as chances dessa atitude ser aceita será bem pequena. **Escutar é a melhor maneira de conhecer as necessidades de um projeto** - [ ] **TODO:** algum BR pode traduzir mais alguns §§? ;-) 1. **Join a mailing list**: For many projects, the mailing list is the main conduit of communication about the development of the project. On large projects, there are many mailing lists to choose from. For example, the PostgreSQL project has no fewer than 12 user-oriented lists and six developer lists on its mailing list page. I suggest you follow the main user-oriented list and the core developer list in which to start listening. 2. **Follow a blog**: Blogs maintained by core developers often give information about what's coming up in future releases, and what it's taken to get there. A planet site aggregates news and blog entries from many sources related to the project. If there is a planet site, like planet.gnome.org or planet.mysql.com, start there. Just search Google for "planet ." 3. **Join an IRC channel**: Many open source projects have dedicated Internet relay chat (IRC) channels where developers and users hang out to discuss problems and development. Check the project's website for the details of what the channel is called and what IRC network it's found on. **Work with Tickets** Code is the heart of any open source project, but don't think that writing code is the only way to contribute. Maintenance of code and the systems surrounding the code often are neglected in the rush to create new features and to fix bugs. Look to these areas as an easy way to get your foot into a project. Most projects have a publicly visible trouble ticket system, linked from the front page of the project's website and included in the documentation. It's the primary conduit of communication between the users and the developers. Keeping it current is a great way to help the project. You may need to get special permissions in the ticketing system, which most project leaders will be glad to give you when you say you want to help clean up the tickets. 4. **Diagnose a bug**: Bugs are often poorly reported. Diagnosing and triaging a bug can help save the developers time with the legwork of figuring out the specifics of the problem. If a user reported, "The software doesn't work when I do X," spend some time to figure out the specifics of what goes into that problem. Is it repeatable? Can you create a set of steps to cause the problem repeatedly? Can you narrow down the problem, such as only happening on one browser but not another, or one distro but not another? Even if you don't know what causes the problem, the effort you put into narrowing down the circumstances makes it easier for someone else to fix it. Whatever you discover, add it to the ticket in the bug system for all to see. 5. **Close fixed bugs**: Often bugs are fixed in the codebase but tickets reported about them don’t get updated in the ticketing system. Cleaning up this cruft can be time-consuming, but it's valuable to the whole project. Start by querying the ticket system for tickets older than a year and see if the bug still exists. Check the project's release change log to see if the bug was fixed and can be closed. If it's known to be fixed, note the version number in the ticket and close it. Try to recreate the bug with the latest version of the software. If it can't be recreated with the latest version, note that in the ticket and close it. If it still exists, note that in the ticket as well and leave it open. Working with Code Programmers of all experience levels can help with the code in the project. Don't think that you have to be a coding genius to make real contributions to your favorite project. If your work involves modification to the code, investigate the method that the project uses for getting code from contributors. Each project has its own workflow, so ask about how to do it before you set out to submit code. For example, the PostgreSQL project is very rigorous in its process: Code modifications are sent in patch form to a mailing list where core developers scrutinize every aspect of the change. On the other end is a project like Parrot where it's easy to get commit privileges to the codebase. If the project uses GitHub, there may be a workflow that uses the pull request feature of GitHub. No two projects are the same. Whenever you modify code, make sure that you act as a responsible member of the community and keep your code style to match the rest of the codebase. The code you add or modify should look like the rest. You might not like the bracing style or the handling of spaces for indentation, but it's rude to submit a code change that doesn't match the existing standards. It's the same as saying "I don't like your style, and I think mine is better, so you should do it my way." 6. **Test a beta or release candidate**: Any project that's designed to run on multiple platforms can have all sorts of portability problems. When a release approaches and a beta or release candidate is published, the project leader hopes that it will be tested by many different people on many different platforms. You can be one of those people and help ensure that the package works on your platform. Typically you only need to download, build, and test the software, but the value to the project can be huge if you're on an uncommon distribution or hardware. Just reporting back that the build and test works helps the project leaders know that the impending release is solid. 7. **Fix a bug**: This is usually where contributors wanting to get working on code start. It’s simple: Find an interesting-sounding bug in the ticket system and try to fix it in the code. Document the fix in the code if it's appropriate. It's a good idea to add a test to the test suite to test the spot of code you fixed; some projects require bug fixes to include tests. Keep notes as you poke around this unfamiliar codebase. Even if you aren't able to fix the bug, document in the ticket what you discovered as part of the fix attempt. What you find helps those who come after you. 8. **Write a test**: Most projects have a test suite that tests the code, but it's hard to imagine a test suite that couldn't have more tests added to it. Use a test coverage tool like gcov for C, or Devel::Cover for Perl to identify areas in the source code that aren't tested by the test suite. Then, add a test to the suite to cover it. 9. **Silence a compiler warning**: The build process for many C-based projects often spew the odd compiler warning flag to the screen. These warnings are usually not indicators of a problem, but they can look like it. Having too many warnings can make the compiler sound like it's crying wolf. Check to see if the code could actually be hiding a bug. If not, modifying the source to silence helps to hide these false positives. 10. **Add a comment**: When you're digging through the code, you may find some spots that are confusing. Chances are if you were confused, others will be as well. Document them in the code and submit a patch. Work with Documentation Documentation is typically the part of a project that gets short shrift. It also can suffer from having been written from the point of view of those who are familiar with the project, rather than through the eyes of someone just getting into it. If you've ever read docs for a project where you think, "It's as though this manual expects that I already know how to use the package," you know what I'm talking about. Often a set of fresh eyes can point out deficiencies in the documentation that those close to the project don't notice. 11. **Create an example**: There is no project that has too many how-to examples. Whether it's a web API, a library of routines, a GUI app like Gimp or a command line tool, a good example of proper usage can more clearly and quickly explain proper usage of software than pages of documentation. For an API or library, create an example program that uses the tool. This could even be extracted from code you've written, trimmed down to the bare necessities. For a tool, show real-world examples of how you've used it in your daily life. If you’re visually oriented, consider creating a screen-capture of an important process, such as how to install the application. Work with Community Open source is only partly about code. Community makes open source work. Here are ways you can help build it up. 12. **Answer a question**: The best way to help build the community is by helping others. Answering a question, especially from someone who is just getting their feet wet, is crucial to helping the project grow and thrive. The time you take to help a beginner, even if they're asking a question where you could easily throw back a quick "RTFM," pays off down the road in getting another active member of the community. Everyone starts out somewhere, and projects need a constant inflow of people if they're to stay vital. 13. **Write a blog post**: If you've got a blog, write about your experiences with the project that you're using. Tell about a problem you faced using the software and what you did to solve it. You'll be helping in two ways, both by helping keep the project on the minds of others around you, and by creating a record for anyone else who has your problem in the future and searches the web for the answer. (A blog of your technical adventures is also an excellent way to show real-world experience with the software in question next time you go hunting for a job using it.) 14. **Improve a website**: If you've got skills in web design and can help improve the website, and thus the public-facing image of the project, that's time well spent. Perhaps the project could use a graphic overhaul, or a logo to identify the project. These may be skills lacking in the community. I know I'd love it if I could get some graphic design help on my projects' websites. 15. **Write technical documentation** If you can write about how an application or piece of software works, you could write technical documentation about it. Especially open source projects that are looking to update, revamp, expand, or create technical docs for the general public to read. The more you write in plain english, the better. The best part, you don't have to be a programmer to write technical docs. Most of all, listen to what people around you discuss. See if you can recognize a pressing need. For instance, recently on the Parrot developers' mailing list, it was decided to use GitHub as the trouble ticket system, abandoning the old Trac installation they had. Some people were against the move because there was no way to convert the tickets to GitHub's system. After a day of back and forth arguing, I piped up and said "How about if I write a converter?" People were thrilled at the idea. I spent the time to write a conversion program for the 450+ tickets, so we lost none of our ticket history. It was a great success. I got to pitch in, and the core developers stayed focused on the business of working on Parrot. 15. **Teach and Help others**: The best way to learn more about a topic is to try to teach it. The best teacher is the one who can explain complex stuff with simple examples. So you need to try to be the best teacher to be the best learner and the best in your programming world. Teaching others will make you feel better about yourself and it will help you get better skills and knowledge in your profession. When you get help from someone don't keep it to yourself share it with others. Make the world a better place to live. ================================================ FILE: docs/additional-material/translations/Portugues/additional-material.pt_br.md ================================================ # Informações Adicionais Nós imaginamos que você já tenha terminado o tutorial básico antes de vir aqui. As informações adicionais te darão algumas informações sobre técnicas mais avançadas de Git. ### [Emendando um commit](../git_workflow_scenarios/amending-a-commit.md) Esse documento provê informações sobre como emendar um commit no repositório remoto. > Use isso quando você precisar ajustar um commit que você tenha feito. ### [Configurando o git](../git_workflow_scenarios/configuring-git.md) Esse documento provê informações sobre como configurar detalhes de usuário e outras opções do git. > Use isso para melhor controlar as suas configurações do git. ### [Mantendo o seu fork em sincronia com o repositório](../git_workflow_scenarios/keeping-your-fork-synced-with-this-repository.md) Esse documento provê informações sobre como manter o seu fork atualizado com o repositório base. Isso é importante, já que se espera que você e muitas outras pessoas contribuem com o projeto. > Siga esses passos se o seu fork não possui as mesmas alterações do repositório pai. ### [Movendo um Commit para um Branch diferente](../git_workflow_scenarios/moving-a-commit-to-a-different-branch.md) Esse documento provê informações sobre como mover um Commit para outro Branch. > Siga esses passos para mover um commit para outro branch. ### [Removendo um arquivo](../git_workflow_scenarios/removing-a-file.md) Esse documento provê informações sobre como remover um arquivo do seu repositório local. > Siga esses passos para aprender como remover um arquivo do seu repositório local. ### [Removendo um Branch do seu repositório](../git_workflow_scenarios/removing-branch-from-your-repository.md) Esse documento provê informações sobre como deletar um Branch do seu repositório. > Apenas siga esses passos após o seu pull request ter sido mesclado. ### [Resolvendo conflitos de Merge](../git_workflow_scenarios/resolving-merge-conflicts.md) Esse documento provê informações sobre como resolver conflitos de Merge. > Siga esses passos para resolver conflitos de Merge irritantes. ### [Revertendo um commit](../git_workflow_scenarios/reverting-a-commit.md) Esse documento provê informações sobre como reverter um commit feito no repositório remoto. Isso é muito útil quando você precisa desfazer um commit que tenha sido publicado no GitHub. > Siga esses passos se você quiser reverter um commit. ### [Comprimir Commits juntos](../git_workflow_scenarios/squashing-commits.md) Esse documento provê informações sobre como esmagar commits juntos em um só realizando um rebase. > Use esses passos se você quiser realizar um PR em um projeto open source e a pessoa que realizou o review pedir para você mesclar todos os commits em um só, com uma mensagem de commit informativa. ### [Desfazendo um commit local](../git_workflow_scenarios/undoing-a-commit.md) Esse documento provê informações sobre como desfazer um commit no seu repositório local. Isso é o que você precisa fazer quando sente que fez alguma besteira no seu repositório e deseja desfazer. > Take these steps if you want to undo/reset a local commit. ### [Links úteis](../git_workflow_scenarios/Useful-links-for-further-learning.md) Esse documento é dedicado a todos os blogs, posts, sites úteis, dicas e truques que fazem a nossa vida mais simples. Seja você um expert ou um iniciante, essa pagina deve servir como um index para todos esses links úteis para ajudar qualquer um que seja novo no mundo de projetos open-source ou alguém que queira prender mais a respeito. ================================================ FILE: docs/additional-material/translations/Portugues/amending-a-commit.pt_br.md ================================================ # Corrigindo um Commit E se você fizer o commit de uma alteração para o seu repositório remoto, e posteriormente acabar percebendo que ele possui um erro na mensagem do commit, ou você se esqueceu de adicionar uma linha de código no seu commit mais recente? Como você editaria isso? É isso que esse tutorial cobre. ## Alterando uma mensagem de commit recente após ter dado push para o Github Para fazer isto sem abrir um arquivo: * Digite o comando ```git commit --amend -m "seguido da sua nova mensagem de commit"``` * Execute ```git push origin ``` para fazer o commit das mudanças para o repositório. Nota: Se você digitar apenas ```git commit --amend```, seu editor de texto abrirá te pedindo para editar a mensagem de commit. Adicionar a flag ``-m`` previne isso. ## Fazendo modificações em um único commit E se nós nos esquecermos de fazer uma pequena mudança em um arquivo, como adicionar uma única palavra, mas nós já demos push no commit para o nosso repositório remoto? Para ilustrar, aqui está um log dos meus commits: ``` g56123f arquivo bot criado a2235d atualizado contributor.md a5da0d arquivo bot modificado ``` Supomos que eu esqueci de adicionar uma palavra no arquivo bot. Há 2 modos de resolver esse problema. O primeiro é fazer um novo commit que contém a mudança, dessa forma: ``` g56123f arquivo bot criado a2235d atualizado contributor.md a5da0d arquivo bot modificado b0ca8f adicionada palavra no arquivo bot ``` O segundo modo é corrigir o commit a5da0d, adicionar essa nova palavra e dar push para o Github como um único commit. Essa ação soa melhor, já que é apenas uma pequena alteração. Para fazer isso, nós faríamos o seguinte: * Modificar o arquivo. Nesse caso, modificarei o arquivo bot para incluir a palavra que eu esqueci anteriormente. * Em seguida, adicionar o arquivo para a área de preparação (*staging area*) com o comando ```git add ``` Normalmente, após adicionar arquivos na área de preparação, a próxima coisa que nós fazemos é entrar com o comando ```git commit -m "nossa mensagem de commit"```, certo? Mas, como o que nós queremos fazer aqui é corrigir o commit anterior, nós ao invés disso iremos rodar: * ```git commit --amend``` Isso irá inicializar o editor de texto para que possamos editar a mensagem. Você decide se irá deixar a mensagem como ela estava antes, ou editá-la. * Sair do editor salvando as alterações * Dar push nas suas alterações com o comando ```git push origin ``` Dessa forma, ambas as alterações agora estarão em um único commit. ================================================ FILE: docs/additional-material/translations/Portugues/confinguring-git.pt-br.md ================================================ # Configurando GIT A primeira vez que você tentar fazer um commit usando git, deve ter recebido uma como esta: ```bash $ git commit *** Please tell me who you are. Rode: git config --global user.email "you@example.com" git config --global user.name "Your Name" Para definir a identidade padrão da sua conta. Omita “--global” para definir a identidade apenas nesse repositório ``` o Git precisa saber quem você é ao criar um commit. Quando você está trabalhando colaborativamente, deve ser capaz de ver quem modificou quais partes do projeto e quando, e assim, o git foi projetado para criar commits vinculados a um nome e um email. Existem várias maneiras de fornecer o comando `git commit` com seu email e nome. Veremos algumas delas a seguir. ### Configuração global Quando você armazena algo na configuração global, fica acessível em todos os sistemas e repositórios nos quais você trabalha. Essa é principal forma e funciona para a maioria dos casos de uso. Para armazenar algo na configuração use o comando `config` da seguinte maneira: `$ git config --global ` No caso dos detalhes do usuário, nós os executamos da seguinte maneira: ``` $ git config --global user.email "you@example.com" $ git config --global user.name "Your Name" ``` ### Configuração do repositório Como o nome diz, essas configurações tem como alvo seu repositório atual. Se você quiser se comprometer com um repositório específico, por exemplo, um projeto relacionado a trabalho, com o email de sua empresa, então você pode usar esse método. Para armazenar algo na configuração do repositório, você usa o comando `config` omitindo a sinalização `--global`, da seguinte forma: `$ git config ` No caso dos detalhes do usuário, nós o executamos da seguinte maneira: ``` $ git config user.email "you@alternate.com" $ git config user.name "Your Name" ``` ### Configuração da linha de comando Esse tipo de configuração tem como alvo apenas o comando atual. Todos os comandos git usam argumentos `-c` antes do verbo de ação para definir dados de configurações temporários Para armazenar algo na configuração da linha de comando. Execute seu comando da seguinte maneira: `$ git -c = -c = ` No exemplo citado, executaríamos o comando commit da seguinte forma: `git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Your commit message"` ### Nota sobre precedência Entre os três metodos descritos aqui, a ordem de precedência é `linha de comando > repositório > global`. Isso significa que, se uma variável for configurada na linha de comando e também globalmente, o valor da linha de comando será usado para a operação. ## Além dos detalhes do usuário: Nós lidamos apenas com os detalhes do usuário até agora, enquanto trabalhamos com a configuração. No entanto, existem várias outras opcões disponíveis. Algumas delas são: 1. `core.editor` - para especificar o nome do editor usado para escrever mensagens de commit etc 2. `commit.template` - para especificar um arquivo no sistema como o modelo de commit inicial 3. `color.ui` - para especificar um valor booleano para usar cores na saída do git Nós abstraimos alguns detalhes para facilitar o entendimento. Para ler mais, acesse: [git-scm.com](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration). ================================================ FILE: docs/additional-material/translations/Portugues/keeping-your-fork-synced-with-this-repository.pt_br.md ================================================ ## Mantendo o seu Fork sincronizado com este repositório Primeiro, o fluxo para uma sincronização completa precisa ser entendido. Nesse cenário, temos 3 repositórios diferentes: o meu repositório público no Github `github.com/Roshanjossey/first-contributions/`, seu Fork no GitHub `github.com/Seu-Nome/first-contributions/` e o repositório local, no qual você deve trabalhar. Esse tipo de cooperação é típica de projetos de *open source* (código aberto) e é chamado de `Triangle Workflows`. triangle workflow Para manter seus dois repositórios atualizados com meu repositório público, o primeiro passo é dar um Fetch (buscar) e então um Merge (mesclar) do repositório público ao seu repositório local. O segundo passo é fazer um Push do repositório local para o seu Fork no GitHub. Como vimos anteriormente, é somente a partir do seu Fork que você consegue fazer um Pull Request. Por isso, esse Fork é o último repositório a ser atualizado. Agora, vamos ver como fazer isso: Primeiro, você precisa estar em seu Branch principal (master). Para saber em qual Branch você está, verifique a primeira linha que aparece como resultado do seguinte comando: ``` git status ``` Se você não está no master, vá para ele: ``` git checkout master ``` Em seguida, você deve adicionar meu repositório público ao seu git com `add upstream url-remoto`: ``` git remote add upstream https://github.com/Roshanjossey/first-contributions ``` Esta é uma forma de dizer ao Git que existe uma outra versão deste projeto na URL especificada e estamos chamando-a de `upstream`. Agora busque a nova versão do meu repositório: ``` git fetch upstream ``` Aqui você está buscando todas as mudanças no meu Fork (o remoto `upstream`). Agora, você precisa mesclá-lo ao repositório público no seu Branch principal. ``` git rebase upstream/master ``` Aqui você está aplicando todas as mudanças que buscou ao seu Branch principal (master). Seu repositório local agora está atualizado. Por último, se você fizer um Push do seu Branch master para o seu Fork, seu GitHub também terá as alterações: ``` git push origin master ``` Note que aqui você está fazendo um Push para o repositório remoto chamado `origin`. Agora, todos os seus repositórios estão atualizados. Bom trabalho! Você deve seguir esses passos sempre que seu repositório no GitHub avisar que está alguns Commits atrás do meu repositório. ================================================ FILE: docs/additional-material/translations/Portugues/moving-a-commit-to-a-different-branch.pt_br.md ================================================ # Movendo um commit para outra branch E se apenas depois de ter realizado o commit de uma alteração, vocẽ perceber que fez esse commit na branch errada? Como você poderia corrigir isso? É sobre isso que este tutorial se trata. ## Movendo os últimos commits para uma branch existente Para fazer isso, digite: ```git reset HEAD~ --soft``` - Desfaz o último commit, mas mantém as alterações disponíveis. ```git stash``` - Grava o estado do diretório. ```git checkout name-of-the-correct-branch``` - Alterna para a outra branch. ```git stash pop``` - Recupera o último estado salvo. ```git add .``` - Ou tente adicionar arquivos individualmente. ```git commit -m "your message here"``` - Faça o commit das alterações. Agora suas alterações estão na branch correta ### Movendo o último commit para uma branch nova Para fazer isso, digite: ```git branch newbranch``` - Cria uma nova branch, mantendo todos os commits. ```git reset --hard HEAD~#``` - Retrocede a branch uma quantidade # de commits. Atenção, estes commits serão removidos da branch. ```git checkout newbranch``` - Vá para a nova branch que você criou, ela possuíra todos os commits. Lembre-se: Qualquer alteração não comitada será PERDIDA. ================================================ FILE: docs/additional-material/translations/Portugues/removing-a-file.pt_br.md ================================================ # Removendo um arquivo do Git Às vezes, você pode querer remover um arquivo do Git, mas não excluí-lo do seu computador. Você pode fazer isso usando o seguinte comando: ``git rm --cached`` ## Então o que aconteceu? O Git não irá mais controlar as mudanças no arquivo removido. Pelo que Git sabe, é como se você tivesse excluído o arquivo. Se você localizar o arquivo em seu sistema de arquivos, notará que ele ainda está lá. Observe que no exemplo acima, o sinalizador `--cached` é utilizado. Se não adicionarmos esse sinalizador, o Git removerá o arquivo não apenas do repositório, mas também do seu sistema de arquivos. Se você confirmar a mudança com `git commit -m" Remove file1.js "` e enviar para o repositório remoto usando `git push origin master`, o repositório remoto removerá o arquivo. ## Características adicionais - Se você deseja remover mais de um arquivo, pode incluí-los todos no mesmo comando: `git rm file1.js file2.js file3.js --cached` - Você pode utilizar o caractere coringa (*) para remover todos os arquivos semelhantes. Por exemplo se você deseja remover todos os .txt do seu repositório local: `git rm *.txt --cached` ================================================ FILE: docs/additional-material/translations/Portugues/removing-branch-from-your-repository.pt_br.md ================================================ ## Removendo o Branch do seu repositório Se você seguiu o tutorial até agora, seu Branch `` concluiu seu objetivo, e é hora de deletá-lo do seu repositório local. Isso não é necessário, mas o próprio nome desse Branch mostra como seu objetivo é específico. Sua vida pode ser tornada curta por causa dessa especificidade. Primeiro, vamos mesclar o Branch `` ao seu Branch principal (master), então vamos para ela: ``` git checkout master ``` Mescle `` ao master: ``` git merge master ``` Remova `` do seu repositório local: ``` git branch -d ``` Agora você deletou seu Branch local `` e tudo está limpo e arrumado. Nesse ponto, você ainda deve ter o Branch `` no seu Fork. Antes de deletá-lo, lembre-se que você mandou um Pull Request para o meu repositório a partir desse Branch remoto. Então, a não ser que eu já tenha mesclado o Branch, não o delete. Porém, se eu já tiver mesclado seu Branch e você quer deletar o Branch remoto, use: ``` git push origin --delete ``` Agora, você sabe como arrumar seus Branches. Com o tempo, muitos Commits serão adicionados ao meu repositório público. E os Branches principais (master) da sua máquina local e do seu Fork não estarão mais atualizados. Então, para manter seus repositórios sincronizados com o meu, siga os passos abaixo. #### [Mantendo o seu Fork sincronizado com este repositório](keeping-your-fork-synced-with-this-repository.pt_br.md) ================================================ FILE: docs/additional-material/translations/Romanian/how-to-contribute-to-open-source-projects.ro.md ================================================ # Cum sa contribuiti la proiectele Open Source: Un ghid detaliat pentru incepatori Pe scurt: Daca sunteti nerabdator/nerabdatoare sa creati primul Pull Request pe un proiect Open Source, folositi instructiunile de aici: [Readme](https://github.com/firstcontributions/first-contributions) Contributiile la proiectele Open Source reprezinta una dintre cele mai bune metode de a te dezvolta ca programator/programatoare, a-ti dezvolta portofoliul si a da ceva inapoi comunitatii. Fie ca esti un programator senior sau doar ai inceput, proiectele Open Source ofera foarte multe oportunitati de a invata, colabora si a avea un impact pozitiv. In acest ghid, vom trece prin tot ceea ce trebuie sa stiti pentru a contribui la proiectele Open Source, de la a gasi proiectul protrivit si pana la a realiza prima contributie. ## De ce sa contribuiti la proiectele Open Source? Inainte sa vorbim despre "cum", sa exploram "de ce". Contribuirea la proiectele Open Source ofera numeroase beneficii: * Dezvoltarea abilitatilor: Proiectele Open Source va expun la cod sursa din proiecte reale, ajutandu-va la imbunatatirea abilitatilor dvs. de programare, depanare si colaborare. * Construirea unui Portofoliu: Contributiile la proiectele bine cunoscute va pot imbogati CV-ul si profilul dvs. de pe Github, ajutandu-va sa iesiti in evidenta in fata potentialilor angajatori. * Networking (Colaborarea, socializarea cu scop profesional): Va veti conecta cu dezvoltatori din intreaga lume, veti invata de la experti si veti face parte la randul dvs. din aceasta comunitate globala. * Sa dai inapoi (ca multumire): Proiectele Open Source stau la baza multor aplicatii/programe software pe care le folosim zilnic. Contributiile sunt un mod de a sustine uneltele si tehnologiile pe care va bazati/de care depindeti. * Oportunitati de cariera: Multe companii cauta in mod activ programatori cu experienta pe proiecte Open Source deoarece astfel se demonstreaza initiativa, proactivitatea si lucrul in echipa. ## Cum sa incepeti sa contribuiti pe proiectele Open Source ### 1. Alegeti Proiectul potrivit Identificarea proiectului potrivit este cruciala. Cautati proiecte care se aliniaza intereselor, nivelurilor abilitatilor si telurilor dvs.. Le puteti gasi intr-unul din modurile urmatoare: * Explorati Github: Folositi pagina Github Explore sau cautati topicurile precum "necesita-ajutor", "ajutor-cerut", "good-first-issue", "help-wanted" etc. * Cautati programe dedicate Open Source: Programe ca Google Summer of Code, Hacktoberfest si altele sunt bune pentru incepatori. * Urmariti proiectele dedicate uneltelor/programelor tale (favorite): Contribuie la librarii, frameworks, unelte sau programe pe care deja le folositi. ### 2. Intelegeti proiectul Inainte sa contribuiti, este indicat sa dedicati timp pentru a intelege proiectul: * Cititi documentatia: Incepeti cu fisierul README, cele mai bune practici, reguli si indicatii pentru contributii si regulamentul de conduita. * Exploreaza codul sursa: Familiarizati-va cu structura proiectului si stilul de programare (indentari, conventii de nume, etc.). * Alaturati-va comunitatii: Participati la discutiile de pe forumuri, Slack sau Discord pentru a va acomoda mai usor in comunitate. ### 3. Incepeti cu pasi mici Incepeti cu pasi mici, sarcini de lucru pe care le puteti dezvolta, care va vor ajuta sa deveniti mai increzator/increzatoare, precum: * Repararea defectelor: Cauta "issues" ((cerinte de) sarcini de lucru) pe pagina dedicata, care au etichete precum "sarcina-buna-de-inceput", "pentru-incepatori", "incepatori", "good-first-issue", "beginner-friendly" etc. * Imbunatatiti documentatia: Actualizarile documentatiei sunt adesea trecute cu vederea, insa aduc multa plus-valoare. * Scrieti teste: Adaugarea de teste (teste unitare, teste de integrare, etc.) este un mod foarte bun de a contribui si a invata mai bine codul sursa. ### 4. Folositi cele mai bune practici Cand contribuiti, este bine sa respectati indicatiile pentru cele mai bune practici: * Bifurca si Cloneaza: Bifurcati (fork) si clonati codul sursa (depozitul) pe masina dvs. locala. * Creati o ramura: Lucrati pe o ramura separata pentru a face modificarile dvs.. * Scrieti cod curat: Urmariti standardele de a scrie cod sursa si scrieti cod clar, curat, citibil, concis. * Testati modificarile: Asigurati-va ca modificarile dvs. nu vor afecta functionalitatea existenta. * Creati un Pull Request (cerere de unificare cod sursa intre doua ramuri): Faceti o cerere de unificare a versiunii dvs. de cod sursa cu cel existent pe alta ramura (de obicei cea principala), unde trebuie sa aveti o descriere clara a PR-ului, referentiati alte sarcini de lucru corelate si fiti deschisi la feedback. ## Sfaturi pentru a avea succes in proiectele Open Source Comunicati eficient si eficace: Fiti respectuosi si comportati-va in mod profesional in toate interactiunile. Puneti intrebari cand nu sunteti siguri de cerinte. Aveti rabdare in timpul procesului de evaluare/revizuire. Fiti consistenti: Contributiile regulate, chiar si cele mici, pot avea un impact mare in timp. Invatati din feedback: Evaluarile de cod sursa sunt un prilej de invatare. Acceptati rezultatele acestor evaluari si va veti imbunatati abilitatile. Dati inapoi (ceva comunitatii): Odata ce sunteti comfortabil(a) cu procesul de PR, ajutati-i si pe altii in acest proces, raspundeti-le la intrebari sau chiar fiti mentor pentru incepatori. ## Provocari comune si cum sa le depasiti * Sindromul Impostorului: Multi incepatori simt ca nu au destule abilitati pentru a contribui. Retineti ca toti au inceput de undeva si ca pana si contributiile mici conteaza. * Gasirea timpului necesari: Incepeti cu sarcini de lucru mici, pe care le puteti face. Pana si 30 de minute pe saptamana pot face o diferenta. * Navigarea unui depozit mare de cod sursa: Impartiti procesul de invatare: Incepeti prin a citi in detaliu documentatia - Concentrati-va pe intelegerea unei singure componente la un moment dat - Folositi toate uneltele pentru depanare de care dispuneti - Nu ezitati sa puneti intrebari pentru clarificari ## Concluzie Contributia la proiectele Open Source este o calatorie/aventura/un proces care va ofera imense posibilitati de dezvoltare personala si profesionala. Incepand cu pasi mici, ramanand consistenti si interactionand cu comunitatea, puteti face contributii de impact in timp ce va imbunatatiti abilitatile. Tineti minte ca proiectele Open Source se dezvolta prin colaborare si ca fiecare contributie - indiferent de cat de mica ar fi - ajuta la imbunatatirea mediului digital. Sunteti gata sa incepeti? Gasiti un proiect care va atrage, realizati prima contributie si alaturati-va miscarii globale Open Source astazi! ================================================ FILE: docs/additional-material/translations/Russian/additional-material.ru.md ================================================ # Дополнительная информация Здесь мы предполагаем, что вы уже освоили основную инструкцию. Дополнительная информация содержит некоторые сведения о GIT командах, необходимыж в более сложных ситуациях. ### [Исправления в коммите](amending-a-commit.md) Документ содержит информацию о том, как внести исправления в коммит в удаленном репозитории. > Она необходима для тех случаев, когда вы хотите изменить коммит, который вы сделали ранее. ### [Конфигурирование GITа](configuring-git.md) Документ содержит сведния о том, как изменить информацию о пользователе и другие настройки GITа. > Он будет полезен, если вы захотите сделать установки GITа более удобными. ### [Синхронизация вашего ответвления с основным репозиторием](keeping-your-fork-synced-with-this-repository.md) Документ рассказывает о том, как обеспечить синхронизацию вашего ответвления с основным репозиторием. Обеспечение синхронизации небходимо, так как, насколько можно надеяться, вы будете работать над проектом не в одиночестве, а вносить изменения в него, наряду с другими участниками. > Выполните эти действия, если ваше ответвление не имеет изменений в master ветке репозитория. ### [Перемещение коммита в другую ветку](moving-a-commit-to-a-different-branch.md) Документ содержит сведения о том, как переместить коммит в другую ветку. > Выполните указанные шаги, чтобы переместить коммит в другую ветку. ### [Удаление файла](removing-a-file.md) Документ описывает как удалить файл из вашего локального репозитория. > Ознакомьтесь с этими командами чтобы понять как удалить файл перед тем, как сделать коммит. ### [Удаление ветки из вашего репозитория](removing-branch-from-your-repository.md) Документ содержит информацию о том, как удалить ветку из вашего репозитория. > Используйте эти команды только после того, как ваш пул-реквест был удовлетворен. ### [Разрешение конфликтов при слиянии веток](resolving-merge-conflicts.md) Документ содержит информацию о том, как разрешать конфликты, возникающие при слиянии веток. > Предложенные здесь шаги помогут вам разобраться с весьма неприятными случаями конфликтов возникающих при слиянии веток. ### [Отмена коммита](reverting-a-commit.md) Документ инструктирует как отменить коммит в удаленном репозитории. Такая операция будет полезна в тех случаях, когда вам необходимо отыграть назад тот коммит, который уже был послан на Github (pushed). > Выполните указанные здесь шаги чтобы отменить коммит. ### [Совмещение коммитов (squashing)](squashing-commits.md) Документ описывает, как совмещать коммиты при помощи интерактивного перебазирования. > Используйте эти инструкции, если вы создали пул-реквест в open source проекте, но эксперт проекта просит вас совместить все ваши коммиты в один коммит с содержательным комментарием. ### [Отмена локального коммита](undoing-a-commit.md) Документ информирует, как отыграть назад коммит в вашем локальном репозитории. Вам понадобится эта информация в том случае, если вы решите, что вы испортили ваш репозиторий и захотите вернуть его содержимое к первоначальному состоянию. > Следуйте этим инструкциям, если вы хотите отменить те изменения, котрые были сделаны последним локальным коммитом. ### [Полезные ссылки](Useful-links-for-further-learning.md) Этот файл содержит ссылки на блог-посты, полезные веб-сайты, веб-сайты с перечислением рекоммендаций и приемов, которые часто облегчают нашу жизнь. Как начинающим, так и экспертам мы рекомендуем обращаться к ним по мере необходимости. Этот файл содержит список полезных линьков, которые наверняка помогут и тем, кто делает первые шаги в open source, и тем, кто захочет рассширить свои знания в этой области. ================================================ FILE: docs/additional-material/translations/Russian/amending-a-commit.ru.md ================================================ # Исправления в коммите Представьте, что вы сделали коммит в удаленный репозиторий, а потом поняли, что допустили опечатку в комментарии к коммиту или забыли вставить строку в этот последний по времени коммит. Как поступить в такой ситуации? Именно об этом и пойдет речь в этом документе. ## Как изменить комментарий к недавнему коммиту после того, как он был послан на Github (pushed) Чтобы сделать это, не открывая файл для редактирования, * наберите ```git commit --amend -m "здесь следует текст нового комментария"``` * а затем исполните ```git push origin <имя-ветки>``` для того, чтобы послать изменения на Github. Примечание: Если вы наберете, только ```git commit --amend```, то откроется текстовый редактор и предложит отредактировать комментарий к коммиту. Использование ключа ``-m`` отменяет запуск редактора. ## Как сделать изменения в одном коммите Что если мы забыли сделать небольшое изменение в файле, например, заменить одно слово в коммите, который уже послан в удаленный репозиторий? Пусть, для примера, записи в журнале моих коммитов выглядят следующим образом: ``` g56123f создай файл bot file a2235d исправлен contributor.md a5da0d изменен bot file ``` Допустим, я забыл добавить одно слово в файл bot file Есть два способа исправить это. Первый заключается в создании нового коммита, содержащего это изменение, например, так: ``` g56123f создай файл bot file a2235d исправлен contributor.md a5da0d изменен botfile b0ca8f добавлено одно слово в botfile ``` Второй способ состоит в исправлении коммита a5da0d, добавлении этого пропущенного слова и запушивании этих изменений на Github в виде одного коммита. Второй способ представляется предпочтительным, поскольку дело идёт лишь о незначительном изменении. Чтобы добиться этого, мы поступим следующим образом: * Изменим файл. В данном случае я изменю файл botfile, добавив к нему слово, которое я пропустил ранее. * Далее, проиндексируем этот файл при помощи команды ```git add <имяфайла>``` В обычном случае сразу после индексирования мы делаем ```git commit -m "комментраий к нашему коммиту"```, правильно? Но поскольку в данном случае наша задача - исправить предыдущий коммит, - то вместо этого мы выполним такую команду: * ```git commit --amend``` В результате откроется окно текстового редактора, в котором мы имеем возможность сделать изменения в комментарии. Мы можем в самом деле отредактировать комментарий, или оставить его без изменений. * Выйдем из редактора * Запушим наши изменения при помощи команды ```git push origin <имя-ветки>``` Таким образом, оба исправления окажутся в одном коммите. ================================================ FILE: docs/additional-material/translations/Russian/configuring-git.ru.md ================================================ # Конфигурирование GITа Когда вы впервые попытались сделать коммит, вы могли увидеть такое сообщение: ```bash $ git commit *** Please tell me who you are. [Пожалуйста, сообщите, кто вы.] Исполните следующие команды: git config --global user.email "you@example.com" git config --global user.name "Your Name" чтобы идентифицировать пользователя по умолчанию для данной учетной записи. Опустите ключ --global если вы хотите указать пользователя только для данного репозитория. ``` Чтобы создать коммит, GIT должен знать кто является его автором. При совместной работе, необходимо знать кем и когда были изменены те или иные части проекта, поэтому GIT предусматривает, что каждый коммит при его создании ассоциируется с именем и емейл адресом пользователя. Существует несколько способов, которые позволяют ассоциировать команду `git commit` с вашим емейлом и именем, и здесь мы перечислим некоторые из них. ### Глобальная конфигурация Информация, сохраненная как часть глобальной конфигурации, относится ко всей системе, т.е. ко всем репозиториям, в которых вы работаете. Это предпочтительный способ, подходящий для большинства из вариантов использования. Для сохранения данных в глобальной конфигурации пользуйтесь коммандой `config` в следующей форме: `$ git config --global <название переменной> <значение переменной>` В применении к информации о пользователе, мы исполняем эти команды таким образом: ``` $ git config --global user.email "you@example.com" $ git config --global user.name "Your Name" ``` ### Конфигурация репозитория Как указывает заголовок, такая конфигурация работает в пределах данного репозитория. Если вы хотите сделать коммит в определенном репозитории, скажем содержащем проект связанный с вашим бизнесом, используя емейл вашей компании, тогда вы можете использовать этот способ конфигурации. Чтобы изменить конфигурацию на уровне репозитория, следует опустить ключ `--global` в команде `config` таким образом: `$ git config <название переменной> <значение переменной>` В применении к информации о пользователе, это выглядит следующим образом: ``` $ git config user.email "you@alternate.com" $ git config user.name "Your Name" ``` ### Конфигурация в командной строке Этот способ конфигурации относится только к данной команде. Все команды GIT'а позволяют использовать ключ `-c` перед глаголом идентифицирующим команду для временной установки конфигурационных параметеров. Для изменения параметров конфигурации, распространяющихся только на данную команду, пользуйтесь следующим форматом команд GIT'a: `$ git -c <переменная-1>=<значение переменной-1> -c <переменная-2>=<значение переменной-2> <команда>` Для нашего случая комманда для коммита будет вылядеть так: `git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Ваш комментарий к коммиту"` ### Замечание о порядке предшествования Порядок предшествования среди трех упомянутых типов команд конфигурации определяется как `конфигурация в командной строке > конфигурация репозитория > глобальная конфигурация`. Это означает, что если какая-либо переменная определена, как в глобальной конфигурации, так и в командной строке, то будет использовано значение, присвоенное в командной строке. ## Не только информация о пользователе До сих пор, обсуждая конфигурацию GIT'а, мы касались лишь информации о пользователе. Однако GIT позволяет конфигурировать еще неслколько параметров. Вот некторые из них: 1. `core.editor` - указывает название редактора для редактирования комментарий для коммита и т.п., 2. `commit.template` - указывает файл, который содержит первоначальный темплат для коммита, 3. `color.ui` - логическая переменная, указывающая следует ли испольовать цветные шрифты в сообщениях на терминале GIT'а. Для простоты мы опустили некоторые детали. Для более подробного ознакомления обратитесь к [git-scm.com](https://git-scm.com/book/ru/v1/Введение-Первоначальная-настройка-Git). ================================================ FILE: docs/additional-material/translations/Russian/moving-a-commit-to-a-different-branch.ru.md ================================================ # Перемещение коммита в другую ветку Что если вы сделали коммит, а затем поняли, что изменили неправильную ветку? Как исправить такую ошибку? На этот вопрос отвечает данная инструкция. ## Перемещение последних коммитов в существующую ветку Для такого перемещения, наберите: ```git reset HEAD~ --soft``` - Отменяет последний коммит, но сохраняет сделанныые изменения. ```git stash``` - Сохраняет состояние директории. ```git checkout <имя правильной ветки>``` - Переключается на другую ветку. ```git stash pop``` - Возвращает последнее сохраненное состояние. ```git add .``` - Добавляет индивидуальные файлы. ```git commit -m "ваш комментарий"``` - Сохраняет и делает коммит изменений. Теперь ваши изменения - в правильной ветке. ### Перемещение последних коммитов в новую ветку Для такого перемещения, наберите: ```git branch newbranch``` - Создает новую ветку, сохраняя все коммиты. ```git reset --hard HEAD~[n]``` - Возвращает ветку master назад на n коммитов. Имейте в виду, что изменения содержащиеся в этих коммитах будут полностью удалены из ветки master. ```git checkout newbranch``` - Переключается на ветку, которую вы создали. Эта ветка теперь содержит все коммиты. Запомните: Любые изменения, которые не были включены в коммит, будут полностью ПОТЕРЯНЫ. ================================================ FILE: docs/additional-material/translations/Russian/removing-a-file.ru.md ================================================ # Удаление файла из-под GIT контроля Иногда может возникнуть необходимость удалить файл из-под GIT контроля, но сохранить его на компьютере. Это может быть достигнуто с помощью следующей команды: ``git rm <файл> --cached`` ## Что же произошло? GIT более не контролирует изменения в удалённом файле. С точки зрения GIT'а, этот файл отсутствует, но если вы попробуете локализовать этот файл в файловой системе, то вы увидите, что он всё еще на месте. Заметьте, что в приведенной выше комманде используется ключ `--cached`. Если бы мы не добавили этот ключ, GIT уничтожил бы файл не только из репозитория, но также и из файловой системы. Если вы сделаете коммит при помощи команды `git commit -m "Удалить file1.js"` и затем запушите его в удалённый репозиторий командой `git push origin master`, файл будет стёрт также и из удалёного репозитория. ## Дополнительная информация - Если вы хотите удалить более одного файла, это можно сделать, перечислив все файлы в одной команде: `git rm file1.js file2.js file3.js --cached` - Вы можете использовать шаблон (*) для удаления файлов с близкими именами, например, если вы хотите удалить все .txt файлы из локального репозитория, наберите: `git rm *.txt --cached` ================================================ FILE: docs/additional-material/translations/Serbian/Cyrillic/delete-branch-locally.sr-Cyrl.md ================================================ # Брисање локално направљене гране Ово ће бити корисно ако случајно направите грешку при спеловању имена гране. Ово можете урадити на *3* начина ``` git branch -D ``` ``` git branch --delete --force # Исто као и -D ``` ``` git branch --delete # Грешка ако није спојена ``` -D је скраћеница за --delete --force што означава брисање гране чак иако није спојена (форсирај брисање), али можете користити и -d скраћеницу за --delete која баца грешку ако грана није спојена... ================================================ FILE: docs/additional-material/translations/Serbian/Latin/delete-branch-locally.sr-Latn.md ================================================ # Brisanje lokalno napravljene grane Ovo će biti korisno ako slučajno napravite grešku pri spelovanju imena grane. Ovo možete uraditi na *3* načina ``` git branch -D ``` ``` git branch --delete --force # Isto kao i -D ``` ``` git branch --delete # Greška ako nije spojena ``` -D je skraćenica za --delete --force što označava brisanje grane čak iako nije spojena (forsiraj brisanje), ali možete koristiti i -d skraćenicu za --delete koja baca grešku ako grana nije spojena... ================================================ FILE: docs/additional-material/translations/Sinhala/amending-a-commit.md ================================================ # Commit එකක් සංශෝධනය කිරීම ඔබේ commit පණිවිඩයේ දෝෂයක් ඇති බව ඔබට පසුව අවබෝධ වුනේ නම් හෝ ඔබට එක් පේලියක් එක් කිරීමට ඔබට අමතක වී ඇත්නම් කුමක් කළ යුතුද? ඔබ එය සංස්කරණය කරන්නේ කෙසේද? මෙම නිබන්ධනය මගින් එය ආවරණය කරනු ඇත. ## ඔබ Github වෙත commit කිරීමෙන් පසුව commit එකක් වෙනස් කිරීම ගොනුවක් විවෘත නොකර මෙය කිරීමට: * ```--amend -m``` ලෙස ටයිප් කර පසුව ඔබේ නව commit පණිවිඩය ටයිප් කරන්න. * Git push වෙනස්කම් සිදු කිරීමට ```git push origin ``` ධාවනය කරන්න. සටහන: ඔබ ```git commit --amend``` ලෙස පමණක් ටයිප් කළහොත්, කැපවීමේ පණිවිඩය සංස්කරණය කිරීමට ඔබෙන් පොළඹවන පරිදි ඔබේ පාඨ සංස්කාරකය විවෘත වේ. -m එකතු කිරීම එය වළක්වයි. ## තනි commit එකක් වෙනස් කිරීම ඉතින්, අපට තනි වචනයක් වෙනස් කිරීම වැනි ගොනුවක සුළු වෙනසක් කිරීමට අමතක වී ඇත්නම් සහ අපි දැනටමත් අපගේ දුරස්ථ ගබඩාව වෙත commit කර ඇත්නම් කුමක් කළ යුතුද? මෙහි නිදර්ශනය කිරීම සඳහා මගේ commit සටහනකි: ``` g56123f create file bot file a2235d updated contributor.md a5da0d modified bot file ``` අපි හිතමු මට bot file එකට එක වචනයක් දාන්න අමතක වුනා කියලා. මෙම ගැටළුව විසඳීමට ක්‍රම දෙකක් තිබේ. පළමුවැන්න නම්, එවැනි වෙනස්කම අඩංගු සම්පූර්ණයෙන්ම නව කැපවීමක් තිබීමයි. ``` g56123f create file botfile a2235d updated contributor.md a5da0d modified botfile b0ca8f added single word to botfile ``` දෙවන ක්‍රමය නම් a5da0d commit සංශෝධනය කර මෙම නව වචනය එකතු කර Github වෙත එක් commit එකක් ලෙස තල්ලු කිරීමයි. එය සුළු වෙනසක් පමණක් බැවින් දෙවැන්න වඩා උචිතය. මෙය සාක්ෂාත් කර ගැනීම සඳහා, අපි පහත සඳහන් දේ කරන්නෙමු: * ගොනුව වෙනස් කරන්න. මෙම අවස්ථාවෙහිදී, මම කලින් මඟ හැරිය වචනය ඇතුළත් කිරීමට මම botfile වෙනස් කරමි. * මීළඟට, ```git add ``` සමඟ ගොනුව වේදිකාවට එක් කරන්න. සාමාන්‍යයෙන් Staging area එකට files එකතු කලාට පස්සේ අපි ඊලගට කරන්නේ git commit -m "our commit message" නේද? නමුත් අපට මෙහි සාක්ෂාත් කර ගැනීමට අවශ්‍ය වන්නේ පෙර කැපවීම සංශෝධනය කිරීම බැවින්, අපි ඒ වෙනුවට ධාවනය කරන්නෙමු: * git commit --amend මෙය පසුව පෙළ සංස්කාරකය ගෙන එන අතර පණිවිඩය සංස්කරණය කිරීමට ඔබෙන් පොළඹවයි. පණිවිඩය පෙර තිබූ ආකාරයටම තැබීමට හෝ එය වෙනස් කිරීමට ඔබට තීරණය කළ හැකිය. * සංස්කාරකයෙන් පිටවන්න * ```git push origin ``` සමඟ ඔබේ වෙනස්කම් තල්ලු කරන්න ඒ ආකාරයෙන්, වෙනස්කම් දෙකම එකම කැපවීමකින් සිදුවනු ඇත. ## දුරස්ථව commit වෙනස් කිරීම ඔබ සංශෝධනය කිරීමට කැමති කැපවීම දැනටමත් දුරස්ථ පාලකයට තල්ලු කර ඇත්නම්, මෙම කැපවීම සංශෝධනය කිරීම ඔබගේ ප්‍රාදේශීය ඉතිහාසය දුරස්ථ පාලකයෙන් අපසරනය වීමට තුඩු දෙනු ඇත (ඔබ මූලික වශයෙන් නව කැපවීමක් සාදා සංශෝධිත එක ප්‍රතිස්ථාපනය කරන බැවින්). ඔබට දුරස්ථ පාලකයේ කැපවීම වෙනස් කිරීමට අවශ්‍ය බැවින්, ඔබ ඔබේ ශාඛාවේ දුරස්ථ ඉතිහාසය නැවත ලිවිය යුතුය. එය සාක්ෂාත් කර ගැනීම සඳහා, ඉහත විස්තර කර ඇති ක්‍රියා පටිපාටියම අනුගමනය කරන්න, නමුත් දුරස්ථ පාලකය වෙත ඔබේ කැපවීම තල්ලු කිරීමේදී බල තල්ලු භාවිතා කරන්න. >අවවාදයයි
>දුරස්ථ පාලකය වෙත බලහත්කාරයෙන් තල්ලු කිරීම දුරස්ථ පාලකයේ වෙනස්කම් උඩින් ලියයි (සහ ඉවත දමනු ඇත) සහ ඔබේ තල්ලු කළ කැපවීම් පමණක් තබා ගනී. මේ අතරතුර අනෙකුත් කණ්ඩායම් සාමාජිකයින් විසින් සිදු කරන ලද දුරස්ථ පාලකයේ වෙනස්කම් ද උඩින් ලියනු ලැබේ. ඔබ දුරස්ථ පාලකයේ අවසන් මෑත කැපවීම වෙනස් කරන ආකාරය මෙයයි: ```bash git add git commit --amend -m "followed by your new commit message" git push --force ``` >```--force``` වෙනුවට ```--force-with-lease``` භාවිතා කිරීම දුරස්ථ ශාඛාවේ (ඔබ එසේ කිරීමට අදහස් නොකරන්නේ නම්) වෙනත් පුද්ගලයින්ගේ වෙනස්කම් උඩින් ලිවීම වළක්වන ආරක්ෂිත විකල්පයකි. ================================================ FILE: docs/additional-material/translations/Sinhala/removing-a-file.sin.md ================================================ # GIT වෙතින් ගොනුවක් ඉවත් කිරීම සමහර විට, ඔබට Git වෙතින් ගොනුවක් ඉවත් කිරීමට අවශ්ය විය හැකි නමුත් එය ඔබේ පරිගණකයෙන් මකා නොදමන්න. පහත දැක්වෙන විධානය භාවිතා කිරීමෙන් ඔබට මෙය සාක්ෂාත් කරගත හැකිය: ``git rm --cached`` ## ඉතින්, මොකද වුණේ? ඉවත් කරන ලද ගොනුවේ වෙනස්කම් ගැන GIT තවදුරටත් අවධානය යොමු නොකරනු ඇත. GIT දන්නා පරිදි, එය ඔබ ගොනුව මකා දැමුවාක් මෙනි. ඔබ ඔබේ ගොනු පද්ධතියේ ගොනුව සොයාගත්තේ නම්, එය තවමත් පවතින බව ඔබට පෙනෙනු ඇත. ඉහත උදාහරණයෙන්, ධජය ඛණ්ඩාංක භාවිතා කරන බව සැලකිල්ලට ගන්න. අපි මෙම ධජය එක් නොකළේ නම්, GIT විසින් නැවත ප්රකාශිත හෝ ඔබේ ගොනු පද්ධතියෙන් ද ගොනුව ඉවත් කරනු ඇත. 'GIT CONEM "Read1.js" `ඉවත් කරන්න .js" සමඟ වෙනස ඔබ කළහොත්, "ගිට් තල්ලු සම්භවය මාස්ටර්', දුරස්ථ ගබඩාව ගොනුව ඉවත් කරයි. ## අතිරේක විශේෂාංග - ඔබට ගොනුවකට වඩා ඉවත් කිරීමට අවශ්ය නම්, ඔබට ඒවා සියල්ලම එකම විධානයකින් ඇතුළත් කළ හැකිය: `git rm fine1.js fine2.js fine3.js --cched` - සමාන ලිපිගොනු ඉවත් කිරීම සඳහා ඔබට ආදේශක කාඩ්පතක් (*) භාවිතා කළ හැකිය. උදාහරණයක් ලෙස, ඔබේ දේශීය ගබඩාවෙන් සියලුම .txt ගොනු ඉවත් කිරීමට ඔබ කැමති නම්: `git rm * .txt --cached` ================================================ FILE: docs/additional-material/translations/Slovenian/additional-material.sl.md ================================================ # Dodatne informacije Predvidevamo da ste že končali osnovni vodič. Sedaj boste dobili dodatne informacije o napredni uporabi Git-a. ### [Popravljanje commita](amending-a-commit.sl.md) Informacije o tem kako spremeniti commit v oddaljenem repositoryu. > Uporabi, ko moraš spremeniti že narejeni commit. ### [Nastavljanje Git-a](configuring-git.sl.md) Informacije o tem kako nastaviti uporabnika in druge možnosti v Git-u. > Uporabi za boljši nadzor nad svojo Git konfiguracijo. ### [Kako imeti svojo različico sinhronizirano z oddaljenim repository-em](keeping-your-fork-synced-with-this-repository.sl.md) Informacije o tem kako obdržati svojo različico v skladu z glavnim repository-em. To je pomembno, ker lahko veliko ljudi prispeva k projektu. > Sledi tem korakom, če tvoja verzija nima nobenih sprememb v nadrejenem imeniku (parent directory). ### [Premikanje commita v drugo vejo](moving-a-commit-to-a-different-branch.sl.md) Informacije o tem kako premakniti commit v drugo vejo. > Sledi tem korakom in premakni commit v drugo vejo. ### [Odstranjevanje datoteke](removing-a-file.sl.md) Informacije o tem kako odstraniti datoteko z svojega lokalnega repository-ja. > Sledi tem korakom in odstrani datoteko pred commitom. ### [Odstrani vejo s svojega repository-ja](removing-branch-from-your-repository.sl.md) Informacije o tem kako zbrisati vejo s svojega repository-ja. > Sledi tem korakom šele potem, ko je bil tvoj pull-request že združen. ### [Razreševanje sporov pri združevanju](resolving-merge-conflicts.sl.md) Informacije o tem kako razrešiti spore pri združevanju (resolve merge conflicts). > Sledi tem korakom pri razreševanju nadležnih sporov pri združevanju. ### [Povrnitev commita](reverting-a-commit.sl.md) Informacije o tem kako povrniti commit na oddaljenem repository-ju v prejšnje stanje. Zelo uporabno, če moraš razveljaviti commit, ki je bil že poslan na GitHub. > sledi tem korakom, če želiš povrniti commit v prejšnje stanje. ### [Stiskanje commit-ov](squashing-commits.sl.md) Informacije o tem kako stisnite commite z interaktivnim rebase-om. > Uporabi te korake, če želiš narediti pull-request v odprto-kodni projekt in te pregledovalec prosi, da stisni (squash) vse commite v enega in dodaj informativno commit sporočilo. ### [Razveljavljanje lokalnega commita](undoing-a-commit.sl.md) Informacije o tem kako razveljaviti commit v svojem localnem repository-ju. Uporabno, ko si naredil zmešnjavo v lokalnem repository-ju in ga želiš postaviti na prejšnje stanje. > Sledi korakom, ko želiš razveljaviti lokalni commit. ### [Uporabne povezave](../git_workflow_scenarios/Useful-links-for-further-learning.md) Ta dokument je namenjem vsem blogom, uporabnim stranem, spletnim stranem s triki in namigi, ki naredijo naša življenja lažja. Stran naj bi bila kazalo teh uporabnih povezav, ki lahko pomagajo vsem novincem v odprto-kodnem svetu in vsem, ki imajo željo po dodatnem znanju. ================================================ FILE: docs/additional-material/translations/Slovenian/amending-a-commit.sl.md ================================================ # Popravljanje Commita Kaj narediti, če pošlješ commit v oddaljeni repository in potem ugotoviš da si se zatipkal ali pa pozabil dodati vrstico kode v svoj zadnji commit. Kako to popraviti? O tem govori ta vodič. ## Spreminjanje komentarja commit-a, ki je bil pred kratkim poslan na GitHub To lahko naredimo brez da bi odprli datoteko: * V terminal vpiši ```git commit --amend -m "followed by your new commit message"``` * Zaženi ```git push origin ``` da pošlješ commit s spremembo v repository. Opomba: Če vtipkaš samo ```git commit --amend```, se odpre tvoj urejevalnik besedil in te pozove da spremeniš komentar commit-a. Zastavica ``-m`` to prepreči. ## Sprememba enega commit-a No, kaj storiti, če pozabimo narediti eno malo spremembo v datoteki, kot na primer spremeniti eno besedo, vendar smo že poslali commit v oddaljeni repository? Prikaz praktičnega primera (zgodovina commit-ov tega repository-a): ``` g56123f create file botfile a2235d updated contributor.md a5da0d modified botfile ``` Recimo da smo pozabili dodati eno samo besedo datoteki botfile. Obstajata dva načina kako se stvari lotiti. Prvi primer je da naredimo nov commit, ki vsebuje spremembo: ``` g56123f create file botfile a2235d updated contributor.md a5da0d modified botfile b0ca8f added single word to botfile ``` Drugi način je, da spremenimo commit a5da0d, mu dodamo pozabljeno besedo in ga pošljemo v GitHub, vse skupaj kot en commit. Drugi način nam je bolj všeč, ker imamo opravka z manjšo spremembo. Da to dosežemo, storimo naslednje: * Spremenimo datoteko. V tem primeru bomo spremenili datoteko botfile in ji dodali spuščeno besedo. * Nato bomo dodali datoteko v čakalnico z ```git add ```. Običajno ko dodamo datoteke v čakalnico, je naslednji korak, da naredimo commit s komentarjem ( git commit -m "our commit message" ). V tem primeru pa želimo popraviti že narejen commit, zato namesto tega izvedemo: * ```git commit --amend``` Ukaz nam v tem primeru prikaže urejevalnik besedila in nam omogoči da spremenimo komentar. Sami se odločimo, ali spremenimo komentar, ali pustimo prejšnjega. * Zapustimo urejevalnik besedil. * Pošljemo spremembe z `` `git push origin ` ``. Na ta način bosta obe spremembi združeni v enem commit-u. ================================================ FILE: docs/additional-material/translations/Slovenian/configuring-git.sl.md ================================================ # Nastavljanje Git okolja Ko si prvič poskusil narediti commit z Git-om, je možno da se je prikazalo naslednje sporočilo: ```bash $ git commit *** Please tell me who you are. Run git config --global user.email "you@example.com" git config --global user.name "Your Name" to set your account's default identity. Omit --global to set the identity only in this repository. ``` Git mora vedeti kdo si, da lahko ustvari commit. Ko delaš v skupini z več ljudmi, naj bi se vedno vedelo kdo je naredil katero spremembo v projektu in kdaj jo je nardil. V ta namen je bil Git ustvarjen tako, da so commit-i vezani na ime in e-pošto. Obstaja več načinov kako ukazu `git commit` podati svoje ime in e-pošto in nekaj jih bomo pregledali v naslednjih vrsticah. ### Globalna konfiguracija Ko nekaj shranimo v globalno konfiguracijo (global config), je ta nastavitev dosegljiva vsem repository-em na katerih delaš. Ta način se priporoča in deluje v večini primerov. Da nekaj shranimo v globalno konfiguracijo, uporabimo ukaz `config`: `$ git config --global ` V primeru uporabniških podatkov: ``` $ git config --global user.email "you@example.com" $ git config --global user.name "Your Name" ``` ### Konfiguracija repository-ja Kot nam že samo ime pove, so te konfiguracije omejene samo na en repository. Če želiš narediti commit v točno določen repository, recimo službeni projekt, s svojo službeno e-pošto, potem uporabimo to metodo. Da nekaj shranimo v konfiguracijo repository-ja, uporabimo ukaz `config` in spustimo zastavico `--global`: `$ git config ` V primeru uporabniških podatkov: ``` $ git config user.email "you@alternate.com" $ git config user.name "Your Name" ``` ### Konfiguracija ukazne vrstice Te konfiguracije so omejene samo na trenutno ukazno vrstico. Vsi Git ukazi sprejmejo predpono `-c` pred glagolom ukaza. S tem ustvarimo začasno konfiguracijo. Da nekaj shranimo v konfiguracijo ukazne vrstice: `$ git -c = -c = ` V našem primeru bi ukaz commit uporabili takole: `git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Your commit message"` ### O prednosti Zaporedje uporabe med zgoraj omenjenimi metodami je sledeče `command-line > repository > global`. To pomeni da, če je spremenljivka shranjena v ukazni vrstici in globalno, bi bila uporabljena vrednost v konfiguraciji ukazne vrstice. ## Dodatno Do sedaj smo delali samo z nastavitvami uporabnika, vendar obstaja še nekaj drugih konfiguracij. Nekatere med njimi so: 1. `core.editor` - za določitev urejevalnika besedila, ki se uporabi za pisanje komentarjev, itd. 2. `commit.template` - za določitev datoteke v sistemu, ki se uporabi kot začetna predloga za commit 3. `color.ui` - za določitev boolean vrednosti za uporabo barv v Git-ovem izpisu. Nekaj podrobnosti smo poenostavili za lažje razumevanje. Več si lahko prebereš na [git-scm.com](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration). ================================================ FILE: docs/additional-material/translations/Slovenian/keeping-your-fork-synced-with-this-repository.sl.md ================================================ # Kako imeti svojo različico sinhronizirano z oddaljenim repository-em Najprej moramo razumeti kako poteka sinhronizacija. V tej shemi so trije različni repository-ji: moj javni repository na GitHub-u `github.com/Roshanjossey/first-contributions/`, tvoja različica tega repository-ja na GitHub-u `github.com/Your-Name/first-contributions/` in lokalni repository na tvojem računalniku. Ta način delovanja je značilen za odprto-kodne projekte in se imenuje `Triangle Workflow`. triangle workflow Da obdržimo tvoja dva repository-ja sinhronizirana z mojim javnim repository-jem, moramo najprej pridobiti javni repository in ga združiti s tvojim lokalnim repository-jem ( fetch and merge ). Naslednji korak bo, da pošljemo tvoj lokalni repository v tvojo GitHub različico. Kot smo že prej videli, lahko samo iz GitHub različice zahtevamo "pull request". Zato je tvoja GitHub različica zadnji repository, ki se ga posodobi na zadnjo verzijo. No pa poglejmo kako se to naredi: Najprej moraš biti v svoji glavni veji ( master branch ). Da izveš na kateri veji si trenutno, izvedi ta ukaz in poglej prvo vrstico odgovora: ``` git status ``` Če nisi na glavni veji uporabi: ``` git checkout master ``` Potem dodaš moj javni repository svojemu git-u z ukazom `add upstream remote-url`: ``` git remote add upstream https://github.com/Roshanjossey/first-contributions ``` Na ta način povemo git-u da obstaja še ena verzija tega projekta na podanem naslovu in da jo imenujemo `upstream`. Sedaj, ko ima tvoj git ime in naslov, lahko s tega naslova pridobimo zadnjo verzijo javnega repository-ja z ukazom `fetch`: ``` git fetch upstream ``` Pravkar ste pridobili zadnjo verzijo moje različice (`upstream` remote). Sedaj pa je potrebno še združiti javni repository v tvojo glavno vejo (master branch). ``` git rebase upstream/master ``` Tukaj združuješ javni repository s svojo glavno vejo. Glavna veja na tvojem računalniku je sedaj posodobljena. Na koncu pošlješ še svojo glavno vejo v tvojo različico (fork) na GitHub-u in tudi ta bo posodobljena z zadnjimi spremembami: ``` git push origin master ``` Tukaj lahko vidiš da pošiljaš v oddaljeni repository imenovan `origin`. Na tej točki, so vsi tvoji repository-ji posodobljeni. Dobro opravljeno! To stori vsakič, ko te tvoj GitHub repository opozori, da ni sinhroniziran z ostalimi repository-ji. ================================================ FILE: docs/additional-material/translations/Slovenian/moving-a-commit-to-a-different-branch.sl.md ================================================ # Premikanje commita v drugo vejo Kaj storiti, če izvedeš commit svojih sprememb, in potem ugotoviš da si izvedel commit v napačni veji? Kako lahko to spremenimo? To je razloženo v tem vodiču. ## Premikanje zadnjega commita v obstoječo vejo To storiš z naslednjimi ukazi: ```git reset HEAD~ --soft``` - Razveljavi zadnji commit, spremembe ostanejo na voljo. ```git stash``` - Posname stanje direktorija in ga shrani v `stash`. ```git checkout name-of-the-correct-branch``` - Prestavi v drugo vejo. ```git stash pop``` - Vzame zadno shranjeno stanje iz `stash-a`. ```git add .``` - Ali dodaš posamezne datoteke. ```git commit -m "your message here"``` - Shrani in izvede commit sprememb. Sedaj so tvoje spremembe na pravi veji. ### Premikanje zadnjih nekaj commitov v novo vejo To storiš z naslednjimi ukazi: ```git branch newbranch``` - Ustvariš novo vejo. Nova veja ima vse prej ustvarjene commite. ```git reset --hard HEAD~#``` - Premakni glavno vejo ( master ) nazaj za # commit-ov. Ti commit-i bodo izbrisani z glavne veje! ```git checkout newbranch``` - Prestaviš se v novo vejo, ki ima vse prej ustvarjene commit-e. Pomembno: Vse spremembe, ki niso bile commit-ane, bodo IZGUBLJENE! ================================================ FILE: docs/additional-material/translations/Slovenian/removing-a-file.sl.md ================================================ # Odstranjevanje datoteke Včasih si želiš odstraniti datoteko z Git-a, vendar je ne želiš odstraniti s svojega računalnika. To lahko storiš z uporabo naslednjega ukaza: ``git rm --cached`` ## Kaj se je zgodilo? Git ne bo več sledil spremembam v odstranjeni datoteki. Kar se tiče Git-a, ta datoteka ne obstaja več. Če poiščeš datoteko na svojem disku, vidiš da še vedno obstaja. V zgornjem primeru smo uporabili zastavico `--cached`. Če je ne bi uporabili, bi Git odstranil datoteko tudi z našega diska. Če sedaj ustvarimo commit z `git commit -m "Remove file1.js"` in ga pošljemo v oddaljeni repository z ukazom `git push origin master`, bo datoteka odstranjena tudi iz oddaljenega repository-ja. ## Dodatne možnosti - Če želiš odstraniti več datotek, jih lahko vse vljučiš v en ukaz: `git rm file1.js file2.js file3.js --cached` - Lahko uporabiš nadomestni znak (*) da odstraniš podobne datoteke. Na primer, če želiš odstraniti vse datoteke s končnico .txt s svojega repository-ja, uporabi ukaz: `git rm *.txt --cached` ================================================ FILE: docs/additional-material/translations/Slovenian/removing-branch-from-your-repository.sl.md ================================================ # Odstrani vejo s svojega repository-ja Če si sledil vodiču do tukaj, sedaj tvoja veja `` ni več uporabna in jo lahko zbrišeš z lokalnega repository-ja. To ni nujno potrebno, vendar ime te veje kaže njen namen obstoja. Ker je opravila svoje delo, jo lahko zbrišeš. Najprej združiš `` z glavno ( master ) vejo, zato se postavi vanjo: ``` git checkout master ``` Združi `` z master: ``` git merge master ``` Odstrani `` z lokalnega repository-ja: ``` git branch -d ``` Sedaj si zbrisal `` vejo s svojega računalnika in vse zgleda urejeno. Vendar ta veja še vedno obstaja v tvoji GitHub različici ( fork ). Preden jo zbrišeš tudi tam, vedi da moraš najprej poslati "Pull request" mojemu repository-ju. Tako da, če je še nisem združil v moj repository, te veje na GitHub-u še ne zbriši! Če pa je tvoja GitHub veja že združena v moj projekt, in jo želiš zbrisati, uporabi naslednji ukaz: ``` git push origin --delete ``` Sedaj veš kako počistiti neuporabne veje s svojega repository-ja. S časom bo veliko commit-ov dodanih v moj javni repository, in glavni veji na tvojem računalniku in GitHub različici ne bosta več posodobljeni na zadnjo verzijo. Da bodo vsi tvoji repository-ji sinhronizirani z mojim, sledi korakom v tem vodiču: #### [Kako imeti svojo različico sinhronizirano z oddaljenim repository-em](keeping-your-fork-synced-with-this-repository.sl.md) ================================================ FILE: docs/additional-material/translations/Slovenian/resolving-merge-conflicts.sl.md ================================================ # Kaj je spor pri združevanju? Ko poskusiš združiti drugo vejo v vejo v kateri trenutno delaš, vzameš spremembe iz drugega konteksta in jih združiš z datotekami s katerimi trenutno delaš. Če dve osebi spremenita vrstico v isti datoteki, ali če se ena oseba odloči zbrisati datoteko medtem, ko se jo druga odloči spremeniti, Git ne ve več kaj je pravilno. Git bo označil datoteko kot spor. Spor, ki ga moraš razrešiti preden lahko nadaljuješ z delom. # Kako razrešiti spor pri združevanje? Ko Git zazna spor pri združevanju, bo mesto problema v datoteku označil tako, da ga bo obdal z: “<<<<<<<< HEAD” and “>>>>>>>>>>[other branch name]” Vsebina za prvo oznako bo izhajala iz tvoje trenutne veje. Nato sledi vrstica z "=======", tej pa sledi vsebina iz veje, ki je v nazkrižju s tvojo. Za tem pridejo znaki ">>>>>" in ime te druge veje. Naša naloga je da uredimo te vrstice. Ko smo končali, naj bi datoteka izgledala točno tako, kot hočemo da izgleda. Lahko da se bo potrebno posvetovati s sodelavcem, ki je napisal vsebino, ki je v navzkrižju z našo, da se bomo lahko odločili katera koda je prava. Mogoče bo tvoja, mogoče bo njegova - ali pa mešanica obeh. Primer: ``` <<<<<<< HEAD:mergetest This is my third line ======= This is a fourth line I am adding >>>>>>> 4e2b407f501b68f8588aa645acafffa0224b9b78:mergetest ``` `<<<<<<<`: Nakazuje začetek vrstic, kjer je spor. Te vrstice so iz tvoje datoteke, ki si jo poskusil združiti. `=======`: Nakazuje prelomno točko za primerjavo. Razdeli spremembe iz tvojega commit-a (zgoraj) in spremembe nekoga drugega (spodaj) za lažjo predstavo. `>>>>>>>`: Nakazuje konec vrstic, kjer je spor. Spor razrešiš z urejanjem datoteke in ročnim združevanjem delov datoteke, kjer je Git naletel na problem. To lahko pomeni da je potrebno zavreči tvoje spremembe, spremembe nekoga drugega ali pa ustvariti mešanico obeh. Prav tako je potrebno zbrisati '<<<<<<<', '=======', in '>>>>>>>'. Ko je bil spor razrešen, uporabi ukaz `git add`. Ne pozabi izvesti teste, s katerimi se prepričaš da je bil spor pravilno razrešen. Lahko si tudi namestiš različne plugine, ki so odvisni od tvojega IDE-ja, za lažje reševanje sporov. # Kako razveljaviti združitev ( merge )? Če želiš razveljaviti združitev uporabi ukaz `git merge —abort`. ================================================ FILE: docs/additional-material/translations/Slovenian/reverting-a-commit.sl.md ================================================ # Povrnitev commit-a Povrnitev commit-a pomeni, da ustvarimo nov commit, ki odstrani vse spremembe, ki smo jih napravili v prejšnjem commit-u. Kot da bi naredili ```CTRL + Z ``` v Git-u. Povrnitev v Git-u je sorazmerno enostavna, ker je vsak commit, ki ga pošljemo v oddaljen repository, povezan s svojim unikatnim alfanumeričnim SHA (Secure Hash Algorithm) ključem. To pomeni da lahko povrnemu vsak commit, če le imamo njegov SHA. V vsakem primeru pa moramo biti previdni pri povračanju, ker si lahko poškodujemo repository. Da lahko izberemo SHA točno določenega commit-a, ki ga hočemo odstraniti, nam zelo prav pride seznam vseh commit-ov, ki smo jih napravili. Ta seznam dobimo s tem ukazom: ```git log --oneline ``` Ukaz ```git log``` bi nam prav tako vrnil SHA, vendar v daljši obliki izpisa. Uporaba zastavice ```--oneline ``` Git-u pove da hočemo pregleden izpis v eni vrstici. Prvih 7 znakov v vsaki vrstici izpisa se imenuje skrajšani hash commit-a. Za primer, to je izpis ```git log --oneline ``` za ta repository: ``` 389004d added spacing in title c1b9fc1 Merge branch 'master' into tutorials 77eaafd added tutorial for reverting a commit ``` To nam torej pokaže, da lahko z ```git log --oneline```, pridobimo seznam vseh commit-ov narejenih v repository-ju s prvimi 7 znaki njihovih SHA. No, sedaj lahko poskusimo zbrisati commit "added spacing in title" z naslednjimi koraki: * Kopiraj SHA commit-a, v tem primeru ```389004d``` * Potem uporabi ukaz ```git revert 389004d``` Sedaj se zažene naš urejevalnik besedila in nas pozove naj uredimo komentar commit-a. Lahko se odločiš, da pustiš privzeto sporočilo Git-a, ki se začne z besedo `Revert`, ali pa spremeniš komentar po svojih željah. * Nato shranimo in zapremo urejevalnik besedila. * Vrnemo se v ukazno vrstico. * Uporabimo ukaz ```git push origin ``` da pošljemo spremembe na GitHub. In to je to, spremembe bodo odstranjene. V tem primeru bi se moj repository povrnil na stanje v commit-u ```c1b9fc1```. ================================================ FILE: docs/additional-material/translations/Slovenian/squashing-commits.sl.md ================================================ # Kaj je stiskanje? V Git-u stiskanje ( squashing ) pomeni popravljanje zgodovine svojih commit-ov, tako da na koncu ostaneš samo z enim commit-om in enim komentarjem narejenih sprememb. To je običajni postopek v odprto kodnih projektih, ker je velik del zgodovine vsake veje pomemben samo programerju, ki jo je ustvaril. Poleg tega na ta način poenostavimo sledenje izvedenih sprememb in jih tudi lažje povrnemo v prejšnje stanje, če je to potrebno. # Kako stisneš commit-e? Najprej uporabimo ukaz `git log` da lahko pregledamp commit-e v svoji veji, ki bi jih rad združili ( merge ). ``` git log ``` Videti bi morali serijo commit-ov, kot na primer: ``` commit blablabla Author: omguhh Date: 10/10/20 Commit message 1 commit blablabla2 Author: omguhh Date: 10/10/20 Commit message 2 ``` Sedaj, ko vidimo commit-e, ki jih želimo združiti v enega, lahko začnemo tako da uporabimo ukaz ```git rebase```. Predvidevam da že poznaš ukaz ```git rebase``` in lahko začnemo stiskanje commit-ov v interaktivnem načinu ukaza `git rebase`, ki ga aktiviramo tako: ``` git rebase -i ``` V interaktivnem načinu ukaza rebase lahko določimo začetno in končno točko do katere nazaj želimo iti. HEAD je začetna točka, "~2" pa pomeni da gremo dva commita nazaj v zgodovino. Ukaz se uporabi takole: ``` git rebase -i HEAD~2 ``` Ko uporabimo ta ukaz, se nam bo prikazalo nekaj podobnega tem vrsticam: ``` pick blablabla Changing test01.txt file pick blablabla2 Adding dummy01.txt file # # Commands: # p, pick = use commit # r, reword = use commit, but edit the commit message # e, edit = use commit, but stop for amending # s, squash = use commit, but meld into previous commit # f, fixup = like "squash", but discard this commit's log message # x, exec = run command (the rest of the line) using shell # # These lines can be re-ordered; they are executed from top to bottom. # # If you remove a line here THAT COMMIT WILL BE LOST. # # However, if you remove everything, the rebase will be aborted. # # Note that empty commits are commented out ``` Ukazi navedeni v zgornjem sporočilu: - p, pick = uporabi commit - r, reword = uporabi commit, vendar uredi komentar - e, edit = uporabi commit, vendar se ustavi za spremembo - s, squash = uporabi commit, vendar ga stisni v prejšnji commit - f, fixup = enak kot "squash", vendar zavrzi komentar tega commit-a - x, exec = zaženi ukaz ( preostanek vrstice ) v shell-u To pomeni da, če želimo stisniti ```blablabla2``` v ```blablablabla```, bi zgornje sporočilo spremenili tako: ``` pick blablabla Changing test01.txt file squash blablabla2 Adding dummy01.txt file ``` Če gre vse po planu, dobimo rezultat, ki zgleda takole: ``` # This is a combination of 2 commits. # The first commit's message is: commit message 1 # This is the 2nd commit message: commit message 2 ``` To sporočilo lahko po želji spremenimo preden zapremo urejevalnik besedila, kar shrani spremembe. Če še enkrat uporabimo ukaz `git log`, bi morali dobiti komentar commit-a, ki smo ga vnesli preden smo zaprli urejevalnik besedila, in commit-i bi morali biti združeni v enega. ================================================ FILE: docs/additional-material/translations/Slovenian/stashing-a-file.sl.md ================================================ # Shranjevanje za pozneje ( Stashing ) Kaj storiti, če delaš na velikem projektu, in moraš nenadoma zamenjati vejo, na kateri trenutno delaš, za neko drugo vejo? Koda, na kateri si delal, ni dokončana in dokler je ne preveriš dobro, ne želiš izvesti commit. Vendar se ne moreš premakniti na drugo vejo brez da bi izvedel commit, Git ti ne pusti prekiniti delovni tok ( workflow ). Kaj storiti? Kako preprečiti nepotreben commit in hkrati preskočiti na drugo vejo? Na to vprašanje odgovarja ta vodič. ## Shranjevanje svojega dela Predpostavimo da delaš na veji projekta, kjer si naredil nekaj spremembe. Če uporabiš ukaz ```git status```, lahko vidiš kje so bile spremembe narejene. ``` $ git status # On branch master # Changes to be committed: # (use "git reset HEAD ..." to unstage) # # modified: index.html # # Changes not staged for commit: # (use "git add ..." to update what will be committed) # # modified: lib/simplegit.rb # ``` Sedaj se želiš prestaviti na drugo vejo, vendar še nočeš izvesti commit s temi spremembami. Zato bi shranil spremembe za pozneje ( stash ). Spremembe lahko shraniš na svoj stack z uporabo ukaza ```git stash```: ``` $ git stash Saved working directory and index state \ "WIP on master: 049d078 added the index file" HEAD is now at 049d078 added the index file (To restore them type "git stash apply") ``` Sedaj je tvoje delovno okolje ( working directory ) čisto. To lahko preveriš z uporabo ukaza ```git status```: ``` $ git status # On branch master nothing to commit, working directory clean ``` Sedaj se lahko prestaviš na katerokoli vejo in delaš naprej; tvoje shranjene spremembe so shranjene na stack-u. Spremembe, ki so shranjene na stack-u, si lahko ogledaš z uporabo ukaza ```git stash list```: ``` $ git stash list stash@{0}: WIP on master: 049d078 added the index file stash@{1}: WIP on master: c264051 Revert "added file_size" stash@{2}: WIP on master: 21d80a5 added number to log ``` V primeru da želiš uveljaviti (re-apply) spremembe, ki si jih ravnokar shranil, lahko uporabiš ukaz ```git stash apply```. S tem ukazom lahko uveljaviš zadnjo shranjeno spremembo. Če želiš uveljaviti katerokoli drugo spremembo, jo moraš točno določiti: ```git stash apply ```, kjer je `````` ime spremembe, ki jo želiš uveljaviti. ``` $ git stash apply # On branch master # Changes not staged for commit: # (use "git add ..." to update what will be committed) # # modified: index.html # modified: lib/simplegit.rb # ``` Git je sedaj spremenil datoteko, ki smo jo povrnili v prvotno stanje, ko smo spremembe shranili v stack. V tem primeru smo imeli čisto delovno okolje, ko smo poskusili uveljaviti stash, in uveljavili smo jih na isti veji, s katere smo jih shranili. Nič od tega, čisto delovno okolje in ista veja, ni nujno da uveljavimo spremembe iz stasha. Spremembe lahko shranimo na eni veji, se prestavimo na drugo vejo in tam uveljavimo iste spremembe. Lahko bi tudi spremenili ali odstranili datoteke v svojem delovnem okolju, ko bi uveljavili stash. V primeru da pride do sporov pri združevanju shranjenih sprememb v obstoječe datoteke, bo Git te spore javil. Spremembe so bile uveljavljene, vendar datoteka, ki je bila pripravljena za commit, sedaj ni več pripravljena. Da dosežemo še to, moramo uporabiti ukaz ```git stash apply``` z ```--index```, da sporočimo ukazu da mora uveljaviti tudi to stanje. Ko uporabimo ta ukaz, se vrnemo v točno tako stanje, kot je bilo na začetku: ``` $ git stash apply --index # On branch master # Changes to be committed: # (use "git reset HEAD ..." to unstage) # # modified: index.html # # Changes not staged for commit: # (use "git add ..." to update what will be committed) # # modified: lib/simplegit.rb # ``` Ukaz `apply` samo uveljavi spremembe, ki so bile shranjene, vendar te še vedno ostanejo na stack-u. Z ukazom ```git stash list``` si lahko prikažeš vsebino stack-a. Da nekaj z njega zbrišemo, uporabimo ukaz ```git stash drop```, ki mu dodamo ime stash-a. ``` $ git stash list stash@{0}: WIP on master: 049d078 added the index file stash@{1}: WIP on master: c264051 Revert "added file_size" stash@{2}: WIP on master: 21d80a5 added number to log $ git stash drop stash@{0} Dropped stash@{0} (364e91f3f268f0900bc3ee613f9f733e82aaed43) ``` Z ukazom ```git stash pop``` lahko hkrati uveljavimo spremembe in jih odstranimo s stack-a. ## Razveljavljanje Stash-a V nekaterih primerih hočeš uveljaviti shranjene spremembe, nekaj narediti, in razveljaviti spremembe, ki so prišle iz stash-a. Git nima ukaza ```git unapply```, vendar je možno doseči isti učinek z kombiniranjem ukazov. Najprej prikažemo željeni stash in ga nato vzratno uveljavimo: ```$ git stash show -p stash@{0} | git apply -R``` Če ne določimo, kateri stash želimo, Git predvideva da želimo zadnjega: ```$ git stash show -p | git apply -R``` Lahko ustvariš alias in v bistvu dodaš ukaz ```stash-unapply``` v svoj Git. Na primer: ``` $ git config --global alias.stash-unapply '!git stash show -p | git apply -R' $ git stash apply $ #... work work work $ git stash-unapply ``` ## Ustvari vejo iz Stash-a Če si shranil spremembe in jih nekaj časa pustil pri miru, vmes pa delal naprej na veji s katere si jih shranil, se ti lahko naredi da boš imel težave z uveljaljanjem sprememb. Če uveljavljaš spremembe na datoteki, ki si jo vmes spremenil, boš dobil spor pri združevanju in ga boš moral razrešiti. Obstaja lažji način povračanja sprememb iz stash-a z uporabo ukaza ```git stash branch```, ki ustvari novo vejo, pridobi commit na katerem si bil, ko si shranil spremembe, na njem uveljavi spremembe in potem zbriše stash, če je bil uspešno uveljavljen: ``` $ git stash branch testchanges Switched to a new branch "testchanges" # On branch testchanges # Changes to be committed: # (use "git reset HEAD ..." to unstage) # # modified: index.html # # Changes not staged for commit: # (use "git add ..." to update what will be committed) # # modified: lib/simplegit.rb # Dropped refs/stash@{0} (f0dfc4d5dc332d1cee34a634182e168c4efc3359) ``` To je prikladna bližnjica s katero lahko enostavo pridobimo shranjene spremembe in jih uporabimo v novi veji. ================================================ FILE: docs/additional-material/translations/Slovenian/undoing-a-commit.sl.md ================================================ # Razveljavljanje lokalnega commit-a Vse kar rabiš storiti, da razveljaviš lokalni commit, je: ``` git reset ``` Ta ukaz bo resetiral stanje v čakalnici na tvoj zadnji commit, vendar bodo spremembe ostale v delovnem okolju. Če želiš, lahko ponovno ustvariš commit s temi spremembami. Lahko pa tudi odstraniš samo eno datoteko s svojega prejšnjega commit-a. Uporabiš ukaz: ``` git reset ``` Ukaz bo odstranil samo določeno datoteko s čakalnice, vendar bodo spremembe narejene na datoteki ostale. Primer uporabe ```git reset```: ``` # Make changes in index.php and tutorial.php # Add files into the staging area $ git add . # Remembered both files need to be committed separately # Unstage tutorial.php $ git reset tutorial.php # Commit index.php first $ git commit -m "Changed index.php" # Commit tutorial.php now $ git add tutorial.php $ git commit -m "Changed tutorial.php" ``` Predpostavimo da si pokvaril svoj lokalni repository in ga želiš resetirati na svoj zadnji commit. Lahko uporabiš spodnji ukaz: ``` git reset --hard ``` Ukaz bo izpraznil čakalnico in tudi povrnil vse spremembe v datotekah na stanje v zadnjem commit-u. Možnost ```--hard``` pove Git-u da mora odstraniti tudi vse spremembe v delovnem okolju. Ta ukaz uporabi samo takrat, ko si prepričan da želiš odstraniti vse spremembe nastale od zadnjega commit-a! Primer uporabe ukaza ```git reset --hard```: ``` # Decided to start a crazy experiment # Create a new file 'crazy.php' and add some code to it # Commit crazy.php $ git add crazy.php $ git commit -m "Started a crazy dev" # Edit crazy.php file again and changed a lot other files # Commit all tracked files $ git add . $ git commit -m "Continued dev" # Tested and things went out of hand # Decided to remove the whole thing $ git reset --hard HEAD~2 ``` Ukaz ```git reset --hard HEAD~2``` premakne trenutno vejo nazaj za 2 commit-a in hkrati povrne vse spremembe na to točko. Odstrani tudi 2 posnetka, ki smo ju ravnokar ustvarili iz zgodovine projekta. P.s: Nikoli ne izvedi ```git reset --hard``` , če si že poslal svoje commit-e v skupni repository, ker boš s tem ustvaril probleme vsem, ki uporabljajo ta repository! ================================================ FILE: docs/additional-material/translations/Spanish/Things a non Programmer can do.es.md ================================================ # Cosas que un no programador puede hacer ## Empieza a escuchar Todo en código abierto involucra a otras personas. Estás buscando unirte a un equipo y eso significa comprender la comunidad y cómo funciona. Entrar en un proyecto y decir "Hola, esto es lo que creo que debería hacer este proyecto." generalmente no se considera algo bueno. Algunos proyectos pueden acoger con agrado ese tipo de enfoque, pero si el proyecto lleva funcionando un tiempo, las posibilidades de que se adopte esa actitud son pequeñas. **Escuchar es la mejor manera de saber qué necesita el proyecto.** 1. **Únase a una lista de correo** : para muchos proyectos, la lista de correo es el principal conducto de comunicación sobre el desarrollo del proyecto. En proyectos grandes, hay muchas listas de correo para elegir. Por ejemplo, el proyecto PostgreSQL tiene no menos de 12 listas orientadas a usuarios y seis listas de desarrolladores en su página de lista de correo. Le sugiero que siga la lista principal orientada al usuario y la lista principal de desarrolladores para comenzar a escuchar. 2. **Siga un blog** : los blogs mantenidos por desarrolladores principales a menudo brindan información sobre lo que se avecina en futuras versiones. y lo que se necesita para llegar allí. Un sitio planetario agrega noticias y entradas de blogs de muchas fuentes relacionadas con el proyecto. Si hay un sitio planetario, como planet.gnome.org o planet.mysql.com, comience allí. Simplemente busque en Google "planeta ". 3. **Únase a un canal IRC** : muchos proyectos de código abierto tienen canales de chat de retransmisión (IRC) de Internet dedicados donde desarrolladores y usuarios se reúnen para discutir problemas y desarrollo. Consulte el sitio web del proyecto para obtener detalles sobre cómo se llama el canal y en qué red IRC se encuentra. **Trabajar con tickets** El código es el corazón de cualquier proyecto de código abierto, pero no crea que escribir código es la única forma de contribuir. El mantenimiento del código y de los sistemas que lo rodean a menudo se descuidan en la prisa por crear nuevas funciones y corregir errores. Considere estas áreas como una manera fácil de involucrarse en un proyecto. La mayoría de los proyectos tienen un sistema de notificación de problemas visible públicamente, vinculado desde la página principal del sitio web del proyecto e incluido en la documentación. Es el conducto principal de comunicación entre los usuarios y los desarrolladores. Mantenerlo actualizado es una excelente manera de ayudar al proyecto. Es posible que necesite obtener permisos especiales en el sistema de tickets, que la mayoría de los líderes de proyecto estarán encantados de otorgarle cuando diga que quiere ayudar a limpiar los tickets. 4. **Diagnosticar un error** : los errores a menudo no se informan correctamente. Diagnosticar y clasificar un error puede ayudar a los desarrolladores a ahorrar tiempo con el trabajo preliminar de descubrir los detalles del problema. Si un usuario informó: "El software no funciona cuando hago X", dedique algún tiempo a descubrir los detalles de ese problema. ¿Es repetible? ¿Puedes crear un conjunto de pasos para causar el problema repetidamente? ¿Puedes limitar el problema, por ejemplo, si solo ocurre en un navegador pero no en otro, o en una distribución pero no en otra? Incluso si no sabes qué causa el problema, el esfuerzo que pones en delimitar las circunstancias hace que sea más fácil para otra persona solucionarlo. Cualquier cosa que descubras, agrégala al ticket en el sistema de errores para que todos lo vean. 5. **Cerrar errores solucionados** : a menudo, los errores se corrigen en el código base, pero los tickets informados sobre ellos no se actualizan en el sistema de emisión de tickets. Limpiar este trozo de papel puede llevar mucho tiempo, pero es valioso para todo el proyecto. Comience consultando el sistema de tickets en busca de tickets con más de un año y vea si el error aún existe. Consulte el registro de cambios de versión del proyecto para ver si el error se solucionó y se puede cerrar. Si se sabe que está solucionado, anote el número de versión en el ticket y ciérrelo. Intente recrear el error con la última versión del software. Si no se puede recrear con la última versión, anótelo en el ticket y ciérrelo. Si todavía existe, anótelo también en el ticket y déjelo abierto. Trabajar con código Los programadores de todos los niveles de experiencia pueden ayudar con el código del proyecto. No creas que tienes que ser un genio de la programación para hacer contribuciones reales a tu proyecto favorito. Si su trabajo implica modificar el código, investigue el método que utiliza el proyecto para obtener el código de los contribuyentes. Cada proyecto tiene su propio flujo de trabajo, así que pregunte cómo hacerlo antes de enviar el código. Por ejemplo, el proyecto PostgreSQL es muy riguroso en su proceso: las modificaciones del código se envían en forma de parche a una lista de correo donde los desarrolladores principales examinan cada aspecto del cambio. En el otro extremo hay un proyecto como Parrot donde es fácil obtener privilegios de confirmación para el código base. Si el proyecto usa GitHub, puede haber un flujo de trabajo que use la función de solicitud de extracción de GitHub. No hay dos proyectos iguales. Siempre que modifique el código, asegúrese de actuar como un miembro responsable de la comunidad y de mantener el estilo de su código para que coincida con el resto del código base. El código que agregue o modifique debería verse como el resto. Puede que no le guste el estilo de refuerzo o el manejo de los espacios para la sangría, pero es de mala educación enviar un cambio de código que no coincide con los estándares existentes. Es lo mismo que decir "No me gusta tu estilo y creo que el mío es mejor, así que deberías hacerlo a mi manera". 6. **Pruebe una versión beta o candidata** : cualquier proyecto diseñado para ejecutarse en múltiples plataformas puede tener todo tipo de problemas de portabilidad. Cuando se acerca una versión y se publica una versión beta o candidata, el líder del proyecto espera que sea probada por muchas personas diferentes en muchas plataformas diferentes. Usted puede ser una de esas personas y ayudar a garantizar que el paquete funcione en su plataforma. Por lo general, solo necesita descargar, compilar y probar el software, pero el valor para el proyecto puede ser enorme si utiliza una distribución o hardware poco común. Simplemente informar que la compilación y la prueba funcionan ayuda a los líderes del proyecto a saber que el lanzamiento inminente es sólido. 7. **Corregir un error** : aquí es donde generalmente comienzan los contribuyentes que desean comenzar a trabajar en el código. Es simple: encuentre un error que parezca interesante en el sistema de tickets e intente corregirlo en el código. Documente la solución en el código si es apropiado. Es una buena idea agregar una prueba al conjunto de pruebas para probar el código que corrigió; algunos proyectos requieren correcciones de errores para incluir pruebas. Tome notas mientras hurga en este código base desconocido. Incluso si no puede corregir el error, documente en el ticket lo que descubrió como parte del intento de solucionarlo. Lo que encuentres ayudará a quienes te sucedan. 8. **Escribe una prueba** : la mayoría de los proyectos tienen un conjunto de pruebas que prueba el código, pero es difícil imaginar un conjunto de pruebas al que no se le puedan agregar más pruebas. Utilice una herramienta de cobertura de pruebas como gcov para C o Devel::Cover para Perl para identificar áreas en el código fuente que no han sido probadas por el conjunto de pruebas. Luego, agregue una prueba a la suite para cubrirlo. 9. **Silenciar una advertencia del compilador** : el proceso de compilación de muchos proyectos basados en C a menudo arroja algún que otro indicador de advertencia del compilador en la pantalla. Estas advertencias generalmente no son indicadores de un problema, pero pueden parecerlo. Tener demasiadas advertencias puede hacer que el compilador suene como si estuviera llorando. Verifique si el código realmente podría estar ocultando un error. De lo contrario, modificar la fuente para silenciarla ayuda a ocultar estos falsos positivos. 10. **Agrega un comentario** : Cuando exploras el código, es posible que encuentres algunos puntos que te resulten confusos. Lo más probable es que si usted estaba confundido, otros también lo estarán. Documentarlos en el código y enviar un parche. Trabajar con documentación La documentación suele ser la parte de un proyecto que recibe poca atención. También puede verse afectado por haber sido escrito desde el punto de vista de quienes están familiarizados con el proyecto, en lugar de desde los ojos de alguien que recién se está involucrando en él. Si alguna vez ha leído documentos de un proyecto en el que piensa: "Es como si este manual esperara que yo ya supiera cómo utilizar el paquete", sabe de lo que estoy hablando. A menudo, un par de ojos nuevos pueden señalar deficiencias en la documentación que quienes están cerca del proyecto no notan. 11. **Crea un ejemplo** : No hay ningún proyecto que tenga demasiados ejemplos prácticos. Ya sea una API web, una biblioteca de rutinas, una aplicación GUI como Gimp o una herramienta de línea de comandos, un buen ejemplo de uso adecuado puede explicar más clara y rápidamente el uso adecuado del software que las páginas de documentación. Para una API o biblioteca, cree un programa de ejemplo que utilice la herramienta. Esto incluso podría extraerse del código que haya escrito y reducirlo a lo estrictamente necesario. Para una herramienta, muestre ejemplos del mundo real de cómo la ha utilizado en su vida diaria. Si estás orientado visualmente, Considere la posibilidad de crear una captura de pantalla de un proceso importante, como por ejemplo cómo instalar la aplicación. Trabajar con la comunidad El código abierto se trata sólo en parte de código. La comunidad hace que el código abierto funcione. A continuación le presentamos formas en las que puede ayudar a desarrollarlo. 12. **Responda una pregunta** : La mejor manera de ayudar a construir la comunidad es ayudando a los demás. Responder una pregunta, especialmente de alguien que recién se está iniciando, es crucial para ayudar a que el proyecto crezca y prospere. El tiempo que se toma para ayudar a un principiante, incluso si está haciendo una pregunta en la que fácilmente se podría responder con un rápido "RTFM", vale la pena en el futuro para conseguir otro miembro activo de la comunidad. Todo el mundo empieza en alguna parte y los proyectos necesitan un flujo constante de personas para que sigan siendo vitales. 13. **Escribe una publicación de blog** : Si tienes un blog, escribe sobre tus experiencias con el proyecto que estás utilizando. Cuéntanos sobre un problema que enfrentaste al usar el software y qué hiciste para resolverlo. Ayudarás de dos maneras: ayudando a mantener el proyecto en la mente de quienes te rodean, y creando un registro para cualquier otra persona que tenga su problema en el futuro y busque la respuesta en la web. (Un blog de sus aventuras técnicas también es una excelente manera de mostrar su experiencia en el mundo real con el software en cuestión la próxima vez que busque trabajo usándolo). 14. **Mejorar un sitio web** : Si tiene habilidades en diseño web y puede ayudar a mejorar el sitio web y, por lo tanto, la imagen pública del proyecto, es tiempo bien invertido. Quizás el proyecto podría necesitar una revisión gráfica o un logotipo para identificarlo. Estas pueden ser habilidades que faltan en la comunidad. Sé que me encantaría poder obtener ayuda con el diseño gráfico de los sitios web de mis proyectos. 15. **Escribir documentación técnica** Si puede escribir sobre cómo funciona una aplicación o software, puede escribir documentación técnica al respecto. Especialmente proyectos de código abierto que buscan actualizar, renovar, ampliar o crear documentos técnicos para que los lea el público en general. Cuanto más escribas en inglés sencillo, mejor. La mejor parte es que no es necesario ser programador para escribir documentos técnicos. Sobre todo, escuche lo que discuten las personas que lo rodean. Vea si puede reconocer una necesidad urgente. Por ejemplo, recientemente en la lista de correo de los desarrolladores de Parrot, se decidió utilizar GitHub como sistema de notificación de problemas, abandonando la antigua instalación de Trac que tenían. Algunas personas estaban en contra de la medida porque no había forma de convertir los tickets al sistema de GitHub. Después de un día de discusiones de ida y vuelta, hablé y dije: "¿Qué tal si escribo un convertidor?" La gente estaba encantada con la idea. Dediqué tiempo a escribir un programa de conversión para más de 450 boletos, por lo que no perdimos nada de nuestro historial de boletos. Fue un gran éxito. Pude colaborar y los desarrolladores principales se mantuvieron concentrados en el negocio de trabajar en Parrot. 16. **Enseñar y ayudar a otros** : La mejor manera de aprender más sobre un tema es intentar enseñarlo. El mejor profesor es el que puede explicar cosas complejas con ejemplos sencillos. Por lo tanto, debes intentar ser el mejor maestro para ser el mejor alumno y el mejor en tu mundo de programación. Enseñar a otros te hará sentir mejor contigo mismo y te ayudará a adquirir mejores habilidades y conocimientos en tu profesión. Cuando reciba ayuda de alguien, no se la guarde para usted, compártala con los demás. Hacer el mundo un lugar mejor para vivir . ================================================ FILE: docs/additional-material/translations/Spanish/additional-material.es.md ================================================ # Información Adicional Aquí asumimos que ya has dominado las instrucciones básicas. La información adicional contiene algunos detalles sobre comandos de Git que son necesarios en situaciones más complejas. ### [Corrección en Commits](corrigiendo-un-commit.es.md) Este documento contiene información sobre cómo corregir un commit en un repositorio remoto. > Esto es necesario en casos en los que deseas modificar un commit que hiciste anteriormente. ### [Configuración de Git](configurando-git.es.md) Este documento ofrece información sobre cómo cambiar la información del usuario y otras configuraciones de Git. > Será útil si deseas hacer que tu configuración de Git sea más conveniente. ### [Manteniendo tu Fork Sincronizado con este Repositorio](manteniendo-tu-fork-sincronizado-con-este-repositorio.es.md) Este documento explica cómo mantener sincronizado tu fork con este repositorio. Mantener la sincronización es importante ya que, en la medida en que esperamos, trabajarás en el proyecto no solo por ti mismo, sino con otros colaboradores. > Sigue estos pasos si tu fork no tiene cambios en la rama master del repositorio. ### [Mover un Commit a una Rama Diferente](moviendo-un-commit-a-una-rama-diferente.es.md) Este documento proporciona información sobre cómo mover un commit a una rama diferente. > Sigue los pasos indicados para mover un commit a otra rama. ### [Eliminando un Archivo](eliminando-un-archivo.es.md) Este documento describe cómo eliminar un archivo de tu repositorio local. > Familiarízate con estos comandos para entender cómo eliminar un archivo antes de realizar un commit. ### [Eliminando una Rama de tu Repositorio](eliminando-una-rama-de-tu-repositorio.es.md) Este documento ofrece información sobre cómo eliminar una rama de tu repositorio. > Utiliza estos comandos solo después de que tu pull request haya sido aceptado. ### [Resolviendo Conflictos de Fusión de Ramas](resolviendo-conflictos-de-fusion-de-ramas.es.md) Este documento proporciona información sobre cómo resolver conflictos que surgen al fusionar ramas. > Sigue estos pasos para manejar los conflictos que pueden ser muy incómodos al fusionar ramas. ### [Deshaciendo un Commit](deshaciendo-un-commit.es.md) Este documento describe cómo deshacer un commit en tu repositorio local. Esta operación es útil cuando necesitas revertir un commit después de que ya haya sido enviado a GitHub (pushed). > Sigue estos pasos para deshacer un commit. ### [Fusionar Commits (Squashing)](fusionando-commits.es.md) Este documento describe cómo fusionar commits mediante la rebase interactiva. > Sigue estas instrucciones si un experto del proyecto te pide que fusiones todos tus commits en uno con un comentario significativo. ### [Deshaciendo un Commit Local](deshaciendo-un-commit-local.es.md) Este documento proporciona información sobre cómo revertir un commit en tu repositorio local. Necesitarás esta información si decides que has dañado tu repositorio y deseas volver a su estado original. > Sigue estas instrucciones si deseas deshacer los cambios que hiciste en tu último commit local. ### [Enlaces Útiles](enlaces-utiles-para-aprender-mas.es.md) Este archivo contiene enlaces a publicaciones de blogs, sitios web útiles, sitios web con listas de recomendaciones y trucos que a menudo hacen nuestra vida más fácil. Tanto para principiantes como para expertos, recomendamos consultarlos según sea necesario. Este archivo contiene una lista de enlaces útiles que seguramente ayudarán a aquellos que dan sus primeros pasos en el código abierto y aquellos que desean expandir sus conocimientos en este campo. ================================================ FILE: docs/additional-material/translations/Spanish/additional-material.sp_mx.md ================================================ # Información adicional Asumimos que ya has terminado el tutorial básico antes de venir aquí. La información adicional te dará una idea de las técnicas de Git más avanzadas. ### [Modificar una confirmación](../git_workflow_scenarios/amending-a-commit.md) Este documento proporciona información sobre cómo modificar una confirmación en el repositorio remoto. > Utiliza esto cuando necesites modificar una confirmación que hayas realizado. ### [Configurando git](../git_workflow_scenarios/configuring-git.md) Este documento proporciona información sobre cómo configurar los detalles del usuario y otras opciones de git. > Utiliza esto para controlar mejor la configuración de Git. ### [Mantener tu bifurcación sincronizada con el repositorio](../git_workflow_scenarios/keeping-your-fork-synced-with-this-repository.md) Este documento proporciona información sobre cómo mantener tu bifurcación actualizada con el repositorio base. Esto es importante ya que se espera que tú y muchas otras personas contribuyan al proyecto. > Sigue estos pasos si su bifurcación no tiene los mismos cambios que el repositorio principal. ### [Mover un compromiso a una rama diferente](../git_workflow_scenarios/moving-a-commit-to-a- Different-branch.md) Este documento proporciona información sobre cómo mover un compromiso a otra rama. > Sigue estos pasos para mover un compromiso a otra rama. ### [Eliminar un archivo](../git_workflow_scenarios/removing-a-file.md) Este documento proporciona información sobre cómo eliminar un archivo de tu repositorio local. > Sigue estos pasos para aprender cómo eliminar un archivo de tu repositorio local. ### [Eliminar una rama de su repositorio](../git_workflow_scenarios/removing-branch-from-your-repository.md) Este documento proporciona información sobre cómo eliminar una rama de tu repositorio. > Sigue estos pasos solo después de que tu solicitud de extracción se haya fusionado. ### [Resolver conflictos de fusión](../git_workflow_scenarios/resolving-merge-conflicts.md) Este documento proporciona información sobre cómo resolver conflictos de fusión. > Sigue estos pasos para resolver los molestos conflictos de fusión. ### [Revertir una confirmación](../git_workflow_scenarios/reverting-a-commit.md) Este documento proporciona información sobre cómo revertir una confirmación realizada en el repositorio remoto. Esto es muy útil cuando necesita deshacer una confirmación que se publicó en GitHub. > Sigue estos pasos si desea revertir una confirmación. ### [Aplastamiento de compromisos juntos] (../git_workflow_scenarios/squashing-commits.md) Este documento proporciona información sobre cómo combinar confirmaciones en una sola realizando una rebase. > Utiliza estos pasos si deseas hacer un PR en un proyecto de código abierto y el revisor te pide que combines todas las confirmaciones en una con un mensaje de confirmación informativo. ### [Deshacer una confirmación local](../git_workflow_scenarios/undoing-a-commit.md) Este documento proporciona información sobre cómo deshacer una confirmación en tu repositorio local. Esto es lo que debes hacer cuando sientas que has arruinado tu repositorio y quieres deshacerlo. > Siga estos pasos si desea deshacer/restablecer una confirmación local. ### [Enlaces útiles](../git_workflow_scenarios/Useful-links-for-further-learning.md) Este documento está dedicado a todas las publicaciones de blogs, sitios web útiles, consejos y trucos que nos hacen la vida más sencilla. Ya seas un experto o un principiante, esta página debería servir como índice de todos estos enlaces útiles para ayudar a cualquiera que sea nuevo en el mundo de los proyectos de código abierto o a cualquiera que quiera aprender más al respecto. ================================================ FILE: docs/additional-material/translations/Spanish/amending-a-commit.es.md ================================================ # Modificar un commit Imaginemos que has realizado un commit en tu repositorio remoto y luego te das cuenta de que hay un error tipográfico en el mensaje del commit o que olvidaste agregar una línea en tu commit más reciente. ¿Cómo corregir este error? Ese es el tema de este tutorial. ## Cambiar un mensaje de commit reciente después de haberlo enviado a GitHub Para hacerlo sin siquiera abrir un archivo: * Escribe el comando ```git commit --amend -m "seguido de tu nuevo mensaje de commit"``` * Lanza el comando ```git push origin ``` para realizar un commit en el repositorio. Nota: Si solo escribes ```git commit --amend```, se abrirá el editor de texto y te pedirá que modifiques el mensaje del commit. Agrega la opción ``-m`` para evitar pasar por el editor de texto. ## Modificar un commit específico Entonces, ¿qué sucede si olvidas hacer un cambio menor en un archivo, como cambiar una palabra, y ya has enviado ese commit a nuestro repositorio remoto? Para ilustrar esto, aquí tienes un registro de mis commits; ``` g56123f creación de un archivo bot a2235d actualización de contributeur.md a5da0d modificación del archivo bot ``` Imaginemos que olvidé agregar una palabra en el archivo bot. Hay dos formas de resolver este problema. La primera es hacer un nuevo commit que contenga el cambio de esta manera: ``` g56123f creación de un archivo bot a2235d actualización de contributeur.md a5da0d modificación del archivo bot b0ca8f agregado de una palabra en el archivo bot ``` La segunda forma es modificar el commit a5da0d y agregar esta nueva palabra, luego enviarlo a GitHub, todo en un solo commit. Esta segunda opción parece más adecuada, ya que es un cambio menor. Para hacer esto, sigue estos pasos: * Modifica el archivo. En nuestro caso, modifica el archivo bot para incluir la palabra olvidada. * Luego, agrega el archivo a la zona de preparación con el comando ```git add ``` Normalmente, después de agregar archivos a la zona de preparación, ¿la siguiente etapa es ejecutar el comando git commit -m "nuestro mensaje de commit", verdad? Pero como lo que queremos aquí es modificar el commit anterior, en su lugar ejecutaremos los comandos: * ```git commit --amend``` Esto abrirá el editor de texto que te pedirá que modifiques el mensaje. Puedes decidir si dejar el mensaje tal como está o cambiarlo. * Sal del editor * Envía tus cambios con el comando ```git push origin ``` De esta manera, ambos cambios se encuentran en un solo commit. ================================================ FILE: docs/additional-material/translations/Spanish/amending-a-commit.sp_mx.md ================================================ # Arreglando un compromiso (Commit) ¿Qué sucede si confirmas un cambio en tu repositorio remoto y luego te das cuenta de que tiene un error en el mensaje de confirmación o si olvidaste agregar una línea de código en tu confirmación más reciente? ¿Cómo editarías esto? Eso es lo que cubre este tutorial. ## Cambiar un mensaje de confirmación reciente después de enviarlo a Github Para hacer esto sin abrir un archivo: * Ingresa el comando ```git commit --amend -m "seguido de su nuevo mensaje de confirmación"``` * Ejecuta ```git push origin ``` para confirmar los cambios en el repositorio. Nota: Si simplemente escribiste ```git commit --amend```, se abrirá el editor de texto y te pedirá que edites el mensaje de confirmación. Agregar el indicador ``-m`` evita esto. ## Realizar cambios en una sola confirmación ¿Qué pasa si nos olvidamos de hacer un pequeño cambio en un archivo, como agregar una sola palabra, pero ya hemos enviado la confirmación a nuestro repositorio remoto? Para ilustrar, aquí hay un registro de mis confirmaciones: ```bash g56123f creó el archivo bot a2235d actualizado colaborador.md archivo bot modificado a5da0d ``` Supongamos que olvidé agregar una palabra en el bot. Hay 2 formas de resolver este problema. La primera es hacer una nueva confirmación que contenga el cambio, como esta: ```bash g56123f creó el archivo bot a2235d actualizado colaborador.md archivo bot modificado a5da0d b0ca8f agregó una palabra en el archivo bot ``` La segunda forma es corregir la confirmación a5da0d, agregar esta nueva palabra y enviarla a Github como una confirmación única. Esta acción suena mejor ya que es sólo un pequeño cambio. Para ello haríamos lo siguiente: * Modificar el archivo. En ese caso, modificaré el archivo del bot para incluir la palabra que omití antes. * A continuación, agregue el archivo al área de preparación (*staging area*) con el comando ```git add ``` Normalmente, después de agregar archivos al área de preparación, lo siguiente que hacemos es ingresar el comando ```git commit -m "our commit message"```, ¿verdad? Pero como lo que queremos hacer aquí es arreglar la confirmación anterior, ejecutaremos en su lugar: * ```git commit --amend``` Esto iniciará el editor de texto para que podamos editar el mensaje. Tú decides si dejar el mensaje como estaba antes o editarlo. * Salir del editor guardando los cambios * Empuja tus cambios con el comando ```git push origin ``` De esa manera, ambos cambios ahora estarán en una sola confirmación. ================================================ FILE: docs/additional-material/translations/Spanish/configuring-git.sp_mx.md ================================================ # Configurando Git La primera vez que intentes comprometerte usando Git, deberías obtener uno como este: ```bash $ git commit *** Por favor dime quién eres. Rode: git config --global usuario.correo electrónico "usted@ejemplo.com" git config --global user.name "Su nombre" Para configurar su identidad de cuenta predeterminada. Omita "--global" para establecer la identidad solo en ese repositorio ``` Git necesita saber quién eres tú al crear una confirmación. Cuando trabajas en colaboración, deberías poder ver quién modificó qué partes del proyecto y cuándo, por lo que Git está diseñado para crear confirmaciones vinculadas a un nombre y correo electrónico. Hay varias formas de proporcionar el comando `git commit` con su correo electrónico y nombre. Veremos algunos de ellos a continuación. ### Configuración global Cuando almacenas algo en la configuración global, es accesible en todos los sistemas y repositorios en los que trabajas. Esta es la forma principal y funciona para la mayoría de los casos de uso. Para almacenar algo en la configuración usa el comando `config` de la siguiente manera: `$ git config --global ` En el caso de los datos del usuario, los ejecutamos de la siguiente manera: ``` $ git config --global usuario.correo electrónico "usted@ejemplo.com" $ git config --global user.name "Su nombre" ``` ### Configuración del repositorio Como su nombre lo indica, estas configuraciones apuntan a su repositorio actual. Si deseas comprometerte con un repositorio específico, por ejemplo, un proyecto relacionado con el trabajo, con el correo electrónico de tu empresa, puedes utilizar este método. Para almacenar algo en la configuración del repositorio, usa el comando `config` omitiendo el indicador `--global`, así: `$ git config ` En el caso de los datos del usuario, lo ejecutamos de la siguiente manera: ``` $ git config user.email "usted@alternate.com" $ git config user.name "Tu nombre" ``` ### Configuración de la línea de comando Este tipo de configuración solo tiene como objetivo el comando actual. Todos los comandos de git usan argumentos `-c` antes del verbo de acción para establecer datos de configuración temporales Para almacenar algo en la configuración de la línea de comando. Ejecuta su comando de la siguiente manera: `$ git -c = -c = ` En el ejemplo anterior, ejecutaríamos el comando de confirmación de la siguiente manera: `git -c user.name='Su nombre' -c user.email='you@example.com' commit -m "Su mensaje de confirmación"` ### Nota sobre precedencia Entre los tres métodos descritos aquí, el orden de prioridad es "línea de comando > repositorio > global". Esto significa que si se establece una variable en la línea de comando y también globalmente, el valor de la línea de comando se usará para la operación. ## Además de los detalles del usuario: Hasta ahora solo nos hemos ocupado de los detalles del usuario mientras trabajamos en la configuración. Sin embargo, hay varias otras opciones disponibles. Algunos de ellos son: 1. `core.editor`: para especificar el nombre del editor utilizado para escribir mensajes de confirmación, etc. 2. `commit.template`: para especificar un archivo en el sistema como plantilla de confirmación inicial 3. `color.ui`: para especificar un valor booleano para usar colores en la salida de git Hemos resumido algunos detalles para facilitar la comprensión. Para leer más, visite: [git-scm.com](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration). ================================================ FILE: docs/additional-material/translations/Spanish/creating-a-gitignore-file.md ================================================ # .gitignore El archivo .gitignore es un archivo de texto que le indica a Git qué archivos o carpetas ignorar en un proyecto. Un archivo .gitignore local generalmente se coloca en el directorio raíz de un proyecto. También puedes crear un archivo .gitignore global, y cualquier entrada en ese archivo será ignorada en todos tus repositorios de Git. ## ¿Por qué .gitignore? Ahora te preguntarás por qué querrías que Git ignorara ciertos archivos y carpetas. Es porque no quieres que archivos como los de construcción, archivos de caché, otras configuraciones locales como los módulos de Node, archivos de compilación, archivos temporales que crean los IDEs, etc., sean rastreados por Git. Normalmente se utiliza para evitar comprometer archivos transitorios de tu directorio de trabajo que no son útiles para otros colaboradores. ## Empezando Para crear un archivo .gitignore local, crea un archivo de texto y nómbralo .gitignore (recuerda incluir el . al principio). Luego edita este archivo según sea necesario. Cada nueva línea debe listar un archivo o carpeta adicional que deseas que Git ignore. Las entradas en este archivo también pueden seguir un patrón de coincidencia. ``` * se utiliza como un comodín / se utiliza para ignorar nombres de ruta relativos al archivo .gitignore # se utiliza para agregar comentarios a un archivo .gitignore Este es un ejemplo de cómo podría verse el archivo .gitignore: # Ignorar archivos del sistema de Mac .DS_store # Ignorar la carpeta node_modules node_modules # Ignorar todos los archivos de texto *.txt # Ignorar archivos relacionados con claves API .env # Ignorar archivos de configuración de SASS .sass-cache ``` Para agregar o cambiar tu archivo .gitignore global, ejecuta el siguiente comando: git config --global core.excludesfile ~/.gitignore_global ``` Esto creará el archivo ~/.gitignore_global. Ahora puedes editar ese archivo de la misma manera que un archivo .gitignore local. Todos tus repositorios de Git ignorarán los archivos y carpetas listados en el archivo .gitignore global. ## Cómo deshacer el seguimiento de archivos previamente comprometidos desde un nuevo .gitignore Para deshacer el seguimiento de un solo archivo, es decir, dejar de rastrear el archivo pero no eliminarlo del sistema, usa: git rm --cached filename ``` Para deshacer el seguimiento de todos los archivos en .gitignore: Primero, confirma cualquier cambio de código pendiente y luego ejecuta: git rm -r --cached ``` Esto elimina cualquier archivo cambiado del índice (área de preparación), luego ejecuta: git add . ``` Confirma: git commit -m ".gitignore ahora está funcionando." ``` Para deshacer ```git rm --cached filename```, usa git ```add filename```. ================================================ FILE: docs/additional-material/translations/Spanish/delete-branch-locally.md ================================================ # Eliminando una rama creada localmente Esto será útil cuando accidentalmente escribiste mal el nombre de una rama. Esto se puede hacer de *3* maneras: ``` git branch -D ``` ``` git branch --delete --force # Igual que -D ``` ``` git branch --delete # Error si no está fusionada ``` -D significa --delete --force, que eliminará la rama incluso si no está fusionada (eliminación forzada), pero también puedes usar -d, que significa --delete, y generará un error según el estado de fusión de la rama... ================================================ FILE: docs/additional-material/translations/Tamil/Things a non Programmer can do.ta.md ================================================ # புரோகிராமர் அல்லாதவர் செய்யக்கூடிய விஷயங்கள் ## கேட்கத் தொடங்குங்கள் திறந்த மூலத்தில் உள்ள அனைத்தும் மற்றவர்களை உள்ளடக்கியது. நீங்கள் ஒரு குழுவில் சேர விரும்புகிறீர்கள், அதாவது சமூகத்தையும் அது எவ்வாறு செயல்படுகிறது என்பதையும் புரிந்துகொள்வது. ஒரு ப்ராஜெக்ட்டில் நுழைந்து, "ஹாய், இதோ இந்த ப்ராஜெக்ட் செய்ய வேண்டும் என்று நான் நினைக்கிறேன்" என்று சொல்வது பொதுவாக நல்ல விஷயமாக எடுத்துக்கொள்ளப்படுவதில்லை. சில திட்டங்கள் அந்த வகையான அணுகுமுறையை வரவேற்கலாம், ஆனால் திட்டம் சிறிது நேரம் இயங்கிக்கொண்டிருந்தால், அந்த அணுகுமுறை ஏற்றுக்கொள்ளப்படுவதற்கான வாய்ப்புகள் சிறியவை. **திட்டத்திற்கு என்ன தேவை என்பதை அறிய சிறந்த வழி கேட்பது.** 1. **அஞ்சல் பட்டியலில் சேரவும்**: பல திட்டங்களுக்கு, திட்டத்தின் மேம்பாடு பற்றிய தகவல் பரிமாற்றத்தின் முக்கிய வழித்தடமாக அஞ்சல் பட்டியல் உள்ளது. பெரிய திட்டங்களில், தேர்வு செய்ய பல அஞ்சல் பட்டியல்கள் உள்ளன. எடுத்துக்காட்டாக, PostgreSQL திட்டமானது அதன் அஞ்சல் பட்டியல் பக்கத்தில் 12 பயனர் சார்ந்த பட்டியல்களையும் ஆறு டெவலப்பர் பட்டியல்களையும் கொண்டிருக்கவில்லை. முக்கிய பயனர் சார்ந்த பட்டியலையும், கேட்கத் தொடங்கும் முக்கிய டெவலப்பர் பட்டியலையும் நீங்கள் பின்பற்ற பரிந்துரைக்கிறேன். 2. **ஒரு வலைப்பதிவைப் பின்தொடரவும்**: முக்கிய டெவலப்பர்களால் பராமரிக்கப்படும் வலைப்பதிவுகள் எதிர்கால வெளியீடுகளில் என்ன வரப்போகிறது என்பது பற்றிய தகவல்களை அடிக்கடி தருகிறது, மற்றும் அங்கு செல்ல என்ன எடுக்கப்பட்டது. திட்டத்துடன் தொடர்புடைய பல மூலங்களிலிருந்து செய்திகள் மற்றும் வலைப்பதிவு உள்ளீடுகளை ஒரு கிரக தளம் ஒருங்கிணைக்கிறது. planet.gnome.org அல்லது planet.mysql.com போன்ற கிரக தளம் இருந்தால், அங்கேயே தொடங்கவும். "planet " என்று கூகுளில் தேடினால் போதும். 3. **IRC சேனலில் சேரவும்**: பல ஓப்பன் சோர்ஸ் திட்டங்களில் டெவலப்பர்கள் மற்றும் பயனர்கள் பிரச்சனைகள் மற்றும் மேம்பாடுகளைப் பற்றி விவாதிக்க பிரத்யேக இணைய ரிலே அரட்டை (IRC) சேனல்கள் உள்ளன. சேனல் என்ன அழைக்கப்படுகிறது மற்றும் எந்த IRC நெட்வொர்க்கில் உள்ளது என்ற விவரங்களுக்கு திட்டத்தின் இணையதளத்தைப் பார்க்கவும். **டிக்கெட்டுகளுடன் வேலை செய்யுங்கள்** எந்தவொரு திறந்த மூல திட்டத்திற்கும் குறியீடு தான் இதயம், ஆனால் குறியீட்டை எழுதுவது மட்டுமே பங்களிப்பதற்கான ஒரே வழி என்று நினைக்க வேண்டாம். புதிய அம்சங்களை உருவாக்குவதற்கும் பிழைகளை சரிசெய்வதற்குமான அவசரத்தில் குறியீட்டின் பராமரிப்பு மற்றும் குறியீட்டைச் சுற்றியுள்ள அமைப்புகள் பெரும்பாலும் புறக்கணிக்கப்படுகின்றன. ஒரு திட்டத்தில் உங்கள் பாதத்தைப் பெறுவதற்கான எளிதான வழியாக இந்தப் பகுதிகளைப் பாருங்கள். பெரும்பாலான ப்ராஜெக்ட்கள் பொதுவில் காணக்கூடிய பிரச்சனை டிக்கெட் அமைப்பைக் கொண்டுள்ளன, இது திட்டத்தின் இணையதளத்தின் முதல் பக்கத்திலிருந்து இணைக்கப்பட்டு ஆவணத்தில் சேர்க்கப்பட்டுள்ளது. இது பயனர்களுக்கும் டெவலப்பர்களுக்கும் இடையிலான தொடர்புக்கான முதன்மையான வழியாகும். அதை தற்போதைய நிலையில் வைத்திருப்பது திட்டத்திற்கு உதவ ஒரு சிறந்த வழியாகும். டிக்கெட் அமைப்பில் நீங்கள் சிறப்பு அனுமதிகளைப் பெற வேண்டியிருக்கலாம், பெரும்பாலான திட்டத் தலைவர்கள் டிக்கெட்டுகளை சுத்தம் செய்ய நீங்கள் உதவ விரும்புகிறீர்கள் என்று நீங்கள் கூறும்போது மகிழ்ச்சியுடன் வழங்குவார்கள். 4. **பிழையைக் கண்டறிதல்**: பிழைகள் பெரும்பாலும் மோசமாகப் புகாரளிக்கப்படுகின்றன. பிழையைக் கண்டறிதல் மற்றும் சோதனை செய்வது, பிரச்சனையின் பிரத்தியேகங்களைக் கண்டறிவதன் மூலம் டெவலப்பர்களின் நேரத்தைச் சேமிக்க உதவும். ஒரு பயனர், "நான் X செய்யும் போது மென்பொருள் வேலை செய்யாது" எனப் புகாரளித்தால், அந்தச் சிக்கலில் என்ன நடக்கிறது என்பதைத் தெரிந்துகொள்ள சிறிது நேரம் செலவிடுங்கள். இது மீண்டும் மீண்டும் செய்யக்கூடியதா? மீண்டும் மீண்டும் சிக்கலை ஏற்படுத்துவதற்கான படிகளின் தொகுப்பை உருவாக்க முடியுமா? ஒரு உலாவியில் மட்டும் நடப்பது மற்றொன்று அல்ல, அல்லது ஒரு டிஸ்ட்ரோ ஆனால் மற்றொன்றில் நடக்காதது போன்ற சிக்கலைக் குறைக்க முடியுமா? பிரச்சனைக்கு என்ன காரணம் என்று உங்களுக்குத் தெரியாவிட்டாலும், சூழ்நிலைகளைக் குறைப்பதில் நீங்கள் எடுக்கும் முயற்சி, அதைச் சரிசெய்வதை மற்றொருவருக்கு எளிதாக்குகிறது. நீங்கள் எதைக் கண்டறிந்தாலும், அதை அனைவரும் பார்க்க, பிழை அமைப்பில் உள்ள டிக்கெட்டில் சேர்க்கவும். 5. **நிலையான பிழைகளை மூடு**: பெரும்பாலும் பிழைகள் கோட்பேஸில் சரி செய்யப்படும் ஆனால் அவற்றைப் பற்றி அறிவிக்கப்படும் டிக்கெட்டுகள் டிக்கெட் அமைப்பில் புதுப்பிக்கப்படுவதில்லை. இந்த க்ராஃப்ட்டை சுத்தம் செய்வது நேரத்தை எடுத்துக்கொள்ளும், ஆனால் இது முழு திட்டத்திற்கும் மதிப்புமிக்கது. ஒரு வருடத்திற்கும் மேலான டிக்கெட்டுகளுக்கான டிக்கெட் முறையை வினவுவதன் மூலம் தொடங்கி, பிழை இன்னும் இருக்கிறதா என்று பார்க்கவும். பிழை சரி செய்யப்பட்டதா மற்றும் மூட முடியுமா என்பதைப் பார்க்க, திட்டத்தின் வெளியீட்டு மாற்றப் பதிவைச் சரிபார்க்கவும். அது சரி செய்யப்பட்டது எனத் தெரிந்தால், டிக்கெட்டில் உள்ள பதிப்பு எண்ணைக் குறிப்பிட்டு அதை மூடவும். மென்பொருளின் சமீபத்திய பதிப்பைக் கொண்டு பிழையை மீண்டும் உருவாக்க முயற்சிக்கவும். சமீபத்திய பதிப்பில் அதை மீண்டும் உருவாக்க முடியாவிட்டால், டிக்கெட்டில் அதைக் கவனித்து அதை மூடவும். அது இன்னும் இருந்தால், டிக்கெட்டிலும் அதைக் கவனித்து அதைத் திறந்து விடுங்கள். குறியீட்டுடன் பணிபுரிதல் அனைத்து அனுபவ நிலைகளிலும் உள்ள புரோகிராமர்கள் திட்டத்தில் உள்ள குறியீட்டிற்கு உதவலாம். உங்களுக்குப் பிடித்த திட்டத்திற்கு உண்மையான பங்களிப்பைச் செய்ய நீங்கள் ஒரு குறியீட்டு மேதையாக இருக்க வேண்டும் என்று நினைக்க வேண்டாம். உங்கள் பணியானது குறியீட்டை மாற்றியமைப்பதை உள்ளடக்கியிருந்தால், பங்களிப்பாளர்களிடமிருந்து குறியீட்டைப் பெற திட்டம் பயன்படுத்தும் முறையை ஆராயுங்கள். ஒவ்வொரு திட்டத்திற்கும் அதன் சொந்த பணிப்பாய்வு உள்ளது, எனவே குறியீட்டை சமர்ப்பிக்கும் முன் அதை எப்படி செய்வது என்று கேளுங்கள். எடுத்துக்காட்டாக, PostgreSQL திட்டம் அதன் செயல்பாட்டில் மிகவும் கடுமையானது: குறியீடு மாற்றங்கள் இணைப்புப் பட்டியலில் அஞ்சல் பட்டியலில் அனுப்பப்படுகின்றன, அங்கு முக்கிய டெவலப்பர்கள் மாற்றத்தின் ஒவ்வொரு அம்சத்தையும் ஆய்வு செய்கிறார்கள். மறுமுனையில் கிளி போன்ற ஒரு திட்டம் உள்ளது, அங்கு கோட்பேஸுக்கு உறுதி சலுகைகளைப் பெறுவது எளிது. திட்டம் GitHub ஐப் பயன்படுத்தினால், GitHub இன் இழுக்கும் கோரிக்கை அம்சத்தைப் பயன்படுத்தும் பணிப்பாய்வு இருக்கலாம். இரண்டு திட்டங்களும் ஒரே மாதிரியானவை அல்ல. நீங்கள் குறியீட்டை மாற்றும் போதெல்லாம், சமூகத்தின் பொறுப்பான உறுப்பினராகச் செயல்படுவதை உறுதிசெய்து, மீதமுள்ள குறியீட்டுத் தளத்துடன் பொருந்துமாறு உங்கள் குறியீட்டு பாணியை வைத்திருக்கவும். நீங்கள் சேர்க்கும் அல்லது மாற்றியமைக்கும் குறியீடு மற்றதைப் போலவே இருக்க வேண்டும். பிரேசிங் ஸ்டைல் ​​அல்லது உள்தள்ளலுக்கான இடைவெளிகளைக் கையாள்வது உங்களுக்குப் பிடிக்காமல் இருக்கலாம், ஆனால் தற்போதுள்ள தரநிலைகளுடன் பொருந்தாத குறியீட்டு மாற்றத்தைச் சமர்ப்பிப்பது முரட்டுத்தனமானது. "உங்கள் பாணி எனக்குப் பிடிக்கவில்லை, என்னுடையது சிறந்தது என்று நான் நினைக்கிறேன், எனவே நீங்கள் அதை என் வழியில் செய்ய வேண்டும்" என்று சொல்வதும் ஒன்றுதான். 6. **பீட்டாவைச் சோதிக்கவும் அல்லது வேட்பாளரை வெளியிடவும்**: பல தளங்களில் இயங்கும் வகையில் வடிவமைக்கப்பட்ட எந்தத் திட்டமும் எல்லா வகையான பெயர்வுத்திறன் சிக்கல்களையும் கொண்டிருக்கலாம். ஒரு வெளியீடு நெருங்கி, பீட்டா அல்லது வெளியீட்டு வேட்பாளர் வெளியிடப்படும் போது, ​​அது பல்வேறு தளங்களில் பல்வேறு நபர்களால் சோதிக்கப்படும் என்று திட்டத் தலைவர் நம்புகிறார். நீங்கள் அந்த நபர்களில் ஒருவராக இருக்கலாம் மற்றும் உங்கள் பிளாட்ஃபார்மில் தொகுப்பு செயல்படுவதை உறுதிசெய்ய உதவலாம். பொதுவாக நீங்கள் மென்பொருளைப் பதிவிறக்கம் செய்து, உருவாக்கி, சோதித்துப் பார்க்க வேண்டும், ஆனால் நீங்கள் அசாதாரணமான விநியோகம் அல்லது வன்பொருளில் இருந்தால் திட்டத்திற்கான மதிப்பு மிகப்பெரியதாக இருக்கும். உருவாக்கம் மற்றும் சோதனை வேலைகள் என்று அறிக்கையிடுவது, வரவிருக்கும் வெளியீடு உறுதியானது என்பதை திட்டத் தலைவர்கள் அறிய உதவுகிறது. 7. **பிழையை சரிசெய்தல்**: பொதுவாக, பங்களிப்பாளர்கள் குறியீட்டில் வேலை செய்ய விரும்பும் இடமாகும். இது எளிதானது: டிக்கெட் அமைப்பில் ஒரு சுவாரஸ்யமான-ஒலி பிழையைக் கண்டறிந்து குறியீட்டில் அதை சரிசெய்ய முயற்சிக்கவும். திருத்தம் பொருத்தமானதாக இருந்தால் குறியீட்டில் ஆவணப்படுத்தவும். நீங்கள் சரிசெய்த குறியீட்டின் இடத்தைச் சோதிக்க, சோதனைத் தொகுப்பில் ஒரு சோதனையைச் சேர்ப்பது நல்லது; சோதனைகளைச் சேர்க்க சில திட்டங்களுக்கு பிழை திருத்தங்கள் தேவை. இந்த அறிமுகமில்லாத கோட்பேஸை சுற்றிக் கொண்டே குறிப்புகளை வைத்துக் கொள்ளுங்கள். பிழையை உங்களால் சரிசெய்ய முடியாவிட்டாலும், திருத்த முயற்சியின் ஒரு பகுதியாக நீங்கள் கண்டறிந்ததை டிக்கெட்டில் பதிவு செய்யவும். நீங்கள் கண்டுபிடிப்பது உங்களுக்குப் பின் வருபவர்களுக்கு உதவும். 8. **சோதனை எழுது**: பெரும்பாலான திட்டங்களில் குறியீட்டைச் சோதிக்கும் ஒரு சோதனைத் தொகுப்பு உள்ளது, ஆனால் கூடுதல் சோதனைகளைச் சேர்க்க முடியாத ஒரு சோதனைத் தொகுப்பைக் கற்பனை செய்வது கடினம். சோதனைத் தொகுப்பால் சோதிக்கப்படாத மூலக் குறியீட்டில் உள்ள பகுதிகளைக் கண்டறிய, Gcov for C அல்லது Devel::Cover for Perl போன்ற சோதனைக் கவரேஜ் கருவியைப் பயன்படுத்தவும். பின்னர், அதை மறைக்க ஒரு சோதனையை தொகுப்பில் சேர்க்கவும். 9. **ஒரு கம்பைலர் எச்சரிக்கையை அமைதிப்படுத்து**: பல சி-அடிப்படையிலான திட்டங்களுக்கான உருவாக்க செயல்முறை பெரும்பாலும் ஒற்றைப்படை கம்பைலர் எச்சரிக்கைக் கொடியை திரையில் செலுத்துகிறது. இந்த எச்சரிக்கைகள் பொதுவாக ஒரு சிக்கலின் குறிகாட்டிகள் அல்ல, ஆனால் அவை அப்படியே இருக்கும். பல எச்சரிக்கைகள் இருப்பதால், கம்பைலர் ஓநாய் அழுவது போல் ஒலிக்கும். குறியீடு உண்மையில் பிழையை மறைக்கிறதா என்பதைப் பார்க்கவும். இல்லையெனில், மூலத்தை அமைதிக்கு மாற்றுவது இந்த தவறான நேர்மறைகளை மறைக்க உதவுகிறது. 10. **ஒரு கருத்தைச் சேர்**: நீங்கள் குறியீட்டைத் தோண்டி எடுக்கும்போது, ​​குழப்பமான சில இடங்களைக் காணலாம். நீங்கள் குழப்பமடைந்திருந்தால், மற்றவர்களும் அவ்வாறு இருப்பதற்கான வாய்ப்புகள் உள்ளன. குறியீட்டில் அவற்றை ஆவணப்படுத்தி ஒரு பேட்சைச் சமர்ப்பிக்கவும். ஆவணங்களுடன் வேலை செய்யுங்கள் ஆவணப்படுத்தல் என்பது ஒரு திட்டத்தின் ஒரு பகுதியாகும், இது குறுகிய மாற்றத்தைப் பெறுகிறது. யாரோ ஒருவரின் பார்வையில் நுழைவதை விட, திட்டத்துடன் நன்கு தெரிந்தவர்களின் பார்வையில் எழுதப்பட்டதால் இது பாதிக்கப்படலாம். நீங்கள் எப்போதாவது ஒரு ப்ராஜெக்ட்டுக்கான டாக்ஸைப் படித்திருந்தால், "இந்த கையேடு எனக்கு ஏற்கனவே பேக்கேஜை எப்படி பயன்படுத்துவது என்று தெரியும் என்று எதிர்பார்க்கிறது போல் இருக்கிறது", நான் எதைப் பற்றி பேசுகிறேன் என்று உங்களுக்குத் தெரியும். பெரும்பாலும் புதிய கண்களின் தொகுப்பு, திட்டத்திற்கு நெருக்கமானவர்கள் கவனிக்காத ஆவணங்களில் உள்ள குறைபாடுகளை சுட்டிக்காட்டலாம். 11. **உதாரணத்தை உருவாக்கவும்**: பல எப்படி-எப்படி-எடுத்துக்கொள்ளும் உதாரணங்களைக் கொண்ட எந்த திட்டமும் இல்லை. இது ஒரு வலை API ஆக இருந்தாலும், நடைமுறைகளின் நூலகமாக இருந்தாலும், Gimp அல்லது கமன் போன்ற GUI ஆப்ஸாக இருந்தாலும் சரி, ஆனால் தற்போதுள்ள தரநிலைகளுடன் பொருந்தாத குறியீட்டு மாற்றத்தைச் சமர்ப்பிப்பது முரட்டுத்தனமானது. "உங்கள் பாணி எனக்குப் பிடிக்கவில்லை, என்னுடையது சிறந்தது என்று நான் நினைக்கிறேன், எனவே நீங்கள் அதை என் வழியில் செய்ய வேண்டும்" என்று சொல்வதும் ஒன்றுதான். 6. **பீட்டாவைச் சோதிக்கவும் அல்லது வேட்பாளரை வெளியிடவும்**: பல தளங்களில் இயங்கும் வகையில் வடிவமைக்கப்பட்ட எந்தத் திட்டமும் எல்லா வகையான பெயர்வுத்திறன் சிக்கல்களையும் கொண்டிருக்கலாம். ஒரு வெளியீடு நெருங்கி, பீட்டா அல்லது வெளியீட்டு வேட்பாளர் வெளியிடப்படும் போது, ​​அது பல்வேறு தளங்களில் பல்வேறு நபர்களால் சோதிக்கப்படும் என்று திட்டத் தலைவர் நம்புகிறார். நீங்கள் அந்த நபர்களில் ஒருவராக இருக்கலாம் மற்றும் உங்கள் பிளாட்ஃபார்மில் தொகுப்பு செயல்படுவதை உறுதிசெய்ய உதவலாம். பொதுவாக நீங்கள் மென்பொருளைப் பதிவிறக்கம் செய்து, உருவாக்கி, சோதித்துப் பார்க்க வேண்டும், ஆனால் நீங்கள் அசாதாரணமான விநியோகம் அல்லது வன்பொருளில் இருந்தால் திட்டத்திற்கான மதிப்பு மிகப்பெரியதாக இருக்கும். உருவாக்கம் மற்றும் சோதனை வேலைகள் என்று அறிக்கையிடுவது, வரவிருக்கும் வெளியீடு உறுதியானது என்பதை திட்டத் தலைவர்கள் அறிய உதவுகிறது. 7. **பிழையை சரிசெய்தல்**: பொதுவாக, பங்களிப்பாளர்கள் குறியீட்டில் வேலை செய்ய விரும்பும் இடமாகும். இது எளிதானது: டிக்கெட் அமைப்பில் ஒரு சுவாரஸ்யமான-ஒலி பிழையைக் கண்டறிந்து குறியீட்டில் அதை சரிசெய்ய முயற்சிக்கவும். திருத்தம் பொருத்தமானதாக இருந்தால் குறியீட்டில் ஆவணப்படுத்தவும். நீங்கள் சரிசெய்த குறியீட்டின் இடத்தைச் சோதிக்க, சோதனைத் தொகுப்பில் ஒரு சோதனையைச் சேர்ப்பது நல்லது; சோதனைகளைச் சேர்க்க சில திட்டங்களுக்கு பிழை திருத்தங்கள் தேவை. இந்த அறிமுகமில்லாத கோட்பேஸை சுற்றிக் கொண்டே குறிப்புகளை வைத்துக் கொள்ளுங்கள். பிழையை உங்களால் சரிசெய்ய முடியாவிட்டாலும், திருத்த முயற்சியின் ஒரு பகுதியாக நீங்கள் கண்டறிந்ததை டிக்கெட்டில் பதிவு செய்யவும். நீங்கள் கண்டுபிடிப்பது உங்களுக்குப் பின் வருபவர்களுக்கு உதவும். 8. **சோதனை எழுது**: பெரும்பாலான திட்டங்களில் குறியீட்டைச் சோதிக்கும் ஒரு சோதனைத் தொகுப்பு உள்ளது, ஆனால் கூடுதல் சோதனைகளைச் சேர்க்க முடியாத ஒரு சோதனைத் தொகுப்பைக் கற்பனை செய்வது கடினம். சோதனைத் தொகுப்பால் சோதிக்கப்படாத மூலக் குறியீட்டில் உள்ள பகுதிகளைக் கண்டறிய, Gcov for C அல்லது Devel::Cover for Perl போன்ற சோதனைக் கவரேஜ் கருவியைப் பயன்படுத்தவும். பின்னர், அதை மறைக்க ஒரு சோதனையை தொகுப்பில் சேர்க்கவும். 9. **ஒரு கம்பைலர் எச்சரிக்கையை அமைதிப்படுத்து**: பல சி-அடிப்படையிலான திட்டங்களுக்கான உருவாக்க செயல்முறை பெரும்பாலும் ஒற்றைப்படை கம்பைலர் எச்சரிக்கைக் கொடியை திரையில் செலுத்துகிறது. இந்த எச்சரிக்கைகள் பொதுவாக ஒரு சிக்கலின் குறிகாட்டிகள் அல்ல, ஆனால் அவை அப்படியே இருக்கும். பல எச்சரிக்கைகள் இருப்பதால், கம்பைலர் ஓநாய் அழுவது போல் ஒலிக்கும். குறியீடு உண்மையில் பிழையை மறைக்கிறதா என்பதைப் பார்க்கவும். இல்லையெனில், மூலத்தை அமைதிக்கு மாற்றுவது இந்த தவறான நேர்மறைகளை மறைக்க உதவுகிறது. 10. **ஒரு கருத்தைச் சேர்**: நீங்கள் குறியீட்டைத் தோண்டி எடுக்கும்போது, ​​குழப்பமான சில இடங்களைக் காணலாம். நீங்கள் குழப்பமடைந்திருந்தால், மற்றவர்களும் அவ்வாறு இருப்பதற்கான வாய்ப்புகள் உள்ளன. குறியீட்டில் அவற்றை ஆவணப்படுத்தி ஒரு பேட்சைச் சமர்ப்பிக்கவும். ஆவணங்களுடன் வேலை செய்யுங்கள் ஆவணப்படுத்தல் என்பது ஒரு திட்டத்தின் ஒரு பகுதியாகும், இது குறுகிய மாற்றத்தைப் பெறுகிறது. யாரோ ஒருவரின் பார்வையில் நுழைவதை விட, திட்டத்துடன் நன்கு தெரிந்தவர்களின் பார்வையில் எழுதப்பட்டதால் இது பாதிக்கப்படலாம். நீங்கள் எப்போதாவது ஒரு ப்ராஜெக்ட்டுக்கான டாக்ஸைப் படித்திருந்தால், "இந்த கையேடு எனக்கு ஏற்கனவே பேக்கேஜை எப்படி பயன்படுத்துவது என்று தெரியும் என்று எதிர்பார்க்கிறது போல் இருக்கிறது", நான் எதைப் பற்றி பேசுகிறேன் என்று உங்களுக்குத் தெரியும். பெரும்பாலும் புதிய கண்களின் தொகுப்பு, திட்டத்திற்கு நெருக்கமானவர்கள் கவனிக்காத ஆவணங்களில் உள்ள குறைபாடுகளை சுட்டிக்காட்டலாம். 11. **உதாரணத்தை உருவாக்கவும்**: பல எப்படி-எப்படி-எடுத்துக்கொள்ளும் உதாரணங்களைக் கொண்ட எந்த திட்டமும் இல்லை. அது ஒரு வலை API, நடைமுறைகளின் நூலகம், Gimp போன்ற GUI ஆப்ஸ் அல்லது கட்டளை வரி கருவியாக இருந்தாலும் சரி, முறையான பயன்பாட்டிற்கான ஒரு சிறந்த எடுத்துக்காட்டு, ஆவணங்களின் பக்கங்களை விட மென்பொருளின் சரியான பயன்பாட்டை மிகவும் தெளிவாகவும் விரைவாகவும் விளக்க முடியும். API அல்லது நூலகத்திற்கு, கருவியைப் பயன்படுத்தும் ஒரு எடுத்துக்காட்டு நிரலை உருவாக்கவும். இது நீங்கள் எழுதிய குறியீட்டிலிருந்து பிரித்தெடுக்கப்படலாம், தேவைக்கேற்ப குறைக்கலாம். ஒரு கருவிக்கு, உங்கள் அன்றாட வாழ்க்கையில் அதை எப்படிப் பயன்படுத்துகிறீர்கள் என்பதற்கான நிஜ உலக உதாரணங்களைக் காட்டுங்கள். நீங்கள் பார்வை சார்ந்தவராக இருந்தால், பயன்பாட்டை எவ்வாறு நிறுவுவது போன்ற முக்கியமான செயல்முறையின் திரை-பிடிப்பை உருவாக்குவதைக் கருத்தில் கொள்ளுங்கள். சமூகத்துடன் வேலை செய்யுங்கள் ஓப்பன் சோர்ஸ் என்பது ஓரளவுக்கு மட்டுமே குறியீடு பற்றியது. சமூகம் திறந்த மூல வேலை செய்கிறது. நீங்கள் அதை உருவாக்க உதவும் வழிகள் இங்கே உள்ளன. 12. **கேள்விக்கு பதிலளிக்கவும்**: சமூகத்தை கட்டியெழுப்ப சிறந்த வழி மற்றவர்களுக்கு உதவுவதே. ஒரு கேள்விக்கு பதிலளிப்பது, குறிப்பாக கால்களை நனைக்கும் ஒருவரிடமிருந்து, திட்டம் வளரவும் செழிக்கவும் உதவும். ஒரு தொடக்கநிலையாளருக்கு உதவ நீங்கள் எடுக்கும் நேரம், நீங்கள் விரைவாக "RTFM" ஐ எங்கே எளிதாகத் திரும்பப் பெறலாம் என்று ஒரு கேள்வியைக் கேட்டாலும், சமூகத்தின் மற்றொரு செயலில் உள்ள உறுப்பினரைப் பெறுவதற்கான பாதையைக் குறைக்கிறது. ஒவ்வொருவரும் எங்காவது தொடங்குகிறார்கள், மேலும் அவர்கள் முக்கியமாக இருக்க வேண்டுமென்றால் திட்டங்களுக்கு மக்கள் தொடர்ந்து வர வேண்டும். 13. **ஒரு வலைப்பதிவு இடுகையை எழுதுங்கள்**: உங்களிடம் வலைப்பதிவு இருந்தால், நீங்கள் பயன்படுத்தும் திட்டத்தில் உங்கள் அனுபவங்களைப் பற்றி எழுதுங்கள். மென்பொருளைப் பயன்படுத்தி நீங்கள் எதிர்கொண்ட பிரச்சனை மற்றும் அதைத் தீர்க்க நீங்கள் என்ன செய்தீர்கள் என்று சொல்லுங்கள். உங்களைச் சுற்றியுள்ள மற்றவர்களின் மனதில் திட்டத்தை வைத்திருக்க உதவுவதன் மூலம், நீங்கள் இரண்டு வழிகளில் உதவுவீர்கள். எதிர்காலத்தில் உங்கள் பிரச்சனையை எதிர்கொண்டு அதற்கான பதிலை இணையத்தில் தேடும் எவருக்கும் ஒரு பதிவை உருவாக்குவதன் மூலம். (உங்கள் தொழில்நுட்ப சாகசங்களின் வலைப்பதிவு, கேள்விக்குரிய மென்பொருளின் நிஜ-உலக அனுபவத்தைக் காட்ட, அடுத்த முறை நீங்கள் வேலைக்காக வேட்டையாடச் செல்லும் ஒரு சிறந்த வழியாகும்.) 14. **ஒரு இணையதளத்தை மேம்படுத்தவும்**: நீங்கள் வலை வடிவமைப்பில் திறமை பெற்றிருந்தால் மற்றும் வலைகளை மேம்படுத்த உதவலாம்இது, மற்றும் திட்டத்தின் பொது முகம் படம், அந்த நேரம் நன்றாக செலவிடப்பட்டது. திட்டமானது ஒரு கிராஃபிக் மாற்றத்தை அல்லது திட்டத்தை அடையாளம் காண ஒரு லோகோவைப் பயன்படுத்தலாம். இவை சமூகத்தில் இல்லாத திறன்களாக இருக்கலாம். எனது திட்டப்பணிகளின் இணையதளங்களில் ஏதேனும் கிராஃபிக் டிசைன் உதவி கிடைத்தால் நான் அதை விரும்புவேன் என்று எனக்குத் தெரியும். 15. **தொழில்நுட்ப ஆவணங்களை எழுதவும்** ஒரு பயன்பாடு அல்லது மென்பொருள் எவ்வாறு செயல்படுகிறது என்பதைப் பற்றி நீங்கள் எழுத முடிந்தால், அதைப் பற்றிய தொழில்நுட்ப ஆவணங்களை நீங்கள் எழுதலாம். குறிப்பாக ஓப்பன் சோர்ஸ் திட்டங்கள், பொது மக்கள் படிக்கும் வகையில் தொழில்நுட்ப ஆவணங்களை புதுப்பிக்க, புதுப்பிக்க, விரிவாக்க அல்லது உருவாக்க வேண்டும். நீங்கள் சாதாரண ஆங்கிலத்தில் எவ்வளவு அதிகமாக எழுதுகிறீர்களோ, அவ்வளவு சிறந்தது. சிறந்த பகுதி, தொழில்நுட்ப ஆவணங்களை எழுத நீங்கள் ஒரு புரோகிராமராக இருக்க வேண்டியதில்லை. எல்லாவற்றிற்கும் மேலாக, உங்களைச் சுற்றியுள்ளவர்கள் என்ன பேசுகிறார்கள் என்பதைக் கேளுங்கள். ஒரு அழுத்தமான தேவையை உங்களால் அடையாளம் காண முடியுமா என்று பாருங்கள். உதாரணமாக, சமீபத்தில் கிளி டெவலப்பர்களின் அஞ்சல் பட்டியலில், அவர்கள் வைத்திருந்த பழைய ட்ராக் நிறுவலைக் கைவிட்டு, சிக்கல் டிக்கெட் அமைப்பாக GitHub ஐப் பயன்படுத்த முடிவு செய்யப்பட்டது. டிக்கெட்டுகளை கிட்ஹப் அமைப்பிற்கு மாற்ற வழி இல்லாததால் சிலர் இந்த நடவடிக்கைக்கு எதிராக இருந்தனர். ஒரு நாள் முன்னும் பின்னுமாக வாக்குவாதத்திற்குப் பிறகு, "நான் மாற்றி எழுதினால் எப்படி?" இந்த யோசனையில் மக்கள் மகிழ்ச்சியடைந்தனர். 450+ டிக்கெட்டுகளுக்கு மாற்றும் திட்டத்தை எழுத நான் நேரத்தை செலவிட்டேன், அதனால் எங்களின் டிக்கெட் வரலாறு எதையும் இழக்கவில்லை. இது பெரும் வெற்றி பெற்றது. நான் களமிறங்கினேன், முக்கிய டெவலப்பர்கள் கிளி வேலை செய்யும் வணிகத்தில் கவனம் செலுத்தினர். 16. **மற்றவர்களுக்குக் கற்றுக் கொடுங்கள்**: ஒரு தலைப்பைப் பற்றி மேலும் அறிய சிறந்த வழி அதைக் கற்பிக்க முயற்சிப்பதாகும். சிக்கலான விஷயங்களை எளிய உதாரணங்களுடன் விளக்கக்கூடியவர் சிறந்த ஆசிரியர். எனவே நீங்கள் சிறந்த கற்பவராகவும் உங்கள் நிரலாக்க உலகில் சிறந்தவராகவும் இருக்க சிறந்த ஆசிரியராக இருக்க முயற்சிக்க வேண்டும். மற்றவர்களுக்குக் கற்பிப்பது உங்களைப் பற்றி நன்றாக உணரவைக்கும், மேலும் உங்கள் தொழிலில் சிறந்த திறன்களையும் அறிவையும் பெற உதவும். நீங்கள் ஒருவரிடமிருந்து உதவியைப் பெற்றால், அதை நீங்களே வைத்துக் கொள்ளாதீர்கள், மற்றவர்களுடன் பகிர்ந்து கொள்ளுங்கள். உலகத்தை வாழ சிறந்த இடமாக மாற்றவும். ================================================ FILE: docs/additional-material/translations/Tamil/additional-material.ta.md ================================================ # கூடுதல் தகவல் இங்கு வருவதற்கு முன்பு நீங்கள் ஏற்கனவே அடிப்படை பயிற்சியை முடித்துவிட்டீர்கள் என்று கருதுகிறோம். இந்த ஆவணம் மேம்பட்ட Git நுட்பங்களைப் பற்றிய சில கூடுதல் தகவல்களை உங்களுக்கு வழங்கும். ### [ஒரு உறுதிப்பாட்டைத் திருத்துதல்](amending-a-commit.md) ரிமோட் ரிபோசிட்டரியில் ஒரு உறுதியை எவ்வாறு திருத்துவது என்பது பற்றிய தகவலை இந்த ஆவணம் வழங்குகிறது.உங்கள் தற்போதைய கிளையில் நீங்கள் செய்த மிக சமீபத்திய உறுதிமொழியை மாற்றுவதற்கான ஒரு வழியாக உறுதிமொழியை திருத்துவது. நீங்கள் கமிட் மெசேஜை எடிட் செய்ய வேண்டும் என்றால் அல்லது கமிட்டில் மாற்றங்களைச் சேர்க்க மறந்துவிட்டால் இது உதவியாக இருக்கும். நீங்கள் அதை ரிமோட் களஞ்சியத்திற்குத் தள்ளும் வரை உறுதிமொழியைத் தொடர்ந்து திருத்தலாம். > நீங்கள் செய்த உறுதிமொழியை சரிசெய்ய வேண்டியிருக்கும் போது இதைப் பயன்படுத்தவும். ### [ஜிட்டை உள்ளமைக்கிறது](configuring-git.md) இந்த ஆவணம் git இல் பயனர் விவரங்கள் மற்றும் பிற விருப்பங்களை எவ்வாறு கட்டமைப்பது என்பது பற்றிய தகவலை வழங்குகிறது. > உங்கள் ஜிட் உள்ளமைவுகளை சிறப்பாகக் கட்டுப்படுத்த இதைப் பயன்படுத்தவும். ### [உங்கள் ஃபோர்க்கை களஞ்சியத்துடன் ஒத்திசைத்தல்](உங்கள்-முட்டை-ஒத்திசைவு-வைத்-திஸ்-ரிபோசிட்டரி.எம்டியுடன் வைத்திருத்தல்) இந்த ஆவணம் உங்கள் ஃபோர்க் செய்யப்பட்ட களஞ்சியத்தை அடிப்படை களஞ்சியத்துடன் புதுப்பித்த நிலையில் வைத்திருப்பது பற்றிய தகவலை வழங்குகிறது. இது முக்கியமானது, நீங்கள் மற்றும் பலர் திட்டத்திற்கு பங்களிப்பீர்கள் என நம்புகிறேன். > பெற்றோர் களஞ்சியத்தில் உங்கள் ஃபோர்க்கில் எந்த மாற்றமும் இல்லை என்றால், இந்தப் படிகளைப் பின்பற்றவும். ### [உறுதியை வேறு கிளைக்கு நகர்த்துதல்](ஒரு-கமிட்-டு-ஒரு-வேறு-பிராஞ்ச்.எம்டி) இந்த ஆவணம் ஒரு உறுதிமொழியை மற்றொரு கிளைக்கு எவ்வாறு மாற்றுவது என்பது பற்றிய தகவலை வழங்குகிறது. > உறுதிமொழியை வேறொரு கிளைக்கு மாற்ற இந்த நடவடிக்கைகளை எடுக்கவும். ### [ஒரு கோப்பை நீக்குதல்](நீக்குதல்-a-file.md) உங்கள் உள்ளூர் களஞ்சியத்திலிருந்து கோப்பை எவ்வாறு அகற்றுவது என்பது பற்றிய தகவலை இந்த ஆவணம் வழங்குகிறது. > உறுதிமொழிக்கு முன் ஒரு கோப்பை எவ்வாறு அகற்றுவது என்பதை அறிய, இந்தப் படிகளைப் பின்பற்றவும் ### [உங்கள் களஞ்சியத்திலிருந்து ஒரு கிளையை அகற்றுதல்](removing-branch-from-your-repository.md) இந்த ஆவணம் உங்கள் களஞ்சியத்திலிருந்து ஒரு கிளையை எவ்வாறு நீக்குவது என்பது பற்றிய தகவலை வழங்குகிறது. > உங்கள் இழுத்தல் கோரிக்கை ஒன்றிணைக்கப்பட்ட பிறகு மட்டுமே இந்தப் படிகளைச் செய்யுங்கள். ### [ஒன்றிணைப்பு மோதல்களைத் தீர்ப்பது](resolving-merge-conflicts.md) இந்த ஆவணம் ஒன்றிணைப்பு முரண்பாடுகளை எவ்வாறு தீர்ப்பது என்பது பற்றிய தகவலை வழங்குகிறது. > எரிச்சலூட்டும் ஒன்றிணைப்பு முரண்பாடுகளைத் தீர்க்க இந்தப் படிகளை எடுக்கவும். ### [ஒரு உறுதிமொழியை மாற்றுதல்](reverting-a-commit.md) இந்த ஆவணம் ரிமோட் ரிபோசிட்டரியில் ஒரு உறுதிப்பாட்டை எவ்வாறு மாற்றுவது என்பது பற்றிய தகவலை வழங்குகிறது. ஏற்கனவே கிதுப்பிற்குத் தள்ளப்பட்ட ஒரு உறுதிமொழியை நீங்கள் செயல்தவிர்க்க வேண்டும் என்றால் அது கைக்கு வரும். > உறுதிமொழியைத் திரும்பப் பெற விரும்பினால் இந்தப் படிகளைச் செய்யுங்கள். ### [Squashing Commits](squashing-commits.md) இந்த ஆவணம் ஊடாடும் மறுபேஸ் மூலம் கமிட்களை எப்படி ஸ்குவாஷ் செய்வது என்பது பற்றிய தகவலை வழங்குகிறது. > ஓப்பன் சோர்ஸ் திட்டத்தில் நீங்கள் PRஐத் திறக்க விரும்பினால் இதைப் பயன்படுத்தவும், மேலும் மதிப்பாய்வாளர் ஒவ்வொரு உறுதிப்பாட்டையும் ஒரு தகவலறிந்த கமிட் மெசேஜுடன் ஒன்றாக மாற்றும்படி கேட்கிறார். ### [உள்ளூர் உறுதியை செயல்தவிர்த்தல்](அன்டூயிங்-ஏ-கமிட்.எம்டி) இந்த ஆவணம் உங்கள் உள்ளூர் களஞ்சியத்தில் ஒரு உறுதியை எவ்வாறு செயல்தவிர்ப்பது என்பது பற்றிய தகவலை வழங்குகிறது. உங்கள் உள்ளூர் களஞ்சியத்தை நீங்கள் குழப்பிவிட்டதாக உணர்ந்து, உள்ளூர் களஞ்சியத்தை மீட்டமைக்க விரும்பினால் நீங்கள் செய்ய வேண்டியது இதுதான். > உள்ளூர் உறுதிமொழியை செயல்தவிர்க்க/மீட்டமைக்க விரும்பினால் இந்தப் படிகளைச் செய்யவும். ### [பயனுள்ள இணைப்புகள்](மேலும் கற்றலுக்கு பயனுள்ள இணைப்புகள்.md) இந்த ஆவணம் அனைத்து உதவிக்குறிப்புகள் மற்றும் தந்திரங்களுக்கான வலைத்தளங்கள், வலைப்பதிவு இடுகைகள் மற்றும் நம் வாழ்க்கையை எளிதாக்கும் பயனுள்ள தளங்களுக்கு அர்ப்பணிக்கப்பட்டுள்ளது. ஒரு தொடக்கக்காரராக இருந்தாலும் சரி, நிபுணராக இருந்தாலும் சரி, நமது தேவைகள் அனைத்திற்கும் அவை சிறந்த குறிப்பு. திறந்த மூல டொமைனில் புதியவர்கள் அல்லது மேலும் அறிய விரும்பும் அனைவருக்கும் உதவும் அனைத்து பயனுள்ள இணைப்புகளின் குறியீடாக இந்தப் பக்கம் செயல்பட வேண்டும். ### [ஒரு .gitignore கோப்பை உருவாக்குதல்](creating-a-gitignore-file.md) இந்த ஆவணம் .gitignore கோப்பு என்ன செய்கிறது, அதை ஏன் பயன்படுத்த வேண்டும் மற்றும் எப்படி .gitignore கோப்பை உருவாக்குவது என்பதை விளக்குகிறது. இந்த கோப்பு கிட்டத்தட்ட அனைத்து git திட்டங்களிலும் பயன்படுத்தப்படுகிறது. இது தேவையான கோப்புகளை மட்டுமே கிட் செய்ய உதவுகிறது. **தொழில்நுட்ப ஆவணங்களை எழுதுங்கள்** ஒரு பயன்பாடு அல்லது மென்பொருள் எவ்வாறு செயல்படுகிறது என்பதைப் பற்றி நீங்கள் எழுத முடிந்தால், அதைப் பற்றிய தொழில்நுட்ப ஆவணங்களை நீங்கள் எழுதலாம். குறிப்பாக ஓப்பன் சோர்ஸ் திட்டங்கள், பொது மக்கள் படிக்கும் வகையில் தொழில்நுட்ப ஆவணங்களை புதுப்பிக்க, புதுப்பிக்க, விரிவாக்க அல்லது உருவாக்க வேண்டும். நீங்கள் சாதாரண ஆங்கிலத்தில் எவ்வளவு அதிகமாக எழுதுகிறீர்களோ, அவ்வளவு சிறந்தது. சிறந்த பகுதி, தொழில்நுட்ப ஆவணங்களை எழுத நீங்கள் ஒரு புரோகிராமராக இருக்க வேண்டியதில்லை. ================================================ FILE: docs/additional-material/translations/Tamil/how-to-contribute-to-open-source-projects-tamil.md ================================================ # ஓபன் சோர்ஸிற்குப் பயனளிக்க எப்படி: ஒரு விரிவான வழிகாட்டி (குவிகட்டிய தொடக்கத்திற்காக) **TL;DR** - நீங்கள் ஓபன் சோர்ஸ் திட்டத்தில் உங்கள் முதல் புல் ரிக்வஸ்டை செய்ய விரும்பினால், [Readme](https://github.com/firstcontributions/first-contributions) லுள்ள வழிமுறைகளைப் பின்பற்றுங்கள். நான் ஒரு சிறிய பிழையை திருத்தும் பங்களிப்பை என் முதல் பங்களிப்பாகச் செய்கிறேன். ஓபன் சோர்ஸிற்குப் பயனளிப்பது ஒரு மென்பொருள் டெவலப்பராக வளரவும், உங்கள் போர்ட்ஃபோலியோவை உருவாக்கவும், சமூகத்திற்குப் பங்களிக்கவும் சிறந்த வழிகளில் ஒன்றாகும். நீங்கள் அனுபவம் வாய்ந்த நிரலாளராக இருந்தாலும், அல்லது புதியதாக இருந்தாலும், ஓபன் சோர்ஸ் உங்களுக்கு நிறைய கற்றல், இணைப்பு, மற்றும் தாக்கம் செலுத்தும் வாய்ப்புகளை வழங்குகிறது. இந்த வழிகாட்டியில், சரியான திட்டத்தைத் தேர்ந்தெடுப்பதிலிருந்து உங்கள் முதல் பங்களிப்பைச் செய்வது வரை, ஓபன் சோர்ஸில் பங்களிப்பதற்கான அனைத்து முக்கிய விஷயங்களையும் ஆராய்வோம். --- ## ஏன் ஓபன் சோர்ஸில் பங்களிக்க வேண்டும்? "எப்படி" என்பதைப் பார்க்கும் முன், "ஏன்" என்பதை ஆராய்வோம். ஓபன் சோர்ஸில் பங்களிப்பது பல நன்மைகளை வழங்குகிறது: - **திறமைகளை மேம்படுத்துதல்** – உண்மையான புரொஜெக்ட் கோடுகளைப் பார்க்க வாய்ப்பு கிடைக்கும், எங்கேயும் சேர முடியாத அனுபவம் கிடைக்கும். - **போர்ட்ஃபோலியோ உருவாக்கம்** – பிரபலமான ஓபன் சோர்ஸ் திட்டங்களில் பங்களிப்பது உங்கள் ரெஸ்யூமேயை மெருகூட்டும். - **நெட்வொர்க்கிங்** – உலகளாவிய டெவலப்பர்களுடன் இணைவது, புதிய விஷயங்களைப் பழகுவது. - **சமூகத்திற்குப் பங்களிக்க** – நாம் தினமும் பயன்படுத்தும் மென்பொருள்களுக்கு உதவிக்கரம் நீட்டும் வாய்ப்பு. - **வேலை வாய்ப்புகள்** – ஓபன் சோர்ஸ் அனுபவம் கொண்டவர்களை பல நிறுவனங்கள் விரும்பி பணியமர்த்துகின்றன. --- ## ஓபன் சோர்ஸில் பங்களிக்க எப்படி தொடங்கலாம்? ### 1. சரியான திட்டத்தைத் தேர்ந்தெடுங்கள் உங்களுக்குப் பொருத்தமான திட்டத்தை கண்டுபிடிப்பது முக்கியம். இதைப் பற்றிச் சில வழிகள்: - **GitHub-ஐ ஆராயுங்கள்** – ["good-first-issue"](https://github.com/search?q=label%3Agood-first-issue) போன்ற தொடக்க நபர்களுக்கான குறிச்சொற்களைப் பயன்படுத்தி தேடுங்கள். - **ஓபன் சோர்ஸ் நிகழ்ச்சிகளைப் பின்பற்றுங்கள்** – Google Summer of Code, Hacktoberfest போன்றவை சிறந்த தொடக்க புள்ளிகள். - **உங்களுக்குப் பழக்கமான கருவிகளைத் தேர்வு செய்யுங்கள்** – நீங்கள் பயன்படுத்தும் புத்தகங்கள், libraries, frameworks ஆகியவற்றில் பங்களிக்கலாம். --- ### 2. திட்டத்தைப் புரிந்துகொள்ளுங்கள் பங்களிக்க முன்பாக, திட்டத்தை முழுமையாகப் புரிந்துகொள்ள முயற்சி செய்யுங்கள்: - **README மற்றும் வழிமுறைகளை வாசிக்கவும்** – பங்களிப்பு வழிகாட்டி, கோட்பாடு (code of conduct) போன்றவற்றைப் பாருங்கள். - **கோட்பணியை ஆராயுங்கள்** – கோப்புகளின் அமைப்பு, கோடிங் ஸ்டைல் போன்றவற்றை அறிந்து கொள்ளுங்கள். - **சமூகத்தில் ஈடுபடுங்கள்** – Forums, Slack, Discord போன்ற இடங்களில் கலந்துரையாடுங்கள். --- ### 3. சிறிய பங்களிப்புகளுடன் தொடங்குங்கள் முதலில் எளிதான விடயங்களில் பங்களிக்கலாம்: - **பிழைகளை சரிசெய்யுங்கள்** – "good-first-issue" அல்லது "beginner-friendly" போன்ற குறிச்சொற்களைப் பயன்படுத்தி சரிபாருங்கள். - **ஆவணங்களை மேம்படுத்துங்கள்** – Documentation முக்கியமான பங்களிப்பு வழியாக இருக்கலாம். - **Unit Testing எழுதுங்கள்** – Code coverage அதிகரிக்க இது உதவும். --- ### 4. சிறந்த நடைமுறைகளைப் பின்பற்றுங்கள் ஒரு நிரல்பாக பங்களிக்கும்போது, திட்ட விதிமுறைகளைப் பின்பற்றுங்கள்: - **Fork & Clone செய்யுங்கள்** – உங்கள் கணக்கில் repository-ஐ fork செய்து, அதை local க்கு clone செய்யுங்கள். - **Branch-ஐ உருவாக்குங்கள்** – தனியான branch-ல் வேலை செய்யுங்கள். - **சுத்தமான கோட்களை எழுதுங்கள்** – திட்டத்திற்கேற்ப coding style-ஐ பின்பற்றுங்கள். - **Test செய்யுங்கள்** – உங்கள் மாற்றங்கள் ஏதாவது பிரச்சனை ஏற்படுத்துகிறதா என்று சரிபாருங்கள். - **Pull Request (PR) சமர்ப்பியுங்கள்** – PR-க்கு சரியான விளக்கம், issue reference, மற்றும் தயார் இருக்கும் மனப்பான்மை ஆகியவற்றுடன் சமர்ப்பியுங்கள். --- ## ஓபன் சோர்ஸில் வெற்றி பெற சில குறிப்புகள் ✅ **தெளிவாக தொடர்புகொள்ளுங்கள்** – கேள்விகள் கேளுங்கள், புல்ல ரிக்வஸ்டுக்கு மறுமொழி கொடுப்பவர்களுக்கு நன்றி சொல்லுங்கள். ✅ **தொடர்ச்சியாக பங்களியுங்கள்** – சிறிய சிறிய பங்களிப்புகள் கூட பெரிய தாக்கத்தை ஏற்படுத்தும். ✅ **விமர்சனத்திலிருந்து கற்றுக்கொள்ளுங்கள்** – Code review மூலம் மேம்படுங்கள். ✅ **மற்றவர்களுக்கு உதவுங்கள்** – புல்ல ரிக்வஸ்டுகளை மதிப்பாய்வு செய்யுங்கள், புதியவர்களை வழிநடத்துங்கள். --- ## பொதுவான சவால்கள் & அதை சமாளிக்க வழிகள் ❌ **Imposter Syndrome (நான் போதுமான திறமையுள்ளவரா? 🤔)** ➡️ எல்லோருக்கும் இது வரும். சிறிய பங்களிப்புகளாலும் பெரிய தாக்கத்தை ஏற்படுத்தலாம். ❌ **நேரம் இல்லாமை** ➡️ ஒரு வாரத்திற்கும் 30 நிமிடங்கள் செலுத்தினாலும், நீங்கள் மெல்ல வளர முடியும். ❌ **பெரிய கோட்பணியை புரிந்துகொள்வது கடினம்** ➡️ டாக்குமென்டேஷனை வாசியுங்கள், ஒரு பிரிவில் கவனம் செலுத்துங்கள், Debugging tool-களை பயன்படுத்துங்கள். --- ## முடிவுரை ஓபன் சோர்ஸில் பங்களிப்பது வளர்ச்சிக்கு மிக நல்ல வழியாகும். சிறிய செயல்களில் தொடங்குங்கள், தொடர்ந்து பங்களியுங்கள், சமூகத்தில் ஈடுபடுங்கள். ஒவ்வொரு பங்களிப்பும் ஓபன் சோர்ஸை மேம்படுத்த உதவுகிறது. 🚀 **தொடங்க தயார்?** உங்களுக்கு பிடித்த திட்டத்தை தேடுங்கள், உங்கள் முதல் பங்களிப்பைச் செய்யுங்கள், மற்றும் உலகளாவிய ஓபன் சோர்ஸ் இயக்கத்தில் சேருங்கள்! 🎉 ================================================ FILE: docs/additional-material/translations/Telugu/how-to-contribute-to-open-source-projects-telugu.md ================================================ # ఓపెన్ సోర్స్‌కు ఎలా సహకరించాలి: ప్రారంభకులకు సమగ్ర మార్గదర్శి TL;DR మీరు ఓపెన్ సోర్స్ ప్రాజెక్ట్‌కి మీ మొదటి పుల్ అభ్యర్థనను చేయాలనుకుంటున్నట్లయితే, [Readme](https://github.com/firstcontributions/first-contributions)లోని సూచనలను అనుసరించండి. డెవలపర్‌గా ఎదగడానికి, మీ పోర్ట్‌ఫోలియోను రూపొందించడానికి మరియు కమ్యూనిటీకి తిరిగి ఇవ్వడానికి ఓపెన్ సోర్స్‌కు సహకారం అందించడం అనేది అత్యంత బహుమతినిచ్చే మార్గాలలో ఒకటి. మీరు అనుభవజ్ఞుడైన ప్రోగ్రామర్ అయినా లేదా ఇప్పుడే ప్రారంభించినా, ఓపెన్ సోర్స్ తెలుసుకోవడానికి, సహకరించడానికి మరియు ప్రభావం చూపడానికి అంతులేని అవకాశాలను అందిస్తుంది. ఈ గైడ్‌లో, సరైన ప్రాజెక్ట్‌ను కనుగొనడం నుండి మీ మొదటి సహకారం అందించడం వరకు ఓపెన్ సోర్స్‌కు సహకరించడం గురించి మీరు తెలుసుకోవలసిన ప్రతిదానిని మేము మీకు తెలియజేస్తాము. ## ఓపెన్ సోర్స్‌కి ఎందుకు సహకరించాలి? "ఎలా"లోకి ప్రవేశించే ముందు, "ఎందుకు" అనేదాన్ని అన్వేషిద్దాం. ఓపెన్ సోర్స్‌కు సహకారం అందించడం వలన అనేక ప్రయోజనాలను అందిస్తుంది: * నైపుణ్యాభివృద్ధి: ఓపెన్ సోర్స్ ప్రాజెక్ట్‌లు మిమ్మల్ని వాస్తవ ప్రపంచ కోడ్‌బేస్‌లకు బహిర్గతం చేస్తాయి, మీ కోడింగ్, డీబగ్గింగ్ మరియు సహకార నైపుణ్యాలను మెరుగుపరచడంలో మీకు సహాయపడతాయి. * పోర్ట్‌ఫోలియో బిల్డింగ్: ప్రసిద్ధ ప్రాజెక్ట్‌లకు విరాళాలు మీ రెజ్యూమ్ మరియు GitHub ప్రొఫైల్‌ను మెరుగుపరుస్తాయి, తద్వారా మీరు సంభావ్య యజమానులకు ప్రత్యేకంగా నిలుస్తారు. * నెట్‌వర్కింగ్: మీరు ప్రపంచవ్యాప్తంగా ఉన్న డెవలపర్‌లతో కనెక్ట్ అవుతారు, నిపుణుల నుండి నేర్చుకుంటారు మరియు గ్లోబల్ కమ్యూనిటీలో భాగం అవుతారు. * గివింగ్ బ్యాక్: ఓపెన్ సోర్స్ మనం రోజూ ఉపయోగించే చాలా సాఫ్ట్‌వేర్‌లకు శక్తినిస్తుంది. మీరు ఆధారపడే సాధనాలు మరియు సాంకేతికతలకు మద్దతు ఇవ్వడానికి సహకారం అందించడం ఒక మార్గం. * కెరీర్ అవకాశాలు: చాలా కంపెనీలు ఓపెన్ సోర్స్ అనుభవంతో డెవలపర్‌లను చురుకుగా కోరుకుంటాయి, ఎందుకంటే ఇది చొరవ మరియు జట్టుకృషిని ప్రదర్శిస్తుంది. ## ఓపెన్ సోర్స్ కంట్రిబ్యూషన్‌లతో ఎలా ప్రారంభించాలి ### 1. సరైన ప్రాజెక్ట్‌ను ఎంచుకోండి సరైన ప్రాజెక్ట్‌ను కనుగొనడం చాలా ముఖ్యం. మీ ఆసక్తులు, నైపుణ్యం స్థాయి మరియు లక్ష్యాలకు అనుగుణంగా ఉండే ప్రాజెక్ట్‌ల కోసం చూడండి. వాటిని ఎలా కనుగొనాలో ఇక్కడ ఉంది: * GitHubని అన్వేషించండి: GitHub యొక్క అన్వేషణ పేజీని ఉపయోగించండి లేదా "గుడ్-ఫస్ట్-ఇష్యూ" లేదా "హెల్ప్-వాంటెడ్" వంటి అంశాల కోసం శోధించండి. * ఓపెన్ సోర్స్ ప్రోగ్రామ్‌లను తనిఖీ చేయండి: గూగుల్ సమ్మర్ ఆఫ్ కోడ్ లేదా హ్యాక్‌టోబర్‌ఫెస్ట్ వంటి ప్రోగ్రామ్‌లు ప్రారంభకులకు గొప్పవి. * మీ సాధనాలను అనుసరించండి: మీరు ఇప్పటికే ఉపయోగిస్తున్న లైబ్రరీలు, ఫ్రేమ్‌వర్క్‌లు లేదా సాధనాలకు సహకరించండి. ### 2. ప్రాజెక్ట్‌ను అర్థం చేసుకోండి సహకరించే ముందు, ప్రాజెక్ట్‌ను అర్థం చేసుకోవడానికి సమయాన్ని వెచ్చించండి: * డాక్యుమెంటేషన్‌ను చదవండి: README ఫైల్, సహకార మార్గదర్శకాలు మరియు ప్రవర్తనా నియమావళితో ప్రారంభించండి. * కోడ్‌బేస్‌ను అన్వేషించండి: ప్రాజెక్ట్ నిర్మాణం మరియు కోడింగ్ శైలితో మిమ్మల్ని మీరు పరిచయం చేసుకోండి. * సంఘంలో చేరండి: కమ్యూనిటీ కోసం ఒక అనుభూతిని పొందడానికి ఫోరమ్‌లు, స్లాక్ లేదా డిస్కార్డ్‌పై చర్చల్లో పాల్గొనండి. ### 3. చిన్నగా ప్రారంభించండి విశ్వాసాన్ని పెంపొందించడానికి చిన్న, నిర్వహించదగిన పనులతో ప్రారంభించండి: * బగ్‌లను పరిష్కరించండి: "మంచి-మొదటి సమస్య" లేదా "బిగినర్స్-ఫ్రెండ్లీ" అని లేబుల్ చేయబడిన సమస్యల కోసం చూడండి. * డాక్యుమెంటేషన్‌ను మెరుగుపరచండి: డాక్యుమెంటేషన్ అప్‌డేట్‌లు తరచుగా విస్మరించబడతాయి కానీ చాలా విలువైనవి. * పరీక్షలు రాయండి: పరీక్షలను జోడించడం అనేది కోడ్‌బేస్ గురించి తెలుసుకోవడానికి మరియు సహకరించడానికి ఒక గొప్ప మార్గం. ### 4. ఉత్తమ పద్ధతులను అనుసరించండి సహకరించేటప్పుడు, ప్రాజెక్ట్ మార్గదర్శకాలకు కట్టుబడి ఉండండి: * ఫోర్క్ మరియు క్లోన్: రిపోజిటరీని ఫోర్క్ చేసి మీ స్థానిక మెషీన్‌కు క్లోన్ చేయండి. * ఒక శాఖను సృష్టించండి: మీ మార్పుల కోసం ప్రత్యేక శాఖలో పని చేయండి. * క్లీన్ కోడ్ వ్రాయండి: ప్రాజెక్ట్ యొక్క కోడింగ్ ప్రమాణాలను అనుసరించండి మరియు స్పష్టమైన, సంక్షిప్త కోడ్‌ను వ్రాయండి. * మీ మార్పులను పరీక్షించండి: మీ మార్పులు ఇప్పటికే ఉన్న కార్యాచరణను విచ్ఛిన్నం చేయలేదని నిర్ధారించుకోండి. * ఒక పుల్ అభ్యర్థన (PR) సమర్పించండి: స్పష్టమైన PR వివరణ, సూచన సంబంధిత సమస్యలను వ్రాయండి మరియు అభిప్రాయానికి సిద్ధంగా ఉండండి. ## ఓపెన్ సోర్స్‌లో విజయం కోసం చిట్కాలు ప్రభావవంతంగా కమ్యూనికేట్ చేయండి: అన్ని పరస్పర చర్యలలో గౌరవప్రదంగా మరియు వృత్తిపరంగా ఉండండి. అవసరాల గురించి అస్పష్టంగా ఉన్నప్పుడు ప్రశ్నలు అడగండి. సమీక్షకులకు వారి సమయం మరియు అభిప్రాయానికి ధన్యవాదాలు. సమీక్ష ప్రక్రియలో ఓపికగా ఉండండి స్థిరంగా ఉండండి: రెగ్యులర్ కంట్రిబ్యూషన్‌లు, చిన్నవి కూడా, కాలక్రమేణా పెద్ద ప్రభావాన్ని చూపుతాయి. అభిప్రాయం నుండి నేర్చుకోండి: కోడ్ సమీక్షలు నేర్చుకునే అవకాశం. అభిప్రాయాన్ని స్వీకరించండి మరియు మీ నైపుణ్యాలను మెరుగుపరచండి. తిరిగి ఇవ్వండి: మీరు సౌకర్యవంతంగా ఉన్న తర్వాత, PRలను సమీక్షించడం, ప్రశ్నలకు సమాధానం ఇవ్వడం లేదా కొత్తవారికి మార్గదర్శకత్వం చేయడం ద్వారా ఇతరులకు సహాయం చేయండి. ## సాధారణ సవాళ్లు మరియు వాటిని ఎలా అధిగమించాలి * ఇంపోస్టర్ సిండ్రోమ్: చాలా మంది ప్రారంభకులు తమకు సహకరించడానికి తగినంత నైపుణ్యం లేదని భావిస్తారు. గుర్తుంచుకోండి, ప్రతి ఒక్కరూ ఎక్కడో ఒకచోట ప్రారంభించబడతారు మరియు చిన్న విరాళాలు కూడా ముఖ్యమైనవి. * సమయాన్ని కనుగొనడం: చిన్న, నిర్వహించదగిన పనులతో ప్రారంభించండి. వారానికి 30 నిమిషాలు కూడా తేడా రావచ్చు. * పెద్ద కోడ్‌బేస్‌లను నావిగేట్ చేయడం: అభ్యాస ప్రక్రియను విచ్ఛిన్నం చేయండి: - డాక్యుమెంటేషన్‌ను పూర్తిగా చదవడం ద్వారా ప్రారంభించండి - ఒక సమయంలో ఒక భాగాన్ని అర్థం చేసుకోవడంపై దృష్టి పెట్టండి - కోడ్ అమలును ట్రేస్ చేయడానికి డీబగ్గింగ్ సాధనాలను ఉపయోగించండి - స్పష్టత కోసం అడగడానికి వెనుకాడకండి ## తీర్మానం ఓపెన్ సోర్స్‌కు సహకరించడం అనేది అపారమైన వ్యక్తిగత మరియు వృత్తిపరమైన వృద్ధిని అందించే ప్రయాణం. చిన్నగా ప్రారంభించడం ద్వారా, స్థిరంగా ఉండటం మరియు సంఘంతో సన్నిహితంగా ఉండటం ద్వారా, మీరు మీ నైపుణ్యాలను మెరుగుపరుచుకుంటూ అర్ధవంతమైన సహకారాన్ని అందించవచ్చు. గుర్తుంచుకోండి, ఓపెన్ సోర్స్ సహకారంతో అభివృద్ధి చెందుతుంది మరియు ప్రతి సహకారం-ఎంత చిన్నదైనా-మెరుగైన డిజిటల్ ప్రపంచాన్ని నిర్మించడంలో సహాయపడుతుంది. మునిగిపోవడానికి సిద్ధంగా ఉన్నారా? మిమ్మల్ని ఉత్తేజపరిచే ప్రాజెక్ట్‌ను కనుగొనండి, మీ మొదటి సహకారాన్ని అందించండి మరియు ఈరోజే గ్లోబల్ ఓపెన్ సోర్స్ ఉద్యమంలో చేరండి! ## చివరి సమాధా ================================================ FILE: docs/additional-material/translations/Telugu/ప్రోగ్రామింగ్ తెలియని వ్యక్తి చేయగల పనులు.md ================================================ # ప్రోగ్రామింగ్ తెలియని వ్యక్తి చేయగల పనులు ## వినడం ప్రారంభించండి ఓపెన్ సోర్స్ లో ప్రతిదీ ఇతరులతో అనుసంధానంగా ఉంటుంది. మీరు ఒక టీమ్ లో చేరాలని చూస్తున్నారు, అంటే ఆ కమ్యూనిటీ మరియు అది ఎలా పనిచేస్తుందో అర్థం చేసుకోవాలి. ఒక ప్రాజెక్ట్ లోకి వెళ్లి "హాయ్, ఈ ప్రాజెక్ట్ ఇలా చేయాలి అని నేను అనుకుంటున్నాను" అని చెప్పడం సాధారణంగా మంచిదిగా భావించబడదు. కొన్ని ప్రాజెక్టులు ఆ విధమైన దృష్టికోణాన్ని స్వాగతించవచ్చు, కానీ ప్రాజెక్ట్ కొన్ని కాలంగా నడుస్తూ ఉంటే, ఆ దృష్టికోణాన్ని ఆమోదించే అవకాశం చాలా తక్కువ. **ప్రాజెక్ట్ కి అవసరమేమిటో తెలుసుకోవడానికి వినడం ఉత్తమ మార్గం.** 1. **మెయిలింగ్ లిస్ట్ లో చేరండి**: చాలా ప్రాజెక్టుల కోసం మెయిలింగ్ లిస్ట్ ప్రధాన కమ్యూనికేషన్ పద్ధతి. పొడవైన ప్రాజెక్టుల్లో ఎన్నో మెయిలింగ్ లిస్ట్ లు ఉంటాయి. ఉదాహరణకు, PostgreSQL ప్రాజెక్ట్ కు కనీసం 12 యూజర్-ఆధారిత లిస్ట్ లు మరియు 6 డెవలపర్ లిస్ట్ లు ఉన్నాయి. ముఖ్యమైన యూజర్-ఆధారిత లిస్ట్ మరియు కోర్ డెవలపర్ లిస్ట్ ను ఫాలో కావడం మొదలుపెట్టండి. 2. **బ్లాగ్ ఫాలో చేయండి**: కోర్ డెవలపర్లు నిర్వహించే బ్లాగులు భవిష్యత్ అప్డేట్స్ గురించి సమాచారం ఇస్తాయి. ఒక ప్రాజెక్ట్ కి సంబంధించి పలు మూలాల నుండి వచ్చిన వార్తలను ఒక చోట చేరదీసే ప్లానెట్ సైట్ ఉంటే, అది మొదటి ప్రాధాన్యత. గూగుల్ లో "ప్లానెట్ <ప్రాజెక్ట్ పేరు>" అని వెతకండి. 3. **IRC ఛానల్ లో చేరండి**: చాలా ఓపెన్ సోర్స్ ప్రాజెక్టులకి ప్రత్యేకమైన ఇంటర్నెట్ రీలే చాట్ (IRC) ఛానల్స్ ఉంటాయి. ఇవి సమస్యలు మరియు డెవలప్మెంట్ గురించి చర్చించడానికి ఉపయోగపడతాయి. ప్రాజెక్ట్ వెబ్‌సైట్ లోకి వెళ్లి ఆ ఛానల్ పేరు మరియు అది ఏ IRC నెట్వర్క్ పై ఉందో తెలుసుకోండి. **టికెట్లతో పని చేయండి** ఒక ప్రాజెక్ట్ లో కోడ్ తప్పనిసరి అయినప్పటికీ, కోడ్ రాయడం మాత్రమే కాంట్రిబ్యూట్ చేయడం కాదు. కొత్త ఫీచర్లను సృష్టించడం మరియు బగ్ లను సరిచేయడం కోసం కోడ్ నిర్వహణను మర్చిపోతారు. ఇలాంటి neglected ప్రాంతాల్లో పని చేయడం ప్రాజెక్ట్ లో చేరడానికి ఉత్తమ మార్గం. 4. **బగ్ ని డయాగ్నోస్ చేయండి**: చాలా సందర్భాల్లో బగ్ రిపోర్ట్ చేయడం సరైన విధంగా జరగదు. మీరు బగ్ ని కొంచెం నిశితంగా విశ్లేషిస్తే, డెవలపర్ల సమయాన్ని ఆదా చేయగలరు. ఉదాహరణకు, "సాఫ్ట్‌వేర్ పనిచేయడం లేదు" అని రిపోర్ట్ చేస్తే, అది ఎందుకు జరుగుతుందో తెలపడానికి ప్రయత్నించండి. మీరు కనుగొన్న ప్రతిదాన్ని టికెట్ లో చేరదీసి అందరికి అందుబాటులో ఉంచండి. 5. **పాత బగ్ లను క్లోజ్ చేయండి**: బగ్ లను కోడ్ బేస్ లో ఫిక్స్ చేసినప్పటికీ, టికెటింగ్ సిస్టమ్ లో అప్‌డేట్ చేయడం మర్చిపోతారు. సాఫ్ట్‌వేర్ తాజా వెర్షన్ తో బగ్ పనితీరుని పరీక్షించి, అవసరమైన మార్పులు చేయండి. **కోడ్ తో పని చేయండి** ప్రజలు అనుభవ స్థాయిని పరిగణనలోకి తీసుకోకుండా ప్రాజెక్ట్ కోడ్ లో సహాయపడవచ్చు. 6. **బీటా వెర్షన్ ని పరీక్షించండి**: ఒక సాఫ్ట్‌వేర్ విభిన్న ప్లాట్‌ఫారమ్‌లపై ఎలా పనిచేస్తుందో పరిశీలించండి. కేవలం డౌన్‌లోడ్ చేసి, టెస్ట్ చేయడం ద్వారా ప్రాజెక్ట్ కు విలువైన ఫీడ్బ్యాక్ ఇస్తారు. 7. **బగ్ ని ఫిక్స్ చేయండి**: ఇది ప్రారంభించడానికి సరైన మార్గం. టికెటింగ్ సిస్టమ్ లో ఒక బగ్ ని ఎంచుకుని దాన్ని ఫిక్స్ చేయండి. 8. **టెస్ట్ రాయండి**: ప్రాజెక్ట్ టెస్ట్ సూట్ ని మెరుగుపరచండి. 9. **కంపైలర్ వార్నింగ్ ను సైలెన్స్ చేయండి**: సాధారణంగా సాఫ్ట్‌వేర్ లో ఉండే చిన్న వార్నింగ్‌లను పరిష్కరించడం ద్వారా డెవలప్ మెంట్ నాణ్యతను మెరుగుపరచండి. 10. **కామెంట్ జోడించండి**: కోడ్ లో క్లారిటీ కోసం అవసరమైన చోట కామెంట్స్ జోడించండి. **డాక్యుమెంటేషన్ తో పని చేయండి** డాక్యుమెంటేషన్ పై పని చేయడం ప్రాజెక్ట్ కి చాలా విలువైనది. 11. **ఉదాహరణలు సృష్టించండి**: సాఫ్ట్‌వేర్ ఉపయోగాన్ని వివరిస్తూ మంచి ఉదాహరణలు ఇవ్వండి. **కమ్యూనిటీ తో పని చేయండి** ఓపెన్ సోర్స్ లో కమ్యూనిటీ చాలా ముఖ్యమైనది. 12. **ప్రశ్నకు సమాధానం ఇవ్వండి**: కొత్తవారికి సహాయం చేయడం ద్వారా కమ్యూనిటీ అభివృద్ధి చెందుతుంది. 13. **బ్లాగ్ పోస్ట్ రాయండి**: మీ అనుభవాల గురించి రాయడం ద్వారా ప్రాజెక్ట్‌కు ప్రచారం చేయండి. 14. **వెబ్‌సైట్ మెరుగుపరచండి**: వెబ్‌సైట్ డిజైన్ మరియు లేఅవుట్ మెరుగుపరచడం ద్వారా ప్రాజెక్ట్ ఇమేజ్ ని మెరుగుపరచండి. 15. **టెక్నికల్ డాక్యుమెంటేషన్ రాయండి**: సాఫ్ట్‌వేర్ పని విధానంపై సులభమైన మరియు స్పష్టమైన డాక్యుమెంటేషన్ ఇవ్వండి. 16. **మరెవరితోనైనా పంచుకోండి మరియు నేర్పండి**: ఇది నేర్చుకోవడానికి ఉత్తమ మార్గం మరియు ఇతరులకు సహాయం చేసే పద్ధతి. **ముఖ్యమైనది: ఇతరుల మాటలు వినండి మరియు ప్రాజెక్ట్ లో అవసరమేదో గుర్తించండి.** ================================================ FILE: docs/additional-material/translations/Thai/Things a non Programmer can do.th.md ================================================ #สิ่งที่คนที่ไม่ใช่โปรแกรมเมอร์สามารถทำได้ ## เริ่มฟัง ทุกสิ่งในโอเพ่นซอร์สเกี่ยวข้องกับบุคคลอื่น คุณกำลังมองหาที่จะเข้าร่วมทีม และนั่นหมายถึงการทำความเข้าใจชุมชนและวิธีการทำงาน การเดินเข้าไปในโปรเจ็กต์แล้วพูดว่า "สวัสดี นี่คือสิ่งที่ฉันคิดว่าโปรเจ็กต์นี้ควรทำ" มักจะไม่ถือเป็นเรื่องดี บางโครงการอาจยินดีกับแนวทางดังกล่าว แต่หากโครงการดำเนินไประยะหนึ่งแล้ว โอกาสที่ทัศนคตินั้นจะได้รับการยอมรับก็มีน้อย **การฟังเป็นวิธีที่ดีที่สุดในการรู้ว่าโครงการต้องการอะไร** 1. **เข้าร่วมรายชื่ออีเมล**: สำหรับหลายโครงการ รายชื่ออีเมลเป็นช่องทางหลักในการสื่อสารเกี่ยวกับการพัฒนาโครงการ ในโครงการขนาดใหญ่ มีรายชื่อผู้รับจดหมายให้เลือกมากมาย ตัวอย่างเช่น โครงการ PostgreSQL มีรายชื่อผู้ใช้ไม่น้อยกว่า 12 รายการ และรายชื่อนักพัฒนาอีก 6 รายการในหน้ารายชื่อผู้รับเมล ฉันขอแนะนำให้คุณปฏิบัติตามรายการหลักที่มุ่งเน้นผู้ใช้และรายชื่อนักพัฒนาหลักที่จะเริ่มฟัง 2. **ติดตามบล็อก**: บล็อกที่ดูแลโดยนักพัฒนาหลักมักจะให้ข้อมูลเกี่ยวกับสิ่งที่จะเกิดขึ้นในอนาคต และสิ่งที่ต้องทำเพื่อไปถึงที่นั่น ไซต์ Planet รวบรวมข่าวสารและบล็อกจากแหล่งต่างๆ ที่เกี่ยวข้องกับโครงการ หากมีไซต์ planet เช่น planet.gnome.org หรือ planet.mysql.com ให้เริ่มต้นจากที่นั่น เพียงค้นหา Google ด้วยคำว่า "planet " 3. **เข้าร่วมช่อง IRC**: โครงการโอเพ่นซอร์สจำนวนมากมีช่อง Internet Relay Chat (IRC) โดยเฉพาะ ซึ่งนักพัฒนาและผู้ใช้ออกไปเที่ยวเพื่อหารือเกี่ยวกับปัญหาและการพัฒนา ตรวจสอบเว็บไซต์ของโครงการเพื่อดูรายละเอียดว่าช่องดังกล่าวเรียกว่าอะไรและพบเครือข่าย IRC ใด **ทำงานกับตั๋ว** โค้ดเป็นหัวใจสำคัญของโครงการโอเพ่นซอร์ส แต่อย่าคิดว่าการเขียนโค้ดเป็นเพียงวิธีเดียวที่จะมีส่วนร่วม การบำรุงรักษาโค้ดและระบบที่อยู่รอบๆ โค้ดมักถูกละเลยในการสร้างคุณสมบัติใหม่ๆ และแก้ไขข้อบกพร่อง มองว่าพื้นที่เหล่านี้เป็นวิธีง่ายๆ ในการก้าวเข้าสู่โครงการ โครงการส่วนใหญ่มีระบบตั๋วแจ้งปัญหาที่เปิดเผยต่อสาธารณะ ซึ่งเชื่อมโยงจากหน้าแรกของเว็บไซต์ของโครงการและรวมอยู่ในเอกสารประกอบ เป็นช่องทางหลักในการสื่อสารระหว่างผู้ใช้และนักพัฒนา การทำให้เป็นปัจจุบันเป็นวิธีที่ดีในการช่วยโครงการ คุณอาจต้องได้รับสิทธิ์พิเศษในระบบตั๋ว ซึ่งหัวหน้าโครงการส่วนใหญ่ยินดีที่จะให้คุณเมื่อคุณบอกว่าต้องการช่วยทำความสะอาดตั๋ว 4. **วินิจฉัยจุดบกพร่อง**: มักมีการรายงานจุดบกพร่องไม่ดี การวินิจฉัยและคัดแยกจุดบกพร่องสามารถช่วยให้นักพัฒนาประหยัดเวลาโดยต้องอาศัยการทำงานที่ถูกต้องในการหาลักษณะเฉพาะของปัญหา หากผู้ใช้รายงานว่า "ซอฟต์แวร์ไม่ทำงานเมื่อฉันทำ X" ใช้เวลาสักพักเพื่อหาสาเหตุเฉพาะของปัญหานั้น มันทำซ้ำได้หรือไม่? คุณสามารถสร้างชุดขั้นตอนเพื่อทำให้เกิดปัญหาซ้ำๆ ได้หรือไม่ คุณสามารถจำกัดปัญหาให้แคบลง เช่น เกิดขึ้นในเบราว์เซอร์เดียวแต่ไม่เกิดขึ้นอีก หรือหนึ่ง distro แต่ไม่ได้เกิดขึ้นที่อื่น แม้ว่าคุณจะไม่รู้ว่าอะไรเป็นสาเหตุของปัญหา แต่ความพยายามที่คุณพยายามจำกัดสถานการณ์ให้แคบลงจะทำให้คนอื่นแก้ไขได้ง่ายขึ้น สิ่งที่คุณค้นพบ เพิ่มลงในตั๋วในระบบบั๊กเพื่อให้ทุกคนได้เห็น 5. **ปิดจุดบกพร่องที่แก้ไขแล้ว**: บ่อยครั้งจุดบกพร่องได้รับการแก้ไขในโค้ดเบส แต่ตั๋วที่รายงานเกี่ยวกับจุดบกพร่องเหล่านั้นไม่ได้รับการอัปเดตในระบบตั๋ว การทำความสะอาดสิ่งที่ค้างอยู่นี้อาจใช้เวลานาน แต่ก็มีคุณค่าต่อทั้งโครงการ เริ่มต้นด้วยการสืบค้นระบบตั๋วสำหรับตั๋วที่มีอายุมากกว่าหนึ่งปีและดูว่ายังมีจุดบกพร่องอยู่หรือไม่ ตรวจสอบบันทึกการเปลี่ยนแปลงการเปิดตัวของโปรเจ็กต์เพื่อดูว่าจุดบกพร่องได้รับการแก้ไขและสามารถปิดได้หรือไม่ หากทราบว่าได้รับการแก้ไขแล้ว ให้จดหมายเลขเวอร์ชันไว้ในตั๋วแล้วปิด ลองสร้างจุดบกพร่องขึ้นใหม่ด้วยซอฟต์แวร์เวอร์ชันล่าสุด หากไม่สามารถสร้างใหม่ด้วยเวอร์ชันล่าสุดได้โปรดทราบว่าในตั๋วแล้วปิด หากยังมีอยู่ให้สังเกตในตั๋วด้วยและเปิดทิ้งไว้ การทำงานกับโค้ด โปรแกรมเมอร์ทุกระดับประสบการณ์สามารถช่วยเขียนโค้ดในโปรเจ็กต์ได้ อย่าคิดว่าคุณจะต้องเป็นอัจฉริยะด้านการเขียนโค้ดจึงจะมีส่วนร่วมกับโปรเจ็กต์ที่คุณชื่นชอบได้อย่างแท้จริง หากงานของคุณเกี่ยวข้องกับการแก้ไขโค้ด ให้ตรวจสอบวิธีการที่โปรเจ็กต์ใช้ในการรับโค้ดจากผู้ร่วมให้ข้อมูล แต่ละโปรเจ็กต์มีขั้นตอนการทำงานของตัวเอง ดังนั้นโปรดสอบถามวิธีการดำเนินการก่อนที่คุณจะเริ่มส่งโค้ด ตัวอย่างเช่น โครงการ PostgreSQL มีกระบวนการที่เข้มงวดมาก: การแก้ไขโค้ดจะถูกส่งในรูปแบบแพตช์ไปยังรายชื่ออีเมล ซึ่งนักพัฒนาหลักจะพิจารณาทุกแง่มุมของการเปลี่ยนแปลง อีกด้านหนึ่งเป็นโปรเจ็กต์อย่าง Parrot ที่ง่ายต่อการรับสิทธิ์ในโค้ดเบส หากโปรเจ็กต์ใช้ GitHub อาจมีเวิร์กโฟลว์ที่ใช้ฟีเจอร์คำขอดึงของ GitHub ไม่มีสองโครงการที่เหมือนกัน เมื่อใดก็ตามที่คุณแก้ไขโค้ด ตรวจสอบให้แน่ใจว่าคุณทำหน้าที่เป็นสมาชิกที่มีความรับผิดชอบของชุมชน และรักษารูปแบบโค้ดของคุณให้ตรงกับโค้ดเบสที่เหลือ โค้ดที่คุณเพิ่มหรือแก้ไขควรมีลักษณะเหมือนกับโค้ดที่เหลือ คุณอาจไม่ชอบรูปแบบการค้ำยันหรือการจัดการช่องว่างสำหรับการเยื้อง แต่การส่งการเปลี่ยนแปลงโค้ดที่ไม่ตรงกับมาตรฐานที่มีอยู่ถือเป็นเรื่องหยาบคาย มันเหมือนกับการพูดว่า "ฉันไม่ชอบสไตล์ของคุณ และฉันคิดว่าสไตล์ของฉันดีกว่า ดังนั้นคุณควรทำในแบบของฉัน" 6. **ทดสอบตัวเลือกเบต้าหรือรีลีส**: โปรเจ็กต์ใดๆ ก็ตามที่ออกแบบมาให้ทำงานบนหลายแพลตฟอร์มอาจมีปัญหาด้านการพกพาได้ทุกประเภท เมื่อใกล้ถึงการเปิดตัวและมีการเผยแพร่ตัวเลือกเบต้าหรือตัวเลือกการเปิดตัว หัวหน้าโครงการหวังว่าจะได้รับการทดสอบโดยผู้คนจำนวนมากบนแพลตฟอร์มที่แตกต่างกัน คุณสามารถเป็นหนึ่งในคนเหล่านั้นและช่วยให้แน่ใจว่าแพ็คเกจใช้งานได้บนแพลตฟอร์มของคุณ โดยทั่วไปคุณเพียงแค่ต้องดาวน์โหลด สร้าง และทดสอบซอฟต์แวร์ แต่มูลค่าของโปรเจ็กต์อาจมีมหาศาลหากคุณใช้การแจกจ่ายหรือฮาร์ดแวร์ที่ไม่ธรรมดา เพียงรายงานกลับมาว่างานสร้างและทดสอบช่วยให้ผู้นำโครงการทราบว่าการเปิดตัวที่กำลังจะเกิดขึ้นนั้นแข็งแกร่ง 7. **แก้ไขข้อบกพร่อง**: โดยปกติจะเป็นจุดที่ผู้มีส่วนร่วมต้องการเริ่มเขียนโค้ด ง่ายมาก: ค้นหาข้อบกพร่องที่ฟังดูน่าสนใจในระบบตั๋วแล้วลองแก้ไขในโค้ด บันทึกการแก้ไขไว้ในโค้ดหากเหมาะสม เป็นความคิดที่ดีที่จะเพิ่มการทดสอบลงในชุดการทดสอบเพื่อทดสอบจุดของโค้ดที่คุณแก้ไข บางโครงการจำเป็นต้องมีการแก้ไขข้อบกพร่องเพื่อรวมการทดสอบ จดบันทึกเมื่อคุณสำรวจโค้ดเบสที่ไม่คุ้นเคยนี้ แม้ว่าคุณจะไม่สามารถแก้ไขจุดบกพร่องได้ ให้บันทึกสิ่งที่คุณค้นพบไว้ในตั๋วเพื่อเป็นส่วนหนึ่งของความพยายามในการแก้ไข สิ่งที่คุณพบจะช่วยเหลือผู้ที่ตามหลังคุณ 8. **เขียนแบบทดสอบ**: โปรเจ็กต์ส่วนใหญ่มีชุดทดสอบที่ทดสอบโค้ด แต่ก็ยากที่จะจินตนาการถึงชุดทดสอบที่ไม่สามารถเพิ่มการทดสอบเข้าไปได้อีก ใช้เครื่องมือความครอบคลุมการทดสอบ เช่น gcov สำหรับ C หรือ Devel::Cover สำหรับ Perl เพื่อระบุพื้นที่ในซอร์สโค้ดที่ไม่ได้รับการทดสอบโดยชุดทดสอบ จากนั้นจึงเพิ่มการทดสอบลงในชุดเพื่อให้ครอบคลุม 9. **ปิดเสียงคำเตือนคอมไพเลอร์**: กระบวนการสร้างสำหรับโปรเจ็กต์ที่ใช้ C จำนวนมากมักจะพ่นแฟล็กคำเตือนคอมไพเลอร์แปลก ๆ ไปที่หน้าจอ คำเตือนเหล่านี้มักจะไม่ใช่ตัวบ่งชี้ปัญหา แต่อาจมีลักษณะเช่นนั้นได้ การมีคำเตือนมากเกินไปอาจทำให้คอมไพเลอร์ดูเหมือนกำลังร้องไห้ ตรวจสอบว่าโค้ดสามารถซ่อนจุดบกพร่องได้จริงหรือไม่ ถ้าไม่เช่นนั้น การแก้ไขแหล่งที่มาเป็นความเงียบจะช่วยซ่อนผลบวกลวงเหล่านี้ได้ 10. **เพิ่มความคิดเห็น**: เมื่อคุณค้นหาโค้ด คุณอาจพบจุดที่สร้างความสับสน มีโอกาสเกิดขึ้นว่าหากคุณสับสน คนอื่นๆ ก็จะสับสนเช่นกัน บันทึกไว้ในโค้ดและส่งแพตช์ ทำงานกับเอกสาร โดยทั่วไปการจัดทำเอกสารจะเป็นส่วนหนึ่งของโครงการที่ใช้เวลาไม่นาน นอกจากนี้ยังอาจต้องทนทุกข์ทรมานจากการเขียนจากมุมมองของผู้ที่คุ้นเคยกับโครงการ แทนที่จะผ่านสายตาของคนที่เพิ่งเข้ามา หากคุณเคยอ่านเอกสารของโครงการโดยคิดว่า "ดูเหมือนว่าคู่มือนี้คาดหวังให้ฉันรู้วิธีใช้แพ็คเกจอยู่แล้ว" คุณจะรู้ว่าฉันกำลังพูดถึงอะไร บ่อยครั้งที่สายตาที่สดใสสามารถชี้ให้เห็นข้อบกพร่องในเอกสารที่ผู้ใกล้ชิดกับโครงการไม่สังเกตเห็น 11. **สร้างตัวอย่าง**: ไม่มีโปรเจ็กต์ใดที่มีตัวอย่างวิธีปฏิบัติมากเกินไป ไม่ว่าจะเป็นเว็บ API, ไลบรารีของกิจวัตร, แอป GUI เช่น Gimp หรือเครื่องมือบรรทัดคำสั่ง ตัวอย่างที่ดีของการใช้งานที่เหมาะสมสามารถอธิบายการใช้งานซอฟต์แวร์ที่เหมาะสมได้ชัดเจนและรวดเร็วกว่าหน้าเอกสารประกอบ สำหรับ API หรือไลบรารี ให้สร้างโปรแกรมตัวอย่างที่ใช้เครื่องมือนี้ สิ่งนี้สามารถดึงออกมาจากโค้ดที่คุณเขียนได้ โดยตัดทอนให้เหลือเพียงสิ่งจำเป็นเท่านั้น สำหรับเครื่องมือ ให้แสดงตัวอย่างการใช้งานจริงของคุณในชีวิตประจำวัน หากคุณมุ่งเน้นด้านการมองเห็น ลองพิจารณาสร้างภาพหน้าจอของกระบวนการสำคัญ เช่น วิธีการติดตั้งแอพพลิเคชั่น ทำงานร่วมกับชุมชน โอเพ่นซอร์สเป็นเพียงบางส่วนเกี่ยวกับโค้ดเท่านั้น ชุมชนทำให้โอเพ่นซอร์สทำงานได้ ต่อไปนี้เป็นวิธีที่คุณสามารถช่วยสร้างมันขึ้นมาได้ 12. **ตอบคำถาม**: วิธีที่ดีที่สุดในการช่วยสร้างชุมชนคือการช่วยเหลือผู้อื่น การตอบคำถาม โดยเฉพาะอย่างยิ่งจากคนที่เพิ่งเริ่มสนใจ เป็นสิ่งสำคัญอย่างยิ่งในการช่วยให้โครงการเติบโตและประสบความสำเร็จ เวลาที่คุณใช้ในการช่วยเหลือผู้เริ่มต้น แม้ว่าพวกเขาจะถามคำถามที่คุณสามารถยกเลิก "RTFM" สั้นๆ ได้อย่างง่ายดาย แต่ก็ให้ผลตอบแทนที่คุ้มค่าในการรับสมาชิกที่กระตือรือร้นอีกคนในชุมชน ทุกคนเริ่มต้นจากที่ไหนสักแห่ง และโครงการต่างๆ จำเป็นต้องมีผู้คนหลั่งไหลเข้ามาอย่างต่อเนื่องหากพวกเขายังคงมีความสำคัญ 13. **เขียนโพสต์บนบล็อก**: หากคุณมีบล็อก ให้เขียนเกี่ยวกับประสบการณ์ของคุณกับโครงการที่คุณกำลังใช้อยู่ บอกเกี่ยวกับปัญหาที่คุณพบในการใช้ซอฟต์แวร์และสิ่งที่คุณทำเพื่อแก้ไข คุณจะช่วยเหลือได้สองวิธี โดยทั้งสองวิธีช่วยให้โครงการนี้อยู่ในใจของผู้อื่นรอบตัวคุณ และด้วยการสร้างบันทึกสำหรับใครก็ตามที่มีปัญหาของคุณในอนาคตและค้นหาคำตอบในเว็บ (บล็อกเกี่ยวกับการผจญภัยทางเทคนิคของคุณยังเป็นวิธีที่ยอดเยี่ยมในการแสดงประสบการณ์ในโลกแห่งความเป็นจริงกับซอฟต์แวร์ดังกล่าวในครั้งต่อไปที่คุณหางานโดยใช้ซอฟต์แวร์ดังกล่าว) 14. **ปรับปรุงเว็บไซต์**: หากคุณมีทักษะในการออกแบบเว็บไซต์และสามารถช่วยปรับปรุงเว็บไซต์ได้ และส่งผลให้โครงการมีภาพลักษณ์ที่เปิดเผยต่อสาธารณะ ก็ถือว่าใช้เวลาอย่างดี บางทีโปรเจ็กต์อาจใช้การยกเครื่องกราฟิกหรือโลโก้เพื่อระบุโปรเจ็กต์ สิ่งเหล่านี้อาจเป็นทักษะที่ขาดในชุมชน ฉันรู้ว่าฉันจะยินดีมากหากได้รับความช่วยเหลือด้านการออกแบบกราฟิกบนเว็บไซต์โครงการของฉัน 15. **เขียนเอกสารทางเทคนิค** หากคุณสามารถเขียนเกี่ยวกับวิธีการทำงานของแอปพลิเคชันหรือซอฟต์แวร์ได้ คุณสามารถเขียนเอกสารทางเทคนิคเกี่ยวกับแอปพลิเคชันหรือซอฟต์แวร์นั้นได้ โดยเฉพาะโครงการโอเพ่นซอร์สที่ต้องการอัปเดต ปรับปรุง ขยาย หรือสร้างเอกสารทางเทคนิคให้บุคคลทั่วไปได้อ่าน ยิ่งคุณเขียนภาษาอังกฤษธรรมดามากเท่าไรก็ยิ่งดีเท่านั้น ส่วนที่ดีที่สุด คุณไม่จำเป็นต้องเป็นโปรแกรมเมอร์จึงจะเขียนเอกสารทางเทคนิคได้ สิ่งสำคัญที่สุดคือฟังสิ่งที่คนรอบตัวคุณพูดคุยกัน ดูว่าคุณสามารถรับรู้ถึงความจำเป็นเร่งด่วนหรือไม่ ตัวอย่างเช่น เมื่อเร็ว ๆ นี้ในรายชื่อผู้รับจดหมายของนักพัฒนา Parrot มีการตัดสินใจที่จะใช้ GitHub เป็นระบบตั๋วปัญหา โดยละทิ้งการติดตั้ง Trac แบบเก่าที่พวกเขามี บางคนไม่เห็นด้วยกับการเคลื่อนไหวนี้เนื่องจากไม่มีทางที่จะแปลงตั๋วเป็นระบบของ GitHub ได้ หลังจากทะเลาะกันมาทั้งวัน ฉันก็พูดขึ้นและพูดว่า "ถ้าฉันเขียนตัวแปลงล่ะ" ผู้คนต่างตื่นเต้นกับความคิดนี้ ฉันใช้เวลาเขียนโปรแกรมแปลงตั๋วสำหรับตั๋วมากกว่า 450 ใบ ดังนั้นเราจึงไม่สูญเสียประวัติตั๋วเลย มันเป็นความสำเร็จที่ยิ่งใหญ่. ฉันได้เข้าร่วม และนักพัฒนาหลักยังคงมุ่งเน้นไปที่ธุรกิจการทำงานกับ Parrot 16. **สอนและช่วยเหลือผู้อื่น**: วิธีที่ดีที่สุดในการเรียนรู้เพิ่มเติมเกี่ยวกับหัวข้อใดหัวข้อหนึ่งคือการพยายามสอนหัวข้อนั้น ครูที่ดีที่สุดคือผู้ที่สามารถอธิบายเรื่องที่ซับซ้อนด้วยตัวอย่างง่ายๆ ดังนั้นคุณต้องพยายามเป็นครูที่ดีที่สุดเพื่อเป็นผู้เรียนที่ดีที่สุดและดีที่สุดในโลกการเขียนโปรแกรมของคุณ การสอนผู้อื่นจะทำให้คุณรู้สึกดีกับตัวเองมากขึ้น และจะช่วยให้คุณได้รับทักษะและความรู้ในวิชาชีพที่ดีขึ้นด้วย เมื่อคุณได้รับความช่วยเหลือจากใครสักคน อย่าเก็บมันไว้คนเดียว แบ่งปันกับผู้อื่น ทำให้โลกน่าอยู่ยิ่งขึ้น ================================================ FILE: docs/additional-material/translations/Things a non Programmer can do.ar.md ================================================ # ما يمكن لغير المبرمج القيام به ## كن متأنيًا في مجال البرمجيات مفتوحة المصدر، كل خطوة، سواء كانت برمجة أو جوانب أخرى، تتطلب مساهمة وتفاعل من الآخرين. الانضمام إلى فريق مفتوح المصدر يعني فهم ديناميكيات المجتمع وطريقة عمله. بدلاً من الوصول إلى مشروع والقول فورًا "هذا ما أعتقد أن المشروع يجب أن يفعله"، من الأفضل غالبًا اتباع نهج أكثر انتباهًا. بعض المشاريع قد ترحب بهذا النهج، لكن إذا كان المشروع قائمًا منذ فترة، فإن احتمالية قبول هذا السلوك تكون منخفضة. الاستماع هو أفضل طريقة لمعرفة ما يحتاجه المشروع. 1. **الاشتراك في قائمة بريدية**: بالنسبة للعديد من المشاريع، تكون القائمة البريدية هي الوسيلة الرئيسية للتواصل حول تطوير المشروع. في المشاريع الكبيرة، توجد قوائم بريدية متعددة. على سبيل المثال، يحتوي مشروع PostgreSQL على 12 قائمة موجهة للمستخدمين و6 قوائم للمطورين. يُنصح بالبدء بالاشتراك في القائمة الرئيسية للمستخدمين والقائمة الرئيسية للمطورين للاستماع أولًا. 2. **متابعة مدونة**: المدونات التي يديرها المطورون الرئيسيون غالبًا ما توفر معلومات عن الإصدارات القادمة والخطوات اللازمة. مواقع مثل "planet" تجمع أخبارًا ومقالات من مصادر متعددة متعلقة بالمشروع، مثل planet.gnome.org أو planet.mysql.com. 3. **الانضمام إلى قناة IRC**: العديد من المشاريع لديها قنوات IRC (الدردشة عبر الإنترنت) حيث يجتمع المطورون والمستخدمون لمناقشة المشاكل والتطوير. تحقق من موقع المشروع لمعرفة اسم القناة والشبكة. 4. **العمل مع التذاكر (tickets)**: البرمجة ليست الطريقة الوحيدة للمساهمة. صيانة الشيفرة والأنظمة المحيطة بها غالبًا ما تكون مهملة، وهذه فرصة سهلة للمشاركة. معظم المشاريع لديها نظام تذاكر يمكن الوصول إليه من الجميع. الحفاظ على تحديث التذاكر طريقة ممتازة للمساعدة. 5. **تشخيص الأخطاء**: في كثير من الأحيان يتم الإبلاغ عن الأخطاء بشكل غير واضح. تشخيص الأخطاء ومراجعتها يساعد المطورين على فهم المشكلة بسرعة. حتى لو لم تعرف سبب المشكلة، فإن جهودك لتقليل الظروف تساعد الآخرين على حلها بسهولة. 6. **إغلاق الأخطاء المصححة**: أحيانًا يتم تصحيح الأخطاء في الشيفرة لكن التذاكر المتعلقة بها لا تُغلق. مراجعة هذه التذاكر مهمة جدًا. ابدأ بالتأكد من التذاكر القديمة وقم بإغلاق ما تم حله. 7. **اختبار إصدار تجريبي أو مرشح للإصدار**: يمكن أن تواجه المشاريع مشاكل توافق على منصات مختلفة. اختبار الإصدارات التجريبية يساعد المشروع على التأكد من جودة الإصدار النهائي. 8. **تصحيح خطأ**: عادة ما يبدأ المساهمون بحل الأخطاء. حدد خطأً وحاول تصحيحه، وأضف اختبارات إذا لزم الأمر. 9. **كتابة اختبار (Test)**: معظم المشاريع لديها اختبارات، لكن هناك دائمًا مجال لإضافة اختبارات جديدة لتغطية أجزاء لم تُختبر بعد. 10. **إخفاء تحذيرات المترجم (compiler warnings)**: في المشاريع بلغة C أو غيرها، قد تظهر تحذيرات لا تشير إلى خطأ حقيقي. إزالة هذه التحذيرات يحسن وضوح عملية البناء. 11. **إضافة تعليق (Comment)**: عند قراءة الشيفرة، إذا وجدت جزءًا مربكًا، أضف تعليقًا لتوضيحه للآخرين. 12. **إنشاء مثال**: لا يوجد مشروع يمكن أن يحتوي على أمثلة كثيرة جدًا. إنشاء مثال عملي يوضح طريقة استخدام البرنامج يساعد المستخدمين الجدد. 13. **التفاعل مع المجتمع**: الرد على أسئلة الآخرين، خاصة المبتدئين، يساعد المشروع على النمو ويجعل المجتمع نشطًا. 14. **كتابة تدوينة (Blog Post)**: مشاركة تجاربك مع المشروع تساعد الآخرين وتوثق خبرتك. 15. **تحسين موقع الويب**: إذا كانت لديك مهارات تصميم، يمكنك تحسين موقع المشروع أو الشعارات، مما يعزز صورة المشروع. 16. **كتابة وثائق تقنية**: كتابة توثيق عن المشروع مفيد، حتى لو لم تكن مبرمجًا، لتسهيل استخدام المشروع على الآخرين. 17. **التعليم ومساعدة الآخرين**: أفضل طريقة لتعلم شيء جديد هي محاولة تعليمه للآخرين، فالتدريس يعزز فهمك ومهاراتك. ================================================ FILE: docs/additional-material/translations/Turkish/Things a non Programmer can do.tr.md ================================================ # Programcı Olmayan Birinin Yapabileceği Şeyler ## Dinlemeye Başlayın Açık kaynak dünyasında her şey diğer insanlarla ilgilidir. Bir ekibe katılmak istiyorsunuz, bu da topluluğu ve nasıl çalıştığını anlamanız gerektiği anlamına gelir. Bir projeye girip *"Merhaba, bu projenin böyle olması gerektiğini düşünüyorum."* demek genellikle iyi bir yaklaşım olarak görülmez. Bazı projeler bu tür bir yaklaşımı kabul edebilir, ancak proje uzun süredir devam ediyorsa bu tavrın benimsenme ihtimali düşüktür. **Dinlemek, projenin neye ihtiyacı olduğunu anlamanın en iyi yoludur.** ### 1. **Bir e-posta listesine katılın** Birçok proje için e-posta listesi, proje gelişimi hakkında ana iletişim kanalıdır. Özellikle büyük projelerde birden fazla e-posta listesi bulunabilir. Örneğin, *PostgreSQL* projesinin kullanıcı odaklı en az 12 ve geliştiricilere yönelik 6 farklı e-posta listesi vardır. Başlangıç olarak, ana kullanıcı listesi ve ana geliştirici listesine abone olmanızı öneririm. ### 2. **Bir blog takip edin** Ana geliştiriciler tarafından tutulan bloglar, gelecekteki sürümler ve gereksinimler hakkında bilgi verir. Bazı projeler için *planet sitesi* (örneğin, `planet.gnome.org` veya `planet.mysql.com`) tüm güncellemeleri bir araya getirir. Google'da `"planet "` şeklinde arama yaparak başlayabilirsiniz. ### 3. **Bir IRC kanalına katılın** Birçok açık kaynak projesinin geliştiriciler ve kullanıcılar için özel IRC kanalları vardır. Projenin web sitesini ziyaret ederek kanal adı ve bulunduğu IRC ağı hakkında bilgi edinebilirsiniz. --- ## Ticket (Hata Bildirimi) ile Çalışmak Kod, her açık kaynak projesinin kalbidir, ancak kod yazmak tek katkı yolu değildir. Projelerde yeni özellikler eklemeye ve hataları düzeltmeye odaklanılırken, sistemlerin bakımına yeterince zaman ayrılmayabilir. Bu alanlara katkıda bulunarak bir projeye dahil olabilirsiniz. ### 4. **Bir hatayı teşhis edin** Hatalar çoğu zaman eksik rapor edilir. Bir hatayı analiz etmek ve sınıflandırmak, geliştiricilere zaman kazandırır. Bir kullanıcı *"Yazılım X yaptığımda çalışmıyor"* dediyse, şu sorulara cevap arayarak sorunu detaylandırabilirsiniz: - Hata tekrar edilebilir mi? - Aynı hatayı oluşturmak için belirli adımlar var mı? - Belirli bir tarayıcıda veya işletim sisteminde mi ortaya çıkıyor? Bulduğunuz her şeyi hata raporuna ekleyerek projenin ilerlemesine yardımcı olabilirsiniz. ### 5. **Çözülen hataları kapatın** Birçok hata raporu çözüldükten sonra sistemde açık olarak kalır. Bunları temizlemek zaman alıcı olabilir, ancak proje için çok değerlidir. - Eski hata raporlarını (1 yıl veya daha eski) gözden geçirin. - Projenin sürüm notlarını kontrol ederek hatanın çözülüp çözülmediğini belirleyin. - Hatayı yeni sürümde test edin, eğer hata artık yoksa raporu kapatın. --- ## Kod ile Çalışmak Her seviyeden programcı, bir projeye katkıda bulunabilir. Bir projede kod yazmak istiyorsanız, projeye nasıl katkı sağlandığını öğrenin. Bazı projeler değişiklikleri doğrudan kabul ederken, bazıları kodun önce bir inceleme sürecinden geçmesini ister. ### 6. **Beta veya aday sürümü test edin** Çoklu platform desteği olan projelerde, yeni sürümlerin test edilmesi büyük önem taşır. Sürüm yöneticileri, beta sürümünü farklı platformlarda test etmek isteyen kullanıcılara ihtiyaç duyar. Yapmanız gereken: - Yazılımın son sürümünü indirip derlemek - Farklı donanım ve işletim sistemlerinde çalışıp çalışmadığını kontrol etmek - Test sonuçlarını geliştiricilere bildirmek ### 7. **Bir hatayı düzeltin** Geliştiricilerin genellikle başladığı nokta burasıdır. - Bir hata bularak çözmeye çalışın - Çözümünüzü kod içinde belgeleyin - Gerekirse bir test ekleyin - Eğer hatayı çözemezseniz bile bulgularınızı hata kaydına ekleyin ### 8. **Bir test yazın** Projelerin test sistemleri genellikle eksik olabilir. *gcov* (C için) veya *Devel::Cover* (Perl için) gibi test kapsamı araçlarını kullanarak eksik alanları tespit edin. Ardından bu alanları kapsayan testler yazın. ### 9. **Derleyici uyarılarını giderin** Özellikle *C tabanlı projelerde*, derleyiciler bazen uyarılar verir. Bunlar gerçek bir hataya işaret etmese bile, fazla uyarı almak kodun daha karışık görünmesine sebep olabilir. Uyarıyı analiz edin ve gerçekten bir hata olup olmadığını belirleyin. ### 10. **Yorum ekleyin** Eğer bir kod parçasını anlamakta zorlandıysanız, başkaları da zorlanabilir. Kod içindeki kafa karıştırıcı bölgelere açıklayıcı yorumlar ekleyerek projeye katkıda bulunabilirsiniz. --- ## Dokümantasyon ile Çalışmak Dokümantasyon genellikle projelerin ihmal edilen kısmıdır. Projeyi uzun süredir geliştirenler, yeni gelenlerin nelere ihtiyacı olabileceğini gözden kaçırabilir. ### 11. **Bir örnek oluşturun** Kodun veya aracın nasıl çalıştığını gösteren iyi örnekler, en az teknik belgeler kadar önemlidir. - API veya kütüphane kullanımı için örnek kodlar yazın - Komut satırı araçları için gerçek hayattan kullanım senaryoları oluşturun - Arayüzlü uygulamalar için ekran görüntüleri ile açıklamalar ekleyin --- ## Topluluk ile Çalışmak Açık kaynak sadece koddan ibaret değildir, topluluk da büyük önem taşır. ### 12. **Bir soruya cevap verin** Birine yardımcı olmak, projenin büyümesine katkıda bulunmanın en iyi yollarından biridir. Özellikle yeni başlayanlara karşı sabırlı olun ve onlara yol gösterin. ### 13. **Bir blog yazısı yazın** Projeyle ilgili deneyimlerinizi paylaşarak iki şekilde yardımcı olabilirsiniz: 1. Projeye olan ilgiyi artırabilirsiniz. 2. Karşılaştığınız sorunlara çözümler sunarak başkalarına rehber olabilirsiniz. ### 14. **Bir web sitesini geliştirin** Eğer web tasarımı konusunda bilginiz varsa, projenin web sitesini geliştirebilirsiniz. Grafik tasarım ve logo gibi görsel öğeler konusunda da destek sağlayabilirsiniz. ### 15. **Teknik dokümantasyon yazın** Bir yazılımın nasıl çalıştığını açıklamak için teknik dokümanlar oluşturabilirsiniz. Özellikle açık kaynak projeler, güncellenmiş ve anlaşılır dokümanlara her zaman ihtiyaç duyar. ### 16. **Öğretin ve başkalarına yardımcı olun** Bir konuyu öğretmek, onu öğrenmenin en iyi yoludur. Açık kaynak projelerine katılan insanlara rehberlik ederek hem kendinizi geliştirir hem de topluluğa katkıda bulunmuş olursunuz. Paylaşılan bilgi, daha fazla kişinin açık kaynak ekosistemine katkıda bulunmasını sağlar. --- ================================================ FILE: docs/additional-material/translations/Turkish/Useful-links-for-further-learning.tr.md ================================================ # Faydalı bağlantılar Bu belge hayatımızı kolaylaştıran tüm ipuçları ve püf noktaları, blog yazıları ve faydalı web sitelerine adanmıştır. İster yeni başlayan olun, ister uzman, tüm ihtiyaçlarımızı karşılayacak harika bir referans noktasıdır. Bu sayfa, açık kaynak alanına yeni başlayan veya daha fazla bilgi edinmek isteyen herkese yardımcı olacak tüm yararlı bağlantıların bir dizini olarak hizmet vermeyi amaçlamaktadır. ## Liste 1. [Interactive tutorial to git](https://try.github.io) 2. [git - the simple guide](http://rogerdudler.github.io/git-guide/) 3. [On undoing, fixing, or removing commits in git](http://sethrobertson.github.io/GitFixUm/fixup.html) 4. [Git and GitHub tutorial translated to many languages](https://github.com/Roshanjossey/first-contributions) 5. [Merge Conflicts](https://www.git-tower.com/learn/git/ebook/en/command-line/advanced-topics/merge-conflicts) 6. [Resolving Merge Conflicts](https://githowto.com/resolving_conflicts) 7. [Basics of Git - The Simple Quick Start Guide](https://blog.praveen.science/basics-of-git-the-quick-start-guide/) 8. [Git Standards followed in our way of Spotify Agile Methodology](https://blog.praveen.science/git-standards-followed-in-our-way-of-spotify-agile-methodolgy/) 9. [Git Shortcuts](https://blog.praveen.science/git-shortcuts/) 10. [Official Git cheat sheet in many languages](https://services.github.com/on-demand/resources/cheatsheets) 11. [Git cheat sheet from Tower](https://www.git-tower.com/learn/cheat-sheets/git) 12. [Common Git Problems](https://www.codementor.io/citizen428/git-tutorial-10-common-git-problems-and-how-to-fix-them-aajv0katd) 13. [Git Rebase](https://blog.gitprime.com/git-rebase-an-illustrated-guide/) 14. [Beginner's Guide to Rebasing and Squashing](https://github.com/servo/servo/wiki/Beginner%27s-guide-to-rebasing-and-squashing) 15. [Git Cheatsheet that shows correlations between commands and files](http://ndpsoftware.com/git-cheatsheet.html) 16. [How to contribute](https://opensource.guide/how-to-contribute/) 17. [Getting started with Open Source](https://github.com/OpenSourceHelpCommunity/Getting-Started-With-Contributing-to-Open-Sources) 18. [How to contribute](https://github.com/freeCodeCamp/how-to-contribute-to-open-source) 19. [Atlassians Git Tutorials](https://www.atlassian.com/git) 20. [Pull request reviews](https://help.github.com/articles/about-pull-request-reviews/) 21. [Another Interactive tutorial for git](https://learngitbranching.js.org/) 22. [Git commandline cheat-sheet](https://gist.github.com/davfre/8313299) 23. [Programming Books](https://github.com/EbookFoundation/free-programming-books) 24. [E-Book of professional tip and secrets](https://goalkicker.com/GitBook/GitProfessionalTipsSecrets.pdf) 25. [tutorial about simple rules of become git professional](https://medium.freecodecamp.org/follow-these-simple-rules-and-youll-become-a-git-and-github-master-e1045057468f) 26. [A Note About Git Commit Messages](https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) 27. [5 Useful Tips For A Better Commit Message](https://thoughtbot.com/blog/5-useful-tips-for-a-better-commit-message) 28. [Version Control using Git](https://ourcodingclub.github.io/2017/02/27/git.html) 29. [Version Control with Git](https://www.udacity.com/course/version-control-with-git--ud123) Yararlı bulduğunuz bağlantıları eklemeye devam edin. ================================================ FILE: docs/additional-material/translations/Turkish/additional-material.tr.md ================================================ # **Ek Bilgiler** Burada, temel Git talimatlarını zaten öğrendiğinizi varsayıyoruz. Bu ek bilgiler, daha karmaşık durumlarda kullanabileceğiniz bazı Git komutlarını içermektedir. ## **Düzeltmeler ve Güncellemeler** ### **[Commitleri Düzeltme](amending-a-commit.by.md)** Bu belge, uzak bir depodaki commit üzerinde nasıl değişiklik yapacağınızı açıklar. > Eğer daha önce yaptığınız bir commit'i değiştirmek istiyorsanız, bu belgeyi okuyabilirsiniz. ### **[Git Yapılandırması](configuring-git.by.md)** Bu belge, Git üzerindeki kullanıcı bilgilerini ve diğer ayarları nasıl değiştireceğinizi anlatır. > Git ayarlarınızı daha konforlu hale getirmek istiyorsanız bu kılavuz faydalı olacaktır. ### **[Fork’unuzu Ana Depoyla Senkronize Etme](keeping-your-fork-synced-with-this-repository.by.md)** Bu belge, kendi fork’unuzun ana depo ile nasıl senkronize edileceğini açıklar. Projede tek başınıza değil, ekip içinde çalışacağınızı düşünerek senkronizasyonun önemli olduğunu unutmayın. > Fork’unuz ana deponun *master* dalıyla senkronize değilse, buradaki adımları izleyin. ### **[Commit’i Farklı Bir Dala Taşıma](moving-a-commit-to-a-different-branch.by.md)** Bu belge, bir commit’i farklı bir dala nasıl taşıyacağınızı anlatır. > Eğer bir commit’i yanlış dala yaptıysanız ve taşımak istiyorsanız, buradaki adımları takip edebilirsiniz. ## **Dosya ve Dal Yönetimi** ### **[Dosya Silme](removing-a-file.by.md)** Bu belge, bir dosyayı yerel deponuzdan nasıl sileceğinizi anlatır. > Commit yapmadan önce bir dosyayı kaldırmak istiyorsanız, bu komutları öğrenmelisiniz. ### **[Bir Dalı Depodan Silme](removing-branch-from-your-repository.by.md)** Bu belge, Git deposundan bir dalın nasıl kaldırılacağını açıklar. > Bir *pull request* tamamlandıktan sonra ilgili dalı silmek için bu adımları takip edebilirsiniz. ### **[Merge Çakışmalarını Çözme](resolving-merge-conflicts.by.md)** Bu belge, dal birleştirme sırasında ortaya çıkan çakışmaları nasıl çözebileceğinizi açıklar. > Merge sırasında oluşabilecek sorunları nasıl çözeceğinizi öğrenmek için buradaki talimatları uygulayın. ## **Commit ve Değişiklik Yönetimi** ### **[Commit’i Geri Alma](reverting-a-commit.by.md)** Bu belge, uzak bir depodaki commit’i nasıl geri alacağınızı açıklar. > Eğer bir commit’i GitHub’a *push* ettiyseniz ve geri almak istiyorsanız, buradaki adımları takip edebilirsiniz. ### **[Commit’leri Birleştirme (Squashing)](squashing-commits.by.md)** Bu belge, commit’leri *interactive rebase* kullanarak nasıl birleştireceğinizi anlatır. > Eğer bir open-source projeye pull request gönderdiyseniz ve projenin yöneticisi commit’lerinizi tek bir commit’te toplamanızı istiyorsa, bu talimatları kullanabilirsiniz. ### **[Yerel Commit’i Geri Alma](undoing-a-commit.by.md)** Bu belge, yerel deponuzdaki bir commit’i nasıl geri alacağınızı anlatır. > Eğer bir commit sonrası değişiklikleri geri almak istiyorsanız, buradaki komutları uygulayabilirsiniz. ## **Ek Kaynaklar ve Bağlantılar** ### **[Faydalı Bağlantılar](Useful-links-for-further-learning.by.md)** Bu dosya, blog yazıları, faydalı web siteleri, Git ipuçları ve açık kaynak geliştirme hakkında öneriler içermektedir. > Açık kaynak dünyasına yeni başlayanlar ve kendini geliştirmek isteyenler için oldukça faydalı kaynaklar içerir. Bu belgeler, Git ile çalışırken karşılaşabileceğiniz karmaşık senaryolar için rehber niteliğindedir. Herhangi bir işlem yapmadan önce ihtiyacınıza uygun belgeyi okuyarak doğru adımları takip edebilirsiniz. ================================================ FILE: docs/additional-material/translations/Turkish/amending-a-commit.tr.md ================================================ # Commit Düzeltmeleri Uzak bir depoya bir commit gönderdiğinizi ve daha sonra commit mesajında bir yazım hatası yaptığınızı veya bu son commite bir satır eklemeyi unuttuğunuzu fark ettiğinizi hayal edin. Bu durumda ne yapmalısınız? İşte bu belgede tam olarak bundan bahsedeceğiz. ## Github'a Gönderilmiş (Push Edilmiş) Son Commit'in Mesajını Nasıl Değiştirirsiniz? Bunu bir dosyayı düzenlemeye açmadan yapmak için: * ```git commit --amend -m "yeni commit mesajınız"``` komutunu girin. * Ardından değişiklikleri Github'a göndermek için ```git push origin ``` komutunu çalıştırın. Not: Eğer sadece ```git commit --amend``` yazarsanız, bir metin editörü açılır ve commit mesajını düzenlemenizi önerir. ``-m`` anahtarını kullanmak editörün açılmasını engeller. ## Bir Committe Nasıl Değişiklik Yapılır? Eğer bir dosyada küçük bir değişiklik yapmayı unuttuysak, örneğin bir kelimeyi değiştirmeyi unuttuysak ve bu commit zaten uzak depoya gönderildiyse ne yapmalıyız? Örneğin, commit geçmişim şu şekilde olsun: `` ` g56123f create file bot file a2235d updated contributor.md a5da0d modified bot file `` ` Diyelim ki bot file dosyasına bir kelime eklemeyi unuttum. Bunu düzeltmek için iki yol var. İlk yol, bu değişikliği içeren yeni bir commit oluşturmaktır, örneğin: `` ` g56123f create file botfile a2235d updated contributor.md a5da0d modified botfile b0ca8f added single word to botfile `` ` İkinci yol ise a5da0d commit'ini düzeltmek, bu eksik kelimeyi eklemek ve bu değişiklikleri Github'a tek bir commit olarak göndermektir. İkinci yol tercih edilir çünkü bu sadece küçük bir değişiklikle ilgilidir. Bunu başarmak için şu adımları izleyeceğiz: * Dosyayı değiştirin. Bu durumda, botfile dosyasını değiştirip daha önce unuttuğum kelimeyi ekleyeceğim. * Ardından, bu dosyayı ```git add ``` komutuyla indeksleyin. Normalde indekslemeden hemen sonra `` `git commit -m" commit mesajımız "` `` yaparız, değil mi? Ancak bu durumda amacımız önceki commit'i düzeltmek olduğu için bunun yerine şu komutu çalıştıracağız: * ```git commit --amend``` Bu, bir metin editörü penceresi açacak ve commit mesajında değişiklik yapma imkanı sunacaktır. Mesajı gerçekten düzenleyebilir veya olduğu gibi bırakabiliriz. * Editörden çıkın. * Değişikliklerimizi ```git push origin ``` komutuyla gönderin. Böylece, her iki düzeltme de tek bir commit'te birleştirilmiş olacaktır. ================================================ FILE: docs/additional-material/translations/Turkish/configuring-git.tr.md ================================================ # Git Konfigürasyonu İlk kez bir commit yapmaya çalıştığınızda aşağıdaki mesajı görmüş olabilirsiniz: ``` $ git commit *** Lütfen kim olduğunuzu söyleyin. Hesabınızın varsayılan kimliğini ayarlamak için şu komutu çalıştırın: git config --global user.email "you@example.com" git config --global user.name "Your Name" Sadece bu depoda kimliği ayarlamak için --global seçeneğini kullanmayın. Bir commit oluşturmak için Git, kimin tarafından yapıldığını bilmelidir. Ekip çalışmalarında, projenin belirli kısımlarının kim tarafından ve ne zaman değiştirildiğini bilmek önemlidir. Bu nedenle Git, her commit'in bir kullanıcı adı ve e-posta adresiyle ilişkilendirilmesini gerektirir. Bu bilgiyi Git ile ilişkilendirmenin birkaç yolu vardır ve burada bazılarını listeleyeceğiz. Global Konfigürasyon Global konfigürasyonda kaydedilen bilgiler, tüm sistem için geçerlidir, yani çalıştığınız tüm depoları kapsar. Bu, çoğu kullanım durumu için tercih edilen yöntemdir. Global konfigürasyona bir şey kaydetmek için config komutunu aşağıdaki şekilde kullanırsınız: $ git config --global Kullanıcı bilgileri için bu komutları şu şekilde çalıştırabilirsiniz: $ git config --global user.email "you@example.com" $ git config --global user.name "Your Name" Depo Konfigürasyonu Adından da anlaşılacağı gibi, bu konfigürasyonlar yalnızca mevcut depo için geçerlidir. Örneğin, işle ilgili bir projede şirket e-posta adresinizi kullanmak istiyorsanız bu yöntemi kullanabilirsiniz. Depo düzeyinde konfigürasyon yapmak için config komutunda --global anahtarını kullanmazsınız: $ git config Kullanıcı bilgileri için bu şu şekilde görünür: $ git config user.email "you@alternate.com" $ git config user.name "Your Name" Komut Satırı Konfigürasyonu Bu konfigürasyon yöntemi yalnızca belirli bir komut için geçerlidir. Tüm Git komutları, komuttan önce -c anahtarını kullanarak geçici konfigürasyon parametreleri ayarlamanıza izin verir. Konfigürasyon parametrelerini yalnızca belirli bir komut için geçici olarak değiştirmek için Git komutlarını aşağıdaki formatta kullanın: $ git -c = -c = Commit komutu için bu şu şekilde olacaktır: git -c user.name='Your Name' -c user.email='you@example.com' commit -m "Commit mesajınız" Öncelik Sırası Hakkında Not Üç konfigürasyon türü arasındaki öncelik sırası şu şekildedir: komut satırı > depo > global. Bu, bir değişken hem global hem de komut satırında tanımlanmışsa, komut satırında atanan değerin kullanılacağı anlamına gelir. Sadece Kullanıcı Bilgisi Değil Şimdiye kadar Git konfigürasyonunu yalnızca kullanıcı bilgisi bağlamında ele aldık. Ancak Git, başka parametreleri de yapılandırmanıza izin verir. İşte bunlardan bazıları: core.editor - Commit mesajlarını düzenlemek için kullanılacak metin düzenleyicisini belirtir. commit.template - Commit mesajları için bir şablon dosyası belirtir. color.ui - Git mesajlarında renkli çıktı kullanılıp kullanılmayacağını belirten mantıksal bir değişkendir. Basitlik adına bazı detayları atladık. Daha fazla bilgi için git-scm.com adresine başvurabilirsiniz. Bu şekilde tüm içerik **tek bir Markdown** dosyasında birleştirilmiş ve Türkçe olarak sunulmuştur. ================================================ FILE: docs/additional-material/translations/Turkish/keeping-your-fork-synced-with-this-repository.tr.md ================================================ # Dalınızı Ana Depo ile Senkronize Etme Öncelikle, tam senkronizasyon için akışı anlamak önemlidir. Bu senaryoda 3 farklı depo bulunur: Github'daki açık depom github.com/firstcontributions/first-contributions.git, GitHub'daki çatal deponuz github.com/Your-Name/first-contributions/ ve üzerinde çalıştığınız yerel makinenizdeki depo. Bu tür bir işbirliği, açık kaynak projeler için tipiktir ve Triangle Workflows olarak adlandırılır. triangle workflow Deponuzu benim açık depomla güncel tutmak için önce ana depoyu yerel deponuzla birleştirmeliyiz. İkinci adımımız, yerel deponuzu GitHub'daki çatal deponuza itmektir. Daha önce gördüğünüz gibi, yalnızca "çatal depo" ile bir "pull request" isteyebilirsiniz. Bu nedenle, GitHub'daki çatal depo, güncellenmesi gereken son depodur. Şimdi bunu nasıl yapacağımıza bir göz atalım: Senkronizasyon Adımları 1. Ana Dal (master) Üzerine Geçin Öncelikle ana dalda olduğunuzdan emin olun. Hangi dalda olduğunuzu öğrenmek için şu komutu çalıştırın: * git status Eğer ana dalda (master) değilseniz, ana dala geçin: * git checkout master 2. Ana Depoyu upstream Olarak Ekleyin Yerel deponuzu ana depo ile senkronize etmek için önce ana depoyu upstream olarak ekleyin: * git remote add upstream https://github.com/firstcontributions/first-contributions.git Bu komut, Git'e belirttiğiniz adreste bu projenin başka bir versiyonunun bulunduğunu ve bunu upstream olarak adlandırdığımızı söyler. 3. upstream'den Son Değişiklikleri Alın Ardından, ana depodan en son değişiklikleri alın: * git fetch upstream Bu komut, upstream (ana depo) üzerindeki tüm son değişiklikleri yerel deponuza indirir. 4. upstream/master ile Birleştirin Şimdi, ana depodaki değişiklikleri yerel ana dalınızla birleştirin: git rebase upstream/master Bu komut, ana depodaki değişiklikleri yerel ana dalınızla birleştirir. Yerel ana dalınız artık günceldir. 5. Yerel Depoyu GitHub Çatal Deponuza İtin Son olarak, yerel ana dalınızı GitHub'daki çatal deponuza itin: * git push origin master Bu komut, yerel deponuzdaki değişiklikleri GitHub'daki çatal deponuza gönderir. Artık tüm depolarınız günceldir! ================================================ FILE: docs/additional-material/translations/Turkish/moving-a-commit-to-a-different-branch.tr.md ================================================ # Taahhütleri başka bir dala taşıma Peki ya bir değişiklik yapıp daha sonra başka bir dala geçtiğinizi fark ederseniz? Bunu nasıl değiştirebilirsiniz? İşte bu eğitim tam da bunu anlatıyor. ## Son yapılan commit'leri mevcut bir dala taşıma Böyle bir hareket için şunu yazın: `` `git reset HEAD ~ --soft` `` - Son commit'i geri alır, ancak değişiklikleri kullanılabilir bırakır. `` `git stash` `` - Bir dizinin durumunu kaydeder. `` `git checkout ` `` - Başka bir dala geçiş yapar. `` `git stash pop` `` - Son kaydedilen durumu döndürür. `` `git add .` `` - Tek tek dosyaları ekler. `` `git commit -m "mesajınızı buraya yazın"``` - Değişiklikleri kaydeder ve onaylar. Değişiklikleriniz artık doğru dalda. ### Son yapılan commit'leri yeni bir dala taşıma Böyle bir hareket için şunu yazın: `` `git branch newbranch` `` - Tüm commit'leri koruyarak yeni bir dal oluşturur. `` `git reset --hard HEAD ~ [n]` `` - Ana dalı n adet commit'e geri döndürür. Bu commitlerde yer alan değişikliklerin master dalından tamamen silineceğini aklınızda bulundurun. `` `git checkout newbranch` `` - Oluşturduğunuz dala geçiş yapar. Bu dal artık tüm commitleri içeriyor. Unutmayın: Commit'e dahil edilmeyen tüm değişiklikler tamamen kaybolacaktır. ================================================ FILE: docs/additional-material/translations/Turkish/removing-a-file.tr.md ================================================ # GIT kontrolünden bir dosyayı kaldırma Bazen bir dosyayı GIT kontrolünden kaldırmanız gerekebilir, ancak onu bilgisayarınızda tutmanız gerekebilir. Bu, aşağıdaki komut kullanılarak gerçekleştirilebilir: ``git rm --cached`` ## Ne oldu? GIT artık uzak dosyadaki değişiklikleri izlemiyor. GIT perspektifinden bakıldığında bu dosya eksiktir, ancak bu dosyayı dosya sisteminde bulmaya çalışırsanız, hala orada olduğunu göreceksiniz. Yukarıdaki örnekte `--cached` bayrağının kullanıldığına dikkat edin. Eğer bu bayrağı eklemezsek Git dosyayı sadece depodan değil aynı zamanda dosya sisteminizden de silecektir. `git commit -m "Remove file1.js"` ile bir değişikliği onaylayıp `git push origin master` ile uzak depoya gönderirseniz, uzak depo dosyayı silecektir. ## Ek Bilgiler - Birden fazla dosyayı silmek istiyorsanız, tüm dosyaları tek bir komutta listeleyerek bunu yapabilirsiniz: `git rm dosya1.js dosya2.js dosya3.js --cached` - Benzer adlara sahip dosyaları silmek için joker karakteri (*) kullanabilirsiniz; örneğin, yerel depoda bulunan tüm .txt dosyalarını silmek istiyorsanız şunu yazın: `git rm *.txt --cached` ================================================ FILE: docs/additional-material/translations/Turkish/removing-branch-from-your-repository.tr.md ================================================ # Depodan bir dalı kaldırma Eğer şimdiye kadar eğitimi takip ettiyseniz, `` dalımız amacına ulaşmıştır, onu yerel makinenizin deposundan kaldırmanın zamanı geldi. Bu gerekli değil, ancak bu endüstrinin ismi onun oldukça özel bir amacını gösteriyor. Ömrü de buna paralel olarak kısa olabilir. Öncelikle ``'inizi master'ınızla birleştirerek kendi dalınıza taşıyalım: ``` git ödeme ustası ``` ``'i ana dosyaya birleştir: ``` git merge master ``` ``'i yerel makinenizin depolarından kaldırın: ``` git branch -d ``` Artık yerel makine dalını `` sildiniz ve her şey düzgün ve düzenli görünüyor. Ancak bu noktada GitHub bölümünüzde hala `` adlı bir dal olması gerekir. Ancak bunu silmeden önce, bu uzak daldan depolarıma bir "Çekme isteği" gönderdiğinizi unutmayın. Yani eğer bunu daha önce birleştirdiysem, bu dalı silmeyin. Ancak, eğer sizin dalınızı birleştirdiysem ve siz uzak dalı silmek istiyorsanız, şunu kullanın: ``` git push origin --delete ``` Artık dallarınızı nasıl toparlayacağınızı biliyorsunuz. Zamanla, kamuya açık arşivime birçok komisyon eklenecek. Hem yerel makinenizin ana dalları hem de GitHub çatalınız güncelliğini yitirecektir. Dolayısıyla, depolarınızı benimkilerle senkronize tutmak için şu adımları izleyin. #### [Çatalınızı bu depoyla senkronize tutma](keeping-your-fork-synced-with-this-repository.md) ================================================ FILE: docs/additional-material/translations/Turkish/resolving-merge-conflicts.tr.md ================================================ # Birleştirme çatışması nedir? Mevcut çalışma dalınızla başka bir dalı birleştirmeye çalıştığınızda, farklı bir bağlamda değişiklikler yapıyor ve bunları mevcut dosyalarınızla birleştiriyorsunuz. Aynı dosyadaki aynı satırlar iki kişi tarafından değiştirilirse veya bir kişi silmeye karar verirken diğeri değiştirmeye karar verirse Git hangi sürümün doğru olduğunu belirleyemeyecektir. Git daha sonra dosyayı bir çakışma olarak işaretleyecektir; çalışmaya devam etmek için bu çakışmayı çözmeniz gerekecektir. # Birleşme ihtilafı nasıl çözülür? Bir birleştirme çakışmasıyla karşılaşıldığında, git dosyadaki sorunlu alanı “<<<<<<< HEAD” ve “>>>>>>>>>>[diğer dal adı]” içine ekleyerek işaretler. İlk işaretleyiciden sonraki içerik mevcut dalınızdan gelir. Git, açılı parantezlerden sonra değişikliklerin nereden (hangi daldan) geldiğini söyler. "=======" satırı, çakışan iki değişikliği ayırır. Bizim görevimiz bu satırları temizlemek: İşimiz bittiğinde dosya istediğimiz gibi görünmeli. Çelişkili değişiklikleri yazan takım arkadaşınıza danışarak hangi versiyonun nihai olacağına karar vermeniz önerilir. Ya sizin olabilir ya da ikisinin karışımı olabilir. Örneğin: ``` <<<<<<< HEAD:birleştirmetesti Bu üçüncü satırım. ======= Eklediğim dördüncü satır bu. >>>>>>> 4e2b407f501b68f8588aa645acafffa0224b9b78:birleştirme testi ``` `<<<<<<`: Birleştirme çakışması olan satırların başlangıcını belirtir. İlk satır kümesi, değişiklikleri birleştirmeye çalıştığınız dosyadaki satırlardır. `=======`: Karşılaştırma için kullanılan kesme noktasını belirtir. Kullanıcının yaptığı değişiklikleri (yukarıda) birleştirmeden kaynaklanan değişikliklerle (aşağıda) görsel olarak karşılaştırarak farkları görmenizi sağlar. `>>>>>>>`: Birleştirme çakışması olan satırların sonunu işaretler. Çakışmayı dosyayı düzenleyip daha sonra manuel olarak birleştirerek çözebilirsiniz. Bir şeyin veya birinin iptali veya değiştirilmesi veya ikisinin bir kombinasyonu anlamına gelebilir. Ayrıca <<<<<<< ',' ======= ', ve' >>>>>>> ' dosyalarını da silmeniz gerekiyor. Çatışmayı çözdükten sonra `git add` komutunu çalıştırın. Çakışmayı çözdüğünüzden emin olmanız gerektiğinden testleri çalıştırmayı unutmayın. Birleştirme çakışmalarını daha kolay çözebilmek için kullandığınız IDE'ye bağlı olarak farklı eklentiler de indirebilirsiniz. # Birleştirme nasıl geri alınır? Birleştirmeyi iptal etmek istiyorsanız `git merge --abort` komutunu kullanabilirsiniz ================================================ FILE: docs/additional-material/translations/Turkish/reverting-a-commit.tr.md ================================================ # Taahhüdü geri al Bir taahhüdü iptal etmek, tüm taahhütleri iptal eden tamamen yeni bir belge oluşturmak anlamına gelir. Öncekine yapılan değişiklikler. Git'te ``CTRL + Z``` yapmak gibi bir şey. Git'te dönüştürme işlemi daha kolay hale gelir çünkü uzak deponuza gönderdiğiniz her katkının SHA (Güvenli Karma Algoritması) olarak bilinen benzersiz bir alfanümerik anahtarı vardır. Yani bu, SHA'nız olduğu sürece herhangi bir commit'i geri alabileceğiniz anlamına geliyor. Ancak daha sonra depolama alanınızı bozmamak için sırayı dikkatli bir şekilde değiştirmeniz gerekiyor. Geri almak istediğimiz belirli bir commit'in SHA'sını seçmek için, yaptığımız tüm commit'lerin bir kaydı kullanışlı olacaktır. Bunu elde etmek için şu komutu çalıştıracağız: `` `git log --oneline` `` ``git log`` komutunun tek bir çalıştırılması bize SHA'yı (uzun formda) da verecektir Ancak `` --oneline `` bayrağını kullanmak, git'e kolay okunabilmesi için bunun özlü (tek satırlık) bir düzende görüntülenmesini istediğimizi söyler. Bu komut çalıştırıldığında görüntülenen ilk 7 karaktere kısa commit hash'i denir. Örneğin, bu depoda ``git log --oneline`` komutunu çalıştırdığımda şunu elde ediyorum: ``` 389004d başlığa boşluk eklendi c1b9fc1 'master' dalını öğreticilere birleştir 77eaafd bir commit'i geri almak için öğretici ekledi ``` Bu, ``git log --oneline`` komutunu kullanarak depoya yapılan tüm commit'lerin bir listesini, SHA'sının ilk 7 karakteriyle birlikte alabileceğimizi gösteriyor. "Başlığa boşluk ekle" işlemini geri almak istediğimi varsayalım. İşte adımlar: * Belgenin SHA'sını kopyalayın, bu durumda ``389004d`` * Daha sonra ```git revert 389004d``` komutunu çalıştırın Bu, metin düzenleyicimi açacak ve benden commit mesajını düzenlememi isteyecek. Varsayılan git mesajı olarak, `Revert` kelimesiyle başlayan commit mesajını bırakmaya karar verebilirsiniz. Veya mesajı kendi zevkinize göre özelleştirmeye de karar verebilirsiniz. * Daha sonra metin düzenleyiciyi kaydedip kapatacağım. * Komut satırına geri dön. * Geri alınan değişiklikleri Github'a göndermek için `` `git push origin ` `` komutunu çalıştırın. Ve işte bu kadar, yapılan değişiklikler geri alınacaktır. Bu durumda, depomuz ``c1b9fc1``'de göründüğü gibi değişecek ================================================ FILE: docs/additional-material/translations/Turkish/squashing-commits.tr.md ================================================ # Squashing nedir? Git'te squashing, eylemlerinizin geçmişini yeniden yazmak anlamına gelir, böylece yaptığınız değişikliklerin bir açıklamasıyla karşılaşırsınız. Bu, açık kaynaklı projelerde sıklıkla yapılır çünkü açık kaynaklı projelerdeki birçok dal geçmişi yalnızca onları oluşturan geliştiriciyle ilgilidir ve yapılan değişiklikleri tanımlamanın ve gerekirse geri almanın daha kolay bir yolunu sağlar. # Commit'leri nasıl ezersiniz? Öncelikle, mevcut dalınıza birleştirmek istediğiniz commit'leri analiz etmek için bir git günlüğü çalıştırın. ``` git günlüğü ``` Taahhütlerinizin bir kısmını şu şekilde görmelisiniz: ``` bla bla bla yapmak Yazar: omguhh Tarih: 10/10/20 Mesaj 1'i kaydet blablabla2'yi taahhüt et Yazar: omguhh Tarih: 10/10/20 Mesaj 2'yi kaydet ``` Şimdi, birleştirmek istediğimiz commitleri gördüğümüzde ``git rebase`` ile oraya gidebiliriz. ``git rebase`` ile zaten aşina olduğunuzu varsayarak, etkileşimli git rebase modunda commit'leri ezmeye başlayabiliriz; bu şu şekilde etkinleştirilebilir: ``` git rebase -i ``` Artık etkileşimli yeniden temellendirme ile şu şekilde hareketlerle ne kadar ileri gitmek istediğinizin başlangıç ​​ve bitiş noktalarını tanımlayabilirsiniz: ``` git rebase -i HEAD~2 ``` Bu komutu çalıştırdığınızda aşağıdakine benzer bir şey göreceksiniz: ``` pick blablabla test01.txt dosyasını değiştirme blablabla2'yi seçin dummy01.txt dosyası ekleniyor # # Komutlar: # p, seç = kullan commit # r, reword = commit'i kullan, ancak commit mesajını düzenle # e, edit = commit kullan, ancak değişiklik yapmak için durdur # s, squash = commit'i kullan, ancak önceki commit'e birleştir # f, fixup = "squash" gibi, ancak bu commit'in günlük mesajını at # x, exec = komutu (satırın geri kalanını) kabuk kullanarak çalıştır # # Bu satırlar yeniden sıralanabilir; yukarıdan aşağıya doğru infaz edilirler. # # Buradaki bir satırı silerseniz O COMMIT KAYBOLACAĞIZ. # # Ancak her şeyi kaldırırsanız, yeniden temellendirme işlemi iptal edilecektir. # # Boş commit'lerin yorum satırına alındığını unutmayın ``` Yani, ```blablabla2```'yi ```blablablabla```'ya sıkıştırmak istiyorsanız, aşağıdakileri değiştirmeniz gerekir: ``` pick blablabla test01.txt dosyasını değiştirme squash blablabla2 dummy01.txt dosyası ekleniyor ``` Her şey yolunda giderse şu sonucu elde edeceksiniz: ``` # Bu 2 commit'in birleşimidir. # İlk commit'in mesajı şu şekilde: mesaj 1'i kaydet # Bu 2. commit mesajıdır: mesaj 2'yi gönder ``` Değişiklikleri kaydetmek için editörden çıkmadan önce bunları özgürce değiştirebilirsiniz. Git log'u çalıştırdığınızda, çıkmadan önce girdiğiniz commit mesajı, commit'ler birleştirilerek tek bir commit'te gösterilmelidir. ================================================ FILE: docs/additional-material/translations/Turkish/stashing-a-file.tr.md ================================================ # Saklamak Ya büyük bir kod parçası üzerinde çalışıyorsanız ve aniden üzerinde çalıştığınız dalı başka bir dala geçirmeniz gerekirse? Kod tamamlanmamış ve herhangi bir test yapılmamış olduğundan muhtemelen onu commit etmek istemezsiniz. Ama değişiklik yapmadan başka bir dala geçemezsiniz, Git bu akışı bozmanıza izin vermez. Peki ne yapacağız? Dallara atlayabilirken gereksiz commit'leri nasıl engelleriz? İşte bu eğitim tam da bunu anlatıyor. ## Çalışmayı Gizleme Diyelim ki bir proje dalında çalışıyorsunuz ve bazı dosyaları değiştiriyorsunuz. Şimdi ``git status`` komutunu çalıştırırsanız dosyalardaki değişiklikleri görebilirsiniz. ``` $ git durumu # Dal ana üzerinde # Taahhüt edilecek değişiklikler: # (sahnelemeyi kaldırmak için "git reset HEAD ..." komutunu kullanın) # # değiştirildi: index.html # # Değişiklikler commit için hazır değil: # (ne taahhüt edileceğini güncellemek için "git add ..." kullanın) # # değiştirildi: lib/simplegit.rb # ``` Şimdi dalınızı değiştirmek istiyorsunuz, ancak henüz herhangi bir değişiklik yapmak istemiyorsunuz; böylece değişikliklerinizi kaydedebilirsiniz. Yığına yeni bir kaynak eklemek için ``git stash`` komutunu çalıştırın: ``` $ git saklama Çalışma dizini ve dizin durumu kaydedildi \ "Ana projedeki WIP: 049d078 dizin dosyasını ekledi" HEAD artık 049d078'de, dizin dosyası eklendi (Geri yüklemek için "git stash apply" yazın) ``` Artık çalışma dizininiz temiz, ```git status``` kullanın: ``` $ git durumu # Dal ana üzerinde taahhüt edilecek bir şey yok, çalışma dizini temiz ``` Artık istediğiniz sektöre girip işinizi yapabilirsiniz; Gizli değişiklikler bir yığın olarak saklanır. Yığınınızda hangi stash'leri sakladığınızı görmek için ``git stash list`` komutunu kullanabilirsiniz: ``` $ git stash listesi stash@{0}: WIP on master: 049d078 dizin dosyasını ekledi stash@{1}: Ana dosyada WIP: c264051 "dosya_boyutu eklendi" geri alındı stash@{2}: WIP ana bilgisayarda: 21d80a5 günlüğe sayı eklendi ``` Az önce sakladığınız değişiklikleri tekrar uygulamak isterseniz ``git stash apply`` komutunu kullanabilirsiniz. Bu komutla son kaydedilen dosyayı tekrar uygulayabilirsiniz. Başka bir dosyayı yeniden uygulamak için, onu şu şekilde adlandırarak belirtebilirsiniz: ```git stash apply ```, `` ``` yerine stash'in adını yazın ve yeniden göndermem gerekiyor. ``` $ git stash uygula # Dal ana üzerinde # Değişiklikler commit için hazır değil: # (ne taahhüt edileceğini güncellemek için "git add ..." kullanın) # # değiştirildi: index.html # değiştirildi: lib/simplegit.rb # ``` Git'in, pozisyonu kaydettiğinizde sildiğiniz dosyayı yeniden düzenlediğini görebilirsiniz. Bu durumda, stash'i uygulamaya çalıştığınızda temiz bir çalışma dizininiz vardı ve stash'i, stash'i aldığınız aynı şubeye uygulamaya çalıştınız; Ancak kutuları başarılı bir şekilde kullanmak için temiz bir çalışma dizinine sahip olmak ve onu aynı dalda kullanmak gerekli değildir. Kutularınızı bir dala kaydedebilir, daha sonra başka bir dala geçebilir ve değişiklikleri yeni dala yeniden uygulayabilirsiniz. Stash'i uyguladığınızda çalışma dizininizde değiştirilmiş ve açılmamış dosyalar da olabilir, başka hiçbir şey temiz bir şekilde uygulanmazsa git birleştirme çakışmaları verir. Dosyalarınızda yaptığınız değişiklikler yeniden uygulandı, ancak oluşturduğunuz dosya yeniden yüklenmedi. Bunu yapmak için, komuta aşamalı değişiklikleri yeniden uygulamasını söylemek üzere ``git stash apply`` komutunu ```--index``` ile çalıştırmanız gerekir. Bunu çalıştırırsanız, başlangıç ​​noktasına geri dönersiniz: ``` $ git stash uygula --index # Dal ana üzerinde # Taahhüt edilecek değişiklikler: # (sahnelemeyi kaldırmak için "git reset HEAD ..." komutunu kullanın) # # değiştirildi: index.html # # Değişiklikler commit için hazır değil: # (ne taahhüt edileceğini güncellemek için "git add ..." kullanın) # # değiştirildi: lib/simplegit.rb # ``` Apply komutu yalnızca kapatılan işe uygulanır, ancak iş hala yığınınızdadır. Bunu kaldırmak için, kaldırılacak yığın adıyla ``git stash drop`` komutunu çalıştırabilirsiniz. ``` $ git stash listesi stash@{0}: WIP on master: 049d078 dizin dosyasını ekledi stash@{1}: Ana dosyada WIP: c264051 "dosya_boyutu eklendi" geri alındı stash@{2}: WIP ana bilgisayarda: 21d80a5 günlüğe sayı eklendi $ git stash stash@{0}'ı bırak Stash@{0} (364e91f3f268f0900bc3ee613f9f733e82aaed43) düşürüldü ``` Son değişiklikleri yığınınızdan kaldırmak için ``git stash pop`` komutunu kullanabilirsiniz. ## Saklamayı geri al Bazı durumlarda stash değişikliklerini uygulamak, bir miktar iş yapmak, ancak başlangıçta stash'ten gelen değişiklikleri uygulamak istersiniz. Git, ``git unapply`` gibi bir komut sağlamaz, ancak stash ile ilişkili yamayı alıp ters sırada uygulayarak bu etkiyi elde edebilirsiniz: ```$ git stash show -p stash@{0} | git uygula -R``` Tekrar ediyorum, eğer bir stash belirtmezseniz Git en son stash'i varsayar: ```$ git stash göster -p | git uygula -R``` Bir takma ad oluşturup ``stash-unapply`` komutunu Git'inize eklemek isteyebilirsiniz. Örneğin: ``` $ git config --global alias.stash-unapply '!git stash göster -p | git uygula -R' $ git stash uygula $ #... çalış çalış çalış $ git stash-unapply ``` ## Stash'tan bir dal oluşturma Eğer yaptığınız bir çalışmayı kaydedip bir süre orada bıraktıktan sonra, gizlediğiniz dalda çalışmaya devam ederseniz, tekrar çalıştığınızda sorun yaşayabilirsiniz. Bir uygulama sizin daha önce değiştirdiğiniz bir dosyayı değiştirmeye çalışırsa, birleştirme çakışması oluşur ve bunu çözmeniz gerekir. Stash değişikliklerinizi daha basit bir şekilde test etmek istiyorsanız, sizin için yeni bir dal oluşturan, işinizi stash ettiğinizde yaptığınız commit'leri kontrol eden ve işinizi yeniden yerleştiren ``git stash branch`` komutunu çalıştırabilirsiniz. orada ve ardından başarıyla uygulandığında kutuyu sıfırlar: ``` $ git stash branch testchanges "testchanges" adlı yeni bir dala geçildi # Branch testchanges üzerinde # Taahhüt edilecek değişiklikler: # (sahnelemeyi kaldırmak için "git reset HEAD ..." komutunu kullanın) # # değiştirildi: index.html # # Değişiklikler commit için hazır değil: # (ne taahhüt edileceğini güncellemek için "git add ..." kullanın) # # değiştirildi: lib/simplegit.rb # Refs/stash@{0} (f0dfc4d5dc332d1cee34a634182e168c4efc3359) düşürüldü ``` Bu, gizli çalışmayı kolayca geri yüklemek ve yeni bir dalda üzerinde çalışmak için iyi bir kısayoldur. ================================================ FILE: docs/additional-material/translations/Turkish/undoing-a-commit.tr.md ================================================ # Yerel onayları geri al Yerel onayları geri almak için yapmanız gereken tek şey ``` git sıfırlama ``` Bu komut, staging alanını son commit'e sıfırlayacaktır, ancak çalışma dizininizde yapılan değişiklikler değişmeyecektir. Bu şekilde, yaptığınız değişiklikleri tekrar uygulayabilirsiniz. Veya, önceki bir commit'ten sadece bir dosyayı kaldırmak istiyorsanız. Daha sonra aşağıdaki komutu uygulayabilirsiniz ``` git reset ``` Komut yalnızca belirtilen dosyayı hazırlama alanından kaldıracaktır, ancak dosyada yapılan değişiklikler yine de kalacaktır. ```git reset``` kullanımına örnek ``` # index.php ve tutorial.php'de değişiklikler yapın # Dosyaları sahneleme alanına ekleyin $ git add . # Her iki dosyanın da ayrı ayrı commit edilmesi gerektiğini unutmayın # Unstage öğreticisi.php $ git sıfırlama öğreticisi.php # Önce index.php'yi işleyin $ git commit -m "index.php değiştirildi" # Şimdi tutorial.php'yi gönder $ git add öğretici.php $ git commit -m "tutorial.php değiştirildi" ``` Diyelim ki yerel depolama alanınızı bozdunuz ve onu sadece son commit'e sıfırlamak istiyorsunuz. Daha sonra aşağıdaki komutu çalıştırabilirsiniz. ``` git reset --hard ``` Komut sadece hazırlama alanınızı sıfırlamakla kalmayacak, aynı zamanda dosyalardaki tüm değişikliklerinizi son commit'inize geri döndürecektir. ``--hard`` modu Git'e çalışma dizinindeki tüm değişiklikleri geri almasını söyler. Bunu yalnızca tüm yerel geliştirmeyi çöpe atacağınızdan gerçekten eminseniz çalıştırmalısınız. ```git reset --hard``` kullanım örneği ``` # Çılgın bir deney başlatmaya karar verdim # Yeni bir 'crazy.php' dosyası oluşturun ve içine biraz kod ekleyin # crazy.php'yi yükle $ git add crazy.php $ git commit -m "Çılgın bir geliştirme başlatıldı" # crazy.php dosyasını tekrar düzenleyin ve diğer birçok dosyayı değiştirin # Takip edilen tüm dosyaları kaydet $ git add . $ git commit -m "Devam eden geliştirme" # Test edildi ve işler kontrolden çıktı # Her şeyi kaldırmaya karar verdim $ git reset --hard HEAD~2 ``` ```git reset --hard HEAD~2``` geçerli dalı her seferinde 2 commit geriye taşır, yaptığınız tüm değişiklikleri geri alır ve az önce oluşturduğumuz 2 anlık görüntüyü proje geçmişinden kaldırır. Not: Eğer commit'lerinizi paylaşımlı bir depoya taşıdıysanız asla ``git reset --hard`` komutunu çalıştırmayın, çünkü bu tüm depolarla sorunlara yol açacaktır. ================================================ FILE: docs/additional-material/translations/Twi/additional-matrial-twi.md ================================================ # Additional information Yɛfa no sɛ woakenkan mfitiaseɛ nkyerɛkyerɛ no dedaw ansa na woaba ha. ### [Commit bi a Wɔsesa](amending-a-commit-twi.md) Saa krataafa yi bɛma wo nsɛm a ɛhia sɛ wobɛsesa commit wɔ akyirikyiri akoraeɛ:> Fa yei siesie commit a woayɛ. ### [Git a Wɔrehyehyɛ](configuring-git.md) Saa krataafa yi bɛma wo nsɛm a wuhia na wode asiesie ɔdefoɔ ho nsɛm ne akwan foforɔ a wobɛfa so wɔ git mu:> Fa yei di dwuma ma wo git nhyehyɛɛ no ​​so tumi yie. ### [Wo Fork a Wobɛma Ne Adekorabea no Ahyia a Ɛsono](forking-a-repository-twi.md) Saa nwoma yi ma wo nsɛm a ɛfa sɛdeɛ wobɛma forked repository ayɛ foforɔ wɔ source repository no ho. Eyi ho hia, na yɛwɔ anidaso sɛ wo ne afoforo pii bɛboa ma wɔayɛ adwuma yi. ### [Commit a Wobɛtu akɔ Baa Dwumadibea a Ɛsono](committing-to-a-forked-repository-twi.md) Saa krataafa yi bɛma wo nsɛm a wuhia na wode commit akɔ baa dwumadibea foforo: Di anammɔn yi akyi na wode commit akɔ baa dwumadibea foforo. ### [Fael bi a Wobeyi afi Mu] (adding-a-file-to-a-repository-twi.md) Kratafa yi bɛma wo nsɛm a wuhia na wode ayi fael bi afi wo mpɔtam hɔ adekorabea: Di anammɔn yi akyi na sua sɛnea wobɛpopa fael bi ansa na woayɛ commit. ### [Baa Biara a Wobeyi Fi Wo Adekorabea no Ahyia a Ɛsono](adding-an-existing-file-to-a-repository-twi.md) Saa krataafa yi bɛma wo nsɛm a wuhia na wode apopa baa dwumadibea bi afi wo adekorabea: Di anammɔn yi akyi bere a wɔaka wo twe abisade no abom akyi nkutoo. ### [Nkabom Ntawntawdi a Wobesiesie](creating-a-pull-request-twi.md) Kratafa yi bɛma wo nsɛm a wuhia na wode asiesie nkabom ntawntawdi ho nsɛm: Di anammɔn yi akyi na woasiesie nkabom ntawntawdi a ɛtaa yɛ ɔhaw yi. ### [Wo Adekorabea a Wɔwɔ Git a Wɔrehyɛ](configuring-a-repository-for-git-twi.md) Saa krataafa yi bɛma wo nsɛm a wuhia na wode asiesie wo adekorabea a wɔwɔ git a wɔrehyɛ: Di anammɔn yi akyi na wode asiesie wo adekorabea a wɔwɔ git a wɔrehyɛ. ### [San kɔ Commit bi so](reverting-a-commit-twi.md) Saa krataafa yi bɛboa wo sɛ ɛhia sɛ wosan kɔ commit a atwam wɔ akyirikyiri akoraeɛ no so a. ### [Squashing Commits a Wɔde Di Dwuma](squashing-commits-twi.md) Saa krataafa yi bɛkyerɛ wo sɛnea wobɛbɔ commits pii akɔ commit biako mu:Fa eyi di dwuma sɛ wopɛ sɛ wode pull request kɔ na reviewer no ka kyerɛ wo sɛ "squash" commits nyinaa kɔ biako mu a nkrasɛm a ɛkɔ akyiri ka ho a. ### [Mpɔtam Hɔ Commit bi a Wɔretu](resetting-a-commit-twi.md) Saa krataafa yi ma wo nsɛm a wuhia na wode asan ahyɛ commit bi a ɛwɔ wo mpɔtam hɔ akorae no mu. ### [Nkitahodi a Mfaso Wɔ So](useful-links-for-git-twi.md) Saa krataafa yi yɛ nea wɔde ama afotuo ne akwansideɛ sites, blogs, ne sites a ɛboa mpɛn pii a ɛma yɛn asetena yɛ mmerɛ nyinaa. Wɔyɛ nsɛm a wɔde gyina hɔ ma a eye kyɛn so a wode bedi w’ahiade nyinaa ho dwuma, sɛ́ ebia woyɛ obi a woafi ase anaasɛ woyɛ onimdefo no. ### [.gitignore Fael a wɔrebɔ](creating-a-gitignore-file-twi.md) Saa krataa yi kyerɛkyerɛ .gitignore fael atirimpɔw, nea enti a wode bedi dwuma, ne sɛnea wobɛbɔ bi. Ɛkame ayɛ sɛ wɔde saa fael yi di dwuma wɔ Git nnwuma nyinaa mu. ================================================ FILE: docs/additional-material/translations/Twi/amending-a-commit-twi.md ================================================ ================================================ FILE: docs/additional-material/translations/Ukrainian/removing-a-file.ua.md ================================================ # Видалення файлу з-під GIT контролю Іноді може виникнути необхідність видалити файл з-під GIT контролю, але зберегти його на комп'ютері. Це може бути досягнуто за допомогою наступної команди: `` Git rm <файл> --cached`` ## Що ж сталося? GIT більш не контролює зміни у віддаленому файлі. З точки зору GIT'а, його немає, але якщо ви спробуєте локалізувати цей файл в файловій системі, то ви побачите, що він все ще на місці. Зауважте, що в наведеній вище комманде використовується ключ `--cached`. Якби ми не додали цей ключ, GIT знищив би файл не тільки зі сховищ, але також і з файлової системи. Якщо ви зробите Комміт за допомогою команди `git commit -m" Видалити file1.js "` і потім запущено його в віддалений репозиторій командою `git push origin master`, файл буде стертий також і з віддаленого сховища. ## Додаткова інформація - Якщо ви хочете видалити більше одного файлу, це можна зробити, перерахувавши всі файли в одній команді:     `Git rm file1.js file2.js file3.js --cached` - Ви можете використовувати шаблон (*) для видалення файлів з близькими іменами, наприклад, якщо ви хочете видалити всі .txt файли з локального сховища, наберіть:     `Git rm * .txt --cached` ================================================ FILE: docs/additional-material/translations/Urdu/additional-material.ur.md ================================================ # اضافی معلومات ہم سمجھتے ہیں کہ آپ یہاں آنے سے پہلے بنیادی سبق کے ساتھ پہلے ہی ختم ہو چکے ہیں. اضافی معلومات آپ کو اعلی درجے کی گیٹ کی تکنیک کے بارے میں کچھ معلومات دے گی. ### [ایک ارتکاب ترمیم] (amending-a-commit.md) یہ دستاویز دور دراز ذخیرہ پر ایک عہد میں ترمیم کے بارے میں معلومات فراہم کرتا ہے. > اس کا استعمال کریں جب آپ نے ایک عہد کو ایڈجسٹ کرنے کی ضرورت ہے. ### [Git ترتیب دیں] (configuring-git.md) یہ دستاویز صارف کی تفصیلات اور Git میں دیگر اختیارات کو ترتیب دینے کے بارے میں معلومات فراہم کرتا ہے. > اپنی گیٹ ترتیب کو بہتر بنانے کے لئے اس کا استعمال کریں. ### [آپ کانٹا مخزن کے ساتھ موافقت پذیر رکھنا] (keeping-your-fork-synced-with-this-repository.md) یہ دستاویزی معلومات فراہم کرتی ہے کہ بیس ذخیرہ کے ساتھ اپ ڈیٹ شدہ ذخیرہ رکھنے کی تاریخ کیسے برقرار رکھے گی. یہ ضروری ہے، امید ہے کہ آپ اور بہت سے دوسرے منصوبے میں حصہ لیں گے. > ان مرحلے پر عمل کریں اگر آپ کے والدین والدین کی ذخیرہ میں کوئی تبدیلی نہیں ہے. ### [چلتی ایک مختلف برانچ کا ارتکاب] (moving-a-commit-to-a-different-branch.md) یہ دستاویز کسی اور برانچ میں کمیٹی منتقل کرنے کے بارے میں معلومات فراہم کرتا ہے. > دوسری شاخ کو انجام دینے کے لۓ ان اقدامات کریں. ### [ایک فائل اتارنے] (removing-a-file.md) یہ دستاویز آپ کے مقامی ذخیرہ سے ایک فائل کو ہٹانے کے بارے میں معلومات فراہم کرتا ہے. > ایک وعدہ سے پہلے ایک فائل کو ہٹانے کے بارے میں سیکھنے کے لئے ان اقدامات پر عمل کریں ### [آپ مخزن سے شاخ ہٹا رہا ہے] (removing-branch-from-your-repository.md) یہ دستاویز آپ کے ذخیرہ سے ایک شاخ کو کیسے خارج کرنے کے بارے میں معلومات فراہم کرتا ہے. > آپ کے پل کی درخواست مل گئی ہے کے بعد صرف ان اقدامات کریں. ### [حل تنازعات کو ضم کریں] (resolving-merge-conflicts.md) یہ دستاویز مرگ تنازعات کو حل کرنے کے بارے میں معلومات فراہم کرتا ہے. > پریشانی مر تنازعات کو حل کرنے کے لئے ان اقدامات کریں. ### [ایک ارتکاب لوٹا رہا ہے] (reverting-a-commit.md) یہ دستاویز دور دراز ذخیرہ پر ایک عہد کو واپس کرنے کے بارے میں معلومات فراہم کرتا ہے. یہ کام میں آتا ہے اس صورت میں جب آپ کو کسی ایسے وعدے کو رد کرنے کی ضرورت ہوتی ہے جو پہلے ہی گیتوب کو منتقل کردی گئی ہے. > اگر آپ کسی وعدے کو ریورس کرنا چاہتے ہیں تو ان اقدامات کریں. ### [اسکواشنگ کمیٹیاں] (squashing-commits.md) یہ دستاویز ایک انٹرایکٹو بغاوت کے ساتھ کام کرتا ہے کس طرح اسکواش کس طرح کے بارے میں معلومات فراہم کرتا ہے. > اس کا استعمال کریں اگر آپ ایک کھلی منبع پراجیکٹ میں پی آر کھولنا چاہتے ہیں اور تجزیہ کار آپ کو ہر ایک کو ایک باضابطہ وعدہ پیغام کے ساتھ اسکواش کرنے سے پوچھتا ہے. ### [کالعدم کنڈ ایک مقامی ارتکاب] (undoing-a-commit.md) یہ دستاویز آپ کے مقامی ذخیرہ پر ایک وعدے کو کس طرح رد کرنے کے بارے میں معلومات فراہم کرتا ہے. جب آپ محسوس کرتے ہیں کہ آپ نے اپنے مقامی ذخیرہ کو مسلط کیا ہے اور مقامی ذخیرہ کو ری سیٹ کرنے کا ارادہ رکھتے ہیں تو یہ وہی ہے. > اگر یہ ایرر برقرار رہے تو ہمارے ہیلپ ڈیسک سے رابطہ کریں. غلط استعمال کی اطلاع دیتے ہوئے ایرر آ گیا ہے. ### [مفید روابط] (Useful-links-for-further-learning.md) یہ دستاویز تمام بلاگز خطوط، مددگار سائٹس، تجاویز اور چالوں کی ویب سائٹوں کے لئے وقف ہے جو ہماری جانوں کو آسان بنا دیتا ہے. کہ ہم اپنی تمام ضروریات کے لئے حوالہ دیتے ہیں، یہ ایک ابتدائی یا ایک ماہر بنیں. یہ صفحہ ان تمام مفید لنکس کی ایک انڈیکس کے طور پر کام کرنا چاہیے جو ہر فرد کو کھلے منبع ڈومین میں یا کسی کو مزید جاننے کے لئے مدد کرے گا. ================================================ FILE: docs/additional-material/translations/Urdu/amending-a-commit.ur.md ================================================ کمانڈر ترمیم # اگر آپ اپنے دور دراز ذخیرہ میں تبدیلی کرتے ہیں تو صرف اس کے بعد احساس کرنے کے لۓ آپ کے پاس وعدہ کردہ پیغام میں ٹائپو ہے یا آپ کو اپنے حالیہ حاکموں میں ایک لائن شامل کرنا بھول گیا ہے. تم اس میں کیسے ترمیم کرتے ہو؟ یہ وہی ہے جو سبق کا احاطہ کرتا ہے. ## آپ Github کے لئے دھکیل دیا ہے کے بعد ایک حالیہ پیغام کا ارتکاب تبدیل کرنا. کسی فائل کو کھولنے کے بغیر ایسا کرنے کے لئے: * میں ٹائپ کریں `` `git commit --amend -m "اپنا نیا ارتکاب کے بعد پیغام "` `` ارتکاب * ذخیرہ کرنے کے لئے تبدیل کرنے کے لئے چلائیں `` `git push origin ` ``. نوٹ: اگر آپ صرف ``` git commit --amend ``` میں ٹائپ کریں تو، آپ کے ٹیکسٹ ایڈیٹر آپ کو وعدہ پیغام میں ترمیم کرنے کے لئے فوری طور پر کھولیں گے. `` -m`` جھگڑے کو شامل کرنے سے روکتا ہے. ## ایک واحد پر ترمیم کا ارتکاب لہذا، اگر ہم ایک ہی لفظ کو تبدیل کرنے کی طرح ایک فائل میں ایک معمولی تبدیلی کرنے کے لئے بھول گئے ہیں اور ہم نے پہلے سے ہی ہمارے دور دراز ذخیرہ کرنے کے لئے وعدے کو دھکا دیا ہے؟ یہاں وضاحت کرنے کے لئے میری اقلیت کی لاگت ہے: `` ` g56123f create file bot file a2235d updated contributor.md a5da0d modified bot file `` ` آتے ہیں کہ میں بوٹ فائل میں ایک ہی لفظ شامل کرنے کے لئے بھول گیا اس کے بارے میں جانے کے لۓ 2 طریقے ہیں. سب سے پہلے ایک مکمل طور پر نیا وعدہ ہے جو اس طرح کی تبدیلی پر مشتمل ہے: `` ` g56123f create file botfile a2235d updated contributor.md a5da0d modified botfile b0ca8f added single word to botfile `` ` دوسرا طریقہ 5da0d وعدہ میں ترمیم کرنا ہے، اس نئے لفظ کو شامل کریں اور یہ ایک عہد کے طور پر جتھوٹ کو دھکا دیں. دوسری آواز بہتر ہے کیونکہ یہ صرف ایک معمولی تبدیلی ہے. اس کو حاصل کرنے کے لئے، ہم مندرجہ ذیل کریں گے: * فائل میں ترمیم کریں. اس صورت میں، میں نے پہلے ہی اتار دیا گیا لفظ شامل کرنے کے لئے میں botfile میں ترمیم کریں گے. * اگلا، فیلڈ اسٹینج علاقے میں `` `git add ` `` عام طور پر اسٹینجنگ علاقے میں فائلوں کو شامل کرنے کے بعد، ہمارا اگلا کام ہمارا وعدہ ہے - ہمارا وعدہ پیغام "صحیح ہے؟ لیکن چونکہ ہم یہاں حاصل کرنا چاہتے ہیں اس سے پچھلے وعدوں میں ترمیم کرنا ہے، ہم اس کے بجائے چلائیں گے: * `` `git commit --amend ` ``  اس کے بعد ٹیکسٹ ایڈیٹر کو لانے اور پیغام کو ترمیم کرنے کے لئے آپ کو فوری طور پر کریں گے. آپ پیغام کو چھوڑنے کا فیصلہ کر سکتے ہیں کیونکہ اس سے پہلے تھا یا اسے تبدیل کر دیا گیا تھا. * ایڈیٹر سے باہر نکلیں * اپنی تبدیلیوں کو دھکا دیں `` `git push origin ` `` اس طرح، دونوں تبدیلیاں ایک ہی انجام میں ہو گی. ================================================ FILE: docs/additional-material/translations/Vietnamese/moving-a-commit-to-a-different-branch.vi.md ================================================ # Di chuyển một commit tới một nhánh khác Điều gì sẽ xảy ra nếu bạn thực hiện một cam kết và sau đó nhận ra mình đã thay đổi sai nhánh? Làm thế nào để khắc phục lỗi này? Hướng dẫn này trả lời câu hỏi này. ## Di chuyển các cam kết mới nhất đến một nhánh hiện có Để di chuyển theo cách này, gõ: ```git reset HEAD~ --soft``` - Hoàn nguyên lần xác nhận cuối cùng, nhưng giữ nguyên các thay đổi đã thực hiện. ```git stash``` - Lưu trạng thái của một thư mục. ```git kiểm tra ``` - Chuyển sang nhánh khác. ```git stash pop``` - Trả về trạng thái đã lưu cuối cùng. ```git add .``` - Thêm các tệp riêng lẻ. ```git commit -m "your comment"``` - Lưu và xác nhận các thay đổi. Những thay đổi của bạn hiện đang ở đúng nhánh. ### Di chuyển các cam kết gần đây sang một nhánh mới Để di chuyển theo cách này, gõ: ```git Branch newbranch``` - Tạo một nhánh mới, giữ nguyên tất cả các cam kết. ```git reset --hard HEAD~[n]``` - Đặt lại nhánh chính trở lại n lần xác nhận. Hãy nhớ rằng những thay đổi có trong các cam kết này sẽ bị xóa hoàn toàn khỏi nhánh chính. ```gitcheck newbranch``` - Chuyển sang nhánh bạn đã tạo. Nhánh này hiện chứa tất cả các cam kết. Hãy nhớ rằng: Mọi thay đổi không có trong cam kết sẽ bị MẤT hoàn toàn. ================================================ FILE: docs/additional-material/translations/Vietnamese/resolving-merge-conflicts.vi.md ================================================ # Mâu Thuẫn Khi Tích Hợp là gì? Khi bạn cố gắng tích hợp một nhánh khác vào nhánh làm việc hiện tại của bạn, bạn đang thực hiện các thay đổi từ bối cảnh khác và kết hợp chúng với các tệp tin hiện tại bạn đang làm việc. Nếu hai người đã thay đổi cùng một dòng trong cùng một tệp hoặc nếu một người quyết định xóa nó trong khi người kia quyết định sửa đổi nó, Git không thể xác định đâu là phiên bản chính xác. Git sau đó sẽ đánh dấu tệp là có xung đột - điều mà bạn sẽ phải giải quyết trước khi bạn có thể tiếp tục công việc của mình. # Làm thế nào để giải quyết xung đột khi tích hợp? Khi đối mặt với việc xảy ra xung đột khi tích hợp, git sẽ đánh dấu khu vực có vấn đề trong tệp bằng cách đặt nó vào trong `<<<<<<<<< HEAD` và `>>>>>>>>>>[other branch name]` Các nội dung sau điểm đánh dấu đầu tiên bắt nguồn từ nhánh làm việc hiện tại của bạn. Sau dấu ngoặc nhọn, Git cho chúng ta biết những thay đổi đến từ đâu (từ nhánh nào). Dòng có `=======` phân tách hai thay đổi xung đột. Công việc của chúng tôi bây giờ là giải quyết những dòng này: khi chúng ta hoàn thành, tệp sẽ trông chính xác như chúng ta muốn. Nên tham khảo ý kiến của người đồng đội đã viết những thay đổi mâu thuẫn để quyết định phiên bản nào sẽ là bản cuối cùng. Nó có thể là của bạn - hoặc có thể là hỗn hợp giữa hai người. Ví dụ: ``` <<<<<<< HEAD:mergetest This is my third line ======= This is a fourth line I am adding >>>>>>> 4e2b407f501b68f8588aa645acafffa0224b9b78:mergetest ``` `<<<<<<<`: Cho biết nơi bắt đầu của các dòng có xung đột khi tích hợp. Những dòng đầu tiên là các dòng từ tệp tin mà bạn đang thử tích hợp các thay đổi vào. `=======`: Cho biết điểm phân chia được sử dụng để so sánh các thay đổi. Phân chia các thay đổi mà người dùng đã cam kết (ở trên) đối với các thay đổi đến từ nhánh tích hợp (bên dưới) để thấy rõ sự khác biệt. `>>>>>>>`: Cho biết kết thúc của các dòng có xung đột khi tích hợp. Bạn giải quyết xung đột bằng cách chỉnh sửa tệp và sau đó tích hợp thủ công các phần của tệp mà git gặp sự cố khi tích hợp. Điều này có thể có nghĩa là loại bỏ các thay đổi của bạn hoặc của người khác hoặc đi tới việc kết hợp thay đổi của cả hai. Bạn cũng sẽ cần xóa '<<<<<<<', '=======' và '>>>>>>>' trong tệp. Một khi bạn đã giải quyết xung đột, chạy lệnh `git add`. Đừng quên chạy thử nghiệm, vì bạn phải chắc chắn rằng bạn đã giải quyết được xung đột. Bạn cũng có thể tải xuống các plugin khác nhau tùy thuộc vào IDE bạn đang sử dụng để có cách dễ dàng hơn để giải quyết xung đột hợp nhất. # Làm thế nào để hoàn tác lại tích hợp? Nếu bạn muốn hoàn tác lại tích hợp thì bạn có thể thực hiện `git merge —abort` ================================================ FILE: docs/cli-tool-tutorials/git-cli-tutorial-PL.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions | GitHub Desktop | 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. \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. \ \ \Jeśli podczas wypychania wystąpią błędy, kliknij tutaj:\ \ - ### Authentication Error      \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/)\/first-contributions.git/'\   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. \ ----- # 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) ================================================ FILE: docs/cli-tool-tutorials/git-cli-tutorial-bengali.md ================================================ প্রথম অবদান (First Contribution) Git Bash Git Bash সংস্করণ প্রথমবার কিছু করলে সেটা কঠিন মনে হয়। বিশেষ করে যখন সহযোগিতামূলক কাজ হয়, তখন ভুল করার ভয় থাকে। কিন্তু ওপেন সোর্স মানেই সহযোগিতা – একসাথে কাজ করা। আমরা চেয়েছি নতুন ওপেন সোর্স অবদানকারীদের জন্য শেখার পথ সহজ করা। শুধু টিউটোরিয়াল পড়ে বা ভিডিও দেখে নয় – বরং হাতে কলমে প্র্যাকটিস করে শিখলে অনেক দ্রুত বোঝা যায়। এই প্রোজেক্টের উদ্দেশ্য হলো নতুনদের গাইড করা এবং তাদের প্রথম অবদান রাখার অভিজ্ঞতাকে সহজ করা। মনে রাখবেন, আপনি যত বেশি স্বাচ্ছন্দ্যবোধ করবেন, শেখাও তত ভালো হবে। যদি আপনি উইন্ডোজ ব্যবহার করেন এবং আপনার কাছে Git Bash না থাকে, এখান থেকে ইন্সটল করুন । fork this repository এই রিপোজিটরিকে Fork করুন এই পেজের উপরের ডান দিকে থাকা Fork বাটনে ক্লিক করুন। এতে করে আপনার গিটহাব অ্যাকাউন্টে এই রিপোজিটরির একটি কপি তৈরি হবে। রিপোজিটরি ক্লোন করুন এবার আপনার ফোর্ক করা রিপোজিটরিটি নিজের কম্পিউটারে ক্লোন করুন। ⚠️ খেয়াল রাখবেন: মূল রিপোজিটরি ক্লোন করবেন না, বরং নিজের ফোর্ক থেকে ক্লোন করতে হবে। ১. আপনার রিপোজিটরির পেজে যান, "Code" বাটনে ক্লিক করুন এবং সেখানে দেওয়া লিঙ্ক কপি করুন। copy string ২. Git Bash অ্যাপ্লিকেশন খুলুন। উইন্ডোজে এটি নিচের ছবির মতো দেখাবে: open git bash terminal ৩. সেই ফোল্ডারে যান যেখানে আপনি প্রোজেক্টটি রাখতে চান: cd cd into a folder ৪. এবার রিপোজিটরিটি ক্লোন করুন: git clone clone the repository ৫. ক্লোন করা ডিরেক্টরিতে যান এবং Visual Studio Code এ ওপেন করুন: cd into the newly cloned repo একটি নতুন ব্রাঞ্চ তৈরি করুন নিচের কমান্ড ব্যবহার করে একটি নতুন ব্রাঞ্চ তৈরি করুন এবং সেই ব্রাঞ্চে চলে যান: git checkout -b 👉 আপনার ব্রাঞ্চের নাম দিন । যেমন: add-james-smith create a branch পরিবর্তন করুন এবং Commit করুন ১. Contributors.md ফাইল ওপেন করুন। ২. নিচের দিকে স্ক্রল করুন এবং সেখানে আপনার নাম যোগ করুন। ৩. ফাইলটি সেভ করুন। উদাহরণ: [James Smith](https://github.com/jamessmith) পরিবর্তন হয়েছে কিনা দেখতে: git status check the status ফাইল স্টেজ করতে: git add file-name কমিট করতে: git commit -m "Add your-name to Contributors list" 👉 এর জায়গায় নিজের নাম লিখবেন। commit changes কমিট চেক করতে চাইলে: git log --oneline পরিবর্তন GitHub এ Push করুন সব ধাপ শেষ হলে পরিবর্তনগুলো GitHub এ পাঠাতে হবে: git push origin push changes Pull Request পাঠান GitHub এ আপনার রিপোজিটরিতে গেলে Compare & pull request বাটন দেখতে পাবেন। সেখানে ক্লিক করুন। create a pull request এরপর Pull Request সাবমিট করুন। submit pull request শীঘ্রই আপনার পরিবর্তনগুলো মূল রিপোজিটরির master ব্রাঞ্চে মার্জ হয়ে যাবে। পরিবর্তন মার্জ হলে ইমেইলে নোটিফিকেশন পাবেন। এরপর কী করবেন? অভিনন্দন 🎉 আপনি এখনই সাধারণ fork → clone → edit → PR ওয়ার্কফ্লো সম্পন্ন করলেন, যা একজন অবদানকারী হিসেবে বারবার ব্যবহার করতে হবে। 👉 আপনার অবদান উদযাপন করুন এবং ওয়েব অ্যাপ থেকে বন্ধুদের সাথে শেয়ার করুন। 👉 কোনো প্রশ্ন থাকলে বা সাহায্যের প্রয়োজন হলে আমাদের Slack টিমে যোগ দিতে পারেন: স্ল্যাক টিমে যোগ দিন । অতিরিক্ত উপকরণ অন্য টুল ব্যবহার করে টিউটোরিয়াল মূল পাতায় ফিরে যান ================================================ FILE: docs/cli-tool-tutorials/git-cli-tutorial-kannada.md ================================================ --- [![ಓಪನ್ ಸೋರ್ಸ್ ಪ್ರೀತಿ](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![ಲೈಸೆನ್ಸ್: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![ಓಪನ್ ಸೋರ್ಸ್ ಸಹಾಯಕರು](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # ಮೊಟ್ಟ ಮೊದಲನೆಯ ಕೊಡುಗೆಗಳು | GitHub ಡೆಸ್ಕ್‌ಟಾಪ್ | GitHub ಕಮಾಂಡ್ ಲೈನ್ ಇಂಟರ್‌ಫೇಸ್ (CLI) | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------| ಇದು ಟರ್ಮಿನಲ್ ನರ್ಡ್ಸ್ ಎಂದರೆ, ಟರ್ಮಿನಲ್‌ನಲ್ಲಿ ಎಲ್ಲವನ್ನೂ ಮಾಡಲು ಬಯಸುವ ನಮಗೆ ಮಾರ್ಗದರ್ಶಿ ಮತ್ತು [Github-CLI](https://cli.github.com/) ಗೆ ಧನ್ಯವಾದಗಳು, ನಾವು ಇದನ್ನು ಸಾಧಿಸಬಹುದು, ನಿಮ್ಮ ಮೊದಲ ಕೊಡುಗೆಯನ್ನು ಮೋಜಿನ, ಪ್ರಶಸ್ತಿಯ ಮತ್ತು ಮುಂದುವರಿಯಲು ಉತ್ತೇಜಕವಾಗಿರಬೇಕು ಎಂದು ನೆನೆಸಿಕೊಳ್ಳಿ! ಈ ಮಾರ್ಗದರ್ಶಿ ಸ್ವಲ್ಪ ಹೆಚ್ಚು ಸವಾಲಿನಂತಿರುತ್ತದೆ ಏಕೆಂದರೆ ನಾವು ಯಾವುದೇ ಗ್ರಾಫಿಕಲ್ ಇಂಟರ್‌ಫೇಸ್ ಅನ್ನು ಬಳಸುತ್ತಿಲ್ಲ, ಆದರೆ ಇದು ಹೀಗೆಯೇ ಸಿಹಿ ಮತ್ತು ನೀವು ಖಚಿತವಾಗಿ ಅದನ್ನು ಅನುಸರಿಸಬಹುದು! ಮೊದಲ ಅಗತ್ಯವಂತದ್ದು: - Git ಅನ್ನು ಸ್ಥಾಪಿತ ಮಾಡಬೇಕು (ಹೇಗೆ ಸ್ಥಾಪಿಸಲು [git](https://git-scm.com/downloads)) - Github ಖಾತೆ ಇದಕ್ಕೆ ನಂತರ, ನಮ್ಮ ಸಿಸ್ಟಮ್‌ನಲ್ಲಿ `github-cli` ಸಾಧನವನ್ನು [ಆಧಿಕಾರಿಕ ಡಾಕ್ಯುಮೆಂಟೇಶನ್](https://github.com/cli/cli#installation) ಅನ್ನು ಅನುಸರಿಸಿ ಸ್ಥಾಪಿಸಬೇಕು. ಆಮೇಲೆ, CLI ಗೆ ಲಾಗಿನ್ ಆಗಬೇಕಾಗಿದೆ, ಆದ್ದರಿಂದ ಈ ಕಮಾಂಡ್ ಅನ್ನು ನಮೂದಿಸಿ: ```bash gh auth login ``` ನಿರ್ದೇಶಗಳನ್ನು ಅನುಸರಿಸಿ ಮತ್ತು ನಾವು ತಯಾರಾಗಿದ್ದೇವೆ! # ಈ ರೆಪೊಸಿಟರಿಯನ್ನು ಫೋರ್ಕ್ ಮಾಡಿ ಇದು ಈ ಕಮಾಂಡ್ ಅನ್ನು ಓಡಿಸುವಷ್ಟು ಸುಲಭ: ```bash gh repo fork firstcontributions/first-contributions ``` **ಮಹತ್ವಪೂರ್ಣ: ಇದು ನೀವು ಅದನ್ನು ಕ್ಲೋನ್ ಮಾಡಲು ಇಚ್ಛಿಸುತ್ತೀರಾ ಎಂದು ಕೇಳುತ್ತದೆ, "ಹೌದು" ಆಯ್ಕೆಯನ್ನು ಆಯ್ಕೆ ಮಾಡಿ** # ನಿಮ್ಮ ಶಾಖೆಯನ್ನು ರಚಿಸಿ ನಾವು ಈ ಹಂತವನ್ನು git ಮೂಲಕ ಮಾಡುತ್ತೇವೆ, ಆದ್ದರಿಂದ ಈ ಕಮಾಂಡ್ ಅನ್ನು ನೀವು ರಚಿಸಿದ ಶಾಖೆಯ ಹೆಸರು ಇನ್‌ಪುಟ್ ಮಾಡಬೇಕಾಗಿದೆ, ಉದಾಹರಣೆಗೆ: ```bash git switch -c add-john-doe ``` # ಅಗತ್ಯವಿರುವ ಬದಲಾವಣೆಗಳನ್ನು ಮಾಡಿ ಮತ್ತು ಇ那些 ಬದಲಾವಣೆಗಳನ್ನು ಕಮಿಟ್ ಮಾಡಿ ಇದನ್ನು ಮಾಡಿದ ನಂತರ, `Contributors.md` ಫೈಲ್ ಅನ್ನು ಪಠ್ಯ ಸಂಪಾದಕದಲ್ಲಿ ತೆರೆಯಿರಿ ಮತ್ತು ನಿಮ್ಮ ಹೆಸರು ಸೇರಿಸಿ. ನಿಮ್ಮ ಹೆಸರನ್ನು ಆರಂಭ ಮತ್ತು ಅಂತ್ಯದ ನಡುವೆ ಎಲ್ಲಿಯೊ ಹಾಕಿ, ನಂತರ ಫೈಲ್ ಅನ್ನು ಉಳಿಸಿ. ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ `git status` ಅನ್ನು ಕಾರ್ಯಗತಗೊಳಿಸಿ ಮತ್ತು ನೀವು ಬದಲಾವಣೆಗಳನ್ನು ನೋಡಬಹುದು. ![image-git](https://camo.githubusercontent.com/a35c4722d7aab337eefc655d1488f7b4dc038508e6adaf5e88e2e052a976f010/68747470733a2f2f6669727374636f6e747269627574696f6e732e6769746875622e696f2f6173736574732f526561646d652f6769742d7374617475732e706e67) ಈ ಬದಲಾವಣೆಗಳನ್ನು ನೀವು ಹಾಲಿ ರಚಿಸಿದ ಶಾಖೆಗೆ ಸೇರಿಸಲು `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` ಅನ್ನು ನೀವು ಮೊದಲು ರಚಿಸಿದ ಶಾಖೆಯ ಹೆಸರು ಮೂಲಕ ಬದಲಾಯಿಸಿ.
ನಿಮ್ಮ ಬದಲಾವಣೆಗಳನ್ನು ಪುಷ್ ಮಾಡುವಾಗ ಯಾವುದೇ ದೋಷಗಳನ್ನು ಎದುರಿಸಿದರೆ, ಇಲ್ಲಿ ಕ್ಲಿಕ್ ಮಾಡಿ: - ### ಪ್ರಮಾಣೀಕರಣ ದೋಷ 
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//first-contributions.git/'
[GitHub ಗಳು SSH ಕೀ ಅನ್ನು ನಿಮ್ಮ ಖಾತೆಗೆ ಸೇರಿಸಲು ಮತ್ತು ನಿಯಂತ್ರಣವನ್ನು configure ಮಾಡುವುದು](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 ``` ಮರು submit the pull request. ನಿಮ್ಮ ಪುಲ್ ರಿಕ್ವೆಸ್ಟ್ ಅನ್ನು ಚಲನೆಯಲ್ಲಿಯೂ ನೋಡಲು `gh status` ಕಮಾಂಡ್ ಅನ್ನು ಬಳಸಬಹುದು. ## ಈಗ ಎಲ್ಲಿ ಹೋಗಬೇಕು? ಶುಭಾಶಯಗಳು! ನೀವು ಶ್ರೇಣೀಬದ್ಧವಾದ _fork -> clone -> edit -> pull request_ ಕಾರ್ಯಾಚರಣೆಯನ್ನು ಸಂಪೂರ್ಣವಾಗಿಸಿದ್ದೀರಿ, ಇದು ನೀವು ಕೊಡುಗೆಯಾಗಿ ಸಾಮಾನ್ಯವಾಗಿ ಭೇಟಿಯಾಗುವ ಪರಿಕ್ರಮೆ! ನಿಮ್ಮ ಕೊಡುಗೆಯನ್ನು ಆಚರಿಸಿ ಮತ್ತು [ವೆಬ್ ಆಪ್](https://firstcontributions.github.io/#social-share) ಗೆ ಹೋಗಿ ಮತ್ತು ನಿಮ್ಮ ಸ್ನೇಹಿತರು ಮತ್ತು ಅನುಯಾಯಿಗಳಿಗೆ ಹಂಚಿಕೊಳ್ಳಿ. ನೀವು ಸಹಾಯ ಅಥವಾ ಪ್ರಶ್ನೆಗಳಿದ್ದರೆ ನಮ್ಮ ಸ್ಲಾಕ್ ತಂಡವನ್ನು ಸೇರಿಕೊಳ್ಳಬಹುದು. [Slack ತಂಡವನ್ನು ಸೇರಿಕೊಳ್ಳಿ](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) --- Feel free to let me know if you need any further adjustments or additions! ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorial-Hindi.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # प्रथम योगदान | Git Bash | Git Bash Edition | | ------------------------------------------------------------------------------------------------------------------ | ---------------- | यह कठिन है। जब आप पहली बार कुछ करते हैं तो यह हमेशा कठिन होता है। खासकर जब आप सहयोग कर रहे हों, तो गलतियाँ करना कोई सहज बात नहीं है। लेकिन ओपन सोर्स का मतलब सहयोग और साथ मिलकर काम करना है। हम नए ओपन-सोर्स योगदानकर्ताओं के सीखने और पहली बार योगदान करने के तरीके को सरल बनाना चाहते थे। लेख पढ़ना और ट्यूटोरियल देखना मददगार हो सकता है, लेकिन बिना कुछ गड़बड़ किए वास्तव में काम करने से बेहतर क्या हो सकता है। इस परियोजना का उद्देश्य मार्गदर्शन प्रदान करना और नौसिखियों द्वारा अपना पहला योगदान करने के तरीके को सरल बनाना है। याद रखें कि आप जितने अधिक सहज होंगे, आप उतना ही बेहतर सीखेंगे। यदि आप अपना पहला योगदान करना चाहते हैं तो बस नीचे दिए गए सरल चरणों का पालन करें। हम आपसे वादा करते हैं, यह मजेदार होगा। यदि आपके पास विंडोज़ मशीन पर Git Bash नहीं है, [तो इसे इंस्टॉल करें](https://git-scm.com/download/win)। fork this repository ## इस रिपोजिटरी को फोर्क करें इस पेज के ऊपर दाईं ओर दिए गए फोर्क बटन पर क्लिक करके इस रिपो को फोर्क करें। इससे आपके खाते में इस रिपो की एक कॉपी बन जाएगी। ## रिपोजिटरी को क्लोन करें अब इस रेपो को अपनी मशीन पर क्लोन करें। महत्वपूर्ण: मूल रेपो को क्लोन न करें। अपने फोर्क पर जाएं और इसे क्लोन करें। रेपो को क्लोन करने के लिए, "कोड" पर क्लिक करें और फिर नीचे स्ट्रिंग को कॉपी करें। copy string आपने अभी जो git bash एप्लीकेशन डाउनलोड किया है उसे खोलें। अगर यह विंडोज़ मशीन पर है तो यह नीचे दी गई छवि की तरह दिखाई देगा। open git bash terminal इस कमांड का उपयोग करके उस फ़ोल्डर पर जाएँ जहाँ आप इस प्रोजेक्ट को सहेजना चाहते हैं `cd ` cd into a folder इस कमांड का उपयोग करके रिपॉजिटरी को क्लोन करने के लिए ऊपर दिए गए चरण में आपके द्वारा कॉपी की गई स्ट्रिंग का उपयोग करें `git clone ` clone the repository उस निर्देशिका पर जाएं जहां रेपो है और अपने परिवर्तन करने के लिए इसे वीएस कोड पर खोलें। cd into the newly cloned repo ## एक शाखा बनाएं अब इस सरल कमांड का उपयोग करके एक शाखा बनाएँ। यह कमांड न केवल आपके लिए एक शाखा बनाता है बल्कि आपको उस शाखा पर स्विच करने की सुविधा भी देता है। ``` git checkout -b ``` अपनी शाखा का नाम `` रखें। उदाहरण के लिए, "add-james-smith" create a branch ## आवश्यक परिवर्तन करें और उन परिवर्तनों को लागू करें अब `Contributors.md` फ़ाइल को टेक्स्ट एडिटर में खोलें, पेज के नीचे स्क्रॉल करें और उसमें अपना नाम जोड़ें, फिर फ़ाइल को सेव करें। उदाहरण: यदि आपका नाम James Smith है, तो यह इस तरह दिखना चाहिए। [James Smith](https://github.com/jamessmith) आप केवल यह आदेश चलाकर देख सकते हैं कि Contributors.md में परिवर्तन हुए हैं `git status` check the status अब उन परिवर्तनों को प्रतिबद्ध करें: सबसे पहले आपके द्वारा किए गए परिवर्तन को स्टेजिंग क्षेत्र में जोड़ें `git add file-name` फिर इस कमांड को गाकर एक कमिट संदेश लिखें `git commit -m "Add your-name to Contributors list"` `` को अपने नाम से बदलें। commit changes यह देखने के लिए कि क्या आपका कमिट हो गया है, आप एक सरल `git log --oneline` कमांड चला सकते हैं। ## परिवर्तनों को github पर भेजें एक बार जब आप उपरोक्त चरणों को पूरा कर लें तो आप इस कमांड का उपयोग करके अपने परिवर्तनों को पुश कर सकते हैं `git push origin ` push changes ## अपने परिवर्तन समीक्षा के लिए सबमिट करें यदि आप गिटहब पर अपने रिपॉजिटरी में जाते हैं, तो आपको `Compare & pull request` बटन दिखाई देगा। उस बटन पर क्लिक करें। create a pull request अब पुल अनुरोध सबमिट करें. submit pull request जल्द ही मैं आपके सभी बदलावों को इस प्रोजेक्ट की मास्टर ब्रांच में मर्ज कर दूँगा। बदलावों के मर्ज हो जाने पर आपको एक सूचना ईमेल मिलेगी। ## यहाँ से कहाँ जाएं? बधाई हो! आपने अभी-अभी मानक _fork -> clone -> edit -> PR_ वर्कफ़्लो पूरा किया है, जिसका सामना आप एक योगदानकर्ता के रूप में अक्सर करेंगे! अपने योगदान का जश्न मनाएँ और [वेब ऐप](https://firstcontributions.github.io#social-share) पर जाकर इसे अपने दोस्तों और फ़ॉलोअर्स के साथ शेयर करें। यदि आपको किसी सहायता की आवश्यकता हो या कोई प्रश्न हो तो आप हमारी स्लैक टीम में शामिल हो सकते हैं। [स्लैक टीम में शामिल हों](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)। ### [अतिरिक्त सामग्री](../additional-material/git_workflow_scenarios/additional-material.md) ## अन्य टूल का उपयोग करके ट्यूटोरियल [मुख्य पृष्ठ पर वापस जाएँ](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorial-Urdu.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # پہلی شراکتیں۔ | GitHub Desktop | GitHub Command Line Interface (CLI) | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------| یہ ہمارے لیے ایک گائیڈ ہے، ٹرمینل کے ماہرین، جو ٹرمینل میں سب کچھ کرنا چاہتے ہیں، اور شکریہ [Github-CLI](https://cli.github.com/),آپ کی پہلی شراکت کو یاد رکھتے ہوئے ہم اسے حاصل کر سکتے ہیں۔ مزہ، فائدہ مند اور جاری رکھنے کے لیے ایک محرک بنیں! یہ گائیڈ کچھ زیادہ ہی مشکل ہے کیونکہ ہم کوئی بھی گرافیکل انٹرفیس استعمال نہیں کر رہے ہیں، لیکن یہ اب بھی واقعی مزہ ہے اور آپ یقینی طور پر اس کی پیروی کر سکتے ہیں! پہلی شرط یہ ہے کہ - گٹ انسٹال ہے۔ [git](انسٹال کرنے کا طریقہ)(https://git-scm.com/downloads) - گیتھب اکاؤنٹ اب ہمیں انسٹال کرنے کی ضرورت ہے۔ `github-cli` ہمارے سسٹم میں ٹول کی پیروی کرکے [official documentation](https://github.com/cli/cli#installation) اس کے بعد، ہمیں CLI میں لاگ ان کرنے کی ضرورت ہے، لہذا یہ کمانڈ درج کریں: ```bash gh auth login ``` ہدایات پر عمل کریں اور ہم تیار ہیں! # اس ذخیرے کو فورک کریں۔ یہ اتنا ہی آسان ہے جتنا اس کمانڈ کو چلانا ```bash gh repo fork firstcontributions/first-contributions ``` **اہم: یہ آپ کو اشارہ کرے گا کہ اگر آپ اسے بھی کلون کرنا چاہتے ہیں تو "ہاں" کا اختیار منتخب کریں۔** # اپنی برانچ بنائیں ہم یہ مرحلہ گٹ کے ساتھ کریں گے، اس لیے اس کمانڈ کو اپنے نام سے بدلتے ہوئے درج کریں، مثال کے طور پر: ```bash git switch -c add-john-doe ``` # ضروری تبدیلیاں کریں اور ان تبدیلیوں کا ارتکاب کریں۔ اب آپ کھول سکتے ہیں۔ `Contributors.md` ٹیکسٹ ایڈیٹر میں فائل کریں اور اس میں اپنا نام شامل کریں۔ اپنا نام رکھو شروع اور اختتام کے درمیان کہیں بھی، پھر فائل کو محفوظ کریں۔ پروجیکٹ ڈائرکٹری میں عملدرآمد کریں۔ `git status` اور آپ تبدیلیاں دیکھیں گے۔ ![image-git](https://camo.githubusercontent.com/a35c4722d7aab337eefc655d1488f7b4dc038508e6adaf5e88e2e052a976f010/68747470733a2f2f6669727374636f6e747269627574696f6e732e6769746875622e696f2f6173736574732f526561646d652f6769742d7374617475732e706e67) ان تبدیلیوں کو اس برانچ میں شامل کریں جو آپ نے ابھی استعمال کرکے بنائی ہے۔ `git add` کمانڈ: `git add Contributors.md` اب استعمال کرکے ان تبدیلیوں کا ارتکاب کریں۔ `git commit` کمانڈ: `git commit -m "Add your-name to Contributors list` تبدیل کرنا `your-name` آپ کے نام کے ساتھ # تبدیلیوں کو گیتوب میں دبائیں۔ کمانڈ کا استعمال کرتے ہوئے اپنی تبدیلیوں کو آگے بڑھائیں۔ `git push`: ``` git push origin -u your-branch-name ``` تبدیل کرنا `your-branch-name` اس برانچ کے نام کے ساتھ جو آپ نے پہلے بنائی تھی۔.
اگر آپ کو دھکیلتے وقت کوئی غلطی ہو جاتی ہے تو، یہاں کلک کریں: - ### تصدیق کی غلطی 
ریموٹ: پاس ورڈ کی توثیق کے لیے سپورٹ 13 اگست 2021 کو ہٹا دیا گیا تھا۔ براہ کرم اس کے بجائے ذاتی رسائی کا ٹوکن استعمال کریں۔
 remote: براہ کرم دیکھیں https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ مزید معلومات کے لیے.
  fatal: کے لیے توثیق ناکام ہو گئی۔ 'https://github.com//first-contributions.git/'
کے پاس جاؤ [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) اپنے اکاؤنٹ میں SSH کلید بنانے اور ترتیب دینے پر۔
# جائزہ کے لیے اپنی تبدیلیاں جمع کروائیں۔ اب اس کمانڈ کو ہماری ریپو کی ڈائرکٹری میں چلانے سے ہمیں نظرثانی کے لیے پل کی درخواست بنانے کی اجازت ملے گی۔ ```bash gh pr create --repo firstcontributions/first-contributions ``` اس کے بعد پل کی درخواست جمع کروائیں۔ آپ کمانڈ استعمال کر سکتے ہیں۔ `gh status` آپ کی ذکر کردہ پل کی درخواست کو عمل میں دیکھنے کے لیے۔ ## یہاں سے کہاں جانا ہے؟ مبارک ہو! آپ نے ابھی معیاری _fork -> کلون -> ترمیم -> pull request_ ورک فلو مکمل کیا ہے جس کا آپ کو اکثر شراکت دار کے طور پر سامنا ہوگا! اپنی شراکت کا جشن منائیں اور اپنے دوستوں اور پیروکاروں کے ساتھ اس کا اشتراک کریں۔[web app](https://firstcontributions.github.io/#social-share). اگر آپ کو کوئی مدد درکار ہو یا کوئی سوال ہو تو آپ ہماری سلیک ٹیم میں شامل ہو سکتے ہیں۔ [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA). اب آئیے آپ کو دوسرے پروجیکٹس میں حصہ ڈالنا شروع کرتے ہیں۔ ہم نے آسان مسائل کے ساتھ پروجیکٹس کی ایک فہرست مرتب کی ہے جس پر آپ شروع کر سکتے ہیں۔ اس کو دیکھو [the list of projects in the 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) ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorial-german.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Erste Beiträge | GitHub Desktop | GitHub-Befehlszeilenschnittstelle (CLI) | | ------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | Dies ist ein Leitfaden für alle, die lieber mit dem Terminal arbeiten. Wenn Sie zum ersten Mal etwas tun, ist es immer schwierig. Besonders wenn Sie zusammenarbeiten, ist es nicht leicht, Fehler zu machen. Aber Open Source bedeutet Zusammenarbeit und gemeinsames Arbeiten. Wir wollten den Prozess der ersten Beitragstellung für neue Open-Source-Mitwirkende vereinfachen und ihnen helfen, sie auf einfache Weise zu lernen. Das Lesen von Artikeln und Anschauen von Tutorials kann hilfreich sein, aber es gibt nichts Besseres, als tatsächlich zu arbeiten, ohne etwas zu vermasseln. Dieses Projekt zielt darauf ab, Orientierung zu geben und die Art zu vereinfachen, wie Anfänger ihren ersten Beitrag leisten. Denken Sie daran: Je entspannter Sie sind, desto besser werden Sie lernen. Wenn Sie Ihren ersten Beitrag leisten möchten, folgen Sie einfach den folgenden einfachen Schritten. Wir versprechen Ihnen, das wird Spaß machen. Der erste Voraussetzung ist: - Git installiert ([Git herunterladen](https://git-scm.com/downloads)) - GitHub-Konto Jetzt müssen wir das `github-cli`-Tool auf unserem System installieren – folgen Sie der offiziellen Dokumentation. Danach müssen wir uns über die CLI anmelden. Geben Sie diesen Befehl ein: ```bash gh auth login ``` Folgen Sie den Anweisungen und schon sind wir bereit! # Dieses Repository forken Dies ist ganz einfach mit diesem Befehl: ```bash gh repo fork firstcontributions/first-contributions ``` **WICHTIG: Es wird Sie fragen, ob Sie das Repository auch klonen möchten, wählen Sie "Ja"** # Erstellen Sie Ihren Branch Wir machen diesen Schritt mit `git`. Geben Sie diesen Befehl ein und ersetzen Sie ihn durch Ihren Namen. Zum Beispiel: (Ersetzen Sie john-doe durch Ihren Namen) ```bash git switch -c add-john-doe ``` # Nehmen Sie erforderliche Änderungen vor und führen Sie diese durch Öffnen Sie jetzt die `Contributors.md`-Datei in einem Texteditor und fügen Sie Ihren Namen hinzu. Platzieren Sie Ihren Namen zwischen den bestehenden Namen, speichern Sie die Datei dann. Führen Sie `git status` in Ihrem Projektverzeichnis aus und Sie werden die Änderungen sehen. Fügen Sie diese Änderungen mit dem `git add`-Befehl zu dem von Ihnen erstellten Branch hinzu: `git add Contributors.md` Begehen Sie diese Änderungen nun mit dem `git commit`-Befehl: `git commit -m "Add your-name to Contributors list"`. Ersetzen Sie `your-name` durch Ihren Namen. # Schieben Sie Änderungen zu GitHub Verwenden Sie den `git push`-Befehl, um Ihre Änderungen zu übertragen: ```bash git push origin -u your-branch-name ``` Ersetzen Sie `your-branch-name` durch den Namen des Branches, den Sie zuvor erstellt haben.
Wenn Sie beim Verschieben Fehler bekommen, klicken Sie hier:
- ### Authentifizierungsfehler Remote: Die Unterstützung für Passwortauthentifizierung wurde am 13. August 2021 entfernt. Verwenden Sie stattdessen bitte ein Personal Access Token. Remote: Weitere Informationen finden Sie unter https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/. Fatal: Authentifizierung für 'https://github.com//first-contrib.git/' fehlgeschlagen [GitHub-Anleitung zum Erstellen und Konfigurieren eines SSH-Schlüssels für Ihr Konto](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account). # Reichen Sie Ihre Änderungen zur Überprüfung ein Nun können Sie diesen Befehl in unserem Repository-Verzeichnis ausführen, um eine Pull-Anfrage zur Überprüfung zu erstellen: ```bash gh pr create --repo firstcontributions/first-contributions ``` Danach reichen Sie die Pull-Anfrage ein. Sie können den `gh status`-Befehl verwenden, um Ihren erwähnten Pull-Request in Aktion zu sehen. ## Wohin von hier? Herzlichen Glückwunsch! Sie haben gerade den Standard-Workflow Fork -> Clone -> Bearbeiten -> Pull-Anfrage abgeschlossen, dem Sie häufig als Mitwirkender begegnen werden! Feiern Sie Ihren Beitrag und teilen Sie ihn mit Ihren Freunden und Followern, indem Sie die [Web-App](https://firstcontributions.github.io/#social-share) besuchen. Wenn Sie Hilfe benötigen oder Fragen haben, können Sie unserem Slack-Team beitreten. [Treten Sie dem Slack-Team bei](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA). Jetzt können wir mit dem Beitrag zu anderen Projekten beginnen. Wir haben eine Liste von Projekten mit einfachen Problemen zusammengestellt, mit denen Sie anfangen können. [Sehen Sie sich die Liste der Projekte in der Web-App an](https://firstcontributions.github.io/#project-list). ### [Zusätzliches Material](additional-material/git_workflow_scenarios/additional-material.md) ## Tutorials mit anderen Tools [Zurück zur Hauptseite](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorial-gujarati.md ================================================ [![ઓપન સોર્સ પ્રેમ](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![લાઇસન્સ: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![ઓપન સોર્સ હેલ્પર્સ](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # પ્રથમ ફાળો | GitHub Desktop | GitHub કમાન્ડ લાઇન ઈન્ટરફેસ (CLI) | | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | આ અમારાં માટે માર્ગદર્શિકા છે, ટર્મિનલના શોખીનો માટે, જે બધું જ ટર્મિનલમાં કરવા ઈચ્છે છે, અને [GitHub-CLI](https://cli.github.com/) ની મદદથી, અમે આ હાંસલ કરી શકીએ છીએ! તમારું પ્રથમ યોગદાન મજાનું, સન્માનજનક અને પ્રેરણાદાયક હોવું જોઈએ. આ માર્ગદર્શિકા થોડી વધુ પડકારજનક છે કારણ કે અમે કોઈપણ ગ્રાફિકલ ઈન્ટરફેસનો ઉપયોગ કરી રહ્યા નથી, પણ આ હજી પણ મજેદાર છે અને તમે ચોક્કસપણે તેને અનુસરવામાં સક્ષમ છો! ## જરૂરીતા - Git ઇન્સ્ટોલ કરેલું હોવું જોઈએ ([Git કેવી રીતે ઇન્સ્ટોલ કરવું](https://git-scm.com/downloads)) - GitHub ખાતું હોવું જોઈએ હવે અમારે આપણા સિસ્ટમમાં `github-cli` ટૂલ ઇન્સ્ટોલ કરવું પડશે. આ માટે [અધિકૃત દસ્તાવેજો](https://github.com/cli/cli#installation) અનુસરો. તેના પછી, CLI માં લોગિન કરવા માટે નીચેનો આદેશ આપો: ```bash gh auth login ``` સૂચનાઓ અનુસરો અને તમે તૈયાર છો! # આ રીપોઝિટરી ફોર્ક કરો આ માત્ર એક આદેશ ચલાવવાથી શક્ય છે: ```bash gh repo fork firstcontributions/first-contributions ``` **મહત્વપૂર્ણ: તે તમને પૂછશે કે શું તમે તેને ક્લોન કરવું માંગો છો, "હા" પસંદ કરો.** # તમારી શાખા બનાવો આ પગલું અમે Git ની મદદથી કરીશું, માટે આ આદેશ ચલાવો (તમારું નામ બદલો, ઉદાહરણ તરીકે): ```bash git switch -c add-john-doe ``` # જરૂરી ફેરફારો કરો અને તેમને કમિટ કરો હવે `Contributors.md` ફાઇલને કોઈપણ ટેક્સ્ટ એડિટરમાં ખોલીને તમારું નામ ઉમેરો. પછી ફાઇલ સાચવો. પ્રોજેક્ટ ડિરેક્ટરીમાં `git status` ચલાવો અને ફેરફારો જુઓ. git status આ ફેરફારોને નીચેના આદેશથી ઉમેરી દો: ```bash git add Contributors.md ``` હવે તમારાં ફેરફારોને કમિટ કરો: ```bash git commit -m "Add your-name to Contributors list" ``` `your-name` ને તમારા નામથી બદલો. # ફેરફારો GitHub પર અપલોડ કરો ```bash git push origin -u your-branch-name ``` `your-branch-name` ને તમે અગાઉ બનાવેલી શાખાના નામથી બદલો.
જો પુશ કરતી વખતે ભૂલ આવે તો અહીં ક્લિક કરો: - ### ઓથન્ટિકેશન ભૂલ 
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//first-contributions.git/'
તમારા GitHub એકાઉન્ટમાં 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) પર જઈને. જો તમને કોઈ પ્રશ્ન હોય અથવા મદદ જોઈતી હોય, તો તમે અમારી Slack ટીમમાં જોડાઈ શકો છો. [Slack ટીમમાં જોડાઓ](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) ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorial-id.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Kontribusi Pertama | GitHub Desktop | GitHub Command Line Interface (CLI) | | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | Ini merupakan panduan untuk seseorang yang ingin melakukan semuanya lewat terminal. Hal ini dapat kita lakukan berkat adanya [Github-CLI](https://cli.github.com/), sehingga kontribusi pertamamu menjadi lebih menyenangkan dan memotivasi kamu untuk terus berkontribusi. Panduan ini sedikit lebih menantang karena kita tidak menggunakan GUI sama sekali, namun tentunya tetap seru dan bisa kamu ikuti dengan mudah. Prasyarat pertama, kamu harus: - Memastikan Git sudah terinstall (cara install [git](https://git-scm.com/downloads))) - Mempunyai akun Github Selanjutnya, kita perlu menginstall `github-cli` di sistem kita dengan mengikuti langkah-langkah pada [dokumentasi resmi](https://github.com/cli/cli#installation) Setelah itu, kita harus login ke CLI dengan menjalankan perintah: ```bash gh auth login ``` Ikuti instruksinya sampai kamu berhasil login. # Fork repositori ini Caranya sangat mudah, dengan menjalankan perintah: ```bash gh repo fork firstcontributions/first-contributions ``` **Penting: Pilih opsi "yes" ketika muncul pertanyaan untuk mengkloning (clone) repositorinya.** # Buat branch baru Kita dapat melakukannya menggunakan git. Caranya dengan menjalankan perintah ini. Nama branch dapat kamu ganti sesuai dengan yang kamu mau, contohnya: ```bash git switch -c add-john-doe ``` # Lakukan perubahan yang diperlukan, kemudian Commit perubahan tersebut Sekarang, kamu bisa buka file `Contributors.md` menggunakan teks editor pilihanmu, dan menambahkan namamu. Jangan lupa untuk save file nya. Pada direktori proyek ini, jalankan perintah `git status`, kamu bisa melihat perubahan yang telah dilakukan. git status Tambahkan perubahan tersebut ke branch yang sudah kamu buat menggunakan perintah `git add`: `git add Contributors.md` Kemudian commit perubahan tersebut menggunakan perintah `git commit`: `git commit -m "Add your-name to Contributors list` ganti `your-name` menggunakan namamu. # Push perubahan ke Github Push perubahan yang kamu lakukan dengan perintah `git push`: ``` git push origin -u your-branch-name ``` ubah `your-branch-name` dengan nama branch yang kamu buat sebelumnya.
Kalo ada error saat melakukan push, klik di sini: - ### Authentication Error 
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//first-contributions.git/'
Buka [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) tentang mengenerate dan menkonfigurasi SSH key untuk akunmu.
# Submit perubahanmu untuk direview Jalankan perintah berikut untuk membuat pull request supaya perubahanmu bisa direview: ```bash gh pr create --repo firstcontributions/first-contributions ``` Setelah itu, submit pull requestnya. Kamu bisa menjalankan perintah `gh status` untuk melihan pull request yang kamu ajukan. ## Selanjutnya apa? Selamat, kamu telah menyelesaikan langkah _fork -> clone -> edit -> pull request_ yang pasti akan kamu lakukan saat menjadi kontributor. Rayakan kontribusimu dan bagikan ke kawan-kawan mu dengan cara pergi ke [web app](https://firstcontributions.github.io/#social-share). Kamu juga bisa join ke slack team kami jika kamu butuh bantuan atau punya pertanyaan. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA). Sekarang, kamu bisa mulai berkontribusi ke proyek-proyek lain. Kami telah mengumpulkan beberapa proyek dengan issues yang mudah diselesaikan untuk kamu. Cek [list nya di web app](https://firstcontributions.github.io/#project-list)) ### [Materi tambahan](additional-material/git_workflow_scenarios/additional-material.md) ## Tutorials Menggunakan Tools Lainnya [Kembali ke halaman utama](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorial-ko.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # 첫 기여 | GitHub Desktop | 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`를 실행하면 변경내용을 확인 할 수 있습니다. 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 이름으로 변경해서 사용하세요.
Push 과정에서 에러가 발생하면, 여기를 클릭하세요: - ### 인증 오류 
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//first-contributions.git/'
SSH키 생성이 필요합니다. [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)를 참고하세요.
# 검토를 받기 위해 수정한 내용을 제출 다음 명령으로 프로젝트 디렉토리에서 실행하여 변경사항 검토를 위한 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) ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorial-malayalam.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![ലൈസൻസ്: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Contributors](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # ആദ്യ സംഭാവനകൾ \| Git Bash | Git Bash പതിപ്പ് | \| ------------------------------------------------- ------------------------------------------------- ------------- | ---------------- | ആദ്യമായി എന്തെങ്കിലും ചെയ്യുമ്പോൾ എല്ലായ്പ്പോഴും അത് കഠിനമായി തോന്നും. പ്രത്യേകിച്ച് സഹകരിച്ച് പ്രവർത്തിക്കുമ്പോൾ തെറ്റുകൾ ചെയ്യുന്നത് ആരും ഇഷ്ടപ്പെടില്ല. പക്ഷേ **ഓപ്പൺ സോഴ്‌സ്** സഹകരണവും കൂട്ടായ പ്രവർത്തനവുമാണ്. പുതിയ സംഭാവനക്കാർക്ക് അവരുടെ **ആദ്യ സംഭാവന** നൽകുന്നത് എളുപ്പമാക്കാൻ ഞങ്ങൾ ആഗ്രഹിക്കുന്നു. ലേഖനങ്ങൾ വായിക്കുകയോ ട്യൂട്ടോറിയലുകൾ കാണുകയോ ചെയ്യുന്നത് സഹായകരമാണ്, പക്ഷേ നേരിട്ട് ചെയ്യുന്നതിന് പകരമൊന്നുമില്ല. ഈ പ്രോജക്റ്റ് പുതിയവർക്ക് അവരുടെ ആദ്യ സംഭാവന നൽകുന്നത് ലളിതമാക്കുകയാണ് ലക്ഷ്യം. ഒരുപക്ഷേ നിങ്ങൾക്ക് ശാന്തമായിരുന്നാൽ നിങ്ങൾ കൂടുതൽ മികച്ച രീതിയിൽ പഠിക്കും. നിങ്ങൾ നിങ്ങളുടെ ആദ്യ സംഭാവന നൽകാൻ ആഗ്രഹിക്കുന്നുവെങ്കിൽ, താഴെ കാണുന്ന ലളിതമായ ഘട്ടങ്ങൾ പിന്തുടരുക. നിങ്ങളുടെ **Windows കമ്പ്യൂട്ടറിൽ Git Bash ഇല്ലെങ്കിൽ**, [ഇവിടെ നിന്ന് ഇൻസ്റ്റാൾ ചെയ്യുക](https://git-scm.com/download/win). ഈ റീപോസിറ്ററി Fork ചെയ്യുക ## ഈ റീപോസിറ്ററി Fork ചെയ്യുക ഈ പേജിന്റെ മുകളിലെ വലത് വശത്ത് കാണുന്ന **Fork** ബട്ടൺ അമർത്തി ഈ റീപോയെ Fork ചെയ്യുക. ഇത് നിങ്ങളുടെ GitHub അക്കൗണ്ടിൽ ഒരു പകർപ്പ് സൃഷ്ടിക്കും. ## റീപോസിറ്ററി Clone ചെയ്യുക ഇപ്പോൾ നിങ്ങളുടെ **Fork ചെയ്ത റീപോ** നിങ്ങളുടെ കമ്പ്യൂട്ടറിലേക്ക് Clone ചെയ്യുക. പ്രധാനമാണ്: **ഒറിജിനൽ റീപോ** Clone ചെയ്യരുത്. നിങ്ങളുടെ Fork ചെയ്‌തത് മാത്രം Clone ചെയ്യുക. Clone ചെയ്യാൻ “Code” അമർത്തി, താഴെ കാണുന്ന URL copy ചെയ്യുക. ```bash git clone ``` പിന്നീട് നിങ്ങൾ Clone ചെയ്ത റീപോ തുറക്കാൻ git bash (അല്ലെങ്കിൽ VS Code) ഉപയോഗിക്കുക. ## ഒരു ബ്രാഞ്ച് സൃഷ്ടിക്കുക ഒരു പുതിയ ബ്രാഞ്ച് സൃഷ്ടിക്കാൻ: ```bash git checkout -b ``` ഉദാഹരണം: `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 ``` ഇതിന് ശേഷം, GitHub-ൽ നിങ്ങളുടെ Fork തുറക്കുമ്പോൾ **Compare & pull request** ബട്ടൺ കാണും. അത് അമർത്തി **Pull Request** തുറക്കുക. 🎉 --- വേണോ ഞാൻ മുഴുവൻ ഗൈഡും (പിന്നിലെ pull request ഭാഗം വരെ) മലയാളത്തിലേക്ക് convert ചെയ്ത് തരട്ടേ? ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorial-pt-br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições | GitHub Desktop | GitHub Interface de Linha de Comandos (CLI) | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------| Esse guia é para nós, os nerdes de terminal, que querem fazer tudo no terminal, e graças a [Github-CLI](https://cli.github.com/), podemos alcançar isso, lembrando que sua primeira contribuição deve ser divertida, recompensadora, e uma motivação para seguir em frente! Esse guia é um pouco mais desafiador desde que já não estamos utilizando nenhum interface gráfico, mas é ainda bem divertido e você com certeza consegui acompanhar! O primeiro requisito é para ter: - Git instalado (como instalar git [git](https://git-scm.com/downloads)) - Ter uma conta no GitHub Agora precisamos instalar a ferramenta `github-cli` no nosso sistema seguindo o [documentação oficial](https://docs.github.com/pt/github-cli/github-cli/quickstart) Depois disso, precisamos fazer login no CLI, só executar esse comando: ```bash gh auth login ``` Segue as instruções e estamos prontos! # Fork esse repositório É tão fácil quanto executar este comando: ```bash gh repo fork firstcontributions/first-contributions ``` **Importante: Ele vai incitar para você se gostaria de clonar também, selecione a opção "yes"** # Cria o seu branch Vamos fazer esse próximo passo com o git, so insira esse comando substituindo o nome pelo seu nome, por exemplo: ```bash git switch -c add-john-doe ``` # Faça as mudanças necessários e commit as mudanças Agora você pode abrir a pasta `Contributors.md` em um editor de texto e adicione o seu nome na pasta. Coloca o seu nome em qualque lugar entre o começo e o final, aí salva a pasta. No diretório do projeto execute `git status` e você verá as mudanças. ![image-git](https://camo.githubusercontent.com/a35c4722d7aab337eefc655d1488f7b4dc038508e6adaf5e88e2e052a976f010/68747470733a2f2f6669727374636f6e747269627574696f6e732e6769746875622e696f2f6173736574732f526561646d652f6769742d7374617475732e706e67) Adicione essas mudanças no branch que você acabou de criar usando`git add` command: `git add Contributors.md` Agora commit essas mudanças usando o comando `git commit`: `git commit -m "Add seu-nome à lista de colaboradores` substituindo `seu-nome` pelo seu nome. # Push as mudanças para o github Push as suas mudanças usando o comando `git push`: ``` git push origin -u seu-nome-branch ``` replacing `seu-nome-branch` com o nome do branch que você criou anterioramente.
Se você receber algum erro durante o push, clique aqui: - ### Erro de Autenticação 
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
  remote: Por favor veja https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ para mais informações.
  fatal: Authentication failed for 'https://github.com//first-contributions.git/'
Vá para o [Tutorial do GitHub](https://docs.github.com/pt/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) sobre como gerar e configurar uma chave SSH para sua conta.
# Enviando suas mudanças para revisão Executando esse comando no diretório do nosso repositório vai criar um pull request para revisão: ```bash gh pr create --repo firstcontributions/first-contributions ``` Depois disso envia o seu pull request. Você pode utilizar o comando `gh status` para You can use the command `gh status` para ver sua solicitação pull mencionada em ação. ## Para onde ir a partir daqui? Parabéns! Você acaba de completar o wokflow de standard _fork -> clone -> edit -> pull request_ que você encontrará frequentemente como colaborador! Comemore sua contribuição e compartilhe-a com seus amigos e seguidores acessando [web app](https://firstcontributions.github.io/#social-share). Você pode se juntar à nossa equipe do Slack se precisar de ajuda ou tiver alguma dúvida. [Junte-se à equipe do Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA). Agora vamos começar a contribuir para outros projetos. Compilamos uma lista de projetos com problemas fáceis nos quais você pode começar. Confira [the list of projects in the web app](https://firstcontributions.github.io/#project-list). ### [Material Adicional](additional-material/git_workflow_scenarios/additional-material.md) ## Tutorias Utilizando Outras Ferramentas [Voltar à página principal](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorial-sinhala.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # පළමු දායකත්වය | GitHub ඩෙස්ක්ටොප් | GitHub Command Line Interface (CLI) | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------| මෙය ටර්මිනලයේ සෑම දෙයක්ම කිරීමට අවශ්‍ය terminal nerds වන අපට මඟ පෙන්වීමක් වන අතර [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 කිරීමට අවශ්‍ය නම් එය ඔබෙන් විමසනු ඇත, "ඔව්" විකල්පය තෝරන්න** # ශාඛාවක් නිර්මාණය කිරීම අපි මෙම පියවර git සමඟ කරන්නෙමු, එබැවින් නම ඔබේ නම සමඟ ප්‍රතිස්ථාපනය කරමින් මෙම විධානය ඇතුළත් කරන්න, උදාහරණයක් ලෙස: ```bash git switch -c add-john-doe ``` # අවශ්‍ය වෙනස්කම් සිදු කර commit කරන්න දැන් ඔබට පාඨ සංස්කාරකයක `Contributors.md` ගොනුව විවෘත කර එයට ඔබේ නම එක් කළ හැක. ඔබේ නම ආරම්භය සහ අවසානය අතර ඕනෑම තැනක තබන්න, ඉන්පසු ගොනුව සුරකින්න. ව්‍යාපෘති නාමාවලියෙහි `git status` ක්‍රියාත්මක කරන්න, එවිට ඔබට වෙනස්කම් පෙනෙනු ඇත. ![image-git](https://camo.githubusercontent.com/a35c4722d7aab337eefc655d1488f7b4dc038508e6adaf5e88e2e052a976f010/6873747072637F6F06F1000000000000000000000000 69627574696f6e732e6769746875622e696f2f6173736574732f526561646d652f6769742d7374617475732e706e67) `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` වෙනුවට.
ඔබට තල්ලු කිරීමේදී කිසියම් දෝෂයක් ඇත්නම්, මෙහි ක්ලික් කරන්න: - ### Authentication Error 
දුරස්ථ: මුරපද සත්‍යාපනය සඳහා වන සහාය 2021 අගෝස්තු 13 දින ඉවත් කරන ලදී. කරුණාකර ඒ වෙනුවට පුද්ගලික ප්‍රවේශ ටෝකනයක් භාවිතා කරන්න.
  දුරස්ථ: කරුණාකර වැඩි විස්තර සඳහා https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ බලන්න.
  මාරක: 'https://github.com//first-contributions.git/'
සඳහා සත්‍යාපනය අසාර්ථක විය [GitHub හි නිබන්ධනය](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) වෙත යන්න ඔබගේ ගිණුමට SSH යතුරක් උත්පාදනය කිරීම සහ වින්‍යාස කිරීම.
# ඔබගේ වෙනස්කම් සමාලෝචනය සඳහා ඉදිරිපත් කරන්න දැන් අපගේ repo හි නාමාවලියෙහි මෙම විධානය ක්‍රියාත්මක කිරීමෙන් සමාලෝචනය සඳහා ඇදීමේ ඉල්ලීමක් සෑදීමට අපට ඉඩ සලසයි: ```bash gh pr create --repo firstcontributions/first-contributions ``` ඊට පස්සේ pull request එක ඉදිරිපත් කරන්න ඔබගේ සඳහන් ඇදීමේ ඉල්ලීම ක්‍රියාත්මක වන ආකාරය බැලීමට ඔබට `gh status` විධානය භාවිතා කළ හැක. ## මෙතනින් කොහෙට යන්නද? සුභ පැතුම්! ඔබ දායකයෙකු ලෙස නිතර හමුවන සම්මත _fork -> clone -> edit -> pull request_ කාර්ය ප්‍රවාහය සම්පූර්ණ කර ඇත! [web යෙදුම](https://firstcontributions.github.io/#social-share) වෙත යාමෙන් ඔබේ දායකත්වය සමරන්න සහ එය ඔබේ මිතුරන් සහ අනුගාමිකයින් සමඟ සමරන්න. ඔබට කිසියම් උදව්වක් අවශ්‍ය නම් හෝ කිසියම් ප්‍රශ්නයක් ඇත්නම් ඔබට අපගේ Slack කණ්ඩායමට සම්බන්ධ විය හැකිය. [Slack කණ්ඩායමට එකතු වන්න](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA). දැන් අපි ඔබට වෙනත් ව්‍යාපෘති සඳහා දායක වීම ආරම්භ කරමු. ඔබට ආරම්භ කළ හැකි පහසු ගැටළු සහිත ව්‍යාපෘති ලැයිස්තුවක් අපි සම්පාදනය කර ඇත්තෙමු. [වෙබ් යෙදුමේ ව්‍යාපෘති ලැයිස්තුව](https://firstcontributions.github.io/#project-list) පරීක්ෂා කරන්න. ### [අතිරේක මූලාශ්‍ර](අතිරේක-ද්‍රව්‍ය/git_workflow_scenarios/additional-material.md) ## වෙනත් මෙවලම් භාවිතා කරන නිබන්ධන [ආපසු ප්‍රධාන පිටුවට](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorial-tamil.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/ ) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![உரிமம்: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![திறந்த மூல உதவியாளர்கள்](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # முதல் பங்களிப்புகள் | Git Bash | Git Bash பதிப்பு | | ------------------------------------------------- ------------------------------------------------- ------------- | ---------------- | இது கடினமானது. நீங்கள் முதல் முறையாக ஏதாவது செய்யும்போது எப்போதும் கடினமாக இருக்கும். குறிப்பாக நீங்கள் ஒத்துழைக்கும்போது, ​​தவறுகள் செய்வது வசதியான விஷயம் அல்ல. ஆனால் ஓப்பன் சோர்ஸ் என்பது ஒத்துழைப்பு மற்றும் ஒன்றாக வேலை செய்வதாகும். புதிய திறந்த மூல பங்களிப்பாளர்கள் முதல் முறையாக கற்றுக் கொள்ளும் மற்றும் பங்களிக்கும் முறையை எளிதாக்க விரும்புகிறோம். கட்டுரைகளைப் படிப்பதும், டுடோரியல்களைப் பார்ப்பதும் உதவலாம், ஆனால் எதையும் குழப்பாமல் உண்மையில் செய்வதை விட எது சிறந்தது. இந்த திட்டம் வழிகாட்டுதலை வழங்குவதையும், புதியவர்கள் தங்கள் முதல் பங்களிப்பை வழங்கும் முறையை எளிமைப்படுத்துவதையும் நோக்கமாகக் கொண்டுள்ளது. நீங்கள் எவ்வளவு நிதானமாக இருக்கிறீர்களோ, அவ்வளவு சிறப்பாக நீங்கள் கற்றுக்கொள்கிறீர்கள் என்பதை நினைவில் கொள்ளுங்கள். உங்கள் முதல் பங்களிப்பை நீங்கள் செய்ய விரும்பினால், கீழே உள்ள எளிய வழிமுறைகளைப் பின்பற்றவும். நாங்கள் உங்களுக்கு உறுதியளிக்கிறோம், அது வேடிக்கையாக இருக்கும். உங்கள் விண்டோஸ் கணினியில் Git Bash இல்லை என்றால், [அதை நிறுவவும்](https://git-scm.com/download/win). இந்த களஞ்சியத்தை பிரிக்கவும் ## இந்த களஞ்சியத்தை பிரிக்கவும் இந்தப் பக்கத்தின் மேல் வலதுபுறத்தில் உள்ள ஃபோர்க் பொத்தானைக் கிளிக் செய்வதன் மூலம் இந்த ரெப்போவை ஃபோர்க் செய்யவும். இது உங்கள் கணக்கில் இந்தக் களஞ்சியத்தின் நகலை உருவாக்கும். ## களஞ்சியத்தை குளோன் செய்யவும் இப்போது இந்த ரெப்போவை உங்கள் கணினியில் குளோன் செய்யவும். முக்கியமானது: அசல் ரெப்போவை க்ளோன் செய்ய வேண்டாம். உங்கள் முட்கரண்டிக்குச் சென்று அதை குளோன் செய்யுங்கள். ரெப்போவை குளோன் செய்ய, "குறியீடு" என்பதைக் கிளிக் செய்து, கீழே உள்ள சரத்தை நகலெடுக்கவும். நகல் சரம் நீங்கள் பதிவிறக்கிய git bash பயன்பாட்டைத் திறக்கவும். விண்டோஸ் மெஷினில் இருந்தால் கீழே உள்ள படம் போல் இருக்க வேண்டும். ஓபன் கிட் பாஷ் டெர்மினல் இந்தக் கட்டளையைப் பயன்படுத்தி இந்தத் திட்டத்தைச் சேமிக்க விரும்பும் கோப்புறைக்குச் செல்லவும் ```பேஷ் cd <கோப்புறை> ``` ஒரு கோப்புறைக்குள் சிடி இந்த கட்டளையைப் பயன்படுத்தி களஞ்சியத்தை குளோன் செய்ய மேலே உள்ள படியில் நீங்கள் நகலெடுத்த சரத்தைப் பயன்படுத்தவும் ```பேஷ் git குளோன் ``` களஞ்சியத்தை குளோன் உங்கள் மாற்றங்களைச் செய்ய ரெப்போ இருக்கும் கோப்பகத்திற்குச் சென்று அதை vs குறியீட்டில் திறக்கவும். புதிதாக குளோன் செய்யப்பட்ட ரெப்போவில் சிடி ## ஒரு கிளையை உருவாக்கவும் இப்போது இந்த எளிய கட்டளையைப் பயன்படுத்தி ஒரு கிளையை உருவாக்கவும். இந்த கட்டளை உங்களுக்காக ஒரு கிளையை உருவாக்குவது மட்டுமல்லாமல் அந்த கிளைக்கு மாற உங்களை அனுமதிக்கிறது. ```பேஷ் git Checkout -b ``` உங்கள் கிளைக்கு `` என்று பெயரிடவும். உதாரணமாக, "add-james-smith" ஒரு கிளையை உருவாக்கு ## தேவையான மாற்றங்களைச் செய்து அந்த மாற்றங்களைச் செய்யுங்கள் இப்போது உரை திருத்தியில் `Contributors.md` கோப்பைத் திறந்து, பக்கத்தின் கீழே ஸ்க்ரோல் செய்து, அதில் உங்கள் பெயரைச் சேர்த்து, கோப்பைச் சேமிக்கவும். எடுத்துக்காட்டு: உங்கள் பெயர் ஜேம்ஸ் ஸ்மித் என்றால், அது இப்படி இருக்க வேண்டும். \[ஜேம்ஸ் ஸ்மித்](https://github.com/jamessmith) இந்தக் கட்டளையை இயக்குவதன் மூலம் Contributors.md இல் மாற்றங்கள் இருப்பதைக் காணலாம் ```பேஷ் git நிலை ``` நிலையைச் சரிபார்க்கவும் இப்போது அந்த மாற்றங்களைச் செய்யுங்கள்: முதலில் பயன்படுத்தி நீங்கள் செய்த மாற்றத்தை ஸ்டேஜிங் பகுதியில் சேர்க்கவும் ```பேஷ் git கோப்பு பெயரைச் சேர்க்கவும் ``` இந்த கட்டளையைப் பாடுவதன் மூலம் ஒரு உறுதி செய்தியை எழுதவும் ```பேஷ் git commit -m "உங்கள் பெயரை பங்களிப்பாளர்கள் பட்டியலில் சேர்" ``` `` என்பதை உங்கள் பெயருடன் மாற்றவும். மாற்றங்களை ஒப்புக்கொள் உங்கள் உறுதிமொழி நிறைவேற்றப்பட்டதா என்பதைப் பார்க்க, நீங்கள் ஒரு எளிய `git log --oneline` கட்டளையை இயக்கலாம். ## கிதுப்பில் மாற்றங்களை அழுத்தவும் மேலே உள்ள படிகளை நீங்கள் முடித்தவுடன் ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorial.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions | GitHub Desktop | GitHub Command Line Interface (CLI) | | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | This is a guide for us, the terminal nerds, who want to do everything in the terminal, and thanks to [Github-CLI](https://cli.github.com/), we can achieve it, remembering your first contribution should be fun, rewarding and a motivator to keep on going! This guide is a bit more challenging since we are not using any graphical interface at all, but it's still really fun and you can definitely follow it! The first requisite is to have: - Git installed (how to install [git](https://git-scm.com/downloads)) - Github account Now we need to install the `github-cli` tool in our system by following the [official documentation](https://github.com/cli/cli#installation) After that, we need to login in the CLI, so enter this command: ```bash gh auth login ``` Follow the instructions and we are ready! # Fork this repository It's just as easy as running this command: ```bash gh repo fork firstcontributions/first-contributions ``` **Important: It will prompt you if you want to clone it as well, select the "yes" option** # Create your branch We will do this step with git, so enter this command replacing the name with your name, for example: ```bash git switch -c add-john-doe ``` # Make necessary changes and commit those changes Now you can open `Contributors.md` file in a text editor and add your name to it. Put your name anywhere between the beginning and the end, then save the file. In the project directory execute `git status` and you will see the changes. git status Add those changes to the branch you just created using the `git add` command: `git add Contributors.md` Now commit those changes using the `git commit` command: `git commit -m "Add your-name to Contributors list` replacing `your-name` with your name. # Push changes to github Push your changes using the command `git push`: ``` git push origin -u your-branch-name ``` replacing `your-branch-name` with the name of the branch you created earlier.
If you get any errors while pushing, click here: - ### Authentication Error 
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//first-contributions.git/'
Go to [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account.
# Submit your changes for review Now running this command in our repo's directory will let us create a pull request for review: ```bash gh pr create --repo firstcontributions/first-contributions ``` After that submit the pull request. You can use the command `gh status` to see your mentioned pull request in action. ## Where to go from here? Congratulations! You have just completed the standard _fork -> clone -> edit -> pull request_ workflow that you'll often encounter 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). If you'd like more practice, checkout [code contributions](https://github.com/roshanjossey/code-contributions). Now let's get you started with contributing to other projects. We've compiled a list of projects with easy issues you can get started on. Check out [the list of projects in the web app](https://firstcontributions.github.io/#project-list). ### [Additional material](https://github.com/firstcontributions/first-contributions/blob/main/docs/additional-material/git_workflow_scenarios/additional-material.md) [Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorials-arabic.md ================================================ [![حب البرمجيات مفتوحة المصدر](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![الترخيص: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![مساعدو المصدر المفتوح](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # المساهمات الأولى | GitHub Desktop | واجهة سطر أوامر GitHub (CLI) | |------------------------------------------------------------------------------------------------------------------------------------|--------------------------------| هذا الدليل مخصص لنا نحن محبي الطرفية 💻، الذين يرغبون في إنجاز كل شيء من خلال سطر الأوامر. بفضل أداة [GitHub CLI](https://cli.github.com/)، أصبح ذلك ممكنًا بكل سهولة. يجب أن تكون مساهمتك الأولى ممتعة، مشجعة، وتمنحك الدافع للاستمرار في عالم المشاريع مفتوحة المصدر! هذا الدليل أكثر تفصيلاً قليلًا لأنه لا يعتمد على واجهة رسومية، لكنه يبقى ممتعًا وسهل المتابعة خطوة بخطوة. 🚀 --- ## المتطلبات الأساسية قبل أن نبدأ، تأكد من توفر ما يلي: - تثبيت Git على جهازك (راجع [كيفية التثبيت](https://git-scm.com/downloads)) - حساب GitHub فعال بعد ذلك، سنقوم بتثبيت أداة **GitHub CLI** من خلال اتباع [التعليمات الرسمية](https://github.com/cli/cli#installation). ثم نقوم بتسجيل الدخول عبر الأمر التالي: ```bash gh auth login اتبع التعليمات على الشاشة، وستكون جاهزًا للعمل 🎉 عمل Fork لهذا المستودع الأمر بسيط جدًا، فقط نفّذ الأمر التالي: bash Copy code gh repo fork firstcontributions/first-contributions 💡 ملاحظة: سيُطلب منك ما إذا كنت ترغب أيضًا في استنساخه (clone)، اختر الخيار "yes" إنشاء فرع خاص بك سنقوم بهذه الخطوة باستخدام Git: bash Copy code git switch -c add-your-name استبدل your-name باسمك، مثل: bash Copy code git switch -c add-okba14 إجراء التعديلات المطلوبة ورفعها الآن افتح الملف Contributors.md في أي محرر نصوص، وأضف اسمك في أي مكان داخل الملف، ثم احفظ التغيير. تحقق من حالة الملفات المعدلة: bash Copy code git status سترى أن الملف Contributors.md قد تم تغييره. أضف التغيير إلى الفرع الجديد: bash Copy code git add Contributors.md ثم أنشئ commit جديد: bash Copy code git commit -m "إضافة اسمك إلى قائمة المساهمين" استبدل “اسمك” باسمك الحقيقي. رفع التغييرات إلى GitHub الآن لنرسل التغييرات إلى GitHub باستخدام: bash Copy code git push origin -u اسم-الفرع استبدل “اسم-الفرع” باسم الفرع الذي أنشأته سابقًا.
في حال واجهت أخطاء أثناء الرفع، اضغط هنا 👇 خطأ في المصادقة (Authentication Error) bash Copy code remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. fatal: Authentication failed for 'https://github.com//first-contributions.git/' لحل المشكلة، اتبع دليل GitHub الرسمي لإعداد مفتاح SSH وربطه بحسابك.
إرسال التغييرات للمراجعة بعد رفع التعديلات، أنشئ Pull Request عبر الأمر التالي: bash Copy code gh pr create --repo firstcontributions/first-contributions ثم أرسل الطلب للمراجعة ✅ يمكنك أيضًا استخدام الأمر التالي للتحقق من حالة الطلب: bash Copy code gh status ماذا بعد؟ 🌱 مبروك! 🎉 لقد أنجزت بنجاح دورة العمل الكاملة: Fork → Clone → تعديل → Pull Request احتفل بمساهمتك وشاركها مع أصدقائك عبر تطبيق الويب. وإذا احتجت لأي مساعدة أو نقاش، يمكنك الانضمام إلى مجتمعنا على Slack من خلال الرابط التالي: 👉 انضم إلى فريق Slack تابع رحلتك 🚀 الآن بعد أن تعلمت الخطوات الأساسية، يمكنك المساهمة في مشاريع أخرى مفتوحة المصدر. راجع قائمة المشاريع السهلة لتبدأ فورًا. مواد إضافية أدلة باستخدام أدوات أخرى 🔙 العودة إلى الصفحة الرئيسية yaml Copy code --- > تمت الترجمة إلى العربية بواسطة: [Guiar Oqba](https://github.com/okba14) 🇩🇿 ================================================ FILE: docs/cli-tool-tutorials/github-cli-tutorials-francais.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Premières Contributions | GitHub Desktop | Interface en Ligne de Commande GitHub (CLI) | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------| Ceci est un guide pour nous, les adeptes du terminal, qui veulent tout faire en ligne de commande. Grâce à [Github-CLI](https://cli.github.com/), nous pouvons y parvenir. Votre première contribution devrait être amusante, gratifiante et motivante pour continuer à progresser ! Ce guide est un peu plus complexe, car nous n'utilisons aucune interface graphique, mais c'est toujours très amusant et vous pouvez suivre les instructions ! Le premier prérequis est d'avoir : - Git installé (comment installer [git](https://git-scm.com/downloads)) - Un compte GitHub Ensuite, nous devons installer l'outil `github-cli` sur notre système en suivant la [documentation officielle](https://github.com/cli/cli#installation). Après cela, nous devons nous connecter à la CLI en entrant cette commande : ```bash gh auth login ``` Suivez les instructions et vous êtes prêt(e) ! # Fork de ce dépôt C'est aussi simple que d'exécuter cette commande : ```bash gh repo fork firstcontributions/first-contributions ``` **Important : Il vous demandera si vous souhaitez également le cloner, sélectionnez l'option "yes"** # Créer votre branche Nous allons effectuer cette étape avec Git, alors entrez cette commande en remplaçant le nom par votre nom, par exemple : ```bash git switch -c add-john-doe ``` # Effectuer les changements nécessaires et commitez ces modifications Vous pouvez maintenant ouvrir le fichier `Contributors.md` dans un éditeur de texte et y ajouter votre nom. Placez votre nom n'importe où entre le début et la fin du fichier, puis enregistrez-le. Dans le répertoire du projet, exécutez `git status` et vous verrez les modifications. ![image-git](https://camo.githubusercontent.com/a35c4722d7aab337eefc655d1488f7b4dc038508e6adaf5e88e2e052a976f010/68747470733a2f2f6669727374636f6e747269627574696f6e732e6769746875622e696f2f6173736574732f526561646d652f6769742d7374617475732e706e67) Ajoutez ces changements à la branche que vous venez de créer en utilisant la commande `git add` : `git add Contributors.md` Commitez maintenant ces changements en utilisant la commande `git commit` : `git commit -m "Ajouter votre-nom à la liste des contributeurs"` en remplaçant `votre-nom` par votre nom. # Envoyez les modifications sur GitHub Envoyez vos modifications en utilisant la commande `git push` : ``` git push origin -u votre-nom-de-branche ``` en remplaçant `votre-nom-de-branche` par le nom de la branche que vous avez créée précédemment.
Si vous obtenez des erreurs lors de la soumission, cliquez ici : - ### Erreur d'authentification 
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//first-contributions.git/'
Suivez le [tutoriel GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) sur la génération et la configuration d'une clé SSH pour votre compte.
# Soumettez vos modifications pour examen Maintenant, en exécutant cette commande dans le répertoire de notre dépôt, vous pourrez créer une pull request pour examen : ```bash gh pr create --repo firstcontributions/first-contributions ``` Ensuite, soumettez la pull request. Vous pouvez utiliser la commande `gh status` pour voir votre pull request mentionnée en action. ## Où aller à partir de maintenant ? Félicitations ! Vous venez de terminer le flux de travail standard _fork -> clone -> édition -> pull request_ que vous rencontrerez souvent en tant que contributeur ! Célébrez votre contribution et partagez-la avec vos amis et abonnés en allant sur [l'application web](https://firstcontributions.github.io/#social-share). Vous pouvez rejoindre notre équipe Slack si vous avez besoin d'aide ou si vous avez des questions. [Rejoignez l'équipe Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA). Maintenant, passons à la contribution à d'autres projets. Nous avons dressé une liste de projets avec des problèmes faciles pour vous permettre de commencer. Consultez [la liste des projets sur l'application web](https://firstcontributions.github.io/#project-list). ### [Matériel supplémentaire](additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriels Utilisant d'Autres Outils [Retour à la page d'accueil](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/cli-tool-tutorials/translations/Bengali/git-bash-windows-tutorial-bn.md ================================================ প্রথম অবদান Git Bash Git Bash সংস্করণ প্রথমবার কিছু করা সবসময়ই কঠিন। বিশেষ করে যখন আপনি টিমে কাজ করেন, তখন ভুল করার ভয় থেকেই যায়। কিন্তু ওপেন সোর্স মানেই সহযোগিতা ও একসাথে কাজ করা। আমরা নতুন ওপেন সোর্স অবদানকারীদের শেখা এবং তাদের প্রথম অবদান রাখার প্রক্রিয়াকে সহজ করতে চাই। আর্টিকেল পড়া বা ভিডিও দেখা সহায়ক হতে পারে, তবে বাস্তবে প্র্যাকটিস করার চেয়ে ভালো কিছু নেই। এই প্রোজেক্টের উদ্দেশ্য হলো নতুনদের জন্য সহজবোধ্য গাইড তৈরি করা এবং তাদের প্রথম অবদান রাখার অভিজ্ঞতাকে আনন্দদায়ক করে তোলা। মনে রাখবেন: আপনি যত শান্ত ও আত্মবিশ্বাসী থাকবেন, শেখাও তত সহজ হবে। যদি আপনার Windows মেশিনে Git Bash না থাকে, তবে এখান থেকে ইন্সটল করুন । এই রিপোজিটরিটি ফর্ক করুন রিপোজিটরি Fork করুন এই পেজের উপরের ডান দিকের Fork বাটনে ক্লিক করুন। এতে করে আপনার অ্যাকাউন্টে রিপোজিটরিটির একটি কপি তৈরি হবে। রিপোজিটরি Clone করুন এখন আপনার ফর্ক করা রিপোজিটরিকে আপনার কম্পিউটারে ক্লোন করুন। ⚠️ গুরুত্বপূর্ণ: মূল রিপোজিটরি ক্লোন করবেন না। নিজের ফোর্ক থেকে ক্লোন করতে হবে। ১. "Code" বাটনে ক্লিক করুন এবং লিঙ্ক কপি করুন। URL টি ক্লিপবোর্ডে কপি করুন ২. Git Bash ওপেন করুন। উইন্ডোজে এটি নিচের ছবির মতো দেখাবে: open git bash terminal ৩. প্রোজেক্ট রাখার ফোল্ডারে যান: cd cd into a folder ৪. এখন কপি করা লিঙ্ক দিয়ে ক্লোন করুন: git clone এই রিপোজিটরিটি ক্লোন করুন ৫. ক্লোন করা ডিরেক্টরিতে যান এবং VS Code এ ওপেন করুন: cd into the newly cloned repo একটি Branch তৈরি করুন নতুন ব্রাঞ্চ তৈরি করুন এবং সেই ব্রাঞ্চে সুইচ করুন: git checkout -b 👉 নাম দিন ফরম্যাটে। যেমন: add-james-smith create a branch পরিবর্তন করুন এবং Commit করুন ১. Contributors.md ফাইল ওপেন করুন। ২. নিচে স্ক্রল করে নিজের নাম যোগ করুন। ৩. ফাইল সেভ করুন। উদাহরণ: [James Smith](https://github.com/jamessmith) পরিবর্তন চেক করতে: git status গিট স্ট্যাটাস পরিবর্তন স্টেজ করুন: git add file-name কমিট করুন: git commit -m "Add your-name to Contributors list" 👉 এখানে এর জায়গায় নিজের নাম লিখুন। commit changes কমিট লিস্ট চেক করতে: git log --oneline GitHub এ Push করুন সব ধাপ শেষ হলে পরিবর্তনগুলো GitHub এ পাঠান: git push origin push changes Pull Request পাঠান GitHub এ আপনার রিপোজিটরিতে গিয়ে Compare & pull request বাটনে ক্লিক করুন। একটি পুল রিকোয়েস্ট তৈরি করুন এরপর Pull Request সাবমিট করুন। পুল রিকোয়েস্ট জমা দিন শীঘ্রই আপনার পরিবর্তনগুলো মূল প্রোজেক্টের প্রধান (main/master) ব্রাঞ্চে মার্জ হয়ে যাবে। পরিবর্তন মার্জ হলে ইমেইলে নোটিফিকেশন পাবেন। এরপর কী করবেন? অভিনন্দন 🎉 আপনি এখনই পুরো স্ট্যান্ডার্ড প্রক্রিয়া শেষ করলেন: fork → clone → edit → PR 👉 আপনার অবদান উদযাপন করুন এবং ওয়েব অ্যাপ থেকে বন্ধুদের সাথে শেয়ার করুন। 👉 যদি কোনো প্রশ্ন থাকে বা সাহায্য প্রয়োজন হয়, আমাদের Slack টিমে যোগ দিন: Slack টিমে যোগ দিন । অতিরিক্ত উপকরণ অন্যান্য টুল ব্যবহার করে টিউটোরিয়াল মূল পাতায় ফিরে যান ================================================ FILE: docs/cli-tool-tutorials/translations/Bengali/git-cli-tutorial-bn.md ================================================ প্রথম অবদান (First Contribution) Git Bash Git Bash সংস্করণ প্রথমবার কিছু করলে সেটা কঠিন মনে হয়। বিশেষ করে যখন সহযোগিতামূলক কাজ হয়, তখন ভুল করার ভয় থাকে। কিন্তু ওপেন সোর্স মানেই সহযোগিতা – একসাথে কাজ করা। আমরা চেয়েছি নতুন ওপেন সোর্স অবদানকারীদের জন্য শেখার পথ সহজ করা। শুধু টিউটোরিয়াল পড়ে বা ভিডিও দেখে নয় – বরং হাতে কলমে প্র্যাকটিস করে শিখলে অনেক দ্রুত বোঝা যায়। এই প্রোজেক্টের উদ্দেশ্য হলো নতুনদের গাইড করা এবং তাদের প্রথম অবদান রাখার অভিজ্ঞতাকে সহজ করা। মনে রাখবেন, আপনি যত বেশি স্বাচ্ছন্দ্যবোধ করবেন, শেখাও তত ভালো হবে। যদি আপনি উইন্ডোজ ব্যবহার করেন এবং আপনার কাছে Git Bash না থাকে, এখান থেকে ইন্সটল করুন । এই রিপোজিটরিটি ফর্ক করুন এই রিপোজিটরিকে Fork করুন এই পেজের উপরের ডান দিকে থাকা Fork বাটনে ক্লিক করুন। এতে করে আপনার গিটহাব অ্যাকাউন্টে এই রিপোজিটরির একটি কপি তৈরি হবে। রিপোজিটরি ক্লোন করুন এবার আপনার ফোর্ক করা রিপোজিটরিটি নিজের কম্পিউটারে ক্লোন করুন। ⚠️ খেয়াল রাখবেন: মূল রিপোজিটরি ক্লোন করবেন না, বরং নিজের ফোর্ক থেকে ক্লোন করতে হবে। ১. আপনার রিপোজিটরির পেজে যান, "Code" বাটনে ক্লিক করুন এবং সেখানে দেওয়া লিঙ্ক কপি করুন। URL টি ক্লিপবোর্ডে কপি করুন ২. Git Bash অ্যাপ্লিকেশন খুলুন। উইন্ডোজে এটি নিচের ছবির মতো দেখাবে: open git bash terminal ৩. সেই ফোল্ডারে যান যেখানে আপনি প্রোজেক্টটি রাখতে চান: cd cd into a folder ৪. এবার রিপোজিটরিটি ক্লোন করুন: git clone এই রিপোজিটরিটি ক্লোন করুন ৫. ক্লোন করা ডিরেক্টরিতে যান এবং Visual Studio Code এ ওপেন করুন: cd into the newly cloned repo একটি নতুন ব্রাঞ্চ তৈরি করুন নিচের কমান্ড ব্যবহার করে একটি নতুন ব্রাঞ্চ তৈরি করুন এবং সেই ব্রাঞ্চে চলে যান: git checkout -b 👉 আপনার ব্রাঞ্চের নাম দিন । যেমন: add-james-smith create a branch পরিবর্তন করুন এবং Commit করুন ১. Contributors.md ফাইল ওপেন করুন। ২. নিচের দিকে স্ক্রল করুন এবং সেখানে আপনার নাম যোগ করুন। ৩. ফাইলটি সেভ করুন। উদাহরণ: [James Smith](https://github.com/jamessmith) পরিবর্তন হয়েছে কিনা দেখতে: git status গিট স্ট্যাটাস ফাইল স্টেজ করতে: git add file-name কমিট করতে: git commit -m "Add your-name to Contributors list" 👉 এর জায়গায় নিজের নাম লিখবেন। commit changes কমিট চেক করতে চাইলে: git log --oneline পরিবর্তন GitHub এ Push করুন সব ধাপ শেষ হলে পরিবর্তনগুলো GitHub এ পাঠাতে হবে: git push origin push changes Pull Request পাঠান GitHub এ আপনার রিপোজিটরিতে গেলে Compare & pull request বাটন দেখতে পাবেন। সেখানে ক্লিক করুন। একটি পুল রিকোয়েস্ট তৈরি করুন এরপর Pull Request সাবমিট করুন। পুল রিকোয়েস্ট জমা দিন শীঘ্রই আপনার পরিবর্তনগুলো মূল রিপোজিটরির master ব্রাঞ্চে মার্জ হয়ে যাবে। পরিবর্তন মার্জ হলে ইমেইলে নোটিফিকেশন পাবেন। এরপর কী করবেন? অভিনন্দন 🎉 আপনি এখনই সাধারণ fork → clone → edit → PR ওয়ার্কফ্লো সম্পন্ন করলেন, যা একজন অবদানকারী হিসেবে বারবার ব্যবহার করতে হবে। 👉 আপনার অবদান উদযাপন করুন এবং ওয়েব অ্যাপ থেকে বন্ধুদের সাথে শেয়ার করুন। 👉 কোনো প্রশ্ন থাকলে বা সাহায্যের প্রয়োজন হলে আমাদের Slack টিমে যোগ দিতে পারেন: স্ল্যাক টিমে যোগ দিন । অতিরিক্ত উপকরণ অন্য টুল ব্যবহার করে টিউটোরিয়াল মূল পাতায় ফিরে যান ================================================ FILE: docs/cli-tool-tutorials/translations/Chinese/git-bash-windows-tutorial.zh-cn.md ================================================ [![开源之爱](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![许可证: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![开源贡献者](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions（首次贡献） | Git Bash | Git Bash Edition | | ------------------------------------------------------------------------------------------------------------------ | ---------------- | 第一次做一件事总是很难，特别是涉及协作的时候，犯错并不是一件让人舒服的事。但开源正是关于协作与共同进步的。我们希望简化新手首次学习和参与开源贡献的流程。 阅读文章和看教程固然有用，但没有什么比“亲自动手且不会搞砸任何事情”更有效。本项目旨在为新手提供引导，简化首次贡献的过程。请记住：你越放松，学得越快。如果你正想要完成你的第一次贡献，只需按照下列简单步骤操作。我们保证这将非常有趣！ 如果你还没有在 Windows 上安装 Git Bash，请[点击这里安装](https://git-scm.com/download/win)。 fork this repository ## Fork 本仓库 点击本页面右上角的 Fork 按钮，即可 Fork 此仓库。 这将在你的 GitHub 账户中创建一个副本。 ## 克隆这个仓库 现在将此仓库克隆到你的本地机器。 **重要：不要克隆原始仓库。请到你自己的 fork 页面进行克隆。** 点击 "Code"，然后复制下方的链接。 copy string 打开你刚下载的 Git Bash 应用。如果是在 Windows 上，它看起来应该如下图所示。 open git bash terminal 使用以下命令进入你希望保存项目的文件夹： ```bash cd ``` cd into a folder 使用你刚刚复制的链接，运行以下命令克隆仓库： ```bash git clone ``` clone the repository 进入该目录，并在 VS Code 中打开项目进行修改。 cd into the newly cloned repo ## 创建分支 使用以下命令创建分支并切换到该分支： ```bash git checkout -b ``` 将 ``替换为例如 "add-james-smith" 的格式。 create a branch ## 做出必要修改并提交更改 使用文本编辑器打开 `Contributors.md` 文件，滚动到页面底部，添加你的名字，然后保存文件。 例如，如果你叫 James Smith，添加如下内容： \[James Smith](https://github.com/jamessmith) 你可以通过运行以下命令查看是否有文件更改： ```bash git status ``` check the status 现在提交你的更改： 首先将更改添加到暂存区： ```bash git add file-name ``` 然后使用以下命令提交更改： ```bash git commit -m "Add your-name to Contributors list" ``` 请将 `` 替换为你的名字。 commit changes 你可以使用 `git log --oneline` 命令确认提交记录。 ## 推送更改到 GitHub 完成上述步骤后，使用以下命令将更改推送到 GitHub： ```bash git push origin ``` push changes ## 提交更改供审查 访问你的 GitHub 仓库页面，会看到 `Compare & pull request` 按钮。点击它。 create a pull request 点击提交 pull request. submit pull request 不久之后，我会将你的更改合并到主分支中。合并后你会收到邮件通知。 ## Where to go from here? 恭喜你！你刚完成了标准的 - fork -> clone -> edit -> PR 工作流程，这是你未来在开源项目中常会用到的模式！ 你可以通过访问 [web app](https://firstcontributions.github.io#social-share)与朋友分享你的贡献。 如果你有任何问题或需要帮助，欢迎加入我们的 Slack 团队： [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) ## 使用其他工具的教程 [Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/cli-tool-tutorials/translations/Chinese/github-cli-tutorial.zh-cn.md ================================================ [![开源之爱](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![许可证: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![开源贡献者](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions （首次贡献） | GitHub Desktop | GitHub 命令行工具 (CLI) | | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | 这是给我们这些终端爱好者准备的指南，感谢 [Github-CLI](https://cli.github.com/)，我们可以在终端中完成所有事情。你的第一次贡献应该是有趣、有成就感的，它将激励你继续前进！ 这个指南稍微有些挑战，因为我们不会使用任何图形界面。但它仍然非常有趣，并且你一定可以跟得上！ 你需要准备以下工具： - 安装 Git (如何安装 [git](https://git-scm.com/downloads)) - Github 账户 现在我们需要在系统中安装 `github-cli` 工具，方法请见[官方文档](https://github.com/cli/cli#installation) 接着输入以下命令登录 CLI： ```bash gh auth login ``` 按照指示完成登录，我们就准备好了！ # Fork 这个仓库 只需运行以下命令即可： ```bash gh repo fork firstcontributions/first-contributions ``` **重要提示：命令会提示你是否需要克隆仓库，请选择 “yes”** # 创建你的分支 使用 Git 创建一个新分支，命名时请用你的名字替换示例中的部分，例如： ```bash git switch -c add-john-doe ``` # 做出必要更改并提交 现在，你可以用文本编辑器打开 `Contributors.md` 文件并添加你的名字。将你的名字加在文件的任何地方，然后保存文件。 在项目目录中执行 `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 origin -u your-branch-name ``` 请将 `your-branch-name` 替换为你之前创建的分支名称。
如果在推送过程中出现错误，请点击这里： - ### 身份验证错误 
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//first-contributions.git/'
请参考 [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) 来生成并配置 SSH key。
# 提交你的更改以供审查 在你的仓库目录下运行以下命令来创建 Pull Request： ```bash gh pr create --repo firstcontributions/first-contributions ``` 接着提交 Pull Request。 你可以使用 `gh status` 命令来查看你的 PR 状态。 ## 接下来做什么？ 恭喜你！你刚完成了一个常见的开源贡献流程 — fork -> clone -> edit -> pull request！ 你可以通过访问 [web app](https://firstcontributions.github.io/#social-share) 与朋友和关注者分享你的贡献。 如果你有任何疑问或需要帮助，也可以加入我们的 Slack 团队：[Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA)。 现在你可以开始为其他项目做贡献了。我们收集了一些适合入门的项目，你可以在[the list of projects in the web app](https://firstcontributions.github.io/#project-list)上查看。 ### [Additional material](additional-material/git_workflow_scenarios/additional-material.md) ## 使用其他工具的教程 [Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/cli-tool-tutorials/translations/Greek/git-bash-windows-tutorial.gr.md ================================================ [![Αγάπη Ανοιχτού Κώδικα](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![Άδεια: MIT](https://img.shields.io/badge/Άδεια-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Βοηθοί Ανοιχτού Κώδικα](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Πρώτες Συνεισφορές | Git Bash | Έκδοση Git Bash | | ------------------------------------------------------------------------------------------------------------------ | ---------------- | Είναι δύσκολο. Είναι πάντα δύσκολο την πρώτη φορά που κάνεις κάτι. Ειδικά όταν συνεργάζεσαι, το να κάνεις λάθη δεν είναι κάτι άνετο. Αλλά ο ανοιχτός κώδικας αφορά όλο το θέμα της συνεργασίας και της εργασίας από κοινού. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο οι νέοι συνεισφέροντες ανοιχτού κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά. Η ανάγνωση άρθρων και η παρακολούθηση εκπαιδευτικών βίντεο μπορεί να βοηθήσει, αλλά τι μπορεί να είναι καλύτερο από το να κάνεις τα πράγματα χωρίς να κάνεις κανένα λάθος. Αυτό το έργο στοχεύει στην παροχή καθοδήγησης και στον απλοποιημένο τρόπο με τον οποίο οι αρχάριοι μπορούν να κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε, όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Αν ψάχνετε για να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε απλά τα ακόλουθα απλά βήματα. Σας υποσχόμαστε, θα είναι διασκεδαστικό. Εάν δεν έχετε το Git Bash στον υπολογιστή σας με Windows, [εγκαταστήστε το](https://git-scm.com/download/win). fork this repository ## Κλωνοποίηση αυτού του αποθετηρίου Κλωνοποιήστε αυτό το αποθετήριο πατώντας το κουμπί "Fork" στην επάνω δεξιά γωνία αυτής της σελίδας. Αυτό θα δημιουργήσει ένα αντίγραφο αυτού του αποθετηρίου στον λογαριασμό σας. ## Κλωνοποίηση του αποθετηρίου Τώρα κλωνοποιήστε αυτό το αποθετήριο στη μηχανή σας. ΣΗΜΑΝΤΙΚΟ: ΜΗΝ ΚΛΩΝΟΠΟΙΗΣΕΤΕ ΤΟ ΠΡΩΤΟΤΥΠΟ ΑΠΟΘΕΤΗΡΙΟ. Πηγαίνετε στο fork σας και κλωνοποιήστε το. Για να κλωνοποιήσετε το αποθετήριο, κάντε κλικ στο "Code" και στη συνέχεια αντιγράψτε το κείμενο παρακάτω. copy string Ανοίξτε την εφαρμογή git bash που μόλις κατεβάσατε. Θα πρέπει να μοιάζει με την παρακάτω εικόνα αν βρίσκεται σε μηχανή με Windows. open git bash terminal Πηγαίνετε στον φάκελο όπου θέλετε να αποθηκεύσετε αυτό το έργο χρησιμοποιώντας αυτήν την εντολή `cd <φάκελος>` cd into a folder Χρησιμοποιήστε το κείμενο που αντιγράψατε στο προηγούμενο βήμα για να κλωνοποιήσετε το αποθετήριο χρησιμοποιώντας αυτήν την εντολή `git clone ` clone the repository Πηγαίνετε στον κατάλογο όπου βρίσκεται το αποθετήριο και ανοίξτε το στο vs code για να κάνετε τις αλλαγές σας. cd into the newly cloned repo ## Δημιουργία κλαδιού Τώρα δημιουργήστε ένα κλαδί χρησιμοποιώντας αυτήν την απλή εντολή. Αυτή η εντολή δεν δημιουργεί μόνο ένα κλαδί για εσάς, αλλά σας επιτρέπει επίσης να αλλάξετε σε αυτό το κλαδί. ``` git checkout -b <όνομα-κλαδιού> ``` Ονομάστε το κλαδί σας `<προσθέστε-το-όνομά-σας>`. Για παράδειγμα, "add-james-smith" create a branch ## Κάντε τις απαραίτητες αλλαγές και κάντε εκείνες τις αλλαγές Τώρα ανοίξτε το αρχείο `Contributors.md` σε έναν επεξεργαστή κειμένου, μεταβείτε στο τέλος της σελίδας και προσθέστε το όνομά σας σε αυτό, στη συνέχεια αποθηκεύστε το αρχείο. Παράδειγμα: Εάν το όνομά σας είναι James Smith, Θα πρέπει να μοιάζει με αυτό. \[James Smith](https://github.com/jamessmith) Μπορείτε να δείτε ότι υπάρχουν αλλαγές στο Contributors.md απλά εκτελώντας αυτήν την εντολή `git status` check the status Τώρα κάντε commit αυτές τις αλλαγές: Πρώτα προσθέστε την αλλαγή που κάνατε στην περιοχή σταγόνων χρησιμοποιώντας `git add file-name` Στη συνέχεια, γράψτε ένα μήνυμα commit χρησιμοποιώντας αυτήν την εντολή `git commit -m "Προσθήκη του-ονόματός-σας στη λίστα συντελεστών"` Αντικαταστήστε το `<το-όνομα-σας>` με το όνομά σας. commit changes Για να δείτε αν έχει γίνει το commit σας μπορείτε να τρέξετε μια απλή εντολή `git log --oneline`. ## Αποστολή των αλλαγών στο GitHub Αφού τελειώσετε με τα παραπάνω βήματα, μπορείτε να στείλετε τις αλλαγές σας χρησιμοποιώντας αυτήν την εντολή `git push origin <όνομα-κλαδιού>` push changes ## Υποβολή των αλλαγών σας για αναθεώρηση Εάν πάτε στο αποθετήριο σας στο GitHub, θα δείτε το κουμπί "Σύγκριση και αίτημα ενσωμάτωσης". πατήστε εκεί. create a pull request Τώρα υποβάλλετε το αίτημα ενσωμάτωσης. submit pull request Σύντομα θα ενσωματώσω όλες τις αλλαγές σας στον κύριο κλάδο αυτού του έργου. Θα λάβετε ένα email ειδοποίησης μόλις οι αλλαγές ενσωματωθούν. ## Πού να πάτε από εδώ; Συγχαρητήρια! Μόλις ολοκληρώσατε την κανονική ροή εργασίας _fork -> clone -> edit -> PR_ που θα συναντήσετε συχνά ως συνεισφέροντες! Γιορτάστε τη συνεισφορά σας και μοιραστείτε τη με τους φίλους και τους ακόλουθούς σας, πηγαίνοντας στην [ιστοσελίδα εφαρμογής](https://firstcontributions.github.io#social-share). ### [Πρόσθετο υλικό](../additional-material/git_workflow_scenarios/additional-material.md) ## Οδηγοί χρήσης άλλων εργαλείων [Πίσω στην κύρια σελίδα](https://github.com/firstcontributions/first-contributions/blob/main/translations/README.gr.md#%CE%B5%CE%BA%CF%80%CE%B1%CE%B9%CE%B4%CE%B5%CF%85%CF%84%CE%B9%CE%BA%CF%8C-%CF%85%CE%BB%CE%B9%CE%BA%CF%8C-%CF%87%CF%81%CE%AE%CF%83%CE%B7%CF%82-%CE%AC%CE%BB%CE%BB%CF%89%CE%BD-%CE%B5%CF%81%CE%B3%CE%B1%CE%BB%CE%B5%CE%AF%CF%89%CE%BD) ================================================ FILE: docs/cli-tool-tutorials/translations/Greek/github-cli-tutorial.gr.md ================================================ [![Αγάπη για το Open Source](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![Άδεια: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Βοηθοί Open Source](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Πρώτες Συνεισφορές | GitHub Desktop | Επιφάνεια Εργασίας GitHub (GitHub Desktop) | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------| Αυτός είναι ο οδηγός μας για εμάς, τους "νερντς" του τερματικού, που θέλουμε να κάνουμε τα πάντα στο τερματικό και, χάρη στο [Github-CLI](https://cli.github.com/), μπορούμε να το επιτύχουμε. Να θυμάστε ότι η πρώτη σας συνεισφορά πρέπει να είναι διασκεδαστική, επαναφέρουσα και κινητήριο για να συνεχίσετε! Αυτός ο οδηγός είναι λίγο πιο προκλητικός, καθώς δεν χρησιμοποιούμε καθόλου γραφική διεπαφή, αλλά είναι πολύ διασκεδαστικός και σίγουρα μπορείτε να τον ακολουθήσετε! Το πρώτο προαπαιτούμενο είναι να έχετε: - Εγκατεστημένο το Git (πώς να εγκαταστήσετε το [git](https://git-scm.com/downloads)) - Λογαριασμό GitHub Τώρα χρειάζεται να εγκαταστήσουμε το εργαλείο `github-cli` στο σύστημά μας ακολουθώντας την [επίσημη τεκμηρίωση](https://github.com/cli/cli#installation) Μετά από αυτό, πρέπει να συνδεθούμε στο CLI, οπότε εκτελέστε αυτήν την εντολή: ```bash gh auth login ``` Ακολουθήστε τις οδηγίες και είμαστε έτοιμοι! # Fork αυτό το αποθετήριο Είναι τόσο εύκολο όσο το να εκτελέσετε αυτήν την εντολή: ```bash gh repo fork firstcontributions/first-contributions ``` **Σημαντικό: Θα σας εμφανίσει εάν θέλετε να το κλωνοποιήσετε επίσης, επιλέξτε την επιλογή "ναι"** # Δημιουργία του κλαδιού σας Θα κάνουμε αυτό το βήμα με το git, οπότε εκτελέστε αυτήν την εντολή αντικαθιστώντας το όνομα με το όνομά σας, για παράδειγμα: ```bash git switch -c add-john-doe ``` # Κάντε τις απαραίτητες αλλαγές και κάντε commit τις αλλαγές σας Τώρα μπορείτε να ανοίξετε το αρχείο `Contributors.md` σε έναν επεξεργαστή κειμένου και να προσθέσετε το όνομά σας. Β άλτε το όνομά σας οπουδήποτε μεταξύ αρχής και τέλους, και στη συνέχεια αποθηκεύστε το αρχείο. Στον φάκελο του έργου, εκτελέστε `git status` και θα δείτε τις αλλαγές. ![image-git](https://camo.githubusercontent.com/a35c4722d7aab337eefc655d1488f7b4dc038508e6adaf5e88e2e052a976f010/68747470733a2f2f6669727374636f6e747269627574696f6e732e6769746875622e696f2f6173736574732f526561646d652f6769742d7374617475732e706e67) Προσθέστε αυτές τις αλλαγές στο κλαδί που μόλις δημιουργήσατε χρησιμοποιώντας την εντολή `git add`: `git add Contributors.md` Τώρα κάντε commit αυτές τις αλλαγές χρησιμοποιώντας την εντολή `git commit`: `git commit -m "Προσθήκη του-ονόματός-σας στη λίστα συντελεστών"` αντικαθιστώντας το `το-όνομα-σας` με το όνομά σας. # Ανέβασμα των αλλαγών στο GitHub Ανεβάστε τις αλλαγές σας χρησιμοποιώντας την εντολή `git push`: ``` git push origin -u το-όνομα-του-κλαδιού-σας ``` αντικαθιστώντας το `το-όνομα-του-κλαδιού-σας` με το όνομα του κλαδιού που δημιουργήσατε προηγουμένως.
Εάν παρατηρήσετε οποιοδήποτε σφάλμα κατά την αποστολή, κάντε κλικ εδώ: - ### Σφάλμα Πιστοποίησης 
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/<το-όνομα-χρήστη-σας>/first-contributions.git/'
Πηγαίνετε στο [οδηγό του GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) για τη δημιουργία και διαμόρφωση ενός κλειδιού SSH στον λογαριασμό σας.
# Υποβολή των αλλαγών σας για αναθεώρηση Τώρα εκτελώντας αυτήν την εντολή στον φάκελο του αποθετηρίου μας θα μας επιτρέψει να δημιουργήσουμε ένα αίτημα ενσωμάτωσης για αναθεώρηση: ```bash gh pr create --repo firstcontributions/first-contributions ``` Μετά από αυτό υποβάλετε το αίτημα ενσωμάτωσης. Μπορείτε να χρησιμοποιήσετε την εντολή `gh status` για να δείτε το αναφερόμενο αίτημα ενσωμάτωσης σε δράση. ## Πού να πάτε από εδώ; Συγχαρητήρια! Μόλις ολοκληρώσατε την κανονική ροή εργασίας _fork -> clone -> edit -> pull request_ που θα συναντήσετε συχνά ως συνεισφέροντες! Γιορτάστε τη συνεισφορά σας και μοιραστείτε τη με τους φίλους και τους ακόλουθούς σας πηγαίνοντας στην [ιστοσελίδα εφα ρμογής](https://firstcontributions.github.io/#social-share). Τώρα ας ξεκινήσουμε με τη συνεισφορά σας σε άλλα έργα. Έχουμε συγκεντρώσει μια λίστα με έργα με εύκολα ζητήματα με τα οποία μπορείτε να ξεκινήσετε. Ρίξτε μια ματιά στη [λίστα των έργων στην ιστοσελίδα εφαρμογής](https://firstcontributions.github.io/#project-list). ### [Πρόσθετο υλικό](additional-material/git_workflow_scenarios/additional-material.md) ## Οδηγοί με Άλλα Εργαλεία [Πίσω στην κύρια σελίδα](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/cli-tool-tutorials/translations/Marathi/github-cli-tutorial.marathi.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # प्रथम योगदान | GitHub Desktop | GitHub Command Line Interface (CLI) | | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | हे आमच्यासाठी मार्गदर्शक आहे, टर्मिनलच्या अभ्यासकांसाठी, ज्यांना टर्मिनलमध्ये सर्व काही करायचे आहे आणि [Github-CLI](https://cli.github.com/) बद्दल धन्यवाद, त्यांना ते मिळू शकते, तुमचे पहिले योगदान लक्षात ठेवा मजेशीर, फायद्याचे आणि पुढे जाण्यासाठी प्रेरक! हे मार्गदर्शक थोडे अधिक आव्हानात्मक आहे कारण आम्ही कोणताही ग्राफिकल इंटरफेस वापरत नाही, परंतु तरीही ते खरोखर मजेदार आहे आणि आपण निश्चितपणे अनुसरण करू शकता! पहिली आवश्यकता आहेः - Git स्थापित ([Git] कसे स्थापित करावे (https://git-scm.com/downloads)) - Github खाते आता आम्हाला अधिकृत कागदपत्रांचे अनुसरण करून आमच्या सिस्टममध्ये `github-cli` टूल स्थापित करणे आवश्यक आहे त्यानंतर, आम्हाला CLI वर लॉग इन करणे आवश्यक आहे, म्हणून ही आज्ञा प्रविष्ट करा: ```bash gh auth login ``` सूचनांचे अनुसरण करा आणि आम्ही तयार आहोत! # या भांडाराचा फोर्क करा ही कमांड चालवणे तितकेच सोपे आहे: ```bash gh repo fork firstcontributions/first-contributions ``` **महत्त्वाचे: तुम्हाला हे देखील क्लोन करायचे असल्यास ते तुम्हाला सूचित करेल, "होय" निवडा** # तुमची शाखा तयार करा आम्ही ही पायरी `git` सह करू, म्हणून ही आज्ञा तुमच्या नावाने पुनर्नामित करून प्रविष्ट करा, उदाहरणार्थ:(जॉन-डूई येथे तुमचे नाव टाका ```bash git switch -c add-जॉन-डूई ``` # आवश्यक बदल करा आणि ते बदल `किट` करा आता तुम्ही मजकूर संपादकामध्ये `Contributors.md` फाईल उघडू शकता आणि त्यात तुमचे नाव जोडू शकता. तुमचे नाव सुरुवातीपासून शेवटच्या दरम्यान कुठेही ठेवा, नंतर फाइल सेव्ह करा. प्रोजेक्ट डिरेक्टरीमध्ये `git status` कार्यान्वित करा आणि तुम्हाला बदल दिसतील. ते बदल तुम्ही 'git add' कमांड वापरून तयार केलेल्या शाखेत जोडा: `git add contributors.md` आता ते बदल `git कमिट` कमांड वापरून करा: `git commit -m "Add your-name to Contributors list` तुमच्या नावाने `your-name` बदला. # Github मध्ये बदल पुश करा 'git push' कमांड वापरून तुमचे बदल पुश करा: ```bash git push origin -u your-branch-name ``` तुम्ही आधी तयार केलेल्या शाखेच्या नावाने `your-branch-name` बदला.
पुश करताना तुम्हाला काही त्रुटी आढळल्यास, येथे क्लिक करा:
- ### प्रमाणीकरण त्रुटी रिमोट: 13 ऑगस्ट 2021 रोजी पासवर्ड ऑथेंटिकेशनसाठी सपोर्ट काढून टाकण्यात आला. कृपया त्याऐवजी वैयक्तिक प्रवेश टोकन वापरा. रिमोट: अधिक माहितीसाठी कृपया https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ पहा. घातक: 'https://github.com//first-contrib.git/' साठी प्रमाणीकरण अयशस्वी [तुमच्या खात्यासाठी एसएसएच की तयार आणि कॉन्फिगर करण्यावर गिटहबचे ट्यूटोरियल](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) ================================================ FILE: docs/cli-tool-tutorials/translations/Spanish/git-bash-windows-tutorial.es.md ================================================ [![Amor por el Código Abierto](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![Licencia: MIT](https://img.shields.io/badge/Άδεια-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Contribuyentes de Código Abierto](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeras Contribuciones | Git Bash | 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). 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. copiar enlace Abre la aplicación Git Bash que acabas de instalar. Debería lucir como la siguiente imagen si estás en Windows: abrir terminal de git bash Ve a la carpeta donde quieres guardar este proyecto usando el comando: `cd ` entrar a la carpeta deseada Usa el enlace copiado anteriormente para clonar tu repositorio: `git clone ` clonar repositorio Ve al directorio recién clonado y ábrelo en Visual Studio Code para hacer tus cambios. entrar al repo clonado ## Crear una rama Ahora crea una nueva rama usando este comando: ``` git checkout -b ``` Ejemplo: `add-james-smith` 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 ``` 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" ``` commit de cambios Para verificar el commit: ```bash git log --oneline ``` ## Sube tus cambios a GitHub ```bash git push origin ``` 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í. crear pull request Completa el formulario y envía el Pull Request. 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) ================================================ FILE: docs/cli-tool-tutorials/translations/Spanish/github-cli-tutorial.es.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions | GitHub Desktop | GitHub Command Line Interface (CLI) | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------| Esta es una guía para nosotros, los nerds de terminales, que queremos hacer todo en el terminal, y gracias a [Github-CLI](https://cli.github.com/), podemos lograrlo, recordando tu primera contribución. ¡Debe ser divertido, gratificante y motivador para seguir adelante! Esta guía es un poco más desafiante ya que no usamos ninguna interfaz gráfica, pero aún así es muy divertida y ¡definitivamente puedes seguirla! El primer requisito es tener: - Git instalado (cómo instalar [git](https://git-scm.com/downloads)) - Cuenta de Github Ahora vamos a necesitar instalar el `github-cli` En nuestro sistema siguiendo la [documentación oficial](https://github.com/cli/cli#installation) Después, debemos iniciar sesión en **CLI** (Interfaz de Línea de Comandos) usando el siguiente comando: ```bash gh auth login ``` Sigue las instrucciones y estamos listos.! # Bifurcar este repositorio Es tan fácil como ejecutar este comando: ```bash gh repo fork firstcontributions/first-contributions ``` **Importante: Te preguntará si también quieres clonarlo, selecciona la opción "sí"** # Crea tu sucursal Haremos este paso con git, así que ingresa este comando reemplazando el nombre con tu nombre, por ejemplo: ```bash git switch -c add-john-doe ``` # Realizar los cambios necesarios y confirmar esos cambios. Ahora puede abrir el archivo `Contributors.md` en un editor de texto y agregarle su nombre. Coloque su nombre en cualquier lugar entre el principio y el final, luego guarde el archivo. En el directorio del proyecto ejecute `git status` y verá los cambios. ![image-git](https://camo.githubusercontent.com/a35c4722d7aab337eefc655d1488f7b4dc038508e6adaf5e88e2e052a976f010/68747470733a2f2f6669727374636f6e747269627574696f6e732e6769746875622e696f2f6173736574732f526561646d652f6769742d7374617475732e706e67) Agrega esos cambios a la rama que acabas de crear usando el comando `git add`: `git add Contributors.md` Ahora confirma esos cambios usando el comando `git commit`: `git commit -m "Add your-name to Contributors list` reemplazando `your-name` con tu nombre. # Enviar cambios a github Empuje sus cambios usando el comando `git push`: ``` git push origin -u your-branch-name ``` reemplazando `your-branch-name` con el nombre de la sucursal que creaste anteriormente.
Si tienes algún error al hacer pull, haz click aquí - ### Authentication Error 
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//first-contributions.git/'
Visita [Tutorial de github](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account.
# Envíe sus cambios para su revisión Ahora, ejecutar este comando en el directorio de nuestro repositorio nos permitirá crear una solicitud de extracción para revisión: ```bash gh pr create --repo firstcontributions/first-contributions ``` Después de eso, envíe la solicitud de extracción. Puede usar el comando `gh status` para ver la solicitud de extracción mencionada en acción. ## ¿A dónde ir desde aquí? ¡Felicidades! ¡Acabas de completar el flujo de trabajo estándar _fork -> clone -> edit -> pull request_ workflow que encontrarás a menudo como colaborador! Celebre su contribución y compártala con sus amigos y seguidores en [aplicación web](https://firstcontributions.github.io/#social-share). Puedes unirte a nuestro equipo de Slack si necesitas ayuda o tienes alguna pregunta. [Únase al equipo de Slack] (https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA). Ahora comencemos a contribuir a otros proyectos. Hemos compilado una lista de proyectos con problemas sencillos con los que puede comenzar. Consulte [la lista de proyectos en la aplicación web] (https://firstcontributions.github.io/#project-list). ### [Material adicional](additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriales usando otras herramientas [Regresa a la página principal](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/cli-tool-tutorials/translations/Ukrainian/git-bash-windows-tutorial.ua.md ================================================ [![Любов до Open Source](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![Ліцензія: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Помічники Open Source](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Перші внески | Git Bash | Версія з Git Bash | | ------------------------------------------------------------------------------------------------------------------ | ----------------- | Це складно. Завжди складно робити щось уперше. Особливо, коли ви працюєте у команді — помилятися завжди некомфортно. Але open source — це саме про співпрацю та командну роботу. Ми хотіли спростити спосіб, у який новачки в open-source навчаються та роблять свій перший внесок. Читати статті й дивитися відеоуроки корисно, але немає нічого кращого, ніж спробувати на практиці без ризику щось зіпсувати. Цей проєкт має на меті зробити зрозумілий посібник і спростити спосіб, у який новачки роблять свій перший внесок. Пам’ятайте: чим спокійніше вам, тим краще ви навчаєтесь. Якщо ви хочете зробити свій перший внесок — просто дотримуйтесь інструкцій нижче. Обіцяємо — це буде весело! Якщо у вас немає Git Bash на Windows, [встановіть його](https://git-scm.com/download/win). fork this repository ## Форкніть цей репозиторій Натисніть кнопку Fork у верхньому правому куті цієї сторінки. Це створить копію репозиторію у вашому акаунті. ## Клонуйте репозиторій Тепер клонуйте репозиторій на ваш комп'ютер. ВАЖЛИВО: НЕ КЛОНУЙТЕ ОРИГІНАЛЬНИЙ РЕПОЗИТОРІЙ. Перейдіть до вашого форку і клонуте його. Щоб клонувати, натисніть на "Code" і скопіюйте запропонований рядок. copy string Відкрийте програму git bash, яку ви щойно встановили. Вона має виглядати як на наступній картинці, якщо ви використовуєте операційну систему Windows. open git bash terminal Перейдіть до папки, куди хочете зберегти проєкт, використовуючи наступну команду: ```bash cd <папка> ``` cd into a folder Вставте скопійований раніше рядок і виконайте команду клонування: ```bash git clone ``` clone the repository Перейдіть у директорію репозиторію та відкрийте його у VS Code для редагування. cd into the newly cloned repo ## Створіть гілку (branch) Використайте наступну просту команду для створення гілки. Ця команда не тільки створює нову гілку, а також переходить на цю гілку. ```bash git checkout -b <назва-гілки> ``` Назвіть свою гілку у форматі ``, наприклад: `add-james-smith` create a branch ## Зробіть необхідні зміни і зафіксуйте їх (commit) Відкрийте файл `Contributors.md` у текстовому редакторі, додайте ваше ім'я внизу сторінки і збережіть файл: Приклад: якщо ваше ім’я — James Smith, результат повинен виглядати так. \[James Smith](https://github.com/jamessmith) Перевірте зміни командою: ```bash git status ``` check the status Зафіксуйте ці зміни: Спочатку додайте зміну, яку ви зробили, до області індексації (staging area), використовуючи команду: ```bash git add ім'я_файлу ``` Потім напишіть повідомлення до коміту за допомогою цієї команди: ```bash git commit -m "Add <ваше-ім'я> to Contributors list" ``` commit changes Щоб перевірити історію комітів: ```bash git log --oneline ``` ## Відправте зміни на GitHub Коли ви завершите виконання наведених вище кроків, ви можете надіслати свої зміни за допомогою цієї команди: ```bash git push origin <назва-гілки> ``` push changes ## Надішліть запит для перевірки Перейдіть до вашого репозиторію на GitHub. Ви побачите кнопку "Compare & pull request". Натисніть її. create a pull request Після цього відправте pull request. submit pull request Незабаром ваші зміни буде об'єднано з основною гілкою проєкту. Ви отримаєте сповіщення електронною поштою після злиття вашої гілки з основною. ## Що далі? Вітаємо! Ви щойно завершили стандартний процес: _fork -> clone -> edit -> PR_! Поділіться своєю участю з друзями або підпишіться на нашу спільноту [web app](https://firstcontributions.github.io#social-share). Приєднуйтесь до нашої Slack-групи, якщо у вас виникли питання або потрібна допомога: [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [Додаткові матеріали](../additional-material/git_workflow_scenarios/additional-material.md) ## Інструкції для інших інструментів [Повернутись на головну сторінку](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/cli-tool-tutorials/translations/Ukrainian/github-cli-tutorial.ua.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Перші внески | GitHub Desktop | Інтерфейс командного рядка GitHub (CLI) | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------| Це керівництво для нас, нердів, які хочуть робити все у терміналі, і завдяки [Github-CLI](https://cli.github.com/), ми можемо досягти цього, пам'ятаючи, що ваш перший внесок повинен бути цікавим, корисним та мотивувати до подальшої роботи! Це керівництво трохи складніше, оскільки ми зовсім не використовуємо графічний інтерфейс, але це все ще дуже цікаво і ви точно зможете його виконати крок за кроком! Перша умова - мати: - Встановлений Git ([як встановити git](https://git-scm.com/downloads)) - Обліковий запис на Github Тепер нам потрібно встановити інструмент `github-cli` у нашу систему, виконавши кроки з [офіційної документації](https://github.com/cli/cli#installation) Після цього нам потрібно увійти до CLI, застосовуючи цю команду: ```bash gh auth login ``` Дотримуйтесь інструкцій, і ми готові починати! # Відгалужуємо репозиторій Це робиться, всього навсього, за допомогою однієї команди: ```bash gh repo fork firstcontributions/first-contributions ``` **Важливо: Якщо ви хочете одразу клонувати репозиторій, виберіть варіант "yes" ** # Створюємо свою гілку Ми зробимо цей крок за допомогою git, тому введіть цю команду, замінивши `taras-shevchenko` на ваше ім'я: ```bash git switch -c add-taras-shevchenko ``` # Вносимо необхідні зміни та записуємо їх Тепер ви можете відкрити файл `Contributors.md` в текстовому редакторі і додати до нього своє ім'я. Впишіть своє ім'я десь між початком і кінцем, а потім збережіть файл. У директорії проекту виконайте команду `git status`, і ви побачите виконані зміни. ![image-git](https://camo.githubusercontent.com/a35c4722d7aab337eefc655d1488f7b4dc038508e6adaf5e88e2e052a976f010/68747470733a2f2f6669727374636f6e747269627574696f6e732e6769746875622e696f2f6173736574732f526561646d652f6769742d7374617475732e706e67) Додайте ці зміни до гілки, яку ви щойно створили, використовуючи команду `git add`: `git add Contributors.md` Тепер запишіть ці зміни за допомогою команди `git commit`: `git commit -m "Add taras-shevchenko to Contributors list` замінюючи `taras-shevchenko` на ваше ім'я. # Відправляємо зміни в GitHub Відправте свої зміни за допомогою команди `git push`: ```bash git push origin -u your-branch-name ``` замініть `your-branch-name` ім'ям гілки, яку ви створили раніше.
Якщо ви отримаєте помилки під час відправки, натисніть тут: - ### Помилка автентифікації 
remote: Підтримка автентифікації за допомогою пароля була припинена 13 серпня 2021 року. Замість цього використовуйте особистий токен доступу.
    remote: Будь ласка, перегляньте https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ для отримання більш докладної інформації.
    fatal: Автентифікація завершилася помилкою для 'https://github.com//first-contributions.git/'
Перейдіть до [посібника GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) щодо створення та налаштування SSH-ключа для вашого облікового запису.
# Створюємо запит на рецензування своїх змін Тепер, запускаючи цю команду у директорії нашого репозиторію, ми зможемо створити запит на витяг (pull request) для рецензування. ```bash gh pr create --repo firstcontributions/first-contributions ``` Після цього подайте запит на витяг. Ви можете використати команду `gh status`, щоб побачити ваш вищезгаданий запит на витяг у дії. ## Що далі? Вітаємо! Ви щойно завершили стандартний робочий процес _fork -> clone -> edit -> pull request_, який часто зустрічається серед співавторів open source проектів! Відзначте свій внесок та поділіться ним з друзями та підписниками, перейшовши до [веб-додатку](https://firstcontributions.github.io/#social-share). Ви можете приєднатися до нашої [команди у Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA), якщо вам потрібна допомога чи у вас є які-небудь питання. Тепер ви можете розпочати робити ваш внесок до інших проектів. Ми склали список проектів з легкими проблемами, з яких ви можете почати. [Посилання до списку проектів](https://firstcontributions.github.io/#project-list). ### [Додатковий матеріал](https://github.com/firstcontributions/first-contributions/blob/main/additional-material/git_workflow_scenarios/additional-material.md) ## Навчальні посібники з використанням інших інструментів [Повернутися на головну сторінку](https://github.com/firstcontributions/first-contributions/blob/main/translations/README.ua.md#%D1%96%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D1%96%D1%97-%D0%B4%D0%BB%D1%8F-%D1%96%D0%BD%D1%88%D0%B8%D1%85-%D1%96%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D1%96%D0%B2) ================================================ FILE: docs/cli-tool-tutorials/translations/github-cli-tutorial-malayalam.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # ആദ്യ സംഭാവനകൾ (First Contributions) | GitHub Desktop | GitHub കമാൻഡ് ലൈൻ ഇൻ്റർഫേസ് (CLI) | | ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | ടെർമിനൽ ഉപയോഗിച്ച് എല്ലാം ചെയ്യാൻ ആഗ്രഹിക്കുന്ന നമുക്ക് വേണ്ടി ഉള്ളതാണ് ഈ വഴികാട്ടി (ഗൈഡ് ). [Github-CLI](https://cli.github.com/)ക്ക് നന്ദി , നമുക്ക് ഇപ്പോൾ അത് സാധ്യമാണ് . നിങ്ങളുടെ ആദ്യ സംഭാവന (first contribution) ഓർമ്മിക്കുന്നത് രസകരവും പ്രതിഫലദായകവും മുന്നോട്ട് പോകുവാൻ പ്രചോദനം നല്കുന്നതുമായിരിക്കണം ! ഒരു ഗ്രാഫിക്കൽ ഇൻ്റർഫേസും ഉപയോഗിക്കാത്തതിനാൽ ഈ ഗൈഡ് അൽപ്പം വെല്ലുവിളി നിറഞ്ഞതാണെങ്കിലും, ഇത് ഇപ്പോഴും വളരെ രസകരവും , തീർച്ചയായും നിങ്ങൾക്ക് പിന്തുടരാനാകുന്നതുമാണ് ! തുടങ്ങുന്നതിന് ആവശ്യമായ കാര്യങ്ങൾ: - Git ഇൻസ്റ്റാൾ ചെയ്യുക ( എങ്ങിനെ [git](https://git-scm.com/downloads) ഇൻസ്റ്റാൾ ചെയ്യണം ) - Git അക്കൗണ്ട് ഇനി നിങ്ങളുടെ കമ്പ്യൂട്ടറിലേക്ക് `github-cli` ടൂൾ ഇൻസ്റ്റാൾ ചെയ്യുന്നതിനായി [ഔദ്യോഗിക ഡോക്യൂമെന്റേഷൻ ](https://github.com/cli/cli#installation)'ൽ പറഞ്ഞിരിക്കുന്ന നിർദ്ദേശങ്ങൾ പിന്തുടരുക. അതിനു ശേഷം CLI'ലേക്ക് ലോഗിൻ ചെയ്യുന്നതിനായി താഴെ പറയുന്ന കമാൻഡ് ഉപയോഗിക്കുക ```bash gh auth login ``` താഴെ പറയുന്ന നിർദ്ദേശങ്ങൾ പാലിക്കുന്നതോടു കൂടി നിങ്ങൾ തയ്യാറായി കഴിഞ്ഞു # ഈ റെപ്പോസിറ്ററി ഫോർക് ചെയ്യുക ഇതിനായി താഴെ പറയുന്ന കമാൻഡ് റൺ ചെയ്‌താൽ മാത്രം മതി ```bash git switch -c add-john-doe ``` # ആവശ്യമായ മാറ്റങ്ങൾ വരുത്തിയതിനു ശേഷം അത് കമ്മിറ്റ് ചെയ്യുക ഇനി നിങ്ങൾക് `Contributors.md` ഫയൽ ഒരു ടെക്സ്റ്റ് എഡിറ്റർ ഉപയോഗിച്ച് തുറന്ന് നിങ്ങളുടെ പേര് അതിൽ ചേർക്കാവുന്നതാണ് . തുടക്കത്തിന്റെയും അവസാനത്ത്തിന്റെയും ഇടയിൽ എവിടെയെങ്കിലും ഒരു സ്ഥാനത്ത് നിങ്ങളുടെ പേര് ചേർത്തതിന് ശേഷം ഫയൽ സേവ് ചെയ്യുക. പ്രൊജക്റ്റ് ഡിറക്ടറിയിൽ `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 your-branch-name ``` `your-branch-name`നു പകരം നിങ്ങൾ നേരത്തെ ഉണ്ടാക്കിയ ബ്രാഞ്ചിന്റെ പേര് വേണം ഉപയോഗിക്കാൻ.
പുഷ് ചെയ്യുന്നതിനിടക്ക് പ്രശനങ്ങൾ(errors) സംഭവിക്കുകയാണെങ്കിൽ ഇവിടെ ക്ലിക്ക് ചെയ്യുക : - ### പ്രാമാണീകരണപിശക് (Authentication Error) 
റിമോട്ട്: പാസ്‌വേഡ് പ്രാമാണീകരണത്തിനുള്ള പിന്തുണ 2021 ഓഗസ്റ്റ് 13-ന് നീക്കം ചെയ്‌തു. പകരം ഒരു വ്യക്തിഗത ആക്‌സസ് ടോക്കൺ ഉപയോഗിക്കുക.
  റിമോട്ട്: കൂടുതൽ വിവരങ്ങൾക്ക് https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ കാണുക.
  fatal:'https://github.com//first-contributions.git/'ലേക്കുള്ള authentication പരാജയപ്പെട്ടു .
നിങ്ങളുടെ അക്കൗണ്ടിലേക്ക് ഒരു SSH കീ നിർമ്മിക്കുവാനും ക്രമീകരിക്കുവാനുമായി ഈ ലിങ്കിലേക്ക് പോകുക [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) .
## നിങ്ങളുടെ വ്യത്യാസങ്ങൾ പരിശോധനക്കായി (review) സമർപ്പിക്കുക നിങ്ങളുടെ റെപ്പോസിറ്റോറിയിൽ താഴെ പറയുന്ന കമാൻഡ് റൺ ചെയ്യുന്നതോടെ പരിശോധനക്കായി ഒരു pull request ഉണ്ടാക്കുവാൻ നിങ്ങൾക് സാധിക്കും. ```bash gh pr create --repo firstcontributions/first-contributions ``` അതിനു ശേഷം pull request സമർപ്പിക്കുക. നിങ്ങളുടെ സൂചിപ്പിച്ച pull request പ്രവർത്തനക്ഷമമായി കാണുന്നതിന് നിങ്ങൾക്ക് `gh status`കമാൻഡ് ഉപയോഗിക്കാം. ## ഇവിടെ നിന്ന് ഇനി എങ്ങോട്ട്? അഭിനന്ദനങ്ങൾ! ഒരു സംഭാവകൻ എന്ന നിലയിൽ നിങ്ങൾ പലപ്പോഴും അഭിമുഖീകരിക്കുന്ന സ്റ്റാൻഡേർഡ് ഫോർക്ക് -> ക്ലോൺ -> എഡിറ്റ് -> പുൾ അഭ്യർത്ഥന വർക്ക്ഫ്ലോ നിങ്ങൾ ഇപ്പോൾ പൂർത്തിയാക്കി! തങ്ങളുടെ സംഭാവന സുഹൃത്തുക്കളും പിൻഗാമികളും ആയി പങ്കിടുന്നതിനും ആഘോഷിക്കുന്നതിനും ആയി [വെബ് ആപ്പ് ](https://firstcontributions.github.io/#social-share)ലേക്ക് പോകുക. താങ്കൾക് എന്ധെങ്കിലും സഹായം വേണമെങ്കിലോ എന്ധെങ്കിലും ചോദ്യങ്ങൾ ഉണ്ടെങ്കിലോ നമ്മുടെ Slack ടീമിൽ ചേരാവുന്നതാണ് . [Slack ടീമിൽ ചേരുക ](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) ================================================ FILE: docs/cli-tool-tutorials/translations/github-cli-tutorial-te.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # మొదటి సహకారం | GitHub Desktop | GitHub Command Line Interface (CLI) | | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ఇది మాకు ఒక గైడ్, టెర్మినల్ నెర్డ్స్, ఎవరైతే టెర్మినల్‌లో ప్రతిదీ చేయాలనుకుంటారు, మరియు [Github-CLI](https://cli.github.com/)కు ధన్యవాదాలు, మేము దీన్ని సాధించగలము, మీ మొదటి సహకారం సరదాగా, బహుమతినిచ్చేది మరియు కొనసాగించడానికి ప్రేరేపకంగా ఉండాలని గుర్తుంచుకోండి! ఈ గైడ్ కొంచెం ఎక్కువ సవాలుగా ఉంటుంది ఎందుకంటే మేము ఏదైనా గ్రాఫికల్ ఇంటర్‌ఫేస్‌ను ఉపయోగించడం లేదు, కానీ ఇది ఇప్పటికీ నిజంగా సరదాగా ఉంటుంది మరియు మీరు ఖచ్చితంగా దీన్ని అనుసరించగలరు! మొదటి అవసరం: - Git ఇన్‌స్టాల్ చేయబడి ఉండాలి ([git](https://git-scm.com/downloads) ఎలా ఇన్‌స్టాల్ చేయాలి) - Github ఖాతా ఇప్పుడు మన సిస్టమ్‌లో `github-cli` టూల్‌ను [అధికారిక డాక్యుమెంటేషన్](https://github.com/cli/cli#installation)ను అనుసరించి ఇన్‌స్టాల్ చేయాలి దాని తర్వాత, మనం CLIలో లాగిన్ అవ్వాలి, కాబట్టి ఈ కమాండ్‌ను ఎంటర్ చేయండి: ```bash gh auth login ``` సూచనలను అనుసరించండి మరియు మేము సిద్ధంగా ఉన్నాము! # ఈ రిపోజిటరీని ఫోర్క్ చేయండి ఈ కమాండ్‌ను రన్ చేయడం ఎంత సులభమో: ```bash gh repo fork firstcontributions/first-contributions ``` **ముఖ్యమైనది: మీరు దీన్ని కూడా క్లోన్ చేయాలనుకుంటున్నారా అని అడుగుతుంది, "yes" ఆప్షన్‌ను ఎంచుకోండి** # మీ బ్రాంచ్‌ను సృష్టించండి మేము ఈ దశను gitతో చేస్తాము, కాబట్టి ఈ కమాండ్‌ను మీ పేరుతో ఎంటర్ చేయండి, ఉదాహరణకు: ```bash git switch -c add-రామ-కృష్ణ ``` # అవసరమైన మార్పులు చేయండి మరియు ఆ మార్పులను కమిట్ చేయండి ఇప్పుడు మీరు `Contributors.md` ఫైల్‌ను టెక్స్ట్ ఎడిటర్‌లో తెరవవచ్చు మరియు దానిలో మీ పేరును జోడించవచ్చు. ప్రారంభం మరియు ముగింపు మధ్య ఎక్కడైనా మీ పేరును ఉంచండి, తర్వాత ఫైల్‌ను సేవ్ చేయండి. ప్రాజెక్ట్ డైరెక్టరీలో `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 your-branch-name ``` `your-branch-name` ను మీరు ముందుగా సృష్టించిన బ్రాంచ్‌ పేరుతో మార్చండి.
మీరు పుష్ చేస్తున్నప్పుడు ఏవైనా లోపాలు వస్తే, ఇక్కడ క్లిక్ చేయండి: - ### ప్రమాణీకరణ లోపం 
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//first-contributions.git/'
మీ ఖాతాకు SSH కీని రూపొందించడం మరియు కాన్ఫిగర్ చేయడంపై [GitHub's tutorial](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` కమాండ్‌ను ఉపయోగించవచ్చు. ## ఇక్కడ నుండి ఎక్కడికి వెళ్లాలి? అభినందనలు! మీరు స్టాండర్డ్ _fork -> clone -> edit -> pull request_ వర్క్‌ఫ్లోను పూర్తి చేసారు, దీన్ని మీరు తరచుగా ఒక కంట్రిబ్యూటర్‌గా ఎదుర్కొంటారు! [వెబ్ యాప్‌కి](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) ================================================ FILE: docs/cli-tool-tutorials/translations/github-cli-tutorial.hi.md ================================================ # first [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # पहला योगदान | GitHub Desktop | 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` निष्पादित करें और आप परिवर्तन देखेंगे। ![image-git](https://camo.githubusercontent.com/a35c4722d7aab337eefc655d1488f7b4dc038508e6adaf5e88e2e052a976f010/68747470733a2f2f6669727374636f6e747269627574696f6e732e6769746875622e696f2f6173736574732f526561646d652f6769742d7374617475732e706e67) उन परिवर्तनों को उस शाखा में जोड़ें जिसे आपने अभी `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` आपके द्वारा पहले बनाई गई शाखा के नाम से बदलकर।
यदि आपको पुश करते समय कोई त्रुटि मिलती है, तो यहां क्लिक करें:
- ### प्रमाणीकरण त्रुटि रिमोट: 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) ================================================ FILE: docs/gui-tool-tutorials/github-desktop-old-version-tutorial.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions |GitHub Desktop|GitHub Desktop 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. fork this repository If you don't have GitHub Desktop on your machine, [install it](https://desktop.github.com/). ## Fork this repository Fork this repo by clicking on the fork button on the top of this page. This will create of copy of this repository in your account. ## Clone the repository Now clone this repo to your machine. Open the GitHub Desktop app and click on the `+` on the top left. clone this repository If it is not already selected, click on `Clone`. Then choose first-contributions and then click on `Clone first-contributions` clone this repository Choose the directory on your machine you would like to clone first-contributions into clone this repository Now you have copied the contents of the first-contributions repository in github to your computer. ## Create a branch Now create a branch by clicking on the branch icon at the top left: make a branch Name your branch add-your-name. For example, add-crawleya Click on `Create new branch` name your branch ## Make necessary changes and commit those changes Now open `Contributors.md` file in a text editor and add your name to it, then save the file. You can see that there are changes to Contributors.md and they have been added. check status Now commit those changes: Write the message "Add `` to Contributors list" in the *summary* field Replace `` with your name Click on the button that says `Commit to add-your-name` commit your changes At the bottom, you can see that the commit has been created. commit your changes ## Push changes to github Click the `Publish` button on the top right. push your 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. create a pull request Now submit the pull request. 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). ### [Additional material](../additional-material/git_workflow_senarios/additional-material.md) ## Tutorials Using Other Tools [Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/github-desktop-tutorial.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions | GitHub Desktop | GitHub Desktop 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 GitHub Desktop on your machine, [install it](https://desktop.github.com/). If you're using a version of GitHub desktop before 1.0, [refer to this tutorial](github-desktop-old-version-tutorial.md). 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 click on "Open in Github Desktop". clone this repository A pop up window will open. Click on "Open GitHubDesktop.exe". clone this repository After you click on "Open GitHubDesktop.exe" a 'Clone a repository' dialogue box appears. Click on 'Clone'. clone this repository After that another dialogue box that says 'How are you planning to use this fork?' appears. Select 'To contribute to the parent project' and click on 'Continue'. Use of repository Now you have copied the contents of the first-contributions repository in github to your computer. ## Create a branch Now create a branch by clicking on the "Current branch" icon at the top and then click on "New branch": make a branch Name your branch . For example, "add-james-smith" name your branch Click on `Create branch` ## Make necessary changes and commit those changes Now, go to history tab and open `Contributors.md` file in a text editor by right clicking and open in 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 and they have been added to the Github Desktop. check status Now commit those changes: Write the message "Add `` to Contributors list" in the _summary_ field. Replace `` with your name. Click on the button that says `Commit to add-your-name`. commit your changes At the bottom, you can see that the commit has been created. commit your changes ## Push changes to github Click on File->Options and sign-in to Github.com. Type in your Github username and password. log-in to Github Click the `Publish` button on the top right. push your 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. create a pull request Now submit the pull request. 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). ### [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) ================================================ FILE: docs/gui-tool-tutorials/github-windows-intellij-tutorial.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions | IntelliJ IDEA | Intellij IDEA | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | 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 IntelliJ IDEA on your machine, [install it](https://www.jetbrains.com/idea/download/#section=windows). **Notice:** This tutorial was made using IntelliJ IDEA (Version 2019.3.2) on a Windows 10 machine. Later in this tutorial we will make use of some keyboard shortcuts. These may differ on other operating systems (macOS/Linux). ## 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 GitHub account. GitHub keeps track of the relationship between your repo and the one you have forked it from. You can think of your repo as a working copy. Most top-level GitHub Repos (i.e. ones not forked from any other repo) have a small core team of people who can directly commit changes. All other contributors must fork the repo and make changes in the fork, then create a Pull Request to request to merge back their changes into the top-level repo. If the top-level repo administrator approves the changes they will be merged, and you will gain instant fame and fortune! More on how to do that later. ## Clone your repository clone this repository The next step is to clone your repo down to your machine, so you can begin making changes. IntelliJ IDEA needs the URL of your repo, so click the "clone" button and then click the "copy to clipboard" icon. **CAREFUL:** One common mistake that new contributors often make is to clone the repo you forked _from_ rather than cloning your repo. Check your browser's address bar and make sure you are cloning your repo. Now open up IntelliJ IDEA. IntelliJ IDEA allows you to check out (in Git terms clone) an existing repository and create a new project based on the data you've downloaded. From the main menu, choose VCS | Get from Version Control, or, if no project is currently opened, click Get from Version Control on the Welcome screen. In the Get from Version Control dialog, specify the URL of the remote repository you want to clone (you can click Test to make sure that connection to the remote can be established) or select one of the VCS hosting services on the left. If you are already logged in to the selected hosting service, completion will suggest the list of available repositories that you can clone. Click Clone. If you want to create an IntelliJ IDEA project based on the sources you have cloned, click Yes in the confirmation dialog. Git root mapping will be automatically set to the project root directory. If your project contains submodules, they will also be cloned and automatically registered as project roots. **Important**: Make sure it is the forked repository and not the original one, otherwise it won't work. ## Create a branch In Git, branching is a powerful mechanism that allows you to diverge from the main development line, for example, when you need to work on a feature or freeze a certain state of a codebase for a release, and so on. In IntelliJ IDEA, all operations with branches are performed in the Git Branches popup. To invoke it, click the Git widget in the Status bar or press Ctrl+Shift+`. The name of the branch that is currently checked out is displayed in the Git widget in the Status bar. In the branches popup, choose New Branch. In the dialog that opens, specify the branch name, and make sure the Checkout branch option is selected if you want to switch to that branch. The new branch will start from the current HEAD. If you want to start a branch from a previous commit instead of the current branch HEAD, select this commit in the Log tab of the Version Control tool window Alt+9 and choose New Branch from the context menu. ## Make necessary changes Open `Contributors.md` and add your name anywhere in the file. This file contains GFM (GitHub Flavored Markdown) which is a proprietary flavor of the markdown syntax. Copy one of the other contributors' lines and modify it with your name to make sure you get the syntax right - it can be picky. ## Commit & Push changes to GitHub Select the files you want to commit or an entire changelist in the Local Changes tab of the Version Control tool window Alt+9 and press Ctrl+K or click Commit Commit button on the toolbar. The Commit Changes dialog that opens lists all files that have been modified since the last commit, as well as all newly added unversioned files. Enter a meaningful commit message. You can click Commit Message history Commit Message history Ctrl+M to choose from the list of recent commit messages. You can also edit the commit message later before you've pushed the commit. Press Ctrl+Shift+K or choose VCS | Git | Push from the main menu. The Push Commits dialog opens showing all Git repositories (for multi-repository projects) and listing all commits made in the current branch in each repository since the last push. ## Submit your changes for review At this point you have completed your change but it still only resides in your repo. This step will show you how to submit a request to the administrator of the top-level repo to merge your change. In your repo on GitHub you'll see the `Compare & pull request` button next to the new branch notification. Click on that button. create a pull request Now submit the pull request. 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 have 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). ### [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) ================================================ FILE: docs/gui-tool-tutorials/github-windows-intellij-tutorial.zh-cn.md ================================================ [![开源之爱](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![许可证: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions（第一次贡献） | IntelliJ IDEA | Intellij IDEA | | ---------------------------------------------------------------------------------------------------------------------- | ------------- | 第一次做某事总是困难的。尤其是在协作时，犯错误并不是一件舒服的事。但开源的本质就是协作与共同进步。我们希望简化新手学习与第一次参与开源项目的过程。 阅读文章和观看教程是有帮助的，但没有什么比“亲手实践又不会搞砸项目”更好的学习方式了。这个项目的目标是为新手提供指导，并简化他们第一次做出贡献的过程。记住：越放松，学习效果越好。如果你正在寻找第一次开源贡献的机会，只需按照以下简单的步骤操作。我们保证这将是一段有趣的旅程。 如果你还没有安装 IntelliJ IDEA，[点击这里安装](https://www.jetbrains.com/idea/download/#section=windows)。 **注意：** 本教程使用的是 IntelliJ IDEA（版本 2019.3.2）在 Windows 10 系统上操作。教程中后续涉及的一些快捷键在 macOS 或 Linux 上可能会有所不同。 --- ## Fork 这个仓库 fork this repository 点击页面右上角的 Fork 按钮 Fork 此仓库。这将在你的 GitHub 账户中创建一个此项目的副本。 GitHub 会记录你 Fork 的仓库与原始仓库之间的关系。你可以把你的副本看作是一个工作副本。 大多数顶层 GitHub 仓库（即不是 Fork 而来的）只有一小部分核心团队成员可以直接提交更改。其他所有贡献者必须 Fork 该仓库，修改后提交 Pull Request 请求将更改合并回主仓库。一旦主仓库管理员批准这些更改，它们将被合并，而你将瞬间收获名誉与财富！稍后我们会介绍如何创建 Pull Request。 --- ## 克隆你的仓库 clone this repository 下一步是将你的仓库克隆到本地，这样你就可以开始修改内容了。IntelliJ IDEA 需要你的仓库 URL，因此点击仓库页面上的 "Code" 按钮，然后点击“复制”图标。 **注意：** 新手经常犯的一个错误是克隆了原始仓库而不是自己的 Fork 仓库。请确认你复制的是你自己的仓库地址。 现在打开 IntelliJ IDEA。 IntelliJ IDEA 允许你检出（Git 中的 clone）一个已有的仓库，并基于下载的内容创建新项目。 在主菜单中选择 `VCS | Get from Version Control`，或者在没有打开项目时点击欢迎界面中的 `Get from Version Control`。 在打开的对话框中，粘贴你仓库的远程地址（你也可以点击 “Test” 测试连接），或从左侧选择一个 VCS 托管服务。如果你已登录某个服务，它会自动列出你可克隆的仓库。 点击 “Clone”。如果你想基于克隆的源代码创建 IntelliJ 项目，在确认对话框中点击 “Yes”。Git 根目录将自动设置为项目根目录。 如果项目包含子模块，它们也会被克隆并注册为项目根。 **重要提示：** 确保克隆的是你自己的 Fork 仓库，而不是原始仓库，否则不会生效。 --- ## 创建分支 在 Git 中，分支是一种强大的机制，允许你从主开发线中分离出来，比如开发一个新功能或为发布冻结某个版本等。 在 IntelliJ IDEA 中，所有与分支相关的操作都可以在 Git 分支弹出窗口中完成。点击状态栏中的 Git 小部件，或按 `Ctrl+Shift+\`` 唤出它。 当前检出的分支名称会显示在状态栏的 Git 小部件中。 在弹出窗口中选择 `New Branch`。 在弹出对话框中输入分支名称，确保勾选 “Checkout branch” 选项，这样你会自动切换到新建分支。 新分支会从当前的 HEAD 开始。如果你想从某个旧提交创建分支，可以在 `Version Control` 工具窗口的 `Log` 选项卡（快捷键 Alt+9）中选择一个提交，然后右键选择 `New Branch`。 --- ## 进行必要的修改 打开 `Contributors.md` 文件，在文件中的任意位置添加你的名字。该文件使用的是 GitHub Flavored Markdown (GFM) 语法，是 Markdown 的一种扩展格式。 你可以复制其他贡献者的格式，并修改成你的名字，以确保语法正确 —— 有时语法会比较严格。 --- ## 提交并推送更改到 GitHub 在 `Version Control` 工具窗口的 `Local Changes` 选项卡中，选择你要提交的文件或整个更改列表，按下 `Ctrl+K` 或点击工具栏上的 `Commit` 按钮。 在弹出的提交对话框中，会列出你自上次提交以来的所有更改文件及新增文件。 输入有意义的提交信息。 你可以按 `Ctrl+M` 打开提交历史，从中选择最近用过的提交信息。 你也可以在推送前随时修改提交信息。 按 `Ctrl+Shift+K` 或从主菜单选择 `VCS | Git | Push`。弹出的 `Push Commits` 窗口会列出当前分支所有未推送的提交。 --- ## 提交 Pull Request 请求代码审查 此时你已完成了修改，但这些更改仍然只存在于你自己的仓库中。接下来我们将向原始仓库提交合并请求。 在你的 GitHub 仓库页面上，你会看到一个 “Compare & pull request” 的按钮。点击它。 创建 Pull Request 接下来提交你的 Pull Request。 提交 Pull Request 不久之后，你的更改就会被合并到主仓库的 master 分支中。一旦合并成功，你会收到邮件通知。 --- ## 接下来可以做什么？ 恭喜！你刚刚完成了标准的 _fork -> clone -> 编辑 -> PR_ 流程，这将是你未来开源贡献中非常常见的工作流程！ 庆祝一下你的首次贡献，并通过 [web app](https://firstcontributions.github.io#social-share) 与好友分享你的成就吧！ --- ### [附加资料](../additional-material/git_workflow_scenarios/additional-material.md) ## 使用其他工具的教程 [返回主页](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions | Visual Studio Code | Visual Studio Code | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | 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 is 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 Visual Studio Code on your machine, [install it](https://code.visualstudio.com/download). **Notice:** This tutorial was made using Visual Studio Code (Version 1.27.2) on a Windows 10 machine. Later in this tutorial we will make use of some keyboard shortcuts. These may differ on other operating systems (macOS/Linux) as well as keyboard language (UK, DE, etc). You can go through your list of shortcuts by searching "shortcut" in the Command Palette. ## 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 GitHub account. GitHub keeps track of the relationship between your repo and the one you have forked it from. You can think of your repo as a working copy. Most top-level GitHub repos (i.e. ones not forked from any other repo) have a small core team of people who can directly commit changes. All other contributors must fork the repo and make changes in the fork, then create a Pull Request to ask for their changes to be merged back into the top-level repo. If the top-level repo administrator likes the changes they will be merged and you will gain instant fame and fortune! More on how to do that later. ## Clone your repository clone this repository The next step is to clone your repo down to your machine so you can begin making changes. VS Code needs the URL of your repo, so click the code button and then click the "copy to clipboard" icon. **CAREFUL:** One mistake that new contributors often make is to clone the repo you forked _from_ rather than cloning your repo. Check your browser's address bar and make sure you are cloning your repo. Now open up Visual Studio Code. The welcome page of VS Code will pop up. From there press `F1` to open up the bar shown below. Notice that there is already a `>` (greater than) sign in the text field. You can also get to the input prompt by pressing `CTRL-P` and then type the `>` character. Clone Popup (Command Popup) You may notice that there are already some obscure commands listed below. Those are my recently used commands. So just don't care about them. Clone repo Now type in `git clone`, only `git` or `clone` (it works like a search). Select the Entry `Git: Clone` and press `Enter` Paste Repository URL in Paste the URL of your repository and press `Enter`. This will open up a File Explorer where you can then choose where the Git repository should be stored. **Important**: Make sure it is the forked repository and not the original one, otherwise it won't work. Status popup You should see a status popup on the bottom right of Visual Studio Code. After it has finished, you can open up the cloned repository (now a folder on your machine) using the buttons in the dialog. ## Create a branch Open up the command palette again by pressing `F1`. Type in `branch` and select the `create branch` command from there. In the next step type in the name of your new branch, for example `add-david-kroell`. Press enter and the branch will be created. The branch is also already checked out. [What does checkout mean?](https://www.git-scm.com/docs/git-checkout) Branches Command Palette ## Make necessary changes Open `Contributors.md` and add your name anywhere in the file. This file contains GFM (GitHub Flavored Markdown) which is a proprietary flavor of the markdown syntax. Copy one of the other contributors' lines and modify it with your name to make sure you get the syntax right - it can be picky. Save file to register change. Add your name ## Commit & Push changes to GitHub On the left side of VS Code is a menu with 5 icons displayed. Select the version control/Source Control icon. (Shortcut : Ctrl + Shift + G) Commit changes The file explorer displays all files which were changed after the last commit. By hovering the files and clicking the `+` (plus) the files are staged. Stashed Files Type something in the line on top of the explorer and press the checkmark. The changes are now committed to your local copy. Now the changes have to be pushed back to GitHub. Stashed Files Use the three-dot icon to open up the menu where you select the `Publish Branch` option. This should open up a dialog to put your GitHub credentials in. Stashed Files ## Submit your changes for review At this point you have completed your change but it still only resides in your repo. This step will show you how to submit a request to the administrator of the top-level repo to merge your change. In your repo on GitHub you'll see the `Compare & pull request` button next to the new branch notification. Click on that button. create a pull request Now submit the pull request. 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 have 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). ### [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) ================================================ FILE: docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions |Visual Studio 2017|Visual Studio 2017 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 Visual Studio 2017 on your machine, [install it](https://www.visualstudio.com/downloads/). ## Fork this repository fork this repository Fork this repository by clicking on the fork button on the top of this page. This will create of copy of this repository in your GitHub account. GitHub keeps track of the relationship between your repo and the one you forked it from. You can think of your repo as a working copy. Most top-level GitHub repos (i.e. ones not forked from any other repo) have a small core team of people who can directly commit changes. All other contributors must fork the repo and make changes in the fork, then create a Pull Request to ask for their changes to be merged back into the top-level repo. If the top-level repo administrator likes the changes they will be merged and you will gain instant fame and fortune! More on how to do that later. ## Clone your repository clone this repository The next step is to clone your repo down to your machine so you can begin making changes. Visual Studio needs the URL of your repo, so click the "clone" button and then click the "copy to clipboard" icon. **CAREFUL:** One mistake that new contributors often make is to clone the repo you forked *from* rather than cloning your repo. Check your browser's address bar and make sure you are cloning your repo. It is now time to jump in to Visual Studio 2017! You will be working in the Team Explorer tab for most of this tutorial. If it is not open by default, click `View > Team Explorer` to open it. Team Explorer Team Explorer has many views and there are navigation buttons located at the top to help you find the different areas. To clone a repo, you need to be on the Connect view, which should be the default. If you do not see the 'clone' button, click the green plug at the top. Click the `Clone` option under **Local Git Repositories** and paste the URL to your repo in the text box. This should be the URL you copied to your clipboard from GitHub previously. Click the `Clone` button to initiate the process. Clone repo When the process is complete you will be moved over to the Solution Explorer tab where you can see the contents of your repo. Yours will look different than the screenshot below because things change! Solution Explorer ## Create a branch Click back to the Team Explorer tab and use the main navigation dropdown to open the Branches view. Branches view You should see the **first-contributions** repo and the default branch, which is called `master`. Right-click on `master` and choose `New Local Branch From...`. New branch Give your branch a name like `add-`, for example: `add-alonzo-church`. Leave the `Checkout branch` box checked and click the `Create Branch` button. Create branch You should see your new branch in the list. See new branch ## Make necessary changes Open `Contributors.md` and add your name to the end of the list. This file contains GFM (GitHub Flavored Markdown) which is a proprietary flavor of the markdown syntax. Copy one of the other contributors' lines and modify it with your name to make sure you get the syntax right - it can be picky. Add your name ## Commit & Push changes to GitHub Switch back to Team Explorer and navigate to the Changes view. Changes Enter the information you want to post with your commit and click `Save`. Visual Studio will remember it for future commits. Git user information **NOTE:** Visual Studio uses a hidden folder called `.vs` to store your personal settings and preferences. The contents of this folder **should not be saved in Git**. If it has not been ignored already, you may need to tell Git to ignore this folder so it does not send it up to the repo. This folder has already been ignored in this repo, so you should not have to perform this step...it is just here for your reference for future projects. Ignore vs folder Now you should see a list of changed files and a textbox to type a commit comment. Comments should be in brief but thorough. There is nothing worse than reading through commit comments and seeing this: `"I updated some stuff"`. Take a few seconds to outline your commit. Your team will thank you later, and you might even thank yourself! Click `Commit All and Push` to perform a local commit and push your changes back up to your repo, all in one step. **NOTE:** Commit can be performed separately from Push. We do both here for convenience. Commit logs your changes locally but they will not be reflected in your GitHub repo until you Push. Commit and Push The first time you Push to GitHub, Visual Studio will ask for your GitHub credentials. They will be cached so you should not see this very often. Login After the Push operation completes, open your repo in GitHub and you should see a message indicating a recently pushed branch. You can view your changes by opening the `Branch: master` dropdown and selecting your new branch. Congratulations, you can share the branch URL with the world to show your progress! View pushed branch on GitHub ## Submit your changes for review At this point you have completed your change but it still only resides in your repo. This step will show you how to submit a request to the administrator of the top-level repo to merge your change. In your repo on GitHub you'll see the `Compare & pull request` button next to the new branch notification. Click on that button. create a pull request Now submit the pull request. 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 have 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). ### [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) ================================================ FILE: docs/gui-tool-tutorials/gitkraken-tutorial.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions |GitKraken|GitKraken Edition| |---|---| It's hard. It's always hard, when you do something for the first time. 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. ## Git Kraken Download [GitKraken](https://www.gitkraken.com), Install and open it. You should see the "Welcome to GitKraken" modal dialog - Sign in with GitHub and allow GitKraken access to your GitHub account. login to GitHub (optional) Go to File -> Preferences and set your project directory to the root of your local repositories. ## Fork this repository Fork this repo by clicking on the fork button on the top of this page. fork this repository This will create of copy of this repository in your account. ## Clone the repository In GitKraken, go to File -> Clone Repo. clone this repository Select GitHub.com in the right pane. Under your username, you should see first-contributions. Click that repository and check the full path shown at the bottom of this pane. Once you're satisfied with the path, click "Clone the repo!". ## Create a branch Click the branch button on the toolbar. Name your branch "add-your-name", for example: "add-william-sutton" name your branch ## Make necessary changes and commit those changes Now open `Contributors.md` file in a text editor and add your name to it, then save the file. If you have the repo open in GitKraken you'll see there are changes. Review and stage those changes by selecting the newest commit marked with "// WIP" and the number of files changed and the type of change. edit some file(s) Review the files that have been changed and decide what you would like to stage. Staging is important to tell git exactly what file changes you want associated with this commit. stage your changes Once you have a good commit message ("Add to Contributors list" sounds nice and descriptive) and are happy with your changes, you can hit "Stage all changes" to stage everything that is modified or "Stage File" to stage an individual file. clone this repository If you change your mind, you can unstage those changes, or you can discard them all together. WARNING: As the word discard implies, this is a destructive operation. Do this only if you don't want any change(s) from whatever repository you're in. Hit commit. Congratulations, you've committed all the changes to your local copy of your branch of your fork of first-contributions. Onward! ## Push changes to GitHub push your changes Click the Push button on the toolbar. origin or branch Submit changes on the origin branch if you want the changes to reflect in the master branch directly, else select the appropriate branch you want to push. ## Submit your changes for review If you go to your repository on github, you'll see `Compare & pull request` button. Click on that button. create a pull request Now submit the pull request. 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 have 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). ### [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) ================================================ FILE: docs/gui-tool-tutorials/sourcetree-macos-tutorial.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions |SourceTree|Atlassian Sourcetree| |---|---| It's hard. It's always hard, when you do something for the first time. 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. ## Sourcetree Please note, this tutorial is for MacOS. It is similar to Sourcetree on Windows but some things may look different. Download [Sourcetree](https://www.sourcetreeapp.com), Install and open it. You should see the "Sourcetree" modal dialog. SourceTree Main From here, you want to click on Remote. If this is the first installation, then you likely haven't connected your GitHub account yet. Do so by clicking the "Connect Button". SourceTree Connect The *Accounts* dialog will appear. Click "Add" in the lower left hand corner. Then select the appropriate settings to add GitHub (or any other account you want) to the client. After you selected your settings for GitHub, click "Connect Account." SourceTree Connect Add This will open a page in your web browser. Follow the steps given to authorize your account. ## Fork this repository Fork this repo by clicking on the fork button on the top of this page. fork this repository This will create of copy of this repository in your account. ## Clone the repository In Sourcetree, Click on the "Remote" button. This should load all of your GitHub repos which are listed on GitHub. clone this repository Once you click the "Clone" button, you will be presented with another view to define several different things. clone this repository 1) **Source URL:** This is automatically filled and you don't need to change it. It is the URL from where your GitHub project resides. 2) **Destination Path:** This is the physical location on your computer where this project will be saved 3) **Name:** This is a "Bookmark" to how Sourcetree will reference your project. Think of it like a shortcut. *Note: Normally the defaults in these fields are fine.* **Once you are satisfied, click "Clone"** This will bring up the main repo browser for your repository! ## Create a branch Click the branch button on the toolbar. Name your branch "add-your-name-to-contribution", for example: "add-sally-to-contribution". To do this, click **Branch (1)** which launches the naming dialog. Then **Add your name (2)** as just described. Finally click **Create Branch**. This will create the branch for what you just named. name your branch ## Make necessary changes and commit those changes Now open `Contributors.md` file in a text editor and add your name to it, with your Github URL link, then save the file. You should be able to see and review the file that have been changed and decide what you would like to stage. Staging is important to tell git exactly what file changes you want associated with this commit. *Note: If you do not see the file's diff, click **Uncommitted Files** at the top of your dialog* edit some file(s) Next click the **Commit** button on the top left of the dialog. This will show you your staging area. Click the *Checkbox* to **add** the file to the staging area. Then enter a commit message. *Note: You can also select files (both in the staging and unstaged areas) and add/remove files from the respective areas by using the spacebar* stage your changes Once you have added your changes and added a commit message, you can press the **Commit** button to finally make the commit. Congratulations, you've committed all the changes to your local copy of your branch of your fork of first-contributions. Onward! ## Push changes to GitHub Now you are ready to push your changes to github. This will be pushing it to your own, forked, copy of the project. Follow the steps to push your branch up. First, click **Push (1)**, this will show the remote/push dialog. **Click (2)** the checkbox of your branch you want to push. Select **OK (3)** and this will push your commit up to Github. origin or branch ## Submit your changes for review If you go to your repository on github, you'll see `Compare & pull request` button. Click on that button. create a pull request Now submit the pull request. 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 have 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). ### [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) ================================================ FILE: docs/gui-tool-tutorials/sublime-merge-tutorial.hi.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions — हिंदी |Sublime Merge|Sublime Merge Git क्लाइंट| |---|---| पहली बार कुछ करना हमेशा थोड़ा कठिन लगता है। खासकर जब आप सहयोग (collaboration) कर रहे हों या कुछ नया आज़मा रहे हों — गलतियाँ करना सहज नहीं लगता। लेकिन ओपन सोर्स का मूल ही सहयोग और मिलकर काम करना है। हम चाहते हैं कि नए ओपन-सोर्स योगदानकर्ता पहली बार योगदान देना आसानी से सीखें और कर पाएं। लेख पढ़ना और ट्यूटोरियल देखना मदद करता है, लेकिन बिना कुछ बिगाड़े **खुद करके सीखना** सबसे अच्छा होता है। यह प्रोजेक्ट नए योगदानकर्ताओं को मार्गदर्शन देने और उनका पहला योगदान सरल बनाने के लिए बनाया गया है। याद रखें: जितना सहज महसूस करेंगे, उतना बेहतर सीखेंगे। अगर आप अपना पहला योगदान देना चाहते हैं, तो नीचे दिए गए आसान चरणों का पालन करें — यह मज़ेदार होगा! ## Sublime Merge [Sublime Merge](https://www.sublimemerge.com/) डाउनलोड करें, इंस्टॉल करें और ओपन करें। ## इस रिपॉज़िटरी को फोर्क करें इस पेज के ऊपर दिए गए **Fork** बटन पर क्लिक करके इस रिपॉज़िटरी को फोर्क करें। fork this repository यह आपकी अकाउंट में इस रिपॉज़िटरी की एक कॉपी बना देगा।



## रिपॉज़िटरी को क्लोन करें clone this repository Sublime Merge में **File -> Clone Repository** पर जाएँ। clone this repository अगला चरण है अपनी रिपॉज़िटरी को अपनी मशीन पर क्लोन करना ताकि आप बदलाव करना शुरू कर सकें। Sublime Merge को आपकी रिपॉज़िटरी का URL चाहिए, इसलिए **“clone”** बटन दबाएँ और फिर **“copy to clipboard”** आइकन पर क्लिक करें। **सावधान:** नए योगदानकर्ता अक्सर गलती से उस रिपॉज़िटरी को क्लोन कर लेते हैं जिससे आपने फोर्क किया है, बजाय अपने फोर्क को क्लोन करने के। अपने ब्राउज़र की address bar देखकर सुनिश्चित करें कि आप **अपने फोर्क** को ही क्लोन कर रहे हैं। Sublime Merge में रिपॉज़िटरी का URL दर्ज करें, चाहें तो कोई नाम दें (या खाली छोड़ दें) और वह डायरेक्टरी चुनें जहाँ आप रिपॉज़िटरी सेव करना चाहते हैं। जब पथ सही लगे, **“Clone”** पर क्लिक करें। ## एक ब्रांच बनाएँ Right click **Branches -> Create Branch** या **Repository -> Create Branch** पर जाएँ। अपनी ब्रांच का नाम `"add-your-name"` जैसा रखें, उदाहरण: `"add-william-sutton"`। name your branch ## ज़रूरी बदलाव करें और उन्हें कमिट करें अब `Contributors.md` फ़ाइल को किसी टेक्स्ट एडिटर में खोलें और अपना नाम जोड़ें, फिर फ़ाइल सेव करें। यदि रिपॉज़िटरी Sublime Merge में खुली है, तो आप बदलाव देख पाएँगे। ऊपर सबसे नए सेक्शन **"x unstaged files"** को चुनें। जिन फ़ाइलों में बदलाव हुआ है उन्हें देखें और तय करें कि क्या स्टेज करना है। कमिट संदेश दें (उदाहरण: `"Add to Contributors list"` — यह स्पष्ट और अच्छा है)। जब आप बदलावों से संतुष्ट हों, तो फ़ाइल-दर-फ़ाइल स्टेज करें या **"stage all"** चुनें। स्टेज करना ज़रूरी है ताकि Git जान सके कि इस कमिट में कौन-से बदलाव शामिल करने हैं। stage your changes यदि मन बदल जाए, तो बदलावों को **unstage** कर सकते हैं या पूरी तरह **discard** भी कर सकते हैं। **चेतावनी:** Discard का मतलब बदलावों को स्थायी रूप से हटाना है। इसे तभी करें जब आपको वे बदलाव बिल्कुल नहीं चाहिएँ। **Commit** पर क्लिक करें, अपना यूज़रनेम और ईमेल दर्ज करें और **Update** दबाएँ। फिर से **Commit** पर क्लिक करें। बधाई! आपने अपनी फोर्क की हुई रिपॉज़िटरी की अपनी ब्रांच पर स्थानीय रूप से सारे बदलाव कमिट कर दिए हैं। आगे बढ़ते हैं! ## बदलाव GitHub पर पुश करें **Repository -> Push** पर जाएँ या ऊपर दाएँ कोने में ऊपर की ओर तीर वाले छोटे आइकन पर क्लिक करें। login अपने GitHub अकाउंट में यूज़रनेम और पासवर्ड से लॉगिन करें। यदि आप चाहते हैं कि बदलाव सीधे master (या default) ब्रांच में दिखें, तो **origin** की वही ब्रांच चुनकर पुश करें; अन्यथा जिस उपयुक्त ब्रांच पर पुश करना है उसे चुनें। ## अपने बदलाव समीक्षा के लिए सबमिट करें GitHub पर अपनी रिपॉज़िटरी में जाएँ — आपको **`Compare & pull request`** बटन दिखेगा। उस पर क्लिक करें। create a pull request अब पुल रिक्वेस्ट सबमिट करें। submit pull request जल्द ही आपके बदलाव इस प्रोजेक्ट की master ब्रांच में मर्ज कर दिए जाएँगे। मर्ज होने पर आपको ईमेल नोटिफ़िकेशन मिल जाएगा। ## आगे क्या? शाबाश! आपने एक योगदानकर्ता के रूप में अक्सर मिलने वाले मानक वर्कफ़्लो — _fork -> clone -> edit -> PR_ — को पूरा कर लिया है! अपने योगदान का जश्न मनाएँ और अपने दोस्तों व फ़ॉलोअर्स के साथ शेयर करें: [web app](https://firstcontributions.github.io#social-share)। ### [अतिरिक्त सामग्री](../additional-material/git_workflow_senarios/additional-material.md) ## अन्य टूल्स के साथ ट्यूटोरियल्स [मुख्य पृष्ठ पर वापस जाएँ](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/sublime-merge-tutorial.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions |Sublime Merge|Sublime Merge Git Client| |---|---| It's hard. It's always hard, when you do something for the first time. Especially when you are collaborating or trying out something new, 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. ## Sublime Merge Download [Sublime Merge](https://www.sublimemerge.com/), Install and open it. ## Fork this repository Fork this repo by clicking on the fork button on the top of this page. fork this repository This will create of copy of this repository in your account.



## Clone the repository clone this repository In Sublime Merge, go to File -> Clone Repository. clone this repository The next step is to clone your repo down to your machine so you can begin making changes. Sublime Merge needs the URL of your repo, so click the "clone" button and then click the "copy to clipboard" icon. **CAREFUL:** One mistake that new contributors often make is to clone the repo you forked _from_ rather than cloning your repo. Check your browser's address bar and make sure you are cloning your repo. Enter the URL of the repo in Sublime Merge, give it a repository name (or leave it blank) and set your directory where to save the repository. Once you're satisfied with the path, click "Clone". ## Create a branch Right click Branches -> Create Branch or Navigate to Repository -> Create Branch Name your branch "add-your-name", for example: "add-william-sutton" name your branch ## Make necessary changes and commit those changes Now open `Contributors.md` file in a text editor and add your name to it, then save the file. If you have the repo open in Sublime Merge you'll see there are changes. Select the newest commit at the top, named "x unstaged files" Review the files that have been changed and decide what you would like to stage. Give the commit a commit message ("Add to Contributors list" sounds nice and descriptive). When you are happy with your changes stage those changes by staging them file by file or selecting "stage all". Staging is important to tell git exactly what file changes you want associated with this commit. stage your changes If you change your mind, you can unstage those changes, or you can discard them all together. WARNING: As the word discard implies, this is a destructive operation. Do this only if you don't want any change(s) from whatever repository you're in. Hit commit and enter your username and email address and press Update. Hit commit again. Congratulations, you've committed all the changes to your local copy of your branch of your fork of first-contributions. Onward! ## Push changes to GitHub Navigate to Repository -> Push or hit the small arrow in upward direction in the right hand corner. login Login to your Github Account with your username and password Submit changes on the origin branch if you want the changes to reflect in the master branch directly, else select the appropriate branch you want to push. ## Submit your changes for review If you go to your repository on github, you'll see `Compare & pull request` button. Click on that button. create a pull request Now submit the pull request. 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 have 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). ### [Additional material](../additional-material/git_workflow_senarios/additional-material.md) ## Tutorials Using Other Tools [Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Amharic/github-desktop-tutorial.am.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # የመጀመሪያ አስተዋፅኦዎች | 'ጊትሀብ ዴስክቶፕ' | GitHub Desktop Edition | | ----------------------------------------------------------------------------------------------- | ---------------------- | ከባድ ነው ። አንድ ነገር ለመጀመሪያ ጊዜ ሲያደርጉ ሁል ጊዜ ከባድ ነው። በተለይ በትብብር ላይ ሲሆኑ ስህተት መስራት ምቹ ነገር አይደለም። ግን ‘ኦፕን ሶርስ’ ስለ ትብብር እና አብሮ መስራት ነው። እኛ አዲስ የኦፕን ሶርስ አስተዋጽዖ አበርካቾች የሚማሩበትን እና ለመጀመሪያ ጊዜ የሚያበረክቱበትን መንገድ ቀለል ለማድረግ እንፈልጋለን። ጽሑፎችን ማንበብ እና አጋዥ ስልጠናዎችን መመልከት ሊረዳ ይችላል፣ ነገር ግን ምንም ነገር ሳያበላሹ ነገሮችን ከማድረግ የተሻለ ምን ይመጣል። ይህ ፕሮጀክት ጀማሪዎችን መመሪያ ለመስጠት እና የመጀመሪያ አስተዋጾዋቸውን የሚያደርጉበትን መንገድ ቀላል ለማድረግ ያለመ ነው ። የበለጠ ዘና ብላችሁ በተማራችሁ ቁጥር የተሻለ እንደሆነ አስታውሱ። የመጀመሪያውን አስተዋፅዖ ለማድረግ ከፈለጉ ከታች ያሉትን ቀላል ደረጃዎች ይከተሉ። ለእርስዎ ቃል እንገባለን, አስደሳች ይሆናል። በማሽንዎ ላይ ጊት(git) ከሌለዎት ፤ [ይጫኑት።](https://docs.github.com/en/get-started/quickstart/set-up-git) ከ1.0 በፊት የ GitHub Desktop ስሪት እየተጠቀሙ ከሆነ ፣ [ይህን አጋዥ ስልጠና ይመልከቱ።](https://github.com/firstcontributions/first-contributions/blob/main/docs/gui-tool-tutorials/github-desktop-old-version-tutorial.md) ማከማቻውን 'ፎርክ' ያድርጉ ## ይህንን ማከማቻ **fork** ያድርጉ በዚህ ገጽ ላይኛው ክፍል ላይ ያለውን የfork button ጠቅ በማድረግ ይህንን ማከማቻ fork ያድርጉት። ይህ በእርስዎ አካውንት ውስጥ የዚህን "ሪፖዚተሪ" ቅጂ ይፈጥራል። ## የማከማቻውን ተመሳሳይ (ቅጂ) ይፍጠሩ (Clone) አሁን የዚህን ማከማቻ ቅጂ በኮምፒተርዎ ላይ ይፍጠሩ። አስፈላጊ፡ የዋናውን ማከማቻ ቅጂ አይፍጠሩ። ወደ እርስዎ ማከማቻ ይሂዱ እና ቅጂውን ይፍጠሩ። ቅጂውን ለመፍጠር "Clone or Download" የሚለውን ጠቅ ያድርጉ ከዛም "Open in Desktop" የሚለውን ጠቅ ያድርጉ። የማከማቻውን ቅጂ ይፍጠሩ አዲስ pop up window ይከፈታል፤ "Open GitHubDesktop.exe" የሚለው ላይ ጠቅ ያድርጉ። በ'ጊትሀብ ዴስክቶፕ' ይክፈቱ "Open GitHubDesktop.exe" የሚለውን ጠቅ ካደረጉ በኋላ 'Clone a repository' የሚል የመረጃ ሳጥን(dialogue box) ይመጣል፤ ከዛም 'Clone' የሚለውን ጠቅ ያድርጉ። የማከማቻውን ቅጂ ይፍጠሩ ቀጥሎም 'How are you planning to use this fork?' የሚል የመረጃ ሳጥን(dialogue box) ይመጣል። 'To contribute to the parent project' የሚለውን በመምርጥ 'Continue' የሚለውን ጠቅ ያድርጉ። የማከማቻው ጥቅም አሁን "first-contributions repository" ውስጥ ያሉትን ይዘቶች ቅጂ ወደ ኮምፒተርዎ አስቀምጠቃል። ## ቅርንጫፍ ይፍጠሩ አሁን ከላይ ያለውን "Current branch" ምልክት በመንካት እና "New branch" የሚለውን ጠቅ በማድረግ አዲስ ቅርንጫፍ ይፍጠሩ። ቅርንጫፍ ይፍጠሩ ቅርንጫፉን ‹add-የእርስዎ-ስም› በማለት ይሰይሙ። ለምሳሌ፣ "add-ይሁን-አለማየሁ"። ቅርንጫፉን ይሰይሙ `Create branch` የሚለውን ጠቅ ያድርጉ። ## አስፈላጊ ለውጦችን ያድርጉ እና ለውጦችን ይፈፅሙ (commit) አሁን ወደ `History` ታብ በመሄድ `Contributors.md` የሚለውን ፋይል 'ራይት ክሊክ' በማድረግ ባሎት ፅሑፍ አርታኢ(text editor) ይክፍቱት። ወደ ገፁ መጨረሻ በመሄድ ስምዎን ይጨምሩና ፋይሉን 'ሴቭ' ያድርጉት። ምሳሌ፡ ስምዎት ይሁን-አለማየሁ ከሆነ፣ ይህን መምሰል አለበት። \[ይሁን-አለማየሁ]( https://github.com/ ይሁን-አለማየሁ) `Contributors.md` ፋይል ላይ ለውጦች እንዳሉ እና ወደ "GitHub Desktop" እንደተጨመሩ ማየት ይችላሉ። ሁኔታውን ይከታትሉ አሁን እነዚህን ለውጦች ይፈፅሙ(commit)። "_summary_ field" በሚለው ክፍት ቦታ ላይ "Add `<የእርስዎ-ስም>` to Contributors list" ብለው ይፃፉ። `<የእርስዎ-ስም>` የሚለውን በትክክለኛ ስምዎ ይተኩት። `Commit to add-your-name` የሚለውን "በተን" ጠቅ ያድርጉት። ለውጦችን ይፈፅሙ ከታች ለውጡ እንደተፈፀመ ማየት ይችላሉ። ለውጦችን ይፈፅሙ ## ለውጦችን ወደ GitHub ይግፉ File->Options ከዛም sign-in to Github.com የሚሉትን ጠቅ ያድርጉ እና የ"GitHub" አካውንትዎን ስምና የይለፍ ቃል በማስገባት "sign-in" ያድርጉ። ወደ 'ጊትሀብ' አካውንትዎ ይግቡ በላይኛው ቀኝ ጠርዝ አካባቢ `Publish` የሚለውን "በተን" ጠቅ ያድርጉት። ለውጦችን ወደ GitHub ይግፉ ## ለውጦችዎን ለግምገማ ያስገቡ (Pull request) በ GitHub ላይ ወደ ማከማቻዎ ከሄዱ፣ ‘compare & pull request' የሚለውን ቁልፍ ያያሉ። በዚያ ቁልፍ ላይ ጠቅ ያድርጉ። የለውጦቹን ግምገማ(pull request) ይፍጠሩ አሁን pull request ያስገቡ። ለውጦችዎን ለግምገማ ያስገቡ በቅርቡ ሁሉንም ለውጦችዎን ወደዚህ ፕሮጀክት ዋና ቅርንጫፍ አዋህዳቸዋለሁ። ለውጦቹ ከተዋሃዱ በኋላ የማሳወቂያ 'ኢይሜል' ይደርስዎታል። ## ከዚህስ ወዴት ልሂድ? እንኳን ደስ ያሎዎት! ልክ እንደ አስተዋጽዖ አበርካች የሚያጋጥሙትን መደበኛ _fork -> clone -> edit -> pull request_ የስራ ፍሰትን አጠናቀዋል! አስተዋጾዎን ያጣጣጥሙ እና ወደ [ድህረ-ግፅ](https://firstcontributions.github.io/#social-share) በመሄድ ለጓደኞችዎ እና ተከታዮችዎ ያካፍሉ። ## [ተጨማሪ ቁሳቁስ](docs/additional-material/git_workflow_scenarios/additional-material.md) ## የሌሎች መሳሪያዎች አጠቃቀም አጋዥ ስልጠናዎች [ወደ ዋናው ገፅ ይመለሱ።](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Bengali/github-windows-vscode-tutorial-bn.md ================================================ প্রথম অবদান (First Contributions) Visual Studio Code Visual Studio Code প্রথমবার কিছু করা সবসময়ই কঠিন। বিশেষ করে যখন আপনি টিমে কাজ করছেন, তখন ভুল করার ভয় থেকেই যায়। কিন্তু ওপেন সোর্স সহযোগিতা আর একসাথে কাজ করার মাধ্যম। আমরা চাই নতুন অবদানকারীদের জন্য প্রথমবার শেখা ও অবদান রাখার প্রক্রিয়াকে সহজ করে তুলতে। আর্টিকেল পড়া বা টিউটোরিয়াল দেখা সাহায্য করতে পারে, কিন্তু বাস্তবে নিজের হাতে চেষ্টা করার মতো অভিজ্ঞতা আর কিছুতেই নেই। এই প্রোজেক্টের উদ্দেশ্য হলো একটি স্পষ্ট গাইড তৈরি করা এবং নতুনদের জন্য প্রথম অবদান রাখার পদ্ধতিকে সহজ করা। মনে রাখবেন: যত শান্ত থাকবেন, শেখাও তত সহজ হবে। 👉 যদি আপনার মেশিনে Visual Studio Code না থাকে, তবে এখান থেকে ইন্সটল করুন । তথ্য: এই টিউটোরিয়ালটি Windows 10 মেশিনে VS Code (ভার্সন 1.27.2) ব্যবহার করে তৈরি করা হয়েছে। এখানে কিছু কিবোর্ড শর্টকাট ব্যবহার করা হয়েছে, যেগুলো অন্য অপারেটিং সিস্টেম (macOS/Linux) বা কিবোর্ড লেআউট অনুযায়ী আলাদা হতে পারে। আপনি চাইলে VS Code-এর Command Palette-এ "shortcut" লিখে আপনার শর্টকাটগুলোর তালিকা দেখতে পারবেন। এই রিপোজিটরিকে Fork করুন fork this repository এই পেজের উপরের ডান দিকে Fork বাটনে ক্লিক করুন। এটি আপনার GitHub অ্যাকাউন্টে এই রিপোজিটরির একটি কপি তৈরি করবে। GitHub আপনার রিপোজিটরি এবং মূল রিপোজিটরির মধ্যে সম্পর্ক ট্র্যাক করে রাখে। আপনার রিপোজিটরি Clone করুন clone this repository এখন রিপোজিটরিটি আপনার মেশিনে ক্লোন করতে হবে। ⚠️ সতর্কতা: অনেক নতুন অবদানকারী ভুল করে মূল রিপোজিটরি ক্লোন করে বসেন। সবসময় নিশ্চিত করুন যে আপনি নিজের ফর্কড রিপোজিটরি ক্লোন করছেন। VS Code ওপেন করুন → F1 চাপুন → কমান্ড প্যালেটে Git: Clone লিখুন → Enter চাপুন। Paste Repository URL in রিপোজিটরির URL পেস্ট করুন → Enter চাপুন → ফোল্ডার লোকেশন সিলেক্ট করুন। একটি Branch তৈরি করুন আবার F1 চাপুন → branch লিখুন → Create Branch সিলেক্ট করুন। নতুন ব্রাঞ্চের নাম দিন যেমন: add-david-krol Enter চাপুন। নতুন ব্রাঞ্চ তৈরি হবে এবং আপনি সেখানেই কাজ শুরু করতে পারবেন। Branches Command Palette প্রয়োজনীয় পরিবর্তন করুন Contributors.md ফাইল ওপেন করুন এবং নিজের নাম যোগ করুন। 👉 অন্য কোনো কন্ট্রিবিউটরের নাম কপি করে তার জায়গায় নিজের নাম বসিয়ে নিতে পারেন, এতে Markdown সিনট্যাক্স সঠিক থাকবে। Add your name GitHub এ পরিবর্তনগুলো Push করুন ১. VS Code-এর বাম পাশ থেকে Source Control (Ctrl+Shift+G) আইকন সিলেক্ট করুন। ২. পরিবর্তিত ফাইলগুলো স্টেজ করুন (+ এ ক্লিক করে)। ৩. কমিট মেসেজ লিখুন এবং ✅ চিহ্নে ক্লিক করুন। ৪. তারপর তিন ডট (...) মেনু থেকে Publish Branch নির্বাচন করুন। push changes Pull Request (PR) সাবমিট করুন এখন GitHub এ গিয়ে নতুন ব্রাঞ্চের পাশে থাকা Compare & pull request বাটনে ক্লিক করুন। একটি Pull Request তৈরি করুন এরপর PR সাবমিট করুন। Pull Request সাবমিট করুন শীঘ্রই আপনার পরিবর্তনগুলো মূল প্রোজেক্টে merge হবে এবং আপনাকে ইমেইলে নোটিফিকেশন দেওয়া হবে। এরপর কী? অভিনন্দন 🎉 আপনি এখনই পুরো প্রক্রিয়াটি শেষ করেছেন: fork → clone → edit → PR 👉 আপনার অবদান উদযাপন করুন এবং ওয়েব অ্যাপ থেকে বন্ধুদের সাথে শেয়ার করুন। 👉 কোনো প্রশ্ন থাকলে আমাদের Slack টিমে যোগ দিন: Slack টিমে যোগ দিন । অতিরিক্ত উপকরণ অন্যান্য টুল ব্যবহার করে টিউটোরিয়াল মূল পাতায় ফিরে যান ================================================ FILE: docs/gui-tool-tutorials/translations/Chinese/github-desktop-tutorial.zh-cn.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # 第一次贡献 | GitHub Desktop | GitHub Desktop Edition | | ----------------------------------------------------------------------------------------------- | ---------------------- | 万事开头难。特别是当你正与其他人合作的时侯，出错不是一件舒服的事情。不过，开源的本质就是和他人合作。我们想要简化开源初学者第一次学习和贡献的方法。 你可以通过阅读文章和观看教程来得到帮助，但是没有比实际去做而不搞砸更好的方法了。本项目旨在简化并指导初学者参与他们的第一次开源。记住：过程越轻松，学习效益越高。如果你想要做出第一次贡献，只需按照以下简单步骤操作即可。相信我们，这将会是一个有趣的过程 :) 如果你没有GithubDesktop在你的电脑上, [点我安装](https://desktop.github.com/). 如果你使用的是1.0之前的GitHub Desktop版本, [请参阅本教程](github-desktop-old-version-tutorial.md). fork this repository ## Fork（复制）本代码仓库 点击页面顶部的 “Fork” 按钮来分叉（Fork）这个仓库。这将在你的账户中创建这个存储库的副本。 ## Clone（克隆）代码仓库 现在将这个储存库复制到你的电脑。 重要！：不要复制源储存库。请到自己的仓库并复制 要克隆仓库，请单击“Clone or Download”，然后单击“Open in Desktop”。 clone this repository 一个弹出窗口将会打开。点击“打开GitHubDesktop.exe”。 clone this repository 点击“打开GitHubDesktop.exe”后，内容将下载到您的计算机上。 clone this repository 现在，您已经将github中first-contributions存储库的内容复制到了您的计算机上。 ## 创建分支 现在，点击顶部的“Current branch”图标，然后点击“New branch”，即可创建分支： make a branch 命名你的分支<添加你的名字>。例如，“add-james-smith” name your branch 点击 `Create branch` ## 进行必要的更改并提交这些更改 现在，转到历史记录选项卡，右键单击并在文本编辑器中打开文本编辑器中的“Contributors.md”文件。滚动到页面底部并添加您的姓名，然后保存文件。 例子: 如果你的名字是 James Smith, 它因该看起来像这样. \[James Smith](https://github.com/jamessmith) 您可以看到对Contributors.md进行了更改，并且已将其添加到GithubDesktop。 check status 现在提交这些更改： 在_summary_字段中写下消息“Add `<你的名字>`to Contributors list”。 将“<你的名字>”替换为你的名字。 点击按钮，上面写着 `Commit to add-your-name`. commit your changes 在底部，您可以看到提交已创建。 commit your changes ## 将更改推送到github 点击文件->选项，登录Github.com。输入您的Github用户名和密码. log-in to Github 点击右上角的“Publish”按钮。 push your changes ## 提交您的更改以供审核 如果你去github上的仓库，你会看到“Compare & pull request”按钮。点击那个按钮。 create a pull request 现在提交拉取请求. submit pull request 很快，我将把您的所有更改合并到这个项目的主分支中。合并更改后，您将收到一封通知电子邮件。 ## 下一步我该去哪里？ 恭喜！您刚刚完成了作为贡献者经常遇到的标准_fork->clone->edit->PR_工作流程！ 庆祝你的贡献，并通过以下方式与你的朋友和追随者分享[web app](https://firstcontributions.github.io#social-share). 如果您需要帮助或有任何问题，可以加入我们的slack team. [加入 slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [附加材料](../additional-material/git_workflow_scenarios/additional-material.md) ## 使用其他工具的教程 [返回主页](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Chinese/gitkraken-tutorial-zh-cn.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # 第一次参与开源项目 | GitKraken | GitKraken 版 | | ------------------------------------------------------------------------------------------------------------------------------------- | ----------- | 万事开头难。特别是当你正与其他人合作的时侯，出错不是一件舒服的事情。不过，开源的本质就是和他人合作。我们想要简化开源初学者第一次学习和贡献的方法。 你可以通过阅读文章和观看教程来得到帮助，但是没有比实际去做而不搞砸更好的方法了。本项目旨在简化并指导初学者参与他们的第一次开源。记住：过程越轻松，学习效益越高。如果你想要做出第一次贡献，只需按照以下简单步骤操作即可。相信我们，这将会是一个有趣的过程 :) ## Git Kraken 下载[GitKraken](https://www.gitkraken.com)，安装并打开它。 你应该会看到 "Welcome to GitKraken" 的对话框。 使用你的GitHub账号登陆并允许GitKraken 访问你的 GitHub 账户。 login to GitHub (可选)点击文件“File” ，选择首选项“Preferences”，将你的项目目录设置为本地存储库的根目录。 ## Fork（复制）本代码仓库 点击页面顶部的 “Fork” 按钮来分叉（Fork）这个仓库。fork this repository 这将在你的账户中创建这个存储库的副本。 ## Clone（克隆）代码仓库 在GitKraken中，点击文件“File” ，选择克隆储存库。 clone this repository 在右侧窗格中选择 ”GitHub.com“。在你的用户名下，你应该看到 “first-contributions”。点击该存储库并查看窗格底部显示的完整路径。 当你确定你想要保存在本地的路径后，点击 “Clone the repo!”。 ## 新建一个代码分支 点击工具栏上的 "分支"（Branch）按钮。 给你的分支命名为 "add-your-name"，例如："add-william-sutton"。 name your branch ## 进行必要的更改并提交这些更改 现在在文本编辑器中打开`Contributors.md`文件并添加您的名字，然后保存文件。 如果你在 GitKraken 中打开了存储库，你会看到有更改。请通过选择最新的提交（标有“// WIP”以及更改的文件数和更改的类型）来审查和暂存这些更改。 edit some file(s) 审查已更改的文件，并决定哪些文件你想要暂存。暂存很重要，它告诉 Git 哪些文件更改与这次提交相关。 stage your changes 一旦你有了一个不错的提交消息（比如“将 <你的名字> 添加到贡献者列表”，这听起来不错而且描述清楚），并且对你的更改感到满意，你可以点击“暂存所有更改”来暂存所有已修改的内容，或者点击“暂存文件”来暂存单个文件。 clone this repository 如果你改变主意，你可以取消这些更改，或者将它们全部丢弃。 警告：由于"discard"（丢弃）这个词的含义，这是一种破坏性的操作。只有当你不希望保留你所在的仓库中的任何更改时才执行此操作。 点击 commit（提交） 恭喜！你已将所有更改提交到首次贡献分支的本地副本。继续前进吧！ ## 将改动 Push（推送）到 GitHub push your changes 点击工具栏上的 "Push" 按钮。 origin or branch 如果你想要更改直接反映在主分支中，就提交更改到源分支。否则，选择你想要推送的适当分支。 ## 提交你的更改供他人审阅 如果你在 GitHub 上进入你的存储库，你会看到`Compare & pull request`按钮。点击这个按钮。 create a pull request 现在提交拉取请求。 submit pull request 很快我将把你的所有更改合并到这个项目的主分支中。一旦更改已经合并，你将收到通知邮件。 ## 接下来该做什么呢？ 恭喜！你刚刚完成了作为贡献者经常遇到的标准“分叉 -> 克隆 -> 编辑 -> 提交请求（PR）”的工作流程！ 庆祝你的贡献，并通过前往[web app](https://firstcontributions.github.io/#social-share)分享给你的朋友和关注者。 如果有任何疑问或想获得更多协助，欢迎加入我们的 [Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)！ ### [更多资料](../additional-material/git_workflow_scenarios/additional-material.md) ## 使用其他工具的教程 [返回主页](https://github.com/firstcontributions/first-contributions/blob/main/translations/README.zh-cn.md) ================================================ FILE: docs/gui-tool-tutorials/translations/German/github-windows-vs-code-tutorial.de.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Erste Beiträge | Visual Studio Code | Visual Studio Code | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | Es ist schwer. Es ist immer schwer, wenn man etwas zum ersten Mal macht. Vor allem, wenn man mit anderen zusammenarbeitet, ist es nicht angenehm, Fehler zu machen. Aber bei Open Source geht es gerade um Zusammenarbeit und gemeinsames Arbeiten. Wir wollten neuen Open-Source-Mitwirkenden den Einstieg erleichtern, damit sie lernen und zum ersten Mal einen Beitrag leisten können. Das Lesen von Artikeln und das Anschauen von Tutorials kann hilfreich sein, aber nichts ist besser, als die Dinge einfach auszuprobieren, ohne etwas zu vermasseln. Dieses Projekt zielt darauf ab, Anfängern eine Anleitung zu bieten und ihnen den Weg zu ihrem ersten Beitrag zu erleichtern. Denke daran: Je entspannter Du bist, desto besser lernst Du. Wenn Du Deinen ersten Beitrag leisten möchtest, folge einfach den folgenden einfachen Schritten. Wir versprechen Dir, es wird Spaß machen. Wenn du Visual Studio Code nicht auf deinem Computer installiert hast, [installiere es jetzt.](https://code.visualstudio.com/download). **Anmerkung:** Dieses Tutorial wurde mit Visual Studio Code (Version 1.27.2) auf einem Windows 10-Rechner erstellt. Später in diesem Tutorial werden wir einige Tastaturkürzel verwenden. Diese können sich je nach Betriebssystem (macOS/Linux) und Tastatursprache (UK, DE usw.) unterscheiden. Du kannst Deine Liste der Tastaturkürzel durchsuchen, indem Du in der Befehlspalette nach „shortcut” suchst. ## Dieses Repository forken fork this repository Forke dieses Repository, indem Du oben rechts auf dieser Seite auf die Schaltfläche „Fork“ klickst. Dadurch wird eine Kopie dieses Repositorys in Ihrem GitHub-Konto erstellt. GitHub verfolgt die Beziehung zwischen Ihrem Repository und dem Repository, von dem Sie es geforkt haben. Sie können sich Ihr Repository als Arbeitskopie vorstellen. Die meisten Top-Level-Repositorys auf GitHub (d. h. solche, die nicht von einem anderen Repository geforkt wurden) haben ein kleines Kernteam von Personen, welche Änderungen direkt committen können. Alle anderen Mitwirkenden müssen das Repo forken und Änderungen im Fork vornehmen, dann einen Pull Request erstellen, um zu beantragen, dass ihre Änderungen wieder in das Top-Level-Repo übernommen werden. Wenn dem Administrator des Top-Level-Repos die Änderungen gefallen, werden sie übernommen und Du wirst sofort berühmt und reich! Mehr dazu später. ## Das Repository klonen clone this repository Der nächste Schritt besteht darin, Dein Repository auf Deinen Computer zu klonen, damit Du Änderungen vornehmen kannst. VS Code benötigt die URL Deines Repositories, also klicke auf die Schaltfläche „Code“ und dann auf das Symbol „In die Zwischenablage kopieren“. **ACHTUNG:** Ein Fehler, den neue Mitwirkende oft machen, ist, dass sie das Repository, von dem sie geforkt haben klonen an Stelle ihres eigenen. Überprüfe die Adressleiste Deines Browsers und stelle sicher, dass Du Dein Repository klonst. Öffne nun Visual Studio Code. Die Willkommensseite von VS Code wird angezeigt. Drücke `F1`, um die Leiste zu öffnen, die unten gezeigt wird. Beachte, dass bereits ein `>` (größer als) Zeichen im Textfeld steht. Du kannst auch über `CTRL-P` zum Eingabeaufforderung gelangen und das `>`-Zeichen eingeben. Clone Popup (Command Popup) Vielleicht bemerkst Du, dass bereits einige obskure Befehle aufgelistet sind. Das sind meine zuletzt verwendeten Befehle. Also kümmere Dich nicht darum. Clone repo Nun tippe `git clone`, nur `git` oder `clone` (es funktioniert wie eine Suche). Wähle den Eintrag `Git: Clone` aus und drücke `Enter`. Paste Repository URL in Füge die URL Deines Repositories ein und drücke `Enter`. Dadurch wird der Datei-Explorer geöffnet, in dem Du auswählen kannst, wo das Git-Repository gespeichert werden soll. **Wichtig**: Achte darauf, dass es sich um das geforkte Repository handelt und nicht um das Original, da es sonst nicht funktioniert. Status popup Du solltest eine Statusmeldung in der unteren rechten Ecke von Visual Studio Code sehen. Nachdem der Vorgang abgeschlossen ist, kannst Du das geklonte Repository (jetzt ein Ordner auf Deinem Computer) mit den Schaltflächen im Dialogfeld öffnen. ## Erstelle einen Branch Öffne die Befehls-Palette erneut, indem Du `F1` drückst. Tippe `branch` ein und wähle den Befehl `create branch` aus. Im nächsten Schritt gib den Namen Deines neuen Branches ein, zum Beispiel `add-david-kroell`. Drücke `Enter`, um den Branch zu erstellen. Der Branch ist auch bereits ausgecheckt. [Was bedeutet checkout?](https://www.git-scm.com/docs/git-checkout) Branches Command Palette ## Nötige Änderungen vornehmen Öffne `Contributors.md` in einem Texteditor und füge Deinen Namen hinzu. Achte darauf, dass Du den Namen nicht am Anfang oder am Ende der Datei hinzufügst. Speichere die Datei anschließend. Diese Datei enthält GFM (GitHub Flavored Markdown), eine proprietäre Variante der Markdown-Syntax. Kopiere eine der anderen Mitwirkenden-Zeilen und passe sie mit Deinem Namen an, um sicherzustellen, dass die Syntax korrekt ist - sie kann schwierig sein. Speichere die Datei, um die Änderung zu registrieren. Add your name ## Änderungen committen und zu GitHub pushen Auf der linken Seite von VS Code befindet sich ein Menü mit 5 Symbolen. Wähle das Versionskontroll-/Quellcodeverwaltungssymbol aus. (Shortcut: `Ctrl + Shift + G`) Commit changes Der Datei-Explorer zeigt alle Dateien an, die seit dem letzten Commit geändert wurden. Wenn Du mit der Maus über die Dateien fährst und auf das `+` (Plus) klickst, werden die Dateien zum Staging hinzugefügt. Stashed Files Tippe etwas in die Zeile oben im Explorer und drücke das Häkchen. Die Änderungen sind jetzt in Deiner lokalen Kopie committed. Jetzt müssen die Änderungen zurück zu GitHub gepusht werden. Stashed Files Klicke auf das Drei-Punkte-Symbol, um das Menü zu öffnen, in dem Du die Option `Publish Branch` auswählst. Dadurch sollte ein Dialogfeld geöffnet werden, in dem Du Deine GitHub-Anmeldeinformationen eingeben kannst. Stashed Files ## Änderungen zur Überprüfung absenden An diesem Punkt hast Du Deine Änderung abgeschlossen, aber sie befindet sich noch nur in Deinem Repository. Dieser Schritt zeigt Dir, wie Du eine Anfrage an den Administrator des Top-Level-Repos stellen kannst, um Deine Änderung zusammenzuführen. In Deinem Repository auf GitHub siehst Du neben der Benachrichtigung über den neuen Branch die Schaltfläche `Compare & pull request`. Klicke auf diese Schaltfläche. create a pull request Sende jetzt den Pull Request ab. submit pull request Ich werde nun Deine Änderungen in den Master-Branch dieses Projekts mergen. Du erhältst eine E-Mail, sobald dies geschehen ist. ## Und jetzt? Herzlichen Glückwunsch! Du hast gerade den Standard-Workflow _fork -> clone -> edit -> PR_ abgeschlossen, den Du als Contributor häufig antreffen wirst! Feiere Deinen Beitrag zum Projekt und teile ihn mit Deinen Freunden und Followern über unsere [Web-App](https://firstcontributions.github.io#social-share). Du kannst dem Slack-Team beitreten, falls Du Hilfe benötigst oder Fragen hast. [Slack-Team beitreten](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [Weiterführende Materialien](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutorials mit anderen Tools [Zurück zur Hauptseite](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Greek/github-desktop-old-version-tutorial.gr.md ================================================ [![Αγάπη για το Ανοικτό Κώδικα](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![Άδεια: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Βοηθοί Ανοικτού Κώδικα](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Πρώτες Συνεισφορές |GitHub Desktop|Έκδοση GitHub Desktop| |---|---| Είναι δύσκολο. Είναι πάντα δύσκολο την πρώτη φορά που κάνετε κάτι. Ειδικά όταν συνεργάζεστε, το να κάνετε λάθη δεν είναι κάτι άνετο. Ωστόσο, ο ανοικτός κώδικας αφορά τη συνεργασία και την εργασία μαζί. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο νέοι συνεισφέροντες στον ανοικτό κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά. Η ανάγνωση άρθρων και η παρακολούθηση μαθημάτων μπορεί να βοηθήσει, αλλά τι μπορεί να είναι καλύτερο από το να κάνετε πράγματι τα πράγματα χωρίς να κάνετε κάποιο λάθος. Αυτό το έργο στοχεύει στην παροχή καθοδήγησης και απλοποίησης του τρόπου με τον οποίο οι νέοι χρήστες κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε, όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Εάν θέλετε να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε απλά τα απλά βήματα παρακάτω. Σας υποσχόμαστε ότι θα είναι διασκεδαστικό. fork this repository Εάν δεν έχετε το GitHub Desktop στη μηχανή σας, [εγκαταστήστε το](https://desktop.github.com/). ## Κλωνοποίηση αυτού του αποθετηρίου Κλωνοποιήστε αυτό το αποθετήριο κάνοντας κλικ στο κουμπί κλωνοποίησης στην κορυφή αυτής της σελίδας. Αυτό θα δημιουργήσει ένα αντίγραφο αυτού του αποθετηρίου στον λογαριασμό σας. ## Κλωνοποίηση του αποθετηρίου Τώρα κλωνοποιήστε αυτό το αποθετήριο στη μηχανή σας. Ανοίξτε την εφαρμογή GitHub Desktop και κάντε κλικ στο `+` στην επάνω αριστερή γωνία. Αν δεν είναι ήδη επιλεγμένο, κάντε κλικ στο `Κλωνοποίηση`. Στη συνέχεια, επιλέξτε το first-contributions και κάντε κλικ στο `Κλωνοποίηση first-contributions`. Επιλέξτε τον κατάλογο στη μηχανή σας όπου θέλετε να κλωνοποιήσετε το first-contributions. Τώρα έχετε αντιγράψει το περιεχόμενο του αποθετηρίου first-contributions από το GitHub στον υπολογιστή σας. ## Δημιουργία κλαδιού Δημιουργήστε τώρα ένα κλαδί κάνοντας κλικ στο εικονίδιο κλαδιού στην επάνω αριστερή γωνία: Ονομάστε το κλαδί σας add-your-name. Για παράδειγμα, add-crawleya Κάντε κλικ στο `Δημιουργία νέου κλαδιού` ## Κάντε τις απαραίτητες αλλαγές και κάντε δεσμεύσεις Ανοίξτε τώρα το αρχείο `Contributors.md` σε έναν επεξεργαστή κειμένου και προσθέστε το όνομά σας, στη συνέχεια αποθηκεύστε το αρχείο. Μπορείτε να δείτε ότι υπάρχουν αλλαγές στο Contributors.md και έχουν προστεθεί. Τώρα, κάντε δεσμεύσεις για αυτές τις αλλαγές: Γράψτε το μήνυμα "Προσθήκη `<του-όνομά-σας>` στη λίστα συντελεστών" στο πεδίο *σύνοψη* Αντικαταστήστε το `<του-όνομά-σας>` με το όνομά σας Κάντε κλικ στο κουμπί που λέει `Δεσμεύσεις για προσθήκη του-όνομά-σας` Στο κάτω μέρος, μπορείτε να δείτε ότι έχει δημιουργηθεί η δέσμευση. ## Στείλτε τις αλλαγές σας για αναθεώρηση Εάν πηγαίνετε στο αποθετήριό σας στο GitHub, θα δείτε το κουμπί `Σύγκριση & αίτηση τραβήγματος`. κάντε κλικ σε αυτό το κουμπί. Τώρα υποβάλετε το αίτημα τραβήγματος. Σύντομα θα συγχωνεύσω όλες τις αλλαγές σας στο κύριο κλαδί αυτού του έργου. Θα λάβετε ένα email ειδοποίησης όταν οι αλλαγές έχουν συγχωνευτεί. ## Πού να πάτε από εδώ; Συγχαρητήρια! Μόλις ολοκληρώσατε την τυπική διαδικασία _fork -> clone -> edit -> PR_ που συναντάτε συχνά ως συνεισφέρων! Γιορτάστε τη συνεισφορά σας και μοιραστείτε τη με τους φίλους σας και τους ακόλουθούς σας πηγαίνοντας στην [ιστοσελίδα εφαρμογής](https://firstcontributions.github.io#social-share). ### [Πρόσθετο υλικό](../additional-material/git_workflow_senarios/additional-material.md) ## Οδηγίες Χρήσης Άλλων Εργαλείων [Επιστροφή στην κύρια σελίδα](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Greek/github-desktop-tutorial.gr.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Πρώτες Συνεισφορές | GitHub Desktop | Έκδοση GitHub Desktop | | ----------------------------------------------------------------------------------------------- | ---------------------- | Είναι δύσκολο. Είναι πάντα δύσκολο όταν κάνετε κάτι για πρώτη φορά. Ειδικά όταν συνεργάζεστε, τα λάθη δεν είναι άνετα. Αλλά η ανοικτή πηγή αφορά τη συνεργασία και την εργασία από κοινού. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο νέοι συνεισφέροντες στην ανοικτή πηγή μαθαίνουν και συνεισφέρουν για πρώτη φορά. Η ανάγνωση άρθρων και η παρακολούθηση εκπαιδευτικών βίντεο μπορούν να βοηθήσουν, αλλά τίποτα δεν είναι καλύτερο από το να κάνετε τα πράγματα χωρίς να κάνετε κάποιο λάθος. Αυτό το έργο στοχεύει στην παροχή καθοδήγησης και στην απλοποίηση του τρόπου με τον οποίο οι αρχάριοι συνεισφέροντες κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε ότι όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Αν θέλετε να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε απλώς τα απλά βήματα παρακάτω. Σας υποσχόμαστε ότι θα είναι διασκεδαστικό. Εάν δεν έχετε το GitHub Desktop στον υπολογιστή σας, [εγκαταστήστε το](https://desktop.github.com/). Εάν χρησιμοποιείτε μια έκδοση του GitHub Desktop πριν το 1.0, [ανατρέξτε σε αυτό το εγχειρίδιο](github-desktop-old-version-tutorial.md). fork this repository ## Κλωνοποίηση αυτού του αποθετηρίου Κλωνοποιήστε αυτό το αποθετήριο και εγκαταστήστε το στον υπολογιστή σας. ΣΗΜΑΝΤΙΚΟ: ΜΗΝ ΚΛΩΝΟΠΟΙΕΙΤΕ ΤΟ ΑΡΧΙΚΟ ΑΠΟΘΕΤΗΡΙΟ. Πηγαίνετε στο δικό σας δικλωνισμό και κλωνοποιήστε το. Για να κλωνοποιήσετε το αποθετήριο, κάντε κλικ στο "Κλωνοποίηση ή Λήψη" και στη συνέχεια κάντε κλικ στο "Άνοιγμα στο Desktop". clone this repository Θα ανοίξει ένα αναδυόμενο παράθυρο. Κάντε κλικ στο "Άνοιγμα GitHubDesktop.exe". clone this repository Αφού κάνετε κλικ στο "Άνοιγμα GitHubDesktop.exe", τα περιεχόμενα θα ληφθούν στον υπολογιστή σας. clone this repository Τώρα έχετε αντιγράψει τα περιεχόμενα του αποθετηρίου first-contributions στο GitHub στον υπολογιστή σας. ## Δημιουργία κλαδιού Τώρα δημιουργήστε ένα κλαδί κάνοντας κλικ στο εικονίδιο "Τρέχον κλαδί" στο πάνω μέρος και στη συνέχεια κάντε κλικ στο "Νέο κλαδί": make a branch Ονομάστε το κλαδί σας <προσθέστε-το-όνομά-σας>. Για παράδειγμα, "προσθήκη-james-smith" name your branch Κάντε κλικ στο `Δημιουργία κλαδιού` ## Κάντε τις απαραίτητες αλλαγές και καταγράψτε αυτές τις αλλαγές Τώρα, πηγαίνετε στην καρτέλα Ιστορικό και ανοίξτε το αρχείο `Contributors.md` σε έναν επεξεργαστή κειμένου κάνοντας δεξί κλικ και επιλέγοντας "Ανοίγμα στον επεξεργαστή κειμένου". Κύλισε προς το τέλος της σελίδας και προσθέστε το όνομά σας, και στη συνέχεια αποθηκεύστε το αρχείο. Παράδειγμα: Εάν το όνομά σας είναι Τάκης Παπαδόπουλος, θα πρέπει να φαίνεται ως εξής. \[Τάκης Παπαδόπουλος](https://github.com/takis) Βλέπετε ότι υπάρχουν αλλαγές στο Contributors.md και έχουν προστεθεί στο GitHub Desktop. check status Τώρα καταγράψτε αυτές τις αλλαγές: Γράψτε το μήνυμα "Προσθήκη `<το-όνομά-σας>` στη λίστα των συντελεστών" στο πεδίο _περίληψη_. Αντικαταστήστε `<το-όνομά-σας>` με το όνομά σας. Κάντε κλικ στο κουμπί που λέει `Καταγραφή για προσθήκη-του-όνομά-σας`. commit your changes Στο κάτω μέρος, μπορείτε να δείτε ότι έχει δημιουργηθεί η καταγραφή. commit your changes ## Μεταφορά των αλλαγών στο GitHub Κάντε κλικ στο Αρχείο->Επιλογές και συνδεθείτε στο Github.com. Πληκτρολογήστε το όνομα χρήστη και τον κωδικό πρόσβασής σας στο Github. log-in to Github Κάντε κλικ στο κουμπί `Δημοσίευση` στην πάνω δεξιά γωνία. push your changes ## Υποβολή των αλλαγών σας για αξιολόγηση Εάν μεταβείτε στο αποθετήριό σας στο GitHub, θα δείτε το κουμπί `Σύγκριση & αίτηση εξαγωγής` (Compare & pull request). Κάντε κλικ σε αυτό το κουμπί. create a pull request Τώρα υποβάλετε το αίτημα εξαγωγής (pull request). submit pull request Σύντομα θα ενσωματώσω όλες τις αλλαγές σας στο κύριο κλαδί αυτού του έργου. Θα λάβετε ένα email ειδοποίησης όταν οι αλλαγές ενσωματωθούν. ## Πού να πάτε από εδώ; Συγχαρητήρια! Μόλις ολοκληρώσατε την κανονική ροή _κλωνοποίηση -> κλωνοποίηση -> επεξεργασία -> αίτηση εξαγωγής_ που θα συναντήσετε συχνά ως συνεισφέροντας! Γιορτάστε τη συνεισφορά σας και μοιραστείτε τη με τους φίλους σας και τους ακόλουθούς σας μεταβαίνοντας στη [ιστοσελίδα εφαρμογής](https://firstcontributions.github.io#social-share). ### [Πρόσθετο υλικό](../additional-material/git_workflow_scenarios/additional-material.md) ## Οδηγοί Χρήσης Άλλων Εργαλείων [Επιστροφή στην κύρια σελίδα](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Greek/github-windows-intellij-tutorial.gr.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Πρώτες Συνεισφορές | IntelliJ IDEA | IntelliJ IDEA | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | Είναι δύσκολο. Είναι πάντα δύσκολο την πρώτη φορά που κάνετε κάτι. Ειδικά όταν συνεργάζεστε, οι λάθος δεν είναι κάτι άνετο. Αλλά το ανοιχτό κώδικα είναι όλο για συνεργασία και συνεργασία. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο νέοι συνεισφέροντες στον ανοιχτό κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά. Το να διαβάζετε άρθρα και να παρακολουθείτε οδηγίες μπορεί να βοηθήσει, αλλά τι είναι καλύτερο από το να κάνετε πράγματα χωρίς να κάνετε κανένα λάθος. Αυτό το έργο στοχεύει στην παροχή καθοδήγησης και απλοποίησης του τρόπου που οι νεοσύστατοι συνεισφέροντες κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε, όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Εάν θέλετε να κάνετε την πρώτη σας συνεισφορά, απλά ακολουθήστε τα απλά βήματα παρακάτω. Σας υποσχόμαστε ότι θα είναι διασκεδαστικό. Εάν δεν έχετε το IntelliJ IDEA στον υπολογιστή σας, [εγκαταστήστε το](https://www.jetbrains.com/idea/download/#section=windows). **Σημείωση:** Αυτός ο οδηγός δημιουργήθηκε χρησιμοποιώντας το IntelliJ IDEA (Έκδοση 2019.3.2) σε μια μηχανή με λειτουργικό σύστημα Windows 10. Αργότερα σε αυτόν τον οδηγό θα χρησιμοποιήσουμε ορισμένες συντομεύσεις πληκτρολογίου. Αυτές μπορεί να διαφέρουν σε άλλα λειτουργικά συστήματα (macOS/Linux). ## Κλωνοποίηση αυτού του αποθετηρίου fork this repository Κλωνοποιήστε αυτό το αποθετήριο κάνοντας κλικ στο κουμπί "Fork" στην επάνω δεξιά γωνία αυτής της σελίδας. Αυτό θα δημιουργήσει αντίγραφο αυτού του αποθετηρίου στον λογαριασμό σας στο GitHub. Το GitHub παρακολουθεί τη σχέση μεταξύ του αποθετηρίου σας και αυτού που το κλωνοποιήσατε. Μπορείτε να σκεφτείτε το αποθετήριο σας ως μια εργαστηριακή έκδοση. Τα περισσότερα αποθετήρια GitHub στο επίπεδο της κορυφής (δηλαδή αυτά που δεν έχουν κλωνοποιηθεί από κανένα άλλο αποθετήριο) έχουν μια μικρή πυρήνα ομάδα ανθρώπων που μπορούν να διαπράξουν αλλαγές απευθείας. Όλοι οι άλλοι συνεισφέροντες πρέπει να κλωνοποιήσουν το αποθετήριο και να κάνουν αλλαγές στο κλωνοποιημένο αποθετήριο, και στη συνέχεια να δημιουργήσουν μια αίτηση εξαγωγής (Pull Request) για να ζητήσουν την ενσωμάτωση των αλλαγών τους στο αποθετήριο στο επίπεδο της κορυφής. Εάν ο διαχειριστής του αποθετηρίου στο επίπεδο της κορυφής εγκρίνει τις αλλαγές, θα ενσωματωθούν, και θα αποκτήσετε αμέσως φήμη και πλούτο! Περισσότερα για το πώς να το κάνετε αυτό αργότερα. ## Κλωνοποίηση του αποθετηρίου σας clone this repository Το επόμενο βήμα είναι να κλωνοποιήσετε το αποθετήριο σας στον υπολογιστή σας, ώστε να μπορείτε να αρχίσετε να κάνετε αλλαγές. Το IntelliJ IDEA χρειάζεται το URL του αποθετηρίου σας, οπότε κάντε κλικ στο κουμπί "Clone" και στη συνέχεια κάντε κλικ στο εικονίδιο "Copy to Clipboard". **ΠΡΟΣΟΧΗ:** Ένα λάθος που συχνά κάνουν οι νέοι συνεισφέροντες είναι να κλωνοποιούν το αποθετήριο από το οποίο κλωνοποιήσατε αντί να κλωνοποιήσετε το δικό σας αποθετήριο. Ελέγξτε τη γραμμή διεύθυνσης του προγράμματος περιήγησής σας και βεβαιωθείτε ότι κάνετε κλωνοποίηση του δικού σας αποθετηρίου. Ανοίξτε το IntelliJ IDEA. Το IntelliJ IDEA σας επιτρέπει να κάνετε checkout (σε όρους Git κλωνοποίηση) ενός υπάρχοντος αποθετηρίου και να δημιουργήσετε ένα νέο έργο με βάση τα δεδομένα που έχετε λήψη. Από το κύριο μενού, επιλέξτε VCS | Get from Version Control, ή, εάν δεν είναι ανοιχτό κάποιο έργο αυτή τη στιγμή, κάντε κλικ στο Get from Version Control στην οθόνη καλωσορίσματος. Στο παράθυρο Get from Version Control, καθορίστε το URL του απομακρυσμένου αποθετηρίου που θέλετε να κλωνοποιήσετε (μπορείτε να κάνετε κλικ στο Test για να ελέγξετε εάν μπορεί να εδραιωθεί η σύνδεση με το απομακρυσμένο) ή επιλέξτε ένα από τις υπηρεσίες φιλοξενίας VCS στα αριστερά. Εάν έχετε ήδη συνδεθεί στην επιλεγμένη υπηρεσία φιλοξενίας, η συμπλήρωση θα προτείνει τη λίστα των διαθέσιμων αποθετηρίων που μπορείτε να κλωνοποιήσετε. Κάντε κλικ στο Clone. Εάν θέλετε να δημιουργήσετε ένα έργο IntelliJ IDEA βασισμένο στις πηγές που έχετε κλωνοποιήσει, κάντε κλικ στο Yes στο παράθυρο επιβεβαίωσης. Η ρίζα του Git θα ρυθμιστεί αυτόματα στον κατάλογο ρίζας του έργου. Εάν το έργο σας περιέχει υποέργα, θα κλωνοποιηθούν επίσης και θα εγγραφούν αυτόματα ως ρίζες έργου. **Σημαντικό**: Βεβαιωθείτε ότι είναι το κλωνοποιημένο αποθετήριο και όχι το αρχικό, διαφορετικά δεν θα λειτουργήσει. ## Δημιουργία κλαδιού Στο Git, η διακλάδωση είναι ένα ισχυρό μηχανισμό που σας επιτρέπει να αποκλίνετε από την κύρια γραμμή ανάπτυξης, για παράδειγμα, όταν χρειάζεστε να εργαστείτε σε μια λειτουργία ή να παγώσετε μια συγκεκριμένη κατάσταση ενός κώδικα για μια νέα έκδοση, κ.λπ. Στο IntelliJ IDEA, όλες οι λειτουργίες με κλαδιά πραγματοποιούνται στην αναδυόμενη πλαίσιο "Git Branches". Για να το εκκινήσετε, κάντε κλικ στο εικονίδιο Git στη γραμμή κατάστασης ή πατήστε Ctrl+Shift+`. Το όνομα του κλαδιού που είναι επί του παρόντος ελεγχόμενο εμφανίζεται στο widget Git στη γραμμή κατάστασης. Στο αναδυόμενο πλαίσιο "Git Branches", επιλέξτε "New Branch" (Νέο Κλαδί). Στο διάλογο που ανοίγει, καθορίστε το όνομα του κλαδιού και βεβαιωθείτε ότι η επιλογή "Checkout branch" (Επιλογή Κλαδιού) είναι επιλεγμένη εάν θέλετε να μεταβείτε σε αυτό το κλαδί. Το νέο κλαδί θα ξεκινήσει από το τρέχον HEAD. Εάν θέλετε να ξεκινήσετε ένα κλαδί από μια προηγούμενη δέσμη αντί από το τρέχον HEAD του κλαδιού, επιλέξτε αυτήν τη δέσμη στον καρτέλα Καταγραφής του παραθύρου εργαλείων Έλεγχος Εκδόσεων Alt+9 και επιλέξτε "New Branch" από το μενού περιβάλλοντος. ## Κάντε τις απαραίτητες αλλαγές Ανοίξτε το αρχείο `Contributors.md` και προσθέστε το όνομά σας οπουδήποτε στο αρχείο. Αυτό το αρχείο περιέχει GFM (GitHub Flavored Markdown), το οποίο είναι μια προπροπριεταρική γεύση της σύνταξης markdown. Αντιγράψτε μία από τις γραμμές άλλων συνεισφερόντων και τροποποιήστε τη με το όνομά σας για να βεβαιωθείτε ότι έχετε σωστή σύνταξη - μπορεί να είναι απαιτητική. ## Κάντε Commit & Push τις αλλαγές στο GitHub Επιλέξτε τα αρχεία που θέλετε να κάνετε commit ή ολόκληρη μια λίστα αλλαγών στο καρτέλα "Local Changes" του παραθύρου Εργαλείων Έλεγχος Εκδόσεων Alt+9 και πατήστε το Ctrl+K ή κάντε κλικ στο κουμπί "Commit" στη γραμμή εργαλείων. Το παράθυρο "Commit Changes" που ανοίγει καταγράφει όλα τα αρχεία που έχουν τροποποιηθεί από την τελευταία δέσμη αλλαγών, καθώς και όλα τα νέα ανεκδότα αρχεία. Εισάγετε ένα νόηματος commit μήνυμα. Μπορείτε να κάνετε κλικ στην ιστορία των μηνυμάτων commit με την ιστορία των μηνυμάτων commit Ctrl+M για να επιλέξετε από τη λίστα των πρόσφατων μηνυμάτων commit. Μπορείτε επίσης να επεξεργαστείτε το μήνυμα commit αργότερα πριν στείλετε το commit. Πατήστε το Ctrl+Shift+K ή επιλέξτε VCS | Git | Push από το κύριο μενού. Το παράθυρο "Push Commits" ανοίγει και εμφανίζει όλα τα αποθετήρια Git (για πολυ-αποθετήρια έργα) και καταγράφει όλες τις δεσμές αλλαγών που έχουν γίνει στο τρέχον κλαδί σε κάθε αποθετήριο από την τελευταία αποστολή. ## Υποβάλλετε τις αλλαγές σας για αξιολόγηση Σε αυτό το σημείο, έχετε ολοκληρώσει την αλλαγή σας, αλλά αυτή βρίσκεται ακόμα μόνο στο αποθετήριό σας. Αυτό το βήμα θα σας δείξει πώς να υποβάλετε αίτηση στον διαχειριστή του αποθετηρίου στο επίπεδο της κορυφής για να ενσωματώσετε την αλλαγή σας. Στο αποθετήριό σας στο GitHub, θα δείτε το κουμπί "Compare & pull request" (Σύγκριση & αίτηση εξαγωγής) δίπλα στην ειδοποίηση για το νέο κλαδί. Κάντε κλικ σε αυτό το κουμπί. create a pull request Στη συνέχεια, υποβάλετε την αίτηση εξαγωγής (Pull Request). submit pull request Σύντομα, θα συγχωνεύσω όλες τις αλλαγές σας στο κύριο κλαδί αυτού του έργου. Θα λάβετε ένα email ειδοποίησης μόλις οι αλλαγές σας έχουν συγχωνευτεί. ## Πού να πάτε από εδώ και πέρα; Συγχαρητήρια! Μόλις ολοκληρώσατε την κανονική ροή _fork -> clone -> edit -> PR_ που θα συναντήσετε συχνά ως συνεισφέροντας! Γιορτάστε τη συνεισφορά σας και μοιραστείτε τη με τους φίλους και τους ακόλουθούς σας μεταβαίνοντας στην [ιστοσελίδα της εφαρμογής](https://firstcontributions.github.io#social-share). ### [Πρόσθετο υλικό](../additional-material/git_workflow_scenarios/additional-material.md) ## Οδηγοί για Χρήση Άλλων Εργαλείων [Επιστροφή στην κύρια σελίδα](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Greek/github-windows-vs-code-tutorial.gr.md ================================================ [![Αγάπη για το Ανοιχτό Κώδικα](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![Άδεια: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Βοηθοί Ανοιχτού Κώδικα](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Πρώτες Συνεισφορές | Visual Studio Code | Visual Studio Code | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | Είναι δύσκολο. Είναι πάντα δύσκολο την πρώτη φορά που κάνετε κάτι. Ειδικά όταν συνεργάζεστε, το να κάνετε λάθη δεν είναι κάτι άνετο. Αλλά το ανοιχτός κώδικας αφορά τη συνεργασία και την εργασία μαζί. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο νέοι συνεισφέροντες ανοιχτού κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά. Το να διαβάζετε άρθρα και να παρακολουθείτε μαθήματα μπορεί να βοηθήσει, αλλά τι καλύτερο από το να κάνετε πράγματα χωρίς να μπερδευτείτε με τίποτα. Αυτό το έργο στοχεύει στην παροχή καθοδήγησης και στην απλοποίηση του τρόπου που οι νεοσύστατοι συνεισφέροντες κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε ότι όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Εάν ψάχνετε να κάνετε την πρώτη σας συνεισφορά, απλώς ακολουθήστε τα απλά βήματα παρακάτω. Σας υποσχόμαστε, θα είναι διασκεδαστικό. Εάν δεν έχετε το Visual Studio Code στον υπολογιστή σας, [εγκαταστήστε το](https://code.visualstudio.com/download). **Προσοχή:** Αυτός ο οδηγός δημιουργήθηκε χρησιμοποιώντας το Visual Studio Code (Έκδοση 1.27.2) σε μηχάνημα με Windows 10. Αργότερα σε αυτόν τον οδηγό, θα χρησιμοποιήσουμε κάποιες συντομεύσεις πληκτρολογίου. Αυτές μπορεί να διαφέρουν σε άλλα λειτουργικά συστήματα (macOS/Linux) καθώς και σε γλώσσες πληκτρολογίου (UK, DE, κλπ). Μπορείτε να εξετάσετε τη λίστα των συντομεύσεων σας αναζητώντας "συντόμευση" στην Εντολική Παλέτα (Command Palette). ## Κάντε Fork το αποθετήριο fork this repository Κάντε fork το αποθετήριο κάνοντας κλικ στο κουμπί fork στην πάνω δεξιά γωνία αυτής της σελίδας. Αυτό θα δημιουργήσει ένα αντίγραφο αυτού του αποθετηρίου στο λογαριασμό σας στο GitHub. Το GitHub κρατάει το ιστορικό της σχέσης μεταξύ του αποθετηρίου σας και του αποθετηρίου από το οποίο το κάνατε fork. Μπορείτε να φανταστείτε το αποθετήριο σας ως μια εργασιακή αντιγραφή. Τα περισσότερα ανώτατα αποθετήρια του GitHub (δηλαδή αυτά που δεν έχουν γίνει fork από κάποιο άλλο αποθετήριο) έχουν μια μικρή ομάδα πυρήνα ανθρώπων που μπορούν να κάνουν απευθείας αλλαγές. Όλοι οι άλλοι συνεισφέροντες πρέπει να κάνουν fork το αποθετήριο και να κάνουν αλλαγές στο fork, στη συνέχεια να δημιουργήσουν ένα αίτημα εξαγωγής (Pull Request) για να ζητήσουν τις αλλαγές τους να συγχωνευτούν πίσω στο ανώτατο αποθετήριο. Εάν ο διαχειριστής του ανώτατου αποθετηρίου αρέσει τις αλλαγές, θα συγχωνευτούν και θα κερδίσετε αμέσως φήμη και πλούτο! Περισσότερα γι' αυτό αργότερα. ## Κλωνοποίηση του αποθετηρίου σας clone this repository Το επόμενο βήμα είναι να κλωνοποιήσετε το αποθετήριο στον υπολογιστή σας, ώστε να μπορείτε να αρχίσετε να κάνετε αλλαγές. Το VS Code χρειάζεται τη διεύθυνση URL του αποθετηρίου σας, οπότε κάντε κλικ στο κουμπί "code" και στη συνέχεια κάντε κλικ στο εικονίδιο "copy to clipboard". **ΠΡΟΣΟΧΗ:** Ένα λάθος που κάνουν συχνά οι νέοι συνεισφέροντες είναι να κλωνοποιούν το αποθετήριο από το οποίο έκαναν fork _αντί να κλωνοποιούν το δικό τους αποθετήριο_. Ελέγξτε τη γραμμή διεύθυνσης του προγράμματος περιήγησής σας και βεβαιωθείτε ότι κάνετε κλωνοποίηση του δικού σας αποθετηρίου. Τώρα ανοίξτε το Visual Studio Code. Η αρχική σελίδα του VS Code θα εμφανιστεί. Από εκεί πατήστε `F1` για να ανοίξετε τη γραμμή εργαλείων που εμφανίζεται παρακάτω. Παρατηρήστε ότι υπάρχει ήδη ένα `>` (μεγαλύτερο από) στο πεδίο κειμένου. Μπορείτε επίσης να φτάσετε στο προσαρτημένο παράθυρο εισαγωγής πατώντας `CTRL-P` και στη συνέχεια πληκτρολογώντας τον χαρακτήρα `>`. Clone Popup (Command Popup) Μπορεί να παρατηρήσετε ότι υπάρχουν ήδη κάποιες ασαφείς εντολές που εμφανίζονται παρακάτω. Αυτές είναι οι πρόσφατα χρησιμοποιημένες εντολές μου. Απλώς μην ασχολείστε μαζί τους. Clone repo Τώρα πληκτρολογήστε `git clone`, μόνο `git` ή `clone` (λειτουργεί σαν αναζήτηση). Επιλέξτε την εισαγωγή `Git: Clone` και πατήστε `Enter`. Paste Repository URL in Επικολλήστε τη διεύθυνση URL του αποθετηρίου σας και πατήστε `Enter`. Αυτό θα ανοίξει ένα Εξερευνητή Αρχείων όπου μπορείτε στη συνέχεια να επιλέξετε πού θα αποθηκευτεί το αποθετήριο Git. **Σημαντικό**: Βεβαιωθείτε ότι είναι το αποθετήριο fork και όχι το αρχικό, διαφορετικά δεν θα λειτουργήσει. Status popup Θα δείτε ένα αναδυόμενο παράθυρο κατάστασης στο κάτω δεξιό μέρος του Visual Studio Code. Αφού ολοκληρωθεί, μπορείτε να ανοίξετε το κλωνοποιημένο αποθετήριο (που τώρα είναι ένας φάκελος στον υπολογιστή σας) χρησιμοποιώντας τα κουμπιά στο διάλογο. ## Δημιουργία ενός κλαδιού Άνοιξτε ξανά τη γραμμή εργαλείων πληκτρολογώντας `F1`. Πληκτρολογήστε `branch` και επιλέξτε την εντολή `create branch`. Στο επόμενο βήμα, πληκτρολογήστε το όνομα του νέου σας κλαδιού, για παράδειγμα `add-david-kroell`. Πατήστε Enter και το κλαδί θα δημιουργηθεί. Το κλαδί είναι επίσης ήδη ελεγχθεί. [Τι σημαίνει η εντολή checkout;](https://www.git-scm.com/docs/git-checkout) Branches Command Palette ## Κάντε τις απαραίτητες αλλαγές Ανοίξτε το αρχείο `Contributors.md` και προσθέστε το όνομά σας οπουδήποτε στο αρχείο. Αυτό το αρχείο περιέχει GFM (GitHub Flavored Markdown), που είναι μια προσαρμοσμένη έκδοση της σύνταξης markdown. Αντιγράψτε μία από τις γραμμές άλλων συνεισφερόντων και τροποποιήστε τη με το όνομά σας για να βεβαιωθείτε ότι καταλαβαίνετε τη σύνταξη - μπορεί να είναι απαιτητική. Αποθηκεύστε το αρχείο για να καταγραφεί η αλλαγή. Add your name ## Κάντε Commit & Push τις αλλαγές στο GitHub Στο αριστερό μέρος του VS Code υπάρχει ένα μενού με 5 εικονίδια. Επιλέξτε το εικονίδιο έλεγχου εκδόσεων/Ελέγχου Κώδικα. (Συντόμευση: Ctrl + Shift + G) Commit changes Ο εξερευνητής αρχείων εμφανίζει όλα τα αρχεία που έχουν αλλάξει μετά το τελευταίο commit. Αν φέρετε το ποντίκι πάνω από τα αρχεία και κάνετε κλικ στο `+` (συν ή πλήκτρο plus), τα αρχεία είναι σταγμένα (staged). Stashed Files Πληκτρολογήστε κάτι στη γραμμή στην κορυφή του εξερευνητή και πατήστε το σημάδι επιλογής ελέγχου. Οι αλλαγές καταγράφονται τώρα στο τοπικό αντίγραφό σας. Τώρα οι αλλαγές πρέπει να ανέβουν πίσω στο GitHub. Stashed Files Χρησιμοποιήστε το εικονίδιο με τις τρεις τελείες για να ανοίξετε το μενού όπου θα επιλέξετε την επιλογή `Publish Branch` (Δημοσίευση Κλαδιού). Αυτό πρέπει να ανοίξει ένα παράθυρο διαλόγου για να εισαγάγετε τα διαπιστευτήρια σας στο GitHub. Stashed Files ## Υποβάλετε τις αλλαγές σας για αξιολόγηση Σε αυτό το σημείο, έχετε ολοκληρώσει την αλλαγή σας αλλά αυτή βρίσκεται ακόμα μόνο στο αποθετήριό σας. Αυτό το βήμα θα σας δείξει πώς να υποβάλετε ένα αίτημα στο διαχειριστή του ανώτατου αποθετηρίου για να συγχωνευτεί η αλλαγή σας. Στο αποθετήριό σας στο GitHub, θα δείτε το κουμπί "Compare & pull request" (Σύγκριση & αίτημα εξαγωγής) δίπλα στην ειδοποίηση για το νέο κλαδί. Κάντε κλικ σε αυτό το κουμπί. create a pull request Υποβάλετε το αίτημα εξαγωγής (pull request). submit pull request Σύντομα θα συγχωνευτούν όλες οι αλλαγές σας στο κύριο κλαδί αυτού του έργου. Θα λάβετε ένα email ειδοποίησης μόλις οι αλλαγές σας συγχωνευτούν. ## Πού να πάτε από εδώ; Συγχαρητήρια! Μόλις ολοκληρώσατε την τυπική ροή _fork -> clone -> edit -> PR_ που θα συναντήσετε συχνά ως συνεισφέροντας! Γιορτάστε τη συνεισφορά σας και μοιραστείτε την με τους φίλους και τους ακόλουθούς σας πηγαίνοντας στη [web εφαρμογή](https://firstcontributions.github.io#social-share). ### [Επιπλέον υλικό](../additional-material/git_workflow_scenarios/additional-material.md) ## Οδηγοί χρήσης με άλλα εργαλεία [Επιστροφή στην κύρια σελίδα](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Greek/github-windows-vs2017-tutorial.gr.md ================================================ [![Αγάπη για το Ανοιχτό Κώδικα](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![Άδεια: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Βοηθοί Ανοιχτού Κώδικα](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Πρώτες Συνεισφορές |Visual Studio 2017|Έκδοση Visual Studio 2017| |---|---| Είναι δύσκολο. Πάντα είναι δύσκολο την πρώτη φορά που κάνεις κάτι. Ειδικά όταν συνεργάζεσαι, οι λάθος δεν είναι κάτι άνετο. Αλλά ο ανοιχτός κώδικας αφορά τη συνεργασία και την εργασία μαζί. Ήθελαν να απλοποιήσουν τον τρόπο με τον οποίο νέοι συνεισφέροντες ανοιχτού κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά. Το να διαβάζεις άρθρα και να παρακολουθείς οδηγούς μπορεί να βοηθήσει, αλλά τίποτα δεν είναι καλύτερο από το να κάνεις πραγματικά τα πράγματα χωρίς να χαλάσεις τίποτα. Αυτό το έργο στοχεύει να παρέχει καθοδήγηση και να απλοποιεί τον τρόπο που οι νέοι συνεισφέροντες κάνουν την πρώτη τους συνεισφορά. Θυμήσου, όσο πιο χαλαρός είσαι, τόσο καλύτερα μαθαίνεις. Αν ψάχνεις να κάνεις την πρώτη σου συνεισφορά, ακολούθησε απλά τα απλά βήματα παρακάτω. Σου υποσχόμαστε, θα είναι διασκεδαστικό. Αν δεν έχετε την Visual Studio 2017 στη μηχανή σας, [εγκαταστήστε την](https://www.visualstudio.com/downloads/). ## Κλωνοποίηση του αποθετηρίου κλωνοποίηση του αποθετηρίου Κλωνοποιήστε αυτό το αποθετήριο κάνοντας κλικ στο κουμπί "fork" στην κορυφή αυτής της σελίδας. Αυτό θα δημιουργήσει ένα αντίγραφο αυτού του αποθετηρίου στο λογαριασμό σας στο GitHub. Το GitHub παρακολουθεί τη σχέση ανάμεσα στο αποθετήριό σας και αυτό από το οποίο το διακλαδώσατε. Μπορείτε να σκεφτείτε το αποθετήριό σας ως μια εργασιακή αντιγραφή. Τα περισσότερα αποθετήρια GitHub επιπέδου κορυφής (δηλαδή εκείνα που δεν διακλαδώθηκαν από κανένα άλλο αποθετήριο) έχουν μια μικρή πυρήνα ομάδα ανθρώπων που μπορούν να κάνουν απευθείας αλλαγές. Οι υπόλοιποι συνεισφέροντες πρέπει να διακλαδώσουν το αποθετήριο και να κάνουν αλλαγές στο διακλάδωμα, και στη συνέχεια να δημιουργήσουν ένα αίτημα τραβήγματος για να ζητήσουν τις αλλαγές τους να ενσωματωθούν πίσω στο αποθετήριο επιπέδου κορυφής. Εάν ο διαχειριστής του αποθετηρίου επιπέδου κορυφής αρέσει τις αλλαγές, θα ενσωματώνονται και θα κερδίσετε άμεση φήμη και πλούτο! Περισσότερα για το πώς να το κάνετε αυτό αργότερα. ## Κλωνοποίηση του αποθετηρίου σας κλωνοποίηση αυτού του αποθετηρίου Ο επόμενος βήμα είναι να κλωνοποιήσετε το αποθετήριο σας στη μηχανή σας ώστε να μπορέσετε να αρχίσετε να κάνετε αλλαγές. Η Visual Studio χρειάζεται το URL του αποθετηρίου σας, οπότε κάντε κλικ στο κουμπί "clone" και στη συνέχεια κάντε κλικ στο εικονίδιο "αντιγραφή στο πρόχειρο". **ΠΡΟΣΟΧΗ:** Ένα σφάλμα που κάνουν συχνά οι νέοι συνεισφέροντες είναι να κλωνοποιούν το αποθετήριο που διακλάδωσαν *από* αντί να κλωνοποιούν το αποθετήριο τους. Ελέγξτε τη γραμμή διεύθυνσης του προγράμματος περιήγησής σας και βεβαιωθείτε ότι κλωνοποιείτε το αποθετήριό σας. Τώρα είναι η στιγμή να μεταβείτε στην Visual Studio 2017! Θα εργαστείτε στην καρτέλα "Ομάδα Εξερεύνησης" για το μεγαλύτερο μέρος αυτού του οδηγού. Εάν δεν είναι ανοικτή από προεπιλογή, κάντε κλικ στο `Προβολή > Ομάδα Εξερεύνησης` για να την ανοίξετε. Ομάδα Εξερεύνησης Η Ομάδα Εξερεύνησης έχει πολλές προβολές και υπάρχουν κουμπιά πλοήγησης στην κορυφή για να σας βοηθήσουν να βρείτε τις διάφορες περιοχές. Για να κλωνοποιήσετε ένα αποθετήριο, πρέπει να βρίσκεστε στην προβολή Σύνδεση, η οποία πρέπει να είναι η προεπιλεγμένη. Εάν δεν βλέπετε το κουμπί "κλώνος", κάντε κλικ στην πράσινη πρίζα στην κορυφή. Κάντε κλικ στην επιλογή "Κλώνος" κάτω από **Τοπικά Αποθετήρια Git** και επικολλήστε το URL του αποθετηρίου σας στο πλαίσιο κειμένου. Αυτό θα πρέπει να είναι το URL που έχετε αντιγράψει στο πρόχειρο από το GitHub προηγουμένως. Κάντε κλικ στο κουμπί "Κλώνος" για να ξεκινήσετε τη διαδικασία. Κλώνος αποθετηρίου Όταν ολοκληρωθεί η διαδικασία, θα μεταφερθείτε στην καρτέλα Εξερεύνησης Λύσης, όπου μπορείτε να δείτε τα περιεχόμενα του αποθετηρίου σας. Το δικό σας θα διαφέρει από τη στιγμιότυπη λήψη παρακάτω επειδή τα πράγματα αλλάζουν! Εξερεύνηση Λύσης ## Δημιουργία κλαδιού Κάντε κλικ πίσω στην καρτέλα Ομάδα Εξερεύνησης και χρησιμοποιήστε το κυρίως αναπτυσσόμενο μενού πλοήγησης για να ανοίξετε την προβολή Κλαδιά. Προβολή Κλαδιών Θα πρέπει να δείτε το αποθετήριο **first-contributions** και το προεπιλεγμένο κλαδί, το οποίο ονομάζεται `master`. Κάντε δεξί κλικ στο `master` και επιλέξτε "Δημιουργία Νέου Τοπικού Κλαδιού Από...". Νέο κλαδί Δώστε στο κλαδί σας ένα όνομα όπως `add-<όνομα_σας_εδώ>`, για παράδειγμα: `add-alonzo-church`. Αφήστε το πλαίσιο "Έλεγχος κλαδιού" επιλεγμένο και κάντε κλικ στο κουμπί "Δημιουργία Κλαδιού". Δημιουργία κλαδιού Θα πρέπει να δείτε το νέο κλαδί σας στη λίστα. Προβολή νέου κλαδιού Here is the translation of the remaining text: ## Κάντε τις απαραίτητες αλλαγές Ανοίξτε το αρχείο `Contributors.md` και προσθέστε το όνομά σας στο τέλος της λίστας. Αυτό το αρχείο περιέχει την GFM (GitHub Flavored Markdown), η οποία είναι μια προπριεταριακή παραλλαγή της [σύνταξης Markdown](https://en.wikipedia.org/wiki/Markdown). Αντιγράψτε μία από τις γραμμές άλλων συνεισφερόντων και τροποποιήστε τη με το όνομά σας για να βεβαιωθείτε ότι έχετε σωστή σύνταξη - μπορεί να είναι λεπτομερής. Προσθήκη του ονόματός σας ## Κάντε commit & αποστείλετε τις αλλαγές στο GitHub Μεταβείτε πίσω στο Team Explorer και πλοηγηθείτε στην προβολή Αλλαγές. Αλλαγές Εισαγάγετε τις πληροφορίες που θέλετε να προσθέσετε με το commit σας και κάντε κλικ στο "Αποθήκευση". Το Visual Studio θα το θυμάται για μελλοντικά commit. Πληροφορίες χρήστη Git **ΣΗΜΕΙΩΣΗ:** Το Visual Studio χρησιμοποιεί έναν κρυφό φάκελο με το όνομα `.vs` για να αποθηκεύει τις προσωπικές σας ρυθμίσεις και προτιμήσεις. Τα περιεχόμενα αυτού του φακέλου **δεν πρέπει να αποθηκευτούν στο Git**. Αν δεν έχει ήδη γίνει αγνόησή του, μπορεί να χρειαστεί να ενημερώσετε το Git να τον αγνοεί, ώστε να μην τον αποστέλλει στο αποθετήριο. Αυτός ο φάκελος έχει ήδη αγνοηθεί σε αυτό το αποθετήριο, οπότε δεν θα χρειαστεί να εκτελέσετε αυτό το βήμα... είναι απλά εδώ για την αναφορά σας για μελλοντικά έργα. Παράβλεψη του φακέλου .vs Τώρα θα πρέπει να δείτε μια λίστα με τα αλλαγμένα αρχεία και ένα πλαίσιο κειμένου για να πληκτρολογήσετε ένα σχόλιο commit. Τα σχόλια πρέπει να είναι σύντομα, αλλά λεπτομερή. Δεν υπάρχει χειρότερο από το να διαβάζετε σχόλια commit και να βλέπετε κάτι τέτοιο: `"Έκανα ανανεώσεις"`. Αφιερώστε λίγα δευτερόλεπτα για να περιγράψετε το commit σας. Η ομάδα σας θα σας ευγνωμονήσει αργότερα, και εσ είς μπορείτε ακόμα και να ευχαριστήσετε τον εαυτό σας! Κάντε κλικ στο "Καταχώρηση όλων και αποστολή" για να πραγματοποιήσετε ένα τοπικό commit και να αποστείλετε τις αλλαγές σας πίσω στο αποθετήριό σας, όλα με ένα βήμα. **ΣΗΜΕΙΩΣΗ:** Το commit μπορεί να γίνει ξεχωριστά από το Push. Εδώ κάνουμε και τα δύο για άνεση. Το commit καταγράφει τις αλλαγές σας τοπικά, αλλά δεν θα αντανακλαστούν στο αποθετήριό σας στο GitHub μέχρι να κάνετε Push. Καταχώρηση και αποστολή Την πρώτη φορά που θα κάνετε Push στο GitHub, το Visual Studio θα ζητήσει τα διαπιστευτήριά σας στο GitHub. Θα αποθηκευτούν στη μνήμη cache, οπότε δεν θα βλέπετε αυτό πολύ συχνά. Σύνδεση Αφού ολοκληρωθεί η λειτουργία Push, ανοίξτε το αποθετήριό σας στο GitHub και θα δείτε ένα μήνυμα που υποδεικνύει μια πρόσφατα απεσταλμένη κλαδί. Μπορείτε να δείτε τις αλλαγές σας ανοίγοντας το αναπτυσσόμενο μενού "Branch: master" και επιλέγοντας το νέο σας κλαδί. Συγχαρητήρια, μπορείτε να μοιραστείτε το URL του κλαδιού με τον κόσμο για να δείξετε την πρόοδό σας! Προβολή απεσταλμένου κλαδιού στο GitHub ## Υποβάλλετε τις αλλαγές σας για αναθεώρηση Σε αυτό το σημείο, έχετε ολοκληρώσει την αλλαγή σας, αλλά εξακολουθεί να βρίσκεται μόνο στο αποθετήριό σας. Αυτό το βήμα θα σας δείξει πώς να υποβάλετε αίτημα προς τον διαχειριστή του ανώτατου επιπέδου αποθετηρίου για να ενσωματώσετε την αλλαγή σας. Στο αποθετήριό σας στο GitHub, θα δείτε το κουμπί "Σύγκριση & αίτηση ενσωμάτωσης" δίπλα στην ειδοποίηση του νέου κλαδιού. Κάντε κλικ σε αυτό το κουμπί. Δημιουργία αίτησης ενσωμάτωσης Τώρα υποβάλετε το αίτημα ενσωμάτωσης. Υποβολή αίτησης ενσωμάτωσης Σύντομα θα συνοψίσω όλες τις αλλαγές σας στον κ ύριο κλαδί αυτού του έργου. Θα λάβετε ένα email ειδοποίησης όταν οι αλλαγές έχουν ενσωματωθεί. ## Τι να κάνετε μετά; Συγχαρητήρια! Έχετε μόλις ολοκληρώσει την κανονική ροή εργασίας "fork -> clone -> edit -> PR" που θα συναντήσετε συχνά ως συνεισφέροντας! Γιορτάστε τη συνεισφορά σας και μοιραστείτε τη με τους φίλους και τους ακόλουθούς σας πηγαίνοντας στην [ιστοσελίδα εφαρμογής](https://firstcontributions.github.io#social-share). ### [Πρόσθετο υλικό](../additional-material/git_workflow_scenarios/additional-material.md) ## Οδηγοί χρήσης άλλων εργαλείων [Επιστροφή στην κύρια σελίδα](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Greek/gitkraken-tutorial.gr.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Πρώτες Συνεισφορές |GitKraken|Έκδοση GitKraken| |---|---| Είναι δύσκολο. Είναι πάντα δύσκολο, όταν κάνετε κάτι για πρώτη φορά. Ειδικά όταν συνεργάζεστε, το να κάνεις κάποιο λάθος δεν είναι κάτι άνετο. Αλλά ο ανοιχτός κώδικας αφορά τη συνεργασία και τη συνεργασία. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο νέοι συνεισφέροντες ανοιχτού κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά. Η ανάγνωση άρθρων και η παρακολούθηση εκπαιδευτικού υλικού μπορεί να βοηθήσει, αλλά τι είναι καλύτερο από το να κάνετε όντως κάτι χωρίς να χαλάσετε τίποτα. Αυτό το έργο έχει σκοπό να παρέχει καθοδήγηση και να απλοποίησει τον τρόπο με τον οποίο οι νέοι συνεισφέροντες μπορούν να κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε, όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Εάν θέλετε να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε απλά τα απλά βήματα παρακάτω. Σας υποσχόμαστε, θα είναι διασκεδαστικό. ## GitKraken Κατεβάστε το [GitKraken](https://www.gitkraken.com), εγκαταστήστε το και ανοίξτε το. Θα δείτε το παράθυρο "Καλώς ήρθατε στο GitKraken" - Συνδεθείτε με το GitHub και επιτρέψτε στο GitKraken να αποκτήσει πρόσβαση στον λογαριασμό σας στο GitHub. login to GitHub (προαιρετικά) Πηγαίνετε στο Αρχείο -> Προτιμήσεις και ορίστε τον κατάλογο του έργου σας στη ρίζα των τοπικών αποθετηρίων σας. ## Κάντε Fork αυτού του αποθετηρίου Κάντε fork αυτό το αποθετήριο κάνοντας κλικ στο κουμπί fork στην κορυφή αυτής της σελίδας. fork this repository Αυτό θα δημιουργήσει ένα αντίγραφο αυτού του αποθετηρίου στο λογαριασμό σας. ## Κλωνοποίηση του αποθετηρίου Στο GitKraken, πηγαίνετε στο Αρχείο -> Κλωνοποίηση Αποθετηρίου. clone this repository Επιλέξτε το GitHub.com στο δεξί πλαίσιο. Κάτω από το όνομα χρήστη σας, θα πρέπει να δείτε το first-contributions. Κάντε κλικ σε αυτό το αποθετήριο και ελέγξτε την πλήρη διαδρομή που εμφανίζεται στο κάτω μέρος αυτού του παραθύρου. Μόλις είστε ικανοποιημένοι με τη διαδρομή, κάντε κλικ στο "Κλωνοποίηση του αποθετηρίου!". ## Δημιουργία παρακλαδιού Κάντε κλικ στο κουμπί παρακλαδιού στη γραμμή εργαλείων. Ονομάστε το παρακλάδι σας "προσθήκη-του-ονόματός-σας", για παράδειγμα: "προσθήκη-ονόματος-William-Sutton" name your branch ## Κάντε τις απαραίτητες αλλαγές και δεσμεύστε αυτές τις αλλαγές Ανοίξτε τώρα το αρχείο `Contributors.md` σε έναν επεξεργαστή κειμένου και προσθέστε το όνομά σας σε αυτό, και στη συνέχεια αποθηκεύστε το αρχείο. Εάν έχετε το αποθετήριο ανοικτό στο GitKraken, θα δείτε ότι υπάρχουν αλλαγές. Ελέγξτε και κάντε stage αυτές τις αλλαγές επιλέγοντας την νεότερη δέσμευση που είναι σημειωμένη με "// WIP" και τον αριθμό των αρχείων που έχουν αλλάξει και τον τύπο της αλλαγής. edit some file(s) Επανεξετάστε τα αρχεία που έχουν αλλάξει και αποφασίστε τι θέλετε να τα κάνετε stage. Το staging είναι σημαντικό για να πείτε στο Git ακριβώς ποιες αλλαγές αρχείων θέλετε να συσχετίσετε με αυτήν τη δέσμευση. stage your changes Αφού έχετε ένα καλό μήνυμα δεσμεύσεως ("Προσθήκη <του-ονόματός-σας> στη λίστα συνεισφερόντων" ακούγεται ωραίο και περιγραφικό) και είστε ικανοποιημένοι με τις αλλαγές σας, μπορείτε να πατήσετε "Stage όλων των αλλαγών" για να κάνετε stage όλα όσα έχουν τροποποιηθεί ή "Stage αρχείου" για να κάνετε stage ένα μεμονωμένο αρχείο. clone this repository Εάν αλλάξετε γνώμη, μπορείτε να ακυρώσετε το staging αυτών των αλλαγών ή να τις απορρίψετε εντελώς. ΠΡΟΕΙΔΟΠΟΙΗΣΗ: Όπως υποδηλώνει η λέξη απόρριψη, αυτή είναι μια καταστροφική λειτουργία. Κάντε αυτό μόνο εάν δεν θέλετε καμία αλλαγή από το αποθετήριο στο οποίο βρίσκεστε. Πατήστε δέσμευση. Συγχαρητήρια, έχετε δεσμεύσει όλες τις αλλαγές στο τοπικό αντίγραφο του κλαδιού σας του δικού σας fork του first-contributions. Συνεχίζουμε! ## Ανέβασμα αλλαγών στο GitHub push your changes Πατήστε το κουμπί Ανέβασμα στη γραμμή εργαλείων. origin or branch Υποβάλετε αλλαγές στο παρακλάδι origin εάν θέλετε οι αλλαγές να αντανακλούν απευθείας στον παρακλάδι master, διαφορετικά επιλέξτε το κατάλληλο παρακλάδι που θέλετε να ανεβάσετε. ## Υποβολή των αλλαγών σας για αξιολόγηση Εάν πάτε στο αποθετήριο σας στο github, θα δείτε το κουμπί "Σύγκριση & αίτηση εξαγωγής". Κάντε κλικ σε αυτό το κουμπί. create a pull request Τώρα υποβάλετε το αίτημα εξαγωγής. submit pull request Σύντομα θα ενσωματώσω όλες τις αλλαγές σας στον κύριο παρακλάδι αυτού του έργου. Θα λάβετε μια ειδοποίηση με ηλεκτρονικό ταχυδρομείο αφού οι αλλαγές έχουν ενσωματωθεί. ## Πού να πάτε από εδώ; Συγχαρητήρια! Μόλις ολοκληρώσατε την τυπική ροή _fork -> clone -> edit -> PR_ που θα συναντήσετε συχνά ως συνεισφέρων! Γιορτάστε τη συνεισφορά σας και μοιραστείτε την με τους φίλους σας και τους ακόλουθούς σας πηγαίνοντας στην [ιστοσελίδα του διαδικτυακού εργαλείου](https://firstcontributions.github.io/#social-share). ### [Πρόσθετο υλικό](../additional-material/git_workflow_scenarios/additional-material.md) ## Οδηγοί Χρήσης Άλλων Εργαλείων [Επιστροφή στην κύρια σελίδα](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Greek/sourcetree-macos-tutorial.gr.md ================================================ [![Αγάπη Ανοικτού Κώδικα](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![Άδεια: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Βοηθοί Ανοικτού Κώδικα](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Πρώτες Συνεισφορές |SourceTree|Atlassian Sourcetree| |---|---| Είναι δύσκολο. Είναι πάντα δύσκολο, όταν κάνεις κάτι για πρώτη φορά. Ειδικά όταν συνεργάζεσαι, το να κάνεις λάθη δεν είναι άνετο. Αλλά το ανοικτός κώδικας αφορά τη συνεργασία και την αλληλεπίδραση. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο νέοι συνεισφέροντες στον ανοικτό κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά. Το να διαβάζεις άρθρα και να παρακολουθείς μαθήματα μπορεί να βοηθήσει, αλλά τι μπορεί να είναι καλύτερο από το να κάνεις πραγματικά τα πράγματα χωρίς να μπλέκεις τίποτα. Αυτό το πρόγραμμα στοχεύει στην παροχή καθοδήγησης και στην απλοποίηση του τρόπου με τον οποίο οι νέοι κάνουν την πρώτη τους συνεισφορά. Θυμήσου ότι όσο πιο χαλαρός είσαι, τόσο καλύτερα μαθαίνεις. Αν ψάχνεις να κάνεις την πρώτη σου συνεισφορά, ακολούθησε τα απλά βήματα παρακάτω. Σου υποσχόμαστε ότι θα είναι διασκεδαστικό. ## Sourcetree Παρακαλούμε σημειώστε ότι αυτό το εκπαιδευτικό εγχειρίδιο αφορά το MacOS. Είναι παρόμοιο με το Sourcetree στα Windows, αλλά κάποια πράγματα μπορεί να φαίνονται διαφορετικά. Κατεβάστε το [Sourcetree](https://www.sourcetreeapp.com), εγκαταστήστε το και ανοίξτε το. Θα πρέπει να δείτε το παράθυρο διαλόγου "Sourcetree". SourceTree Main Από εδώ, θέλετε να κάνετε κλικ στο "Remote" (Απομακρυσμένο). Εάν αυτή είναι η πρώτη εγκατάσταση, τότε πιθανώς δεν έχετε συνδέσει ακόμα τον λογαριασμό σας στο GitHub. Κάντε το κάνοντας κλικ στο κουμπί "Connect" (Σύνδεση). SourceTree Connect Θα εμφανιστεί το παράθυρο διαλόγου *Accounts* (Λογαριασμοί). Κάντε κλικ στο "Add" (Προσθήκη) στην κάτω αριστερή γωνία. Στη συνέχεια, επιλέξτε τις κατάλληλες ρυθμίσεις για να προσθέσετε το GitHub (ή οποιονδήποτε άλλο λογαριασμό θέλετε) στον πελάτη. Αφού επιλέξετε τις ρυθμίσεις σας για το GitHub, κάντε κλικ στο "Connect Account" (Σύνδεση Λογαριασμού). SourceTree Connect Add Αυτό θα ανοίξει μια σελίδα στον περιηγητή σας. Ακολουθήστε τα βήματα που δίνονται για να εξουσιοδοτήσετε τον λογαριασμό σας. ## Κλωνοποίηση αυτού του αποθετηρίου Κλωνοποιήστε αυτό το αποθετήριο κάνοντας κλικ στο κουμπί κλωνοποίησης (fork) στην κορυφή αυτής της σελίδας. fork this repository Αυτό θα δημιουργήσει ένα αντίγραφο αυτού του αποθετηρίου στον λογαριασμό σας. ## Κλωνοποίηση του αποθετηρίου Στο Sourcetree, κάντε κλικ στο κουμπί "Remote" (Απομακρυσμένο). Αυτό θα φορτώσει όλα τα αποθετήριά σας στο GitHub που εμφανίζονται στο GitHub. clone this repository Αφού κάνετε κλικ στο κουμπί "Clone" (Κλωνοποίηση), θα εμφανιστεί μια άλλη προβολή για να ορίσετε διάφορα πράγματα. clone this repository 1) **Διεύθυνση URL πηγής:** Αυτό συμπληρώνεται αυτόματα και δεν χρειάζεται να το αλλάξετε. Είναι η URL από όπου βρίσκεται το έργο σας στο GitHub. 2) **Διαδρομή προορισμού:** Αυτή είναι η φυσική τοποθεσία στον υπολογιστή σας όπου θα αποθηκευτεί το έργο. 3) **Όνομα:** Αυτό είναι ένα "Σελιδοδείκτης" προς τον τρόπο που θα αναφέρεται στο έργο σας ο Sourcetree. Σκεφτείτε το ως μια συντόμευση. *Σημείωση: Συνήθως οι προεπιλογές σε αυτά τα πεδία είναι καλές.* **Αφού είστε ικανοποιημένοι, κάντε κλικ στο "Clone" (Κλωνοποίηση)** Αυτό θα φέρει το κύριο πρόγραμμα περιήγησης του αποθετηρίου σας! ## Δημιουργία κλαδιού (branch) Κάντε κλικ στο κουμπί κλαδιού στη γραμμή εργαλείων. Ονομάστε το κλαδί σας "add-your-name-to-contribution", για παράδειγμα: "add-sally-to-contribution". Για να το κάνετε αυτό, κάντε κλικ στο **Branch (1)** που θα εκκινήσει το παράθυρο ονομασίας. Στη συνέχεια, **Προσθέστε το όνομά σας (2)** όπως μόλις περιγράφηκε. Τέλος, κάντε κλικ στο **Create Branch (Δημιουργία Κλαδιού)**. Αυτό θα δημιουργήσει το κλαδί για ό,τι μόλις ονομάσατε. name your branch ## Κάντε τις απαραίτητες αλλαγές και κάντε commit αυτές τις αλλαγές Τώρα ανοίξτε το αρχείο `Contributors.md` σε έναν επεξεργαστή κειμένου και προσθέστε το όνομά σας σε αυτό, μαζί με το σύνδεσμο του GitHub, και σώστε το αρχείο. Θα πρέπει να μπορείτε να δείτε και να ελέγξετε το αρχείο που έχει αλλάξει και να αποφασίσετε τι θέλετε να επιλέξετε. Η επιλογή είναι σημαντική για να πείτε στο git ποιες αλλαγές θέλετε να συσχετίσετε με αυτή την προσθήκη. *Σημείωση: Εάν δεν βλέπετε τη διαφορά του αρχείου, κάντε κλικ στο **Uncommitted Files** (Μη Κοινοποιημένα Αρχεία) στην κορυφή του παραθύρου διαλόγου σας* edit some file(s) Στη συνέχεια, κάντε κλικ στο κουμπί **Commit (Κοινοποίηση)** στην πάνω αριστερή γωνία του παραθύρου. Αυτό θα σας εμφανίσει την περιοχή σας κοινοποίησης. Κάντε κλικ στο *Checkbox* για να **προσθέσετε** το αρχείο στην περιοχή κοινοποίησης. Στη συνέχεια, εισαγάγετε ένα μήνυμα κοινοποίησης. *Σημείωση: Μπορείτε επίσης να επιλέξετε αρχεία (και στις περιοχές κοινοποίησης και μη κοινοποιημένες) και να προσθέσετε/αφαιρέσετε αρχεία από τις αντίστοιχες περιοχές χρησιμοποιώντας το πλήκτρο διαστήματος* stage your changes Αφού προσθέσετε τις αλλαγές σας και προσθέσετε ένα μήνυμα κοινοποίησης, μπορείτε να πατήσετε το κουμπί **Commit (Κοινοποίηση)** για να κάνετε την κοινοποίηση τελικά. Συγχαρητήρια, έχετε κοινοποιήσει όλες τις αλλαγές στο τοπικό αντίγραφο του κλαδιού του πιρουνιού (branch) του fork σας των πρώτων συνεισφορών. Μπράβο! ## Μεταφόρτωση (Push) των αλλαγών στο GitHub Τώρα είστε έτοιμοι να μεταφορτώσετε τις αλλαγές σας στο github. Αυτό θα γίνει μεταφέροντάς το στο δικό σας, το fork, αντίγραφο του έργου. Ακολουθήστε τα βήματα για να μεταφέρετε το πρόγραμμα. Πρώτα, κάντε κλικ στο **Push (Μεταφόρτωση) (1)**, αυτό θα εμφανίσει το παράθυρο απομακρυσμένης/μεταφόρτωσης. **Κάντε κλικ (2)** στο πλαίσιο ελέγχου του κλαδιού που θέλετε να μεταφορτώσετε. Επιλέξτε **OK (3)** και αυτό θα μεταφορτώσει την κοινοποίησή σας στο Github. origin or branch ## Υποβάλετε τις αλλαγές σας για αναθεώρηση Εάν πάτε στο αποθετήριο σας στο github, θα δείτε το κουμπί `Compare & pull request` (Σύγκριση και αίτηση εξαγωγής). Κάντε κλικ σε αυτό το κουμπί. create a pull request Τώρα υποβάλετε την αίτηση εξαγωγής (pull request). submit pull request Σύντομα θα ενσωματώσω όλες τις αλλαγές σας στο κύριο κλαδί (master) αυτού του έργου. Θα λάβετε ένα email ειδοποίησης μόλις οι αλλαγές έχουν ενσωματωθεί. ## Πού να πάτε από εδώ; Συγχαρητήρια! Έχετε μόλις ολοκληρώσει την τυπική ροή _fork -> clone -> edit -> PR_ που θα αντιμετωπίσετε συχνά ως συνεισφέροντας! Γιορτάστε τη συνεισφορά σας και μοιραστείτε τη με τους φίλους σας και τους ακόλουθούς σας μεταβαίνοντας στην [ιστοσελίδα εφαρμογής](https://firstcontributions.github.io/#social-share). ### [Πρόσθετο υλικό](../additional-material/git_workflow_scenarios/additional-material.md) ## Οδηγοί με άλλα εργαλεία [Επιστροφή στην κύρια σελίδα](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Greek/sublime-merge-tutorial.gr.md ================================================ [![Αγάπη για τον Ανοικτό Κώδικα](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![Άδεια: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Βοηθοί Ανοικτού Κώδικα](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Πρώτες Συνεισφορές |Sublime Merge|Sublime Merge Git Client| |---|---| Είναι δύσκολο. Είναι πάντα δύσκολο, όταν κάνετε κάτι για πρώτη φορά. Ειδικά όταν συνεργάζεστε ή δοκιμάζετε κάτι νέο, τα λάθη δεν είναι ένα άνετο πράγμα. Αλλά ο ανοικτός κώδικας αφορά την συνεργασία και την ομαδική εργασία. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο οι νέοι συνεισφέροντες ανοικτού κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά. Η ανάγνωση άρθρων και η παρακολούθηση εκπαιδευτικού υλικού μπορεί να βοηθήσουν, αλλά τι είναι καλύτερο από το να κάνετε πράγματα στην πράξη χωρίς να χαλάσετε τίποτα. Αυτό το έργο στοχεύει στην παροχή καθοδήγησης και στην απλοποίηση του τρόπου με τον οποίο οι νεοσύστατοι συνεισφέροντες κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε ότι όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Αν ψάχνετε για να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε απλά τα απλά βήματα παρακάτω. Σας υποσχόμαστε, θα είναι διασκεδαστικό. ## Sublime Merge Κατεβάστε το [Sublime Merge](https://www.sublimemerge.com/), εγκαταστήστε το και ανοίξτε το. ## Διακλάδωση (Fork) αυτού του αποθετηρίου Κάντε διακλάδωση (fork) αυτού του αποθετηρίου κάνοντας κλικ στο κουμπί διακλάδωσης (fork) στην κορυφή αυτής της σελίδας. fork this repository Αυτό θα δημιουργήσει ένα αντίγραφο αυτού του αποθετηρίου στον λογαριασμό σας.



## Κλωνοποίηση (Clone) του αποθετηρίου clone this repository Στο Sublime Merge, πηγαίνετε στο Αρχείο -> Κλωνοποίηση (Clone) αποθετηρίου. clone this repository Το επόμενο βήμα είναι να κλωνοποιήσετε το αποθετήριο σας στον υπολογιστή σας, ώστε να μπορείτε να αρχίσετε να κάνετε αλλαγές. Το Sublime Merge χρειάζεται το URL του αποθετηρίου σας, οπότε κάντε κλικ στο κουμπί "κλωνοποίηση" και στη συνέχεια κάντε κλικ στο εικονίδιο "αντιγραφή στο πρόχειρο". **ΠΡΟΣΟΧΗ:** Ένα λάθος που συχνά κάνουν οι νέοι συνεισφέροντες είναι να κλωνοποιούν το αποθετήριο από το οποίο έχουν κάνει fork _αντί να κλωνοποιούν το δικό τους αποθετήριο_. Ελέγξτε τη γραμμή διεύθυνσης του προγράμματος περιήγησής σας και βεβαιωθείτε ότι κλωνοποιείτε το δικό σας αποθετήριο. Εισάγετε το URL του αποθετηρίου στο Sublime Merge, δώστε του ένα όνομα αποθετηρίου (ή αφήστε το κενό) και ορίστε τον κατάλογο όπου θα αποθηκευτεί το αποθετήριο. Αφού είστε ικανοποιημένοι με το μονοπάτι, κάντε κλικ στο "Κλωνοποίηση". ## Δημιουργία παρακλαδιού (Branch) Κάντε δεξί κλικ στο Branches -> Δημιουργία Παρακλαδιού ή Πλοηγηθείτε στο Αποθετήριο -> Δημιουργία Παρακλαδιού Δώστε όνομα στο παρακλάδι σας "προσθήκη-του-όνοματός-σας", για παράδειγμα: "προσθήκη-της-Άννας-Σοφίας" name your branch ## Κάντε τις απαραίτητες αλλαγές και κοινοποιήστε τις αλλαγές αυτές Τώρα ανοίξτε το αρχείο `Contributors.md` σε έναν επεξεργαστή κειμένου και προσθέστε το όνομά σας, στη συνέχεια αποθηκεύστε το αρχείο. Εάν έχετε το αποθετήριο ανοιχτό στο Sublime Merge, θα δείτε ότι υπάρχουν αλλαγές. Επιλέξτε την πιο πρόσφατη κοινοποίηση στην κορυφή, που έχει όνομα "x unstaged αρχεία" Ελέγξτε τα αρχεία που έχουν αλλάξει και αποφασίστε ποια θέλετε να κάνετε stage. Δώστε στην κοινοποίηση ένα μήνυμα ("Προσθήκη του <το-όνομά-σας> στη λίστα Συνεισφερόντων" ακούγεται ωραίο και περιγραφικό). Όταν είστε ικανοποιημένοι με τις αλλαγές σας, κοινοποιήστε αυτές τις αλλαγές κάνοντας τες stage αρχείο-αρχείο ή επιλέγοντας "stage all". Το staging είναι σημαντικό για να πείτε στο git ακριβώς ποιες αλλαγές αρχείων θέλετε να συσχετίσετε με αυτήν την κοινοποίηση. stage your changes Εάν αλλάξετε γνώμη, μπορείτε να αφαιρέσετε αυτές τις αλλαγές, ή μπορείτε να τις απορρίψετε εντελώς. ΠΡΟΕΙΔΟΠΟΙΗΣΗ: Όπως υποδηλώνει η λέξη "απόρριψη", αυτή είναι μια καταστροφική λειτουργία. Κάντε αυτό μόνο εάν δεν θέλετε καμία αλλαγή από το οποιοδήποτε αποθετήριο βρίσκεστε. Κάντε κλικ στο κουμπί "Κοινοποίηση" στο επάνω αριστερό μέρος της προκαθορισμένης συνομιλίας. Αυτό θα σας δείξει την περιοχή σας που έχει κοινοποιηθεί. Κάντε κλικ στο *κουτάκι επιλογής* για να **προσθέσετε** το αρχείο στη σκηνή. Στη συνέχεια, εισαγάγετε ένα μήνυμα κοινοποίησης. *Σημείωση: Μπορείτε επίσης να επιλέξετε αρχεία (και στις περιοχές με κοινοποίηση και μη κοινοποίηση) και να προσθέσετε/αφαιρέσετε αρχεία από τις αντίστοιχες περιοχές χρησιμοποιώντας το πλήκτρο διαστήματος.* Αφού προσθέσετε τις αλλαγές σας και προσθέσετε ένα μήνυμα κοινοποίησης, μπορείτε να πατήσετε το κουμπί "Κοινοποίηση" για να κάνετε την τελική κοινοποίηση. Συγχαρητήρια, έχετε κοινοποιήσει όλες τις αλλαγές στo τοπικό αντίγραφο του παρακλαδιού σας του αποθετηρίου που έχετε κάνει fork. Συνεχίζουμε! ## Αποστολή των αλλαγών στο GitHub Τώρα είστε έτοιμοι να στείλετε τις αλλαγές σας στο GitHub. Αυτό θα τις στείλει στο δικό σας, διακλαδωμένο, αντίγραφο του έργου. Πλοηγηθείτε στο Αποθετήριο -> Αποστολή (Push) ή πατήστε το μικρό βέλος προς τα πάνω στη δεξιά πάνω γωνία. login Συνδεθείτε στον λογαριασμό σας στο Github με το όνομα χρήστη και τον κωδικό πρόσβασής σας. Καταθέστε τις αλλαγές στο παρακλάδι origin εάν θέλετε να εμφανίζονται οι αλλαγές στο παρακλάδι master απευθείας, διαφορετικά επιλέξτε το κατάλληλο παρακλάδι που θέλετε να στείλετε. ## Υποβολή των αλλαγών σας για αξιολόγηση Εάν πάτε στο αποθετήριο σας στο Github, θα δείτε το κουμπί `Σύγκριση και αίτηση ενσωμάτωσης` (Compare & pull request). Κάντε κλικ σε αυτό το κουμπί. create a pull request Τώρα υποβάλετε το αίτημα ενσωμάτωσης (pull request). Κάντε κλικ στο κουμπί `Υποβολή αιτήματος ενσωμάτωσης` (Submit pull request). Σύντομα θα ενσωματώσω όλες τις αλλαγές σας στον παρακλάδι master αυτού του έργου. Θα λάβετε ένα email ειδοποίησης μόλις οι αλλαγές έχουν ενσωματωθεί. ## Τι να κάνετε μετά; Συγχαρητήρια! Έχετε μόλις ολοκληρώσει την τυπική ροή εργασίας _fork -> clone -> edit -> PR_ που θα συναντήσετε συχνά ως συνεισφέρων! Γιορτάστε τη συνεισφορά σας και μοιραστείτε τη με τους φίλους και τους ακόλουθούς σας, πηγαίνοντας στην [ιστοσελίδα εφαρμογής](https://firstcontributions.github.io#social-share). ### [Επιπλέον υλικό](../additional-material/git_workflow_senarios/additional-material.md) ## Εκπαιδευτικό υλικό για Άλλα Εργαλεία [Επιστροφή στην κύρια σελίδα](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Hebrew/github-desktop-tutorial-heb.md ================================================
[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # תרומות ראשונות (First Contributions) | GitHub Desktop | מהדורת GitHub Desktop | | ---------------------------------------------------------------------------------------------- | --------------------- | זה קשה. זה תמיד קשה בפעם הראשונה שעושים משהו. במיוחד כאשר אתם משתפים פעולה, טעויות אינן דבר נוח. אבל קוד פתוח (Open Source) הוא כולו שיתוף פעולה ועבודה ביחד. רצינו לפשט את הדרך שבה תורמים חדשים לקוד פתוח לומדים ותורמים בפעם הראשונה שלהם. קריאה של מאמרים וצפייה במדריכים יכולים לעזור, אבל מה יכול להיות טוב יותר מאשר באמת לבצע את הדברים מבלי להרוס שום דבר. מטרת הפרויקט היא לספק הכוונה ולפשט את הדרך שבה מתחילים מבצעים את התרומה הראשונה שלהם. זכרו, ככל שתהיו רגועים יותר, כך תלמדו טוב יותר. אם אתם מעוניינים לבצע את התרומה הראשונה שלכם, פשוט עקבו אחרי השלבים הבאים. אנו מבטיחים שזה יהיה מהנה. אם GitHub Desktop אינו מותקן אצלכם במחשב, [התקינו אותו](https://desktop.github.com/). אם אתם משתמשים בגרסה של GitHub Desktop מלפני 1.0, [עיינו במדריך הזה](github-desktop-old-version-tutorial.md). fork this repository ## בצעו Fork למאגר זה בצעו Fork למאגר זה על ידי לחיצה על כפתור ה-fork בחלק העליון הימני של הדף. פעולה זו תיצור עותק של המאגר תחת החשבון שלכם. ## שכפלו (Clone) את המאגר כעת שכפלו את המאגר למחשב שלכם. **חשוב: אין לשכפל (Clone) את המאגר המקורי. גשו ל-Fork שלכם ושכפלו אותו.** כדי לשכפל, לחצו על "Code" ולאחר מכן על "Open in Github Desktop". clone this repository ייפתח חלון קופץ. לחצו על "Open GitHubDesktop.exe". clone this repository לאחר הלחיצה על "Open GitHubDesktop.exe", יופיע חלון 'Clone a repository'. לחצו על 'Clone'. clone this repository לאחר מכן יופיע חלון נוסף: 'How are you planning to use this fork?' בחרו: **To contribute to the parent project** ולחצו על **Continue**. Use of repository כעת העתקתם את תוכן מאגר first-contributions למחשב שלכם. ## יצירת Branch כעת צרו Branch על ידי לחיצה על האייקון **Current branch** למעלה, ואז לחצו על **New branch**: make a branch קראו ל-branch שלכם בשם ``. לדוגמה: `add-james-smith` name your branch לחצו על `Create branch`. ## בצעו את השינויים הנדרשים ו-Commit לשינויים כעת, עברו ללשונית History ופתחו את הקובץ `Contributors.md` בעורך טקסט על ידי קליק ימני ו-Open in text editor. גללו לתחתית הדף, הוסיפו את שמכם, ושמרו את הקובץ. דוגמה: אם שמכם הוא James Smith, זה אמור להיראות כך: ``` [James Smith](https://github.com/jamessmith) ``` תוכלו לראות שהשינויים בקובץ Contributors.md נוספו ל-GitHub Desktop. check status כעת בצעו Commit לשינויים: בשדה ה-summary כתבו: ``` Add to Contributors list ``` החליפו את `` בשמכם. לחצו על הכפתור `Commit to add-your-name`. commit your changes בתחתית תוכלו לראות שה-commit נוצר. commit your changes ## דחיפת השינויים ל-GitHub לחצו על File -> Options והתחברו ל-Github.com. הזינו את שם המשתמש והסיסמה שלכם. log-in to Github לחצו על כפתור `Publish` בפינה השמאלית העליונה. push your changes ## הגשת השינויים לבדיקה אם תיכנסו למאגר שלכם ב-GitHub, תראו את הכפתור `Compare & pull request`. לחצו עליו. create a pull request כעת הגישו את ה-pull request. submit pull request בקרוב אמזג את השינויים שלכם ל-branch הראשי של הפרויקט. תקבלו התראה במייל לאחר המיזוג. ## לאן ממשיכים מכאן? כל הכבוד! השלמתם את תהליך העבודה הסטנדרטי של: _fork -> clone -> edit -> PR_ תהליך שבו תיתקלו פעמים רבות כתורמים! חגגו את התרומה שלכם ושתפו אותה עם חברים ועוקבים דרך [אפליקציית ה-Web](https://firstcontributions.github.io#social-share). ### [חומר נוסף](../additional-material/git_workflow_scenarios/additional-material.md) ## מדריכים לשימוש בכלים נוספים [חזרה לדף הראשי](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
================================================ FILE: docs/gui-tool-tutorials/translations/Hindi/github-windows-vs-code-tutorial-hi.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/CodeWithAjaySaini) # First Contributions | Visual Studio Code | Visual Studio Code | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | यह मुश्किल है। पहली बार जब आप कुछ करते हैं तो यह हमेशा कठिन होता है। खासकर जब आप सहयोग कर रहे हों, तो गलतियाँ करना सहज बात नहीं है। लेकिन ओपन सोर्स सहयोग और एक साथ काम करने के बारे में है। हम नए ओपन-सोर्स योगदानकर्ताओं के पहली बार सीखने और योगदान करने के तरीके को सरल बनाना चाहते थे। लेख पढ़ना और ट्यूटोरियल देखना मदद कर सकता है, लेकिन वास्तव में कुछ भी गड़बड़ किए बिना सामान करने से बेहतर क्या हो सकता है। इस परियोजना का उद्देश्य मार्गदर्शन प्रदान करना और धोखेबाज़ों द्वारा अपना पहला योगदान देने के तरीके को सरल बनाना है। याद रखें कि आप जितने अधिक आराम से होंगे, आप उतना ही बेहतर सीखेंगे। यदि आप अपना पहला योगदान करना चाहते हैं, तो बस नीचे दिए गए सरल चरणों का पालन करें। हम आपसे वादा करते हैं, यह मजेदार होगा। यदि आपकी मशीन पर विजुअल स्टूडियो कोड नहीं है, [install it](https://code.visualstudio.com/download). **सूचना:** यह ट्यूटोरियल विंडोज 10 मशीन पर विजुअल स्टूडियो कोड (संस्करण 1.27.2) का उपयोग करके बनाया गया था। बाद में इस ट्यूटोरियल में हम कुछ कीबोर्ड शॉर्टकट का उपयोग करेंगे। ये अन्य ऑपरेटिंग सिस्टम (मैकोज़/लिनक्स) के साथ-साथ कीबोर्ड भाषा (यूके, डीई, आदि) पर भिन्न हो सकते हैं। आप कमांड पैलेट में "शॉर्टकट" खोजकर अपने शॉर्टकट की सूची देख सकते हैं। ## इस भंडार को फोर्क करें fork this repository इस रेपो को फोर्क करने के लिए इस पेज के ऊपर दाईं ओर फोर्क बटन पर क्लिक करें। यह आपके GitHub खाते में इस रिपॉजिटरी की एक प्रति बनाएगा। गिटहब आपके रेपो और उस रेपो के बीच संबंधों का ट्रैक रखता है जिसे आपने इसे फोर्क किया है। आप अपने रेपो को एक कार्यशील प्रति के रूप में सोच सकते हैं। अधिकांश शीर्ष-स्तरीय गिटहब रेपो (यानी किसी अन्य रेपो से फोर्क नहीं किए गए) में लोगों की एक छोटी सी कोर टीम होती है जो सीधे बदलाव कर सकती है। अन्य सभी योगदानकर्ताओं को रेपो को फोर्क करना होगा और फोर्क में परिवर्तन करना होगा, फिर एक पुल अनुरोध बनाना होगा ताकि उनके परिवर्तनों को शीर्ष-स्तरीय रेपो में वापस विलय करने के लिए कहा जा सके। यदि शीर्ष-स्तरीय रेपो व्यवस्थापक परिवर्तनों को पसंद करता है तो उन्हें विलय कर दिया जाएगा और आपको तुरंत प्रसिद्धि और भाग्य प्राप्त होगा! इसे बाद में कैसे करें, इसके बारे में अधिक। ## अपने भंडार को क्लोन करें clone this repository अगला कदम अपने रेपो को अपनी मशीन पर क्लोन करना है ताकि आप बदलाव करना शुरू कर सकें। वीएस कोड को आपके रेपो के यूआरएल की जरूरत है, इसलिए "क्लोन" बटन पर क्लिक करें और फिर "क्लिपबोर्ड पर कॉपी करें" आइकन पर क्लिक करें। **सावधान:** एक गलती जो नए योगदानकर्ता अक्सर करते हैं, वह है रेपो का क्लोन बनाना जो आपने अपने रेपो को क्लोन करने के बजाय _from_ को फोर्क किया था। अपने ब्राउज़र के एड्रेस बार की जाँच करें और सुनिश्चित करें कि आप अपने रेपो की क्लोनिंग कर रहे हैं। अब विजुअल स्टूडियो कोड खोलें। वीएस कोड का वेलकम पेज खुल जाएगा। वहां से नीचे दिखाए गए बार को खोलने के लिए `F1` दबाएं। ध्यान दें कि टेक्स्ट फ़ील्ड में पहले से ही एक `>` (इससे बड़ा) चिन्ह है। आप `CTRL-P` दबाकर इनपुट प्रॉम्प्ट पर भी जा सकते हैं और फिर `>` वर्ण टाइप कर सकते हैं। Clone Popup (Command Popup) आप देख सकते हैं कि नीचे सूचीबद्ध कुछ अस्पष्ट आदेश पहले से ही हैं। वे मेरे हाल ही में उपयोग किए गए आदेश हैं। तो बस उनकी परवाह मत करो। Clone repo अब 'गिट क्लोन' टाइप करें, केवल 'गिट' या 'क्लोन' (यह एक खोज की तरह काम करता है)। प्रविष्टि `गिट: क्लोन` का चयन करें और `एंटर` दबाएं Paste Repository URL in अपनी रिपॉजिटरी का URL पेस्ट करें और `Enter` दबाएं। यह एक फ़ाइल एक्सप्लोरर खोलेगा जहाँ आप तब चुन सकते हैं जहाँ Git रिपॉजिटरी को संग्रहीत किया जाना चाहिए। **महत्वपूर्ण**: सुनिश्चित करें कि यह फोर्कड रिपोजिटरी है और मूल नहीं है, अन्यथा यह काम नहीं करेगा। Status popup आपको विजुअल स्टूडियो कोड के नीचे दाईं ओर एक स्टेटस पॉपअप देखना चाहिए। इसके समाप्त होने के बाद, आप संवाद में बटनों का उपयोग करके क्लोन रिपॉजिटरी (अब आपकी मशीन पर एक फ़ोल्डर) खोल सकते हैं। ## एक शाखा बनाएं `F1` दबाकर फिर से कमांड पैलेट खोलें। `शाखा` टाइप करें और वहां से `शाखा बनाएं` कमांड चुनें। अगले चरण में अपनी नई शाखा का नाम टाइप करें, उदाहरण के लिए `ऐड-डेविड-क्रोल`। एंटर दबाएं और ब्रांच बन जाएगी. The branch is also already checked out. [What does checkout mean?](https://www.git-scm.com/docs/git-checkout) Branches Command Palette ## आवश्यक परिवर्तन करें `Contributors.md` खोलें और फ़ाइल में कहीं भी अपना नाम जोड़ें। इस फ़ाइल में GFM (GitHub Flavored Markdown) है जो markdown सिंटैक्स का मालिकाना स्वाद है। अन्य योगदानकर्ताओं में से एक की प्रतिलिपि बनाएँ' लाइनों और इसे अपने नाम के साथ संशोधित करें यह सुनिश्चित करने के लिए कि आपको सिंटैक्स सही मिलता है - यह पिक्य हो सकता है। Add your name ## गिटहब में बदलाव करें और पुश करें वीएस कोड के बाईं ओर एक मेनू है जिसमें 5 आइकन प्रदर्शित होते हैं। संस्करण नियंत्रण/स्रोत नियंत्रण चिह्न का चयन करें। (शॉर्टकट : Ctrl + Shift + G) Commit changes फ़ाइल एक्सप्लोरर उन सभी फाइलों को प्रदर्शित करता है जिन्हें अंतिम प्रतिबद्धता के बाद बदल दिया गया था। फाइलों को मँडराकर और `+` (प्लस) पर क्लिक करके फाइलों का मंचन किया जाता है। Stashed Files एक्सप्लोरर के ऊपर लाइन में कुछ टाइप करें और चेकमार्क दबाएं। परिवर्तन अब आपकी स्थानीय प्रति के लिए प्रतिबद्ध हैं। अब परिवर्तनों को वापस GitHub पर धकेलना होगा। Stashed Files मेनू खोलने के लिए थ्री-डॉट आइकन का उपयोग करें जहां आप `पब्लिश ब्रांच` विकल्प का चयन करते हैं। यह आपके GitHub क्रेडेंशियल्स को डालने के लिए एक डायलॉग खोलना चाहिए। स्टैश की गई फ़ाइलें ## समीक्षा के लिए अपने परिवर्तन सबमिट करें इस बिंदु पर आपने अपना परिवर्तन पूरा कर लिया है लेकिन यह अभी भी केवल आपके रेपो में रहता है। यह चरण आपको दिखाएगा कि अपने परिवर्तन को मर्ज करने के लिए शीर्ष-स्तरीय रेपो के व्यवस्थापक को अनुरोध कैसे सबमिट करें। गिटहब पर अपने रेपो में आपको नई शाखा अधिसूचना के बगल में `तुलना और पुल अनुरोध` बटन दिखाई देगा। उस बटन पर क्लिक करें। एक पुल अनुरोध बनाएं अब पुल रिक्वेस्ट सबमिट करें। पुल अनुरोध सबमिट करें जल्द ही मैं आपके सभी परिवर्तनों को इस परियोजना की मास्टर शाखा में मिला दूंगा। परिवर्तनों को मर्ज कर दिए जाने के बाद आपको एक सूचना ईमेल प्राप्त होगी। ## यहाँ से कहाँ जाएं? बधाई! आपने अभी-अभी मानक _fork -> क्लोन -> संपादित करें -> PR_ वर्कफ़्लो पूरा किया है जिसका आप अक्सर एक योगदानकर्ता के रूप में सामना करेंगे! अपने योगदान का जश्न मनाएं और [वेब ऐप](https://firstcontributions.github.io#social-share) पर जाकर इसे अपने दोस्तों और अनुयायियों के साथ साझा करें। यदि आपको किसी सहायता की आवश्यकता हो या कोई प्रश्न पूछना हो तो आप हमारी सुस्त टीम में शामिल हो सकते हैं। [स्लैक टीम में शामिल हों](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)। ### [अतिरिक्त सामग्री](../additional-material/git_workflow_scenarios/additional-material.md) ## अन्य टूल्स का उपयोग करने वाले ट्यूटोरियल [मुख्य पृष्ठ पर वापस जाएं](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Hindi/sublime-merge-tutorial.hi.md ================================================ [![ओपन सोर्स को प्यार](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![लाइसेंस: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![ओपन सोर्स हेल्पर्स](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions |Sublime Merge|Sublime Merge Git क्लाइंट| |---|---| यह मुश्किल है। पहली बार कुछ करते समय यह हमेशा मुश्किल होता है। खासकर जब आप सहयोग कर रहे हों या कुछ नया आजमा रहे हों, गलतियाँ करना आसान नहीं होता। लेकिन ओपन सोर्स सहयोग और टीमवर्क के बारे में है। हमने नए ओपन सोर्स योगदानकर्ताओं के लिए पहली बार सीखने और योगदान करने की प्रक्रिया को आसान बनाना चाहा। लेख पढ़ने और ट्यूटोरियल देखने से मदद मिल सकती है, लेकिन बिना कुछ गड़बड़ किए वास्तव में चीजें करने से बेहतर और क्या हो सकता है? यह प्रोजेक्ट मार्गदर्शन प्रदान करने और नए योगदानकर्ताओं की पहली योगदान प्रक्रिया को सरल बनाने का लक्ष्य रखता है। याद रखें, जितने अधिक रिलैक्स्ड आप होंगे, उतना ही बेहतर आप सीखेंगे। यदि आप अपना पहला योगदान देना चाहते हैं, तो बस नीचे दिए गए सरल चरणों का पालन करें। हम वादा करते हैं, यह मजेदार होगा। ## Sublime Merge [Sublime Merge](https://www.sublimemerge.com/) डाउनलोड करें, इंस्टॉल करें और खोलें। ## इस रिपॉजिटरी को फोर्क करें इस पेज के ऊपर दिए गए फोर्क बटन पर क्लिक करके इस रिपॉजिटरी को फोर्क करें। fork this repository यह आपके अकाउंट में इस रिपॉजिटरी की एक कॉपी बना देगा।



## रिपॉजिटरी को क्लोन करें clone this repository Sublime Merge में, फाइल -> क्लोन रिपॉजिटरी पर जाएं। clone this repository अगला चरण आपकी रिपॉजिटरी को अपने कंप्यूटर पर क्लोन करना है ताकि आप बदलाव करना शुरू कर सकें। Sublime Merge को आपकी रिपॉजिटरी का URL चाहिए, इसलिए "क्लोन" बटन पर क्लिक करें और फिर "क्लिपबोर्ड पर कॉपी" आइकन पर क्लिक करें। **ध्यान दें:** नए योगदानकर्ता अक्सर गलती से मूल रिपॉजिटरी को क्लोन कर लेते हैं _बजाय अपनी खुद की फोर्क की गई रिपॉजिटरी के_। अपने ब्राउज़र की एड्रेस बार चेक करें और सुनिश्चित करें कि आप अपनी खुद की रिपॉजिटरी क्लोन कर रहे हैं। Sublime Merge में रिपॉजिटरी का URL पेस्ट करें, उसे एक रिपॉजिटरी नाम दें (या खाली छोड़ दें) और वह डायरेक्टरी सेट करें जहां रिपॉजिटरी सेव होगी। पाथ से संतुष्ट होने के बाद, "क्लोन" पर क्लिक करें। ## ब्रांच बनाएं Branches पर राइट-क्लिक करें -> नई ब्रांच बनाएं या रिपॉजिटरी -> नई ब्रांच पर जाएं अपनी ब्रांच को "add-your-name" जैसा नाम दें, उदाहरण के लिए: "add-अन्ना-सोफिया" name your branch ## आवश्यक बदलाव करें और उन्हें कमिट करें अब `Contributors.md` फाइल को टेक्स्ट एडिटर में खोलें और अपना नाम जोड़ें, फिर फाइल सेव करें। अगर आपकी रिपॉजिटरी Sublime Merge में खुली है, तो आप देखेंगे कि कुछ बदलाव हुए हैं। सबसे ऊपर "x unstaged files" नाम की लेटेस्ट कमिट को चुनें जिन फाइल्स में बदलाव हुए हैं उन्हें चेक करें और तय करें कि किन्हें स्टेज करना है। कमिट को एक मैसेज दें ("योगदानकर्ताओं की सूची में <आपका-नाम> जोड़ें" अच्छा और डिस्क्रिप्टिव लगता है)। जब आप अपने बदलावों से संतुष्ट हों, तो फाइल-बाय-फाइल या "stage all" चुनकर इन बदलावों को स्टेज करके कमिट करें। स्टेजिंग महत्वपूर्ण है ताकि git को पता चले कि इस कमिट से किन फाइल बदलावों को जोड़ना है। stage your changes अगर आप अपना मन बदलते हैं, तो आप इन बदलावों को अनस्टेज कर सकते हैं, या पूरी तरह से डिस्कार्ड भी कर सकते हैं। चेतावनी: जैसा कि "डिस्कार्ड" शब्द से पता चलता है, यह एक डिस्ट्रक्टिव ऑपरेशन है। ऐसा केवल तब करें जब आप वर्तमान रिपॉजिटरी से कोई भी बदलाव नहीं रखना चाहते। ऊपर बाईं ओर दिए गए "कमिट" बटन पर क्लिक करें। यह आपको आपके स्टेज्ड एरिया को दिखाएगा। *चेकबॉक्स* पर क्लिक करके फाइल को **स्टेज** करें। फिर एक कमिट मैसेज दर्ज करें। *नोट: आप स्टेज्ड और अनस्टेज्ड दोनों एरिया से फाइल्स (और हंक्स) चुन सकते हैं और स्पेस बार का उपयोग करके उन्हें संबंधित एरिया में एड/रिमूव कर सकते हैं।* एक बार जब आप अपने बदलावों को स्टेज कर लेते हैं और कमिट मैसेज जोड़ देते हैं, तो आप फाइनल कमिट करने के लिए "कमिट" बटन दबा सकते हैं। बधाई हो, आपने अपने फोर्क किए गए रिपॉजिटरी के अपनी ब्रांच के लोकल कॉपी में सभी बदलावों को कमिट कर दिया है। चलिए आगे बढ़ते हैं! ## GitHub पर बदलाव पुश करें अब आप अपने बदलावों को GitHub पर पुश करने के लिए तैयार हैं। यह आपके फोर्क किए गए प्रोजेक्ट कॉपी में बदलाव भेजेगा। रिपॉजिटरी -> पुश पर जाएं या ऊपर दाईं ओर छोटे अप ऐरो पर क्लिक करें। login अपने Github अकाउंट में यूजरनेम और पासवर्ड से लॉगिन करें। अगर आप चाहते हैं कि बदलाव सीधे मास्टर ब्रांच पर दिखें तो origin ब्रांच में बदलाव पुश करें, अन्यथा उस ब्रांच को चुनें जिसमें आप पुश करना चाहते हैं। ## समीक्षा के लिए अपने बदलाव सबमिट करें अगर आप GitHub पर अपनी रिपॉजिटरी पर जाएंगे, तो आपको `तुलना करें और पुल रिक्वेस्ट करें` बटन दिखेगा। इस बटन पर क्लिक करें। create a pull request अब पुल रिक्वेस्ट सबमिट करें। `पुल रिक्वेस्ट सबमिट करें` बटन पर क्लिक करें। जल्द ही मैं इस प्रोजेक्ट की मास्टर ब्रांच में आपके सभी बदलावों को मर्ज कर दूंगा। एक बार बदलाव मर्ज हो जाने पर आपको एक ईमेल नोटिफिकेशन मिलेगा। ## आगे क्या करें? बधाई हो! आपने अभी-अभी स्टैंडर्ड _फोर्क -> क्लोन -> एडिट -> PR_ वर्कफ्लो पूरा किया है जो आपको अक्सर योगदानकर्ता के रूप में देखने को मिलेगा! अपने योगदान का जश्न मनाएं और इसे अपने दोस्तों और फॉलोअर्स के साथ [वेब ऐप](https://firstcontributions.github.io#social-share) पर शेयर करें। अगर आपको मदद चाहिए या कोई सवाल है तो आप हमारी स्लैक टीम में जॉइन कर सकते हैं। [स्लैक टीम में जॉइन करें](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)। ### [अतिरिक्त सामग्री](../additional-material/git_workflow_senarios/additional-material.md) ## अन्य टूल्स के लिए ट्यूटोरियल [मुख्य पेज पर वापस जाएं](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Indonesian/github-windows-vs-code-tutorial_id.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Kontribusi Pertama | Visual Studio Code | Visual Studio Code | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | Sulit. Memang selalu sulit melakukan sesuatu untuk pertama kali. Khususnya ketika kamu berkolaborasi, membuat sebuah masalah bukanlah hal yang mengenakkan. Tetapi proyek terbuka berarti kolaborasi dan kerjasama. Kami ingin menyederhanakan cara belajar bagi kontributor dan cara berkontribusi untuk pertama kali. Membaca artikel & menonton tutorial bisa membantu, tetapi lebih baik praktek langsung tanpa membuat masalah apapun pada proyek. Laman ini bertujuan untuk memberikan panduan & menyederhanakan cara bagi pemula untuk membuat kontribusi pertama. Ingat semakin santai kamu, maka semakin baik kamu belajar. Jika kamu ingin membuat kontribusi pertama, cukup ikuti langkah-langkah sederhana di bawah ini. Kami janji, ini akan menyenangkan kok. Jika kamu belum punya Visual Studio Code pada perangkat mu, [install disini](https://code.visualstudio.com/download). **Perlu Diingat:** Tutorial ini dibuat menggunakan Visual Studio Code (Versi 1.27.2) pada Windows 10. Nanti dalam tutorial ini kita akan menggunakan beberapa shortcut keyboard. Ini mungkin berbeda pada sistem operasi lain (macOS/Linux) serta bahasa keyboard (UK, DE, dll). Kamu dapat menelusuri daftar pintasan mu dengan mencari "shortcut" di Palet Perintah. ## Fork repositori ini fork this repository Fork repo ini dengan mengklik tombol fork di kanan atas halaman ini. Ini akan membuat salinan repositori ini di akun GitHub Anda. GitHub selalu menjaga repo mu dan sumber repo yang sudah kamu fork supaya tetap pada jalurnya. Kamu bisa menganggap repo mu sebagai salinan pekerjaan. Sebagian besar repo GitHub tingkat atas (yaitu yang tidak di-copy dari repo lain mana pun) mempunyai tim inti yang terdiri dari orang-orang yang dapat langsung melakukan perubahan. Semua kontributor lain harus melakukan fork repo dan membuat perubahan pada fork, lalu membuat Pull Request untuk meminta perubahan mereka digabungkan kembali ke repo tingkat atas. Jika administrator repo tingkat atas menyukai perubahan, mereka akan menggabungkan perubahan mu dan kamu bisa mendapatkan reputasi dan nasib baik! Lebih lanjut tentang cara melakukannya akan dibahas nanti. ## Klon Repositori mu clone this repository Langkah selanjutnya adalah mengkloning repo mu ke perangkat mu sehingga bisa segera mulai membuat perubahan. VS Code membutuhkan URL repo mu agar terhubung, jadi klik tombol "clone" dan kemudian klik ikon "copy to clipboard". **HATI-HATI:** Satu kesalahan yang sering dilakukan oleh kontributor baru adalah mengkloning repo utama yang kamu fork _sumbernya_ daripada mengkloning repo mu sendiri. Periksa alamat browser mu dan pastikan kamu mengkloning repo mu sendiri. Sekarang buka Visual Studio Code. Halaman selamat datang dari VS Code akan muncul. Dari sana tekan `F1` untuk membuka bar yang ditunjukkan di bawah ini. Perhatikan bahwa sudah ada tanda `>` (lebih besar dari) di kolom teks. Anda juga dapat membuka input prompt dengan menekan `CTRL-P` lalu ketik `>`. Clone Popup (Command Popup) Anda mungkin memperhatikan bahwa sudah ada beberapa perintah tidak jelas yang tercantum di bawah ini. Itu adalah perintah yang digunakan baru-baru ini. Jadi, hiraukan saja. Clone repo Sekarang ketik `git clone`, hanya `git` atau `clone` (berfungsi seperti melakukan pencarian). Pilih Entri `Git: Clone` dan tekan `Enter` Paste Repository URL in Tempelkan URL repositori kamu dan tekan `Enter`. Ini akan membuka File Explorer di mana kamu dapat memilih di mana repositori Git harus disimpan **Penting**: Pastikan itu adalah repositori yang kamu fork dan bukan yang asli, jika tidak maka tidak akan berfungsi Status popup Kamu akan melihat status popup di kanan bawah Visual Studio Code. Setelah selesai, kamu dapat membuka repositori kloning (di folder yang sudah kamu pilih) menggunakan tombol di dialog. ## Membuat Cabang (Branch) Buka kembali palet perintah dengan menekan `F1`. Ketik `branch` dan pilih perintah `create branch` dari sana. Pada langkah berikutnya ketik nama cabang baru kamu, misalnya `add-david-kroell`. Tekan enter dan cabang akan dibuat. Cabang juga sudah siap dipakai. [Apa artinya checkout?](https://www.git-scm.com/docs/git-checkout) Branches Command Palette ## Buat Perubahan yang diperlukan Buka `Contributors.md` dan tambahkan nama kamu di mana saja di file. File ini berisi GFM (GitHub Flavoured Markdown) yang merupakan ciri khas sintaks markdown. Salin salah satu kontributor lain' baris dan modifikasi dengan nama mu untuk memastikan kamu menggunakan sintaks yang benar - itu bisa pilih-pilih Add your name ## Commit & Push perubahan ke GitHub Di sisi kiri VS Code adalah menu dengan 5 ikon yang ditampilkan. Pilih ikon versi kontrol/Sumber Kontrol. (Pintasan: Ctrl + Shift + G) Commit changes File explorer menampilkan semua file yang diubah setelah komit terakhir. Dengan mengarahkan penunjuk pada file dan mengklik `+` (plus) file akan disiapkan. Stashed Files Ketik sesuatu pada baris di atas explorer dan tekan tanda centang. Perubahan telah tersimpan pada salinan lokal kamu. Sekarang perubahan harus di _push_ kembali ke GitHub. Stashed Files Gunakan ikon titik tiga untuk membuka menu tempat kamu akan memilih opsi `Publish Branch`. Ini akan membuka dialog untuk memasukkan kredensial GitHub kamu. Stashed Files ## Submit perubahan mu untuk diperiksa Dititik ini kamu telah menyelesaikan perubahan mu tetapi masih berada di repo mu sendiri. Langkah ini akan menunjukkan bagaimana cara mengirimkan permintaan ke administrator repo tingkat atas untuk menggabungkan perubahan Pada repo mu di GitHub, kamu akan melihat tombol `Compare & pull request` di sebelah pemberitahuan cabang baru. Klik tombol itu. create a pull request Sekarang kirimkan permintaan _pull_. submit pull request Segera saya akan menggabungkan semua perubahan mu ke dalam cabang utama proyek ini. Kamu akan mendapatkan email pemberitahuan setelah perubahan digabungkan. ## Kemana lagi setelah ini? Selamat! kamu baru saja menyelesaikan alur kerja _fork -> clone -> edit -> PR_ standar yang akan sering kamu temui sebagai kontributor! Rayakan kontribusi mu dan bagikan dengan teman dan pengikut kamu dengan membuka [web app](https://firstcontributions.github.io#social-share). Kamu dapat bergabung dengan tim slack kami jika memerlukan bantuan atau memiliki pertanyaan. [Bergabung dengan tim Slack](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY). ### [ Materi tambahan ](../../additional-material/translations/additional-material.id.md) ## Tutorial menggunakan Alat lain [Kembali ke halaman utama](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Marathi/github-windows-vs-code-tutorial-hi.md ================================================ [![मुक्त स्रोत प्रेम](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/CodeWithAjaySaini) #प्रथम योगदान , Visual Studio Code | व्हिज्युअल स्टुडिओ कोड | , , , हे अवघड आहे. तुम्ही पहिल्यांदा काहीतरी करता ते नेहमीच कठीण असते. विशेषत: तुम्ही सहयोग करत असताना, चुका करणे सोपे नसते. पण ओपन सोर्स हे सहकार्य आणि एकत्र काम करण्याबद्दल आहे. आम्हाला नवीन मुक्त-स्रोत योगदानकर्त्यांसाठी प्रथमच शिकण्याचा आणि योगदान देण्याचा मार्ग सोपा करायचा होता. लेख वाचणे आणि ट्यूटोरियल पाहणे मदत करू शकते, परंतु काहीही गोंधळ न करता प्रत्यक्षात सामग्री करण्यापेक्षा काय चांगले आहे. या प्रकल्पाचे उद्दिष्ट मार्गदर्शन प्रदान करणे आणि धोकेबाजांना त्यांचे प्रथम योगदान देण्यासाठी मार्ग सुलभ करणे आहे. लक्षात ठेवा की तुम्ही जितके निवांत राहाल तितके चांगले शिकाल. तुम्हाला तुमचे पहिले योगदान करायचे असल्यास, फक्त खालील सोप्या चरणांचे अनुसरण करा. आम्ही तुम्हाला वचन देतो, ते मजेदार असेल. तुमच्या मशीनवर व्हिज्युअल स्टुडिओ कोड नसल्यास, [तो स्थापित करा](https://code.visualstudio.com/download). **टीप:** हे ट्यूटोरियल Windows 10 मशीनवर व्हिज्युअल स्टुडिओ कोड (आवृत्ती 1.27.2) वापरून तयार केले गेले आहे. नंतर या ट्युटोरियलमध्ये आपण काही कीबोर्ड शॉर्टकट वापरू. हे इतर ऑपरेटिंग सिस्टीम (MacOS/Linux) तसेच कीबोर्ड भाषा (UK, DE, इ.) वर बदलू शकतात. कमांड पॅलेटमध्ये "शॉर्टकट" शोधून तुम्ही तुमच्या शॉर्टकटची यादी पाहू शकता. ##या भांडाराचा फोर्क करा fork this repository हा रेपो फोर्क करण्यासाठी, या पृष्ठाच्या वरच्या उजव्या बाजूला असलेल्या फोर्क बटणावर क्लिक करा. हे तुमच्या GitHub खात्यामध्ये या भांडाराची एक प्रत तयार करेल. GitHub तुमचा रेपो आणि तुम्ही ज्या रेपो मधून फॉर्क केले आहे त्यामधील संबंधांचा मागोवा ठेवतो. तुम्ही तुमच्या रेपोचा एक कार्यरत प्रत म्हणून विचार करू शकता. बर्‍याच उच्च-स्तरीय GitHub रेपोमध्ये (म्हणजे दुसर्‍या रेपोमधून काटे काढलेले नाहीत) लोकांची एक लहान कोर टीम असते जी थेट बदल करू शकतात. इतर सर्व योगदानकर्त्यांनी रेपो फोर्क करणे आवश्यक आहे आणि फोर्कमध्ये बदल करणे आवश्यक आहे, त्यानंतर त्यांच्या बदलांना पुन्हा उच्च-स्तरीय रेपोमध्ये विलीन करण्याची विनंती करणारी पुल विनंती तयार करणे आवश्यक आहे. जर उच्च-स्तरीय रेपो प्रशासकाला बदल आवडले तर ते विलीन केले जातील आणि तुम्हाला झटपट प्रसिद्धी आणि नशीब मिळेल! हे कसे करायचे ते नंतर अधिक. ## तुमचा रेपॉजिटरी क्लोन करा हे भांडार क्लोन करा पुढील पायरी म्हणजे तुमचा रेपो तुमच्या मशीनवर क्लोन करणे म्हणजे तुम्ही बदल करणे सुरू करू शकता. VS कोडला तुमच्या रेपोच्या URL ची आवश्यकता आहे, म्हणून "क्लोन" बटणावर क्लिक करा आणि नंतर "क्लिपबोर्डवर कॉपी करा" चिन्हावर क्लिक करा. **सावधगिरी:** नवीन योगदानकर्ते अनेकदा आपल्या स्वतःच्या रेपोचे क्लोनिंग करण्याऐवजी तुम्ही _from_ फोर्क केलेले रेपो क्लोन करणे ही चूक करतात. तुमच्या ब्राउझरचा अॅड्रेस बार तपासा आणि तुम्ही तुमचा रेपो क्लोन करत असल्याची खात्री करा. आता व्हिज्युअल स्टुडिओ कोड उघडा. व्हीएस कोडचे स्वागत पृष्ठ उघडेल. तेथून खाली दाखवलेला बार उघडण्यासाठी `F1` दाबा. लक्षात ठेवा मजकूर फील्डमध्ये आधीपासूनच `>` (त्यापेक्षा मोठे) चिन्ह आहे. तुम्ही `CTRL-P` दाबून इनपुट प्रॉम्प्टवर देखील जाऊ शकता आणि नंतर `>` अक्षर टाइप करू शकता. क्लोन पॉपअप (कमांड) पॉपअप) तुमच्या लक्षात येईल की खाली सूचीबद्ध केलेल्या काही अस्पष्ट आज्ञा आहेत. त्या माझ्या अलीकडे वापरलेल्या कमांड्स आहेत. त्यामुळे फक्त त्यांची काळजी करू नका. क्लोन रेपो आता 'गिट क्लोन' टाइप करा, फक्त 'गिट' किंवा 'क्लोन' (हे शोधासारखे कार्य करते). एंट्री `git:clone` निवडा आणि `Enter` दाबा मध्ये भांडार URL पेस्ट करा तुमच्या भांडाराची URL पेस्ट करा आणि 'एंटर' दाबा. हे एक फाईल एक्सप्लोरर उघडेल जिथे तुम्ही गिट रेपॉजिटरी कुठे संग्रहित करावी हे निवडू शकता. **महत्त्वाचे**: ते फोर्क केलेले भांडार आहे आणि मूळ नाही याची खात्री करा, अन्यथा ते कार्य करणार नाही. स्थिती पॉपअप तुम्हाला व्हिज्युअल स्टुडिओ कोडच्या तळाशी उजवीकडे स्टेटस पॉपअप दिसेल. ते पूर्ण झाल्यानंतर, तुम्ही डायलॉगमधील बटणे वापरून क्लोन केलेले भांडार (आता तुमच्या मशीनवरील फोल्डर) उघडू शकता. ## एक शाखा तयार करा 'F1' दाबून कमांड पॅलेट पुन्हा उघडा. 'शाखा' टाइप करा आणि तिथून 'शाखा तयार करा' कमांड निवडा. पुढील चरणात तुमच्या नवीन शाखेचे नाव टाइप करा, उदाहरणार्थ `add-david-kroll`.एंटर दाबा आणि शाखा तयार होईल. शाखा देखील आधीच तपासली आहे. [चेकआउट म्हणजे काय?](https://www.git-scm.com/docs/git-checkout) शाखा कमांड पॅलेट ## आवश्यक बदल करा `Contributors.md` उघडा आणि फाइलमध्ये कुठेही तुमचे नाव जोडा. या फाइलमध्ये GFM (GitHub Flavored Markdown) आहे जी मार्कडाउन सिंटॅक्सची मालकी आहे. इतर योगदानकर्त्यांपैकी एक कॉपी करा' ओळी करा आणि तुम्हाला वाक्यरचना योग्य असल्याची खात्री करण्यासाठी तुमच्या नावासह ते सुधारित करा - ते निवडक असू शकते. तुमचे नाव जोडा ## GitHub मध्ये बदल करा आणि पुश करा VS कोडच्या डाव्या बाजूला 5 चिन्ह दाखवणारा मेनू आहे. आवृत्ती नियंत्रण/स्रोत नियंत्रण चिन्ह निवडा. (शॉर्टकट: Ctrl + Shift + G) बदल वचन द्या फाईल एक्सप्लोरर शेवटच्या कमिटपासून बदललेल्या सर्व फायली प्रदर्शित करतो. फाइल्सवर फिरवून आणि `+` (प्लस) वर क्लिक करून फाईल्स स्टेज केल्या जातात. Stashed Files एक्सप्लोररच्या शीर्षस्थानी असलेल्या ओळीत काहीतरी टाइप करा आणि चेकमार्क दाबा. बदल आता तुमच्या स्थानिक प्रतीसाठी वचनबद्ध आहेत. आता बदल GitHub वर ढकलले जाणे आवश्यक आहे. Stashed Files मेनू उघडण्यासाठी तीन-बिंदू चिन्ह वापरा जिथे तुम्ही `शाखा प्रकाशित करा` पर्याय निवडता. तुमची GitHub क्रेडेन्शियल एंटर करण्यासाठी याने संवाद उघडला पाहिजे. Stash की गेलेल्या फाईल्स ##तुमचे बदल पुनरावलोकनासाठी सबमिट करा या टप्प्यावर तुम्ही तुमचा बदल पूर्ण केला आहे परंतु तो अजूनही तुमच्या रेपोमध्येच राहतो. हे चरण तुम्हाला तुमचे बदल विलीन करण्यासाठी उच्च-स्तरीय रेपोच्या प्रशासकाकडे विनंती कशी सबमिट करायची ते दर्शवेल. GitHub वरील तुमच्या रेपोमध्ये तुम्हाला नवीन शाखेच्या अधिसूचनेशेजारी `तुलना आणि पुल विनंती` बटण दिसेल. त्या बटणावर क्लिक करा. पुल विनंती तयार करा आता पुल विनंती सबमिट करा. पुल विनंती सबमिट करा लवकरच मी तुमचे सर्व बदल या प्रकल्पाच्या मुख्य शाखेत विलीन करीन. एकदा बदल विलीन झाल्यानंतर तुम्हाला एक सूचना ईमेल प्राप्त होईल. ## इथून कुठे जायचं? अभिनंदन! तुम्ही नुकतेच मानक _fork -> क्लोन -> संपादन -> PR_ वर्कफ्लो पूर्ण केले आहे ज्याचा तुम्हाला अनेकदा एक योगदानकर्ता म्हणून सामना करावा लागेल! तुमचे योगदान साजरे करा आणि [वेब अॅप](https://firstcontributions.github.io#social-share) ला भेट देऊन ते तुमच्या मित्र आणि अनुयायांसह शेअर करा. तुम्हाला कोणत्याही सहाय्याची आवश्यकता असल्यास किंवा काही प्रश्न असल्यास, तुम्ही आमच्या स्लॅक टीममध्ये सामील होऊ शकता. [स्लॅक टीममध्ये सामील व्हा](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [अतिरिक्त साहित्य](../additional-material/git_workflow_scenarios/additional-material.md) ##इतर साधनांचा वापर करून शिकवण्या [मुख्य पृष्ठावर परत](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Persian/github-desktop-tutorial.fa.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # اولین مشارکت | GitHub Desktop | GitHub Desktop Edition | | ----------------------------------------------------------------------------------------------- | ---------------------- | همیشه اولین بار سخت‌ترین بار هست. به خصوص زمانی که در حال همکاری هستید، اشتباه کردن کار راحتی نیست. اما منبع باز همه چیز در مورد همکاری و کار با هم است. ما می خواستیم روشی را که مشارکت کنندگان منبع باز جدید یاد می گیرند و برای اولین بار مشارکت می دهند، ساده کنیم. خواندن مقاله‌ها و دیدن ویدئوهای آموزشی کمک کننده است، ولی چه چیزی بهتر از این است که واقعاً کارها را بدون خراب کردن چیزی انجام دهید. هدف این پروژه ارائه راهنمایی و ساده‌سازی روشی است که تازه‌کاران اولین مشارکت خود را انجام می‌دهند. به یاد داشته باشید که هر چه آرامش بیشتری داشته باشید بهتر یاد می گیرید. اگر به دنبال اولین مشارکت خود هستید، فقط مراحل ساده زیر را دنبال کنید. ما به شما قول می دهیم، سرگرم کننده خواهد بود. اگر برنامه `GitHub Desktop` رو نصب نداری، [از اینجا نصب کن](https://desktop.github.com/). اگر از نسخه `GitHub Desktop` قبل از 1.0 استفاده می کنید،[به این آموزش مراجعه کنید](github-desktop-old-version-tutorial.md). fork this repository ## مخزن را فورک کنید با کلیک کردن بر روی دکمه Fork، از مخزن مورد نظر یک انشعاب بگیرید. این عملیات یک نسخه کپی از مخزن را بر روی حساب کاربری شما ایجاد می‌کند. ## مخزن را کلون (شبیه) کنید اکنون این مخزن را در دستگاه خود کلون کنید. مهم: مخزن اصلی را کلون نکنید. به فورک خود بروید و آن را شبیه سازی کنید. برای کلون کردن مخزن، روی "Clone or Download" کلیک کنید و سپس روی "Open in Desktop" کلیک کنید. clone this repository یک پنجره پاپ آپ باز می شود. بر روی "Open GitHubDesktop.exe" کلیک کنید. clone this repository پس از کلیک بر روی "Open GitHubDesktop.exe" محتویات در کامپیوتر شما دانلود می شود. clone this repository اکنون محتویات مخزن `first-contributions` در github را در کامپیوتر خود کپی کرده اید. ## یک شاخه جدید ایجاد کنید اکنون با کلیک بر روی نماد "Current branch" در بالا و سپس روی "New branch" یک شاخه ایجاد کنید: make a branch نام شاخه خود را بگذارید. به عنوان مثال، "add-john-hazrati" name your branch روی `Create branch` کلیک کنید. ## تغییرات را اعمال کنید و کامیت کنید حالا به تب history رفته و فایل `Contributors.md` را در یک ویرایشگر متن با کلیک راست و باز کردن در ویرایشگر متن باز کنید. به پایین صفحه بروید و نام خود را به آن اضافه کنید، سپس فایل را ذخیره کنید. مثال: اگر نام شما جان حضرتی است، باید به این شکل باشد. \[John Hazrati](https://github.com/john-6670) می بینید که تغییراتی در Contributors.md وجود دارد و آنها به Github Desktop اضافه شده اند. check status اکنون آن تغییرات را کامیت کنید: در قسمت _summary_ پیام "Add `` to Contributors list" را بنویسید. بخش `` را با نام خود جایگزین کنید. روی دکمه ای که می گوید `Commit to add-your-name` کلیک کنید. commit your changes در پایین مشاهده می کنید که commit ایجاد شده است. commit your changes ## تغییرات را ارسال (پوش) کنید روی File-> Options کلیک کنید و وارد Github.com شوید. نام کاربری و رمز عبور Github خود را وارد کنید. log-in to Github روی دکمه `Publish` در بالا سمت راست کلیک کنید. push your changes ## تغییرات خود را برای بررسی، ثبت کنید اگر به مخزن خود در github بروید، دکمه `Compare & pull request` را خواهید دید. روی آن دکمه کلیک کنید create a pull request اکنون pull request را ارسال کنید. submit pull request به زودی تمام تغییرات شما را در شاخه اصلی این پروژه ادغام خواهم کرد. پس از ادغام تغییرات، یک ایمیل اعلان دریافت خواهید کرد. ## اقدامات بعدی تبریک میگم شما به تازگی چرخه استاندارد _fork -> clone -> edit -> PR_ ا را تکمیل کرده اید که اغلب به عنوان یک مشارکت کننده با آن مواجه می شوید! مشارکت خود روی این پروژه را [از اینجا](https://firstcontributions.github.io#social-share) با دیگر دوستان و دنبال‌کنندگان خود جشن بگیرید. همچنین شما می‌توانید [از اینجا](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FAA)، وارد تیم Slack ما شوید و سوالات خود را مطرح نمایید. ### [اطلاعات بیشتر](../additional-material/git_workflow_scenarios/additional-material.md) ## آموزش انجام مشارکت در دیگر ابزارها [برگشت به صفحه اصلی](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Persian/gitkraken-tutorial-fa.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # اولین مشارکت‌ها |GitKraken|نسخه GitKraken| |---|---| همیشه اولین بار سخت‌ترین بار هست. به خصوص زمانی که در حال همکاری هستید، اشتباه کردن کار راحتی نیست. اما منبع باز همه چیز در مورد همکاری و کار با هم است. ما می خواستیم روشی را که مشارکت کنندگان منبع باز جدید یاد می گیرند و برای اولین بار مشارکت می دهند، ساده کنیم. خواندن مقاله‌ها و دیدن ویدئوهای آموزشی کمک کننده است، ولی چه چیزی بهتر از این است که واقعاً کارها را بدون خراب کردن چیزی انجام دهید. هدف این پروژه ارائه راهنمایی و ساده‌سازی روشی است که تازه‌کاران اولین مشارکت خود را انجام می‌دهند. به یاد داشته باشید که هر چه آرامش بیشتری داشته باشید بهتر یاد می گیرید. اگر به دنبال اولین مشارکت خود هستید، فقط مراحل ساده زیر را دنبال کنید. ما به شما قول می دهیم، سرگرم کننده خواهد بود. ## Git Kraken [GitKraken](https://www.gitkraken.com) را دانلود کنید، نصب و باز کنید. باید پنجره گفتگوی "Welcome to GitKraken" را ببینید - با GitHub وارد شوید و به GitKraken اجازه دسترسی به حساب GitHub خود را بدهید. login to GitHub (اختیاری) به File -> Preferences بروید و دایرکتوری پروژه خود را به ریشه مخازن محلی خود تنظیم کنید. ## این مخزن را فورک کنید با کلیک بر روی دکمه فورک در بالای این صفحه، این مخزن را فورک کنید. fork this repository این کار یک کپی از این مخزن را در حساب شما ایجاد می‌کند. ## مخزن را کلون کنید در GitKraken، به File -> Clone Repo بروید. clone this repository GitHub.com را در پنل سمت راست انتخاب کنید. زیر نام کاربری خود، باید first-contributions را ببینید. روی آن مخزن کلیک کنید و مسیر کامل نشان داده شده در پایین این پنل را بررسی کنید. هنگامی که از مسیر راضی هستید، روی "Clone the repo!" کلیک کنید. ## یک شاخه ایجاد کنید روی دکمه branch در نوار ابزار کلیک کنید. نام شاخه خود را "add-your-name" بگذارید، به عنوان مثال: "add-william-sutton" name your branch ## تغییرات لازم را انجام دهید و آنها را کامیت کنید اکنون فایل `Contributors.md` را در یک ویرایشگر متن باز کنید و نام خود را به آن اضافه کنید، سپس فایل را ذخیره کنید. اگر مخزن را در GitKraken باز دارید، خواهید دید که تغییراتی وجود دارد. با انتخاب جدیدترین کامیت که با "// WIP" و تعداد فایل‌های تغییر یافته و نوع تغییر مشخص شده است، آن تغییرات را بررسی و آماده کنید. edit some file(s) فایل‌هایی که تغییر کرده‌اند را بررسی کنید و تصمیم بگیرید که کدام را می‌خواهید آماده کنید. آماده‌سازی برای گفتن دقیق به git اینکه دقیقاً چه تغییرات فایلی را می‌خواهید با این کامیت مرتبط کنید، مهم است. stage your changes هنگامی که پیام کامیت خوبی دارید ("Add to Contributors list" خوب و توصیفی به نظر می‌رسد) و از تغییرات خود راضی هستید، می‌توانید روی "Stage all changes" بزنید تا همه چیز اصلاح شده آماده شود یا "Stage File" برای آماده کردن یک فایل منفرد. clone this repository اگر نظرتان عوض شد، می‌توانید آن تغییرات را از حالت آماده خارج کنید، یا می‌توانید همه آنها را با هم حذف کنید. هشدار: همانطور که کلمه discard نشان می‌دهد، این یک عملیات مخرب است. این کار را فقط در صورتی انجام دهید که هیچ تغییری از هر مخزنی که در آن هستید نمی‌خواهید. روی commit بزنید. تبریک می‌گوییم، شما همه تغییرات را به نسخه محلی شاخه خود از فورک خود از first-contributions کامیت کرده‌اید. به پیش! ## تغییرات را به GitHub ارسال کنید push your changes روی دکمه Push در نوار ابزار کلیک کنید. origin or branch تغییرات را روی شاخه origin ارسال کنید اگر می‌خواهید تغییرات مستقیماً در شاخه master منعکس شوند، در غیر این صورت شاخه مناسبی را که می‌خواهید push کنید انتخاب کنید. ## تغییرات خود را برای بررسی ارسال کنید اگر به مخزن خود در github بروید، دکمه `Compare & pull request` را خواهید دید. روی آن دکمه کلیک کنید. create a pull request اکنون pull request را ارسال کنید. submit pull request به زودی من همه تغییرات شما را در شاخه master این پروژه ادغام خواهم کرد. هنگامی که تغییرات ادغام شدند، یک ایمیل اطلاع‌رسانی دریافت خواهید کرد. ## از اینجا به کجا برویم؟ تبریک! شما به تازگی گردش کار استاندارد _fork -> clone -> edit -> PR_ را که اغلب به عنوان یک مشارکت‌کننده با آن روبرو خواهید شد، تکمیل کردید! مشارکت خود را جشن بگیرید و با رفتن به [وب اپلیکیشن](https://firstcontributions.github.io/#social-share) آن را با دوستان و دنبال‌کنندگان خود به اشتراک بگذارید. ### [مطالب اضافی](../additional-material/git_workflow_scenarios/additional-material.md) ## آموزش‌ها با استفاده از ابزارهای دیگر [بازگشت به صفحه اصلی](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Persian/sublime-merge-tutorial-fa.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # اولین مشارکت‌ها |Sublime Merge|کلاینت Git ساب‌لایم مرج| |---|---| همیشه اولین بار سخت‌ترین بار هست. به خصوص زمانی که در حال همکاری یا امتحان کردن چیز جدیدی هستید، اشتباه کردن کار راحتی نیست. اما منبع باز همه چیز در مورد همکاری و کار با هم است. ما می خواستیم روشی را که مشارکت کنندگان منبع باز جدید یاد می گیرند و برای اولین بار مشارکت می دهند، ساده کنیم. خواندن مقاله‌ها و دیدن ویدئوهای آموزشی کمک کننده است، ولی چه چیزی بهتر از این است که واقعاً کارها را بدون خراب کردن چیزی انجام دهید. هدف این پروژه ارائه راهنمایی و ساده‌سازی روشی است که تازه‌کاران اولین مشارکت خود را انجام می‌دهند. به یاد داشته باشید که هر چه آرامش بیشتری داشته باشید بهتر یاد می گیرید. اگر به دنبال اولین مشارکت خود هستید، فقط مراحل ساده زیر را دنبال کنید. ما به شما قول می دهیم، سرگرم کننده خواهد بود. ## Sublime Merge [Sublime Merge](https://www.sublimemerge.com/) را دانلود کنید، نصب و باز کنید. ## این مخزن را فورک کنید با کلیک بر روی دکمه فورک در بالای این صفحه، این مخزن را فورک کنید. fork this repository این کار یک کپی از این مخزن را در حساب شما ایجاد می‌کند.



## مخزن را کلون کنید clone this repository در Sublime Merge، به File -> Clone Repository بروید. clone this repository مرحله بعدی کلون کردن مخزن شما روی دستگاه شماست تا بتوانید شروع به ایجاد تغییرات کنید. Sublime Merge به URL مخزن شما نیاز دارد، بنابراین روی دکمه "clone" کلیک کنید و سپس روی آیکون "copy to clipboard" کلیک کنید. **دقت کنید:** یک اشتباهی که مشارکت‌کنندگان جدید اغلب مرتکب می‌شوند این است که به جای کلون کردن مخزن خود، مخزنی را که از آن فورک کرده‌اند کلون می‌کنند. نوار آدرس مرورگر خود را بررسی کنید و مطمئن شوید که مخزن خود را کلون می‌کنید. URL مخزن را در Sublime Merge وارد کنید، یک نام مخزن به آن بدهید (یا آن را خالی بگذارید) و دایرکتوری خود را برای ذخیره مخزن تنظیم کنید. هنگامی که از مسیر راضی هستید، روی "Clone" کلیک کنید. ## یک شاخه ایجاد کنید کلیک راست روی Branches -> Create Branch یا به Repository -> Create Branch بروید نام شاخه خود را "add-your-name" بگذارید، به عنوان مثال: "add-william-sutton" name your branch ## تغییرات لازم را انجام دهید و آنها را کامیت کنید اکنون فایل `Contributors.md` را در یک ویرایشگر متن باز کنید و نام خود را به آن اضافه کنید، سپس فایل را ذخیره کنید. اگر مخزن را در Sublime Merge باز دارید، خواهید دید که تغییراتی وجود دارد. جدیدترین کامیت را در بالا، با نام "x unstaged files" انتخاب کنید. فایل‌هایی که تغییر کرده‌اند را بررسی کنید و تصمیم بگیرید که کدام را می‌خواهید آماده کنید. به کامیت یک پیام کامیت بدهید ("Add to Contributors list" خوب و توصیفی به نظر می‌رسد). هنگامی که از تغییرات خود راضی هستید، آن تغییرات را با آماده کردن آنها فایل به فایل یا انتخاب "stage all" آماده کنید. آماده‌سازی برای گفتن دقیق به git اینکه دقیقاً چه تغییرات فایلی را می‌خواهید با این کامیت مرتبط کنید، مهم است. stage your changes اگر نظرتان عوض شد، می‌توانید آن تغییرات را از حالت آماده خارج کنید، یا می‌توانید همه آنها را با هم حذف کنید. هشدار: همانطور که کلمه discard نشان می‌دهد، این یک عملیات مخرب است. این کار را فقط در صورتی انجام دهید که هیچ تغییری از هر مخزنی که در آن هستید نمی‌خواهید. روی commit بزنید و نام کاربری و آدرس ایمیل خود را وارد کنید و روی Update بزنید. دوباره روی commit بزنید. تبریک می‌گوییم، شما همه تغییرات را به نسخه محلی شاخه خود از فورک خود از first-contributions کامیت کرده‌اید. به پیش! ## تغییرات را به GitHub ارسال کنید به Repository -> Push بروید یا روی فلش کوچک در جهت بالا در گوشه سمت راست بزنید. login با نام کاربری و رمز عبور خود به حساب Github خود وارد شوید تغییرات را روی شاخه origin ارسال کنید اگر می‌خواهید تغییرات مستقیماً در شاخه master منعکس شوند، در غیر این صورت شاخه مناسبی را که می‌خواهید push کنید انتخاب کنید. ## تغییرات خود را برای بررسی ارسال کنید اگر به مخزن خود در github بروید، دکمه `Compare & pull request` را خواهید دید. روی آن دکمه کلیک کنید. create a pull request اکنون pull request را ارسال کنید. submit pull request به زودی من همه تغییرات شما را در شاخه master این پروژه ادغام خواهم کرد. هنگامی که تغییرات ادغام شدند، یک ایمیل اطلاع‌رسانی دریافت خواهید کرد. ## از اینجا به کجا برویم؟ تبریک! شما به تازگی گردش کار استاندارد _fork -> clone -> edit -> PR_ را که اغلب به عنوان یک مشارکت‌کننده با آن روبرو خواهید شد، تکمیل کردید! مشارکت خود را جشن بگیرید و با رفتن به [وب اپلیکیشن](https://firstcontributions.github.io#social-share) آن را با دوستان و دنبال‌کنندگان خود به اشتراک بگذارید. ### [مطالب اضافی](../additional-material/git_workflow_senarios/additional-material.md) ## آموزش‌ها با استفاده از ابزارهای دیگر [بازگشت به صفحه اصلی](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Portuguese/github-desktop-tutorial.pt_br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions | GitHub Desktop | GitHub Desktop Edition | | ----------------------------------------------------------------------------------------------- | ---------------------- | É difícil. É sempre difícil fazer algo pela primeira vez. Especialmente quando se está colaborando, cometer erros não é algo agradável. Mas _open source_ (código aberto) se trata de colaboração e de trabalharmos juntos. Queremos simplificar a forma com que novos colaboradores _open source_ aprendem e contribuem pela primeira vez. Ler artigos e ver tutoriais pode ajudar, mas o que é melhor do que realmente pôr a mão na massa em um ambiente prático? Este projeto visa guiar e simplificar a forma com que os novatos fazem a sua primeira contribuição. Se quiser fazer a sua primeira contribuição, siga os passos abaixo. Se você nao tem o Github desktop na sua máquina, [instale aqui](https://desktop.github.com/). Se você está usando uma versão do Github desktop antes da 1.0, [consulte este tutorial](github-desktop-old-version-tutorial.md). fork este repositório ## Fork este repositório Fork este repositório clicando no botão fork na parte superior direita dessa página. Isso vai criar uma cópia desse repositório na sua conta. ## Clone este repositório Agora clone esse repositório na sua máquina. IMPORTANTE: NÃO CLONE O REPOSITÓRIO ORIGINAL. Vá para o seu fork e clone. Para clonar esse repositório, clique em "Clone or Download" e então clique em "Open in Desktop". clone este repositório Uma janela pop up vai aparecer. Clique em "Open GitHubDesktop.exe". clone este repositório Depois de clicar em "Open GitHubDesktop.exe" os arquivos serão baixados para o seu computador. clone este repositório Agora você copiou os arquivos do repositório first-contributions no github para o seu computador. ## Criando uma branch (ramo) Agora crie uma branch clicando na aba "Current branch" que fica no topo, depois clique em "New branch": criar uma branch Nomeie sua branch como . Por exemplo, "add-james-smith" nomeie sua branch Clique em `Create branch` ## Faça as mudanças necessárias e commit essas mudanças Agora abra o arquivo `Contributors.md` em um editor de texto, vá para o final do arquivo e adicione seu nome, depois salve o arquivo. Exemplo: Se o seu nome for James Smith, Deve ficar parecido com isso. \[James Smith](https://github.com/jamessmith) Você pode ver as alterações feitas em Contributors.md no Github Desktop. checar mudanças Agora faça commit dessas alterações: Escreva a mensagem "Add `` to Contributors list" no campo _sumary_ Substitua `` pelo seu nome. Clique no botão que diz `Commit to add-your-name`. commit suas alterações Na parte inferior, você pode ver que o commit foi criado com sucesso. commit suas alterações ## Faça o push das mudanças no github Clique em File -> Options e depois em sign-in to Github.com. Digite seu username e senha do Github. log-in no Github Clique no botão `Publish` na parte superior direita. push suas alterações ## Envie suas alterações para review Se você for até seu repositório no github, verá o botão `Compare & pull request`. Clique nesse botão criando um pull request Agora envie o pull request. enviando o pull request Em breve estarei mesclando todas as suas alterações na branch Master do projeto. Você vai receber um email de notificação assim que as alterações forem integradas. ## Qual o próximo passo? Parabéns! Você acabou de completar o fluxo _fork -> clone -> edit -> PR_ que encontrará diversas vezes como contribuidor! Comemore sua contribuição e compartilhe com seus amigos e seguidores acessando o [web app](https://firstcontributions.github.io#social-share). Você pode entrar na nossa equipe no Slack caso precise de alguma ajuda ou tenha alguma dúvida. [Entre no Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [Material adicional](../additional-material/git_workflow_senarios/additional-material.md) ## Tutoriais usando outras ferramentas [Voltar a página principal](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Portuguese/github-windows-intellij-tutorial.pt_br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições | IntelliJ IDEA | IntelliJ IDEA | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | É difícil, sempre é difícil quando fazemos alguma coisa pela primeira vez. Especialmente quando você está colaborando, cometendo erros, não é nada confortável. No entanto, o open source é totalmente sobre colaboração & trabalho em equipe. Por isso, nós queremos simplificar a maneira como os novos colaboradores de código aberto aprendem & contribuem pela primeira vez. Ler artigos & assistir a tutoriais até podem ajudar, mas o que é melhor do que fazer as coisas sem bagunçar nada. Este projeto tem como objetivo orientar & simplificar a forma como os iniciantes fazem a sua primeira contribuição. Lembre-se que você aprende melhor quando está relaxado. Se você deseja fazer sua primeira contribuição, basta seguir os passos abaixo. Nós prometemos a você que será divertido! Se você ainda não tem o IntelliJ IDEA no seu computador, [instale-o](https://www.jetbrains.com/idea/download/#section=windows) **Observação:** Este tutorial foi feito usando o IntelliJ IDEA (versão 2019.3.2) em um computador rodando Windows 10. Posteriormente neste tutorial, faremos uso de algumas teclas de atalho, que podem ser diferentes em outros sistemas operacionais (macOS / Linux). ## Faça o Fork deste repositório fork this repository Faça um *fork* deste repositório clicando no botão *fork* (bifurcar) no canto superior direito desta página. Isso criará uma cópia deste repositório em sua conta do GitHub. O GitHub rastreia a relação entre seu repositório e o original, o qual você fez o *fork*. Você pode pensar em seu repositório como uma cópia de trabalho. Muitos dos repositórios matrizes do GitHub (ou seja, aqueles que não são *Fork* de nenhum outro repositório) tem um pequeno grupo de pessoas que podem fazer commits de modificações diretamente. Todos os outros contribuidores devem fazer um *for* do repositório e fazer alterações no *fork*, em seguida, devem criar um Pull Request para solicitar um *Merge* (mesclagem) das modificações feitas no repositório original. ## Clone seu Repositório clone this repository O próximo passo será clonar seu repositório em sua máquina para que você possa modificá-lo. Visual Studio precisa da URL do seu repositório, portanto clique no botão "clone" e então clique no ícone "copy to clipboard". **CUIDADO**: Um erro que os novatos costumam cometer é clonar o repo do qual você fez o fork, em vez de clonar seu repo. Verifique a barra de endereços do seu navegador e certifique-se de que você está clonando o seu repositório. Agora abra o IntelliJ IDEA. O IntelliJ IDEA permite que você fassa um check out (em termos do Git clone) de um repositório existente e crie um novo projeto com base nos dados que você baixou. No menu principal, escolha VCS | Get from Version Control ou, se nenhum projeto estiver aberto no momento, clique em Get from Version Control na tela inicial. Na caixa de diálogo Get from Version Control dialog, especifique a URL do repositório remoto que deseja clonar (você pode clicar em Test para certificar-se de que a conexão com o repositório remoto pode ser estabelecida) ou selecione um dos serviços de hospedagem VCS à esquerda. Se você já estiver conectado ao serviço de hospedagem selecionado, a completion irá sugerir a lista de repositórios disponíveis que você pode clonar. Clique em Clone. Se quiser criar um projeto IntelliJ IDEA com base nas fontes que você clonou, clique em Sim na caixa de diálogo de confirmação. O mapeamento de raiz do Git será automaticamente definido para o diretório raiz do projeto. Se o seu projeto tiver submodelos, eles também serão clonados e automaticamente registrados como raízes do projeto. **Importante**: certifique-se de que é o repositório é o fork e não o original, caso contrário, o procedimento não funcionará. ## Crie um branch No Git, o processo de branching (ramificação) é um mecanismo poderoso que permite divergir da linha principal de desenvolvimento, por exemplo, quando você precisa trabalhar em um recurso ou congelar um determinado estado de uma base de código para um release e assim por diante. No IntelliJ IDEA, todas as operações com branches são realizadas no pop-up Git Branches. Para ativá-lo, clique no widget Git na barra de status ou pressione Ctrl + Shift + `. O nome do branch atual é exibido no widget do Git na barra de status. No pop-up branch, escolha Novo branch. Na caixa de diálogo que é aberta, especifique o nome do branch e certifique-se de que a opção Checkout branch esteja selecionada se você quiser alternar para esse branch. A nova ramificação começará a partir do HEAD atual. Se você deseja iniciar um branch de um commit anterior ao invés do branch atual HEAD, selecione este commit na aba Log da janela da ferramenta de Controle de Versão Alt + 9 e escolha New Branch no menu de contexto. ## Faça as alterações necessárias Abra ``Contributors.md`` e adicione seu nome em qualquer lugar do arquivo. Este arquivo contém GFM (GitHub Flavored Markdown), que é um tipo proprietário da sintaxe de [markdown](https://pt.wikipedia.org/wiki/Markdown). Copie uma das linhas de outros contribuidores e modifique-a com seu nome para ter certeza que você obteve a sintaxe correta. ## Commit & Push modificações para o GitHub Selecione os arquivos que deseja commitar ou uma lista de alterações inteira na guia Local Changes da janela da ferramenta de controle de versão Alt + 9 e pressione Ctrl + K ou clique no botão Commit na barra de ferramentas. A caixa de diálogo Commit Changes abrira e listara todos os arquivos que foram modificados desde o último commit, bem como todos os arquivos não versionados recém-adicionados. Insira uma mensagem de commit que faça sentido. Você pode clicar em Commit Message history (Confirmar histórico de mensagens) Ctrl + M para escolher na lista de mensagens de commits recentes. Você também pode editar a mensagem de commit mais tarde, antes de enviar o commit. Pressione Ctrl + Shift + K ou escolha VCS | Git | Push from the main menu. A caixa de diálogo Push Commits é aberta, mostrando todos os repositórios Git (para projetos de vários repositórios) e listando todos os commits feitos no branch atual em cada repositório desde o último push. ## Envie suas alterações para revisão Neste ponto, você concluiu a alteração, mas ela ainda está apenas no seu repo. Esta etapa mostrará como enviar uma solicitação ao administrador do repo matriz para mesclar sua alteração. Em seu repo no GitHub, você verá o botão `Compare & pull request` ao lado da notificação do novo branch, clique nesse botão. create a pull request Agora submeta o pull request. submit pull request Em breve estarei mesclando todas as suas alterações no branch master deste projeto. Você receberá um e-mail de notificação assim que as alterações forem integradas. ## Para onde ir agora? Parabéns! Você acabou de completar o padrão _fork -> clone -> edit -> PR_ workflow que você encontrará frequentemente como um contribuidor! Comemore sua contribuição e compartilhe-a com seus amigos e seguidores acessando o [web app](https://firstcontributions.github.io/#social-share). Você pode se juntar a nossa equipe slack caso precise de alguma ajuda ou tenha alguma dúvida. [Junte-se ao time slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). Agora vamos começar a contribuir para outros projetos, compilamos uma lista de projetos com questões fáceis para você começar. [Confira a lista de projetos no web app](https://firstcontributions.github.io/#project-list). ### [Material Adicional](../../additional-material/translations/Portuguese/additional-material.pt_br.md). ## Tutoriais usando outras ferramentas [Voltar a página principal](https://github.com/firstcontributions/first-contributions/blob/master/translations/README.pt_br.md) ## Autopromoção Se você gostou deste projeto, de star no GitHub. Se você gostou dessa tradução me siga no GitHub [Vitor Matias](https://github.com/VitorCMatias). ================================================ FILE: docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs-code-tutorial.pt_br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições | Visual Studio Code | Visual Studio Code | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | É difícil. É sempre difícil a primeira vez que você faz algo. Especialmente quando você está colaborando, cometer erros não é uma coisa confortável. Mas o código aberto tem tudo a ver com colaboração e trabalho em conjunto. Queríamos simplificar a maneira como os novos colaboradores de código aberto aprendem e contribuem pela primeira vez. Ler artigos e assistir a tutoriais pode ajudar, mas o que é melhor do que realmente fazer as coisas sem estragar nada. Este projeto visa fornecer orientação e simplificar a maneira como os novatos fazem sua primeira contribuição. Lembre-se, quanto mais relaxado você estiver, melhor você aprenderá. Se você está procurando fazer sua primeira contribuição, basta seguir os passos simples abaixo. Nós prometemos a você, vai ser divertido. Se você não tiver o Visual Studio Code em sua máquina, [instale-o](https://code.visualstudio.com/download). **Atenção:** Este tutorial foi feito usando o Visual Studio Code (Versão 1.27.2) em uma máquina Windows 10. Mais adiante neste tutorial, usaremos alguns atalhos de teclado. Eles podem diferir em outros sistemas operacionais (macOS/Linux), bem como no idioma do teclado (UK, DE, etc). Você pode percorrer sua lista de atalhos pesquisando "atalho" na Paleta de Comandos. ## Fork este repositório fork this repository Fork este repositório clicando no botão fork no canto superior direito desta página. Isso criará uma cópia deste repositório em sua conta do GitHub. O GitHub acompanha o relacionamento entre seu repositório e aquele do qual você o bifurcou. Você pode pensar em seu repositório como uma cópia de trabalho. A maioria dos repositórios de alto nível do GitHub (ou seja, aqueles que não são bifurcados de nenhum outro repositório) têm uma pequena equipe principal de pessoas que podem confirmar alterações diretamente. Todos os outros contribuidores devem bifurcar o repositório e fazer alterações na bifurcação e, em seguida, criar uma solicitação de pull para solicitar que suas alterações sejam mescladas novamente no repositório de nível superior. Se o administrador de repo de nível superior gostar das alterações, elas serão mescladas e você ganhará fama e fortuna instantâneas! Mais sobre como fazer isso mais tarde. ## Clone seu repositório clone this repository A próxima etapa é clonar seu repositório para sua máquina para que você possa começar a fazer alterações. O VS Code precisa do URL do seu repositório, então clique no botão "clone" e depois clique no ícone "copiar para a área de transferência". **CUIDADO:** Um erro que os novos contribuidores costumam cometer é clonar o repositório que você bifurcou _de_ em vez de clonar seu repositório. Verifique a barra de endereços do seu navegador e certifique-se de estar clonando seu repositório. Agora abra o Visual Studio Code. A página de boas-vindas do VS Code aparecerá. A partir daí, pressione `F1` para abrir a barra mostrada abaixo. Observe que já existe um sinal `>` (maior que) no campo de texto. Você também pode acessar o prompt de entrada pressionando `CTRL-P` e digite o caractere `>`. Clone Popup (Command Popup) Você pode notar que já existem alguns comandos obscuros listados abaixo. Esses são meus comandos usados recentemente. Então, simplesmente não se importe com eles. Clone repo Agora digite `git clone`, apenas `git` ou `clone` (funciona como uma pesquisa). Selecione a entrada `Git: Clone` e pressione `Entrar` Colar URL do repositório Cole a URL do seu repositório e pressione `Entrar`. Isso abrirá um File Explorer onde você pode escolher onde o repositório Git deve ser armazenado. **Importante**: Certifique-se de que é o repositório bifurcado e não o original, caso contrário não funcionará. Status popup Você deve ver um pop-up de status no canto inferior direito do Visual Studio Code. Depois de terminar, você pode abrir o repositório clonado (agora uma pasta em sua máquina) usando os botões da caixa de diálogo. ## Criar uma branch Abra a paleta de comandos novamente pressionando `F1`. Digite `branch` e selecione o comando `criar branch` a partir daí. Na próxima etapa digite o nome do seu novo branch, por exemplo `add-david-kroell`. Pressione enter e a ramificação será criada. A filial também já foi verificada. [O que significa checkout?](https://www.git-scm.com/docs/git-checkout) Branches Command Palette ## Faça as alterações necessárias Abra `Contributors.md` e adicione seu nome em qualquer lugar do arquivo. Este arquivo contém GFM (GitHub Flavored Markdown), que é um sabor proprietário da sintaxe markdown. Copie um dos outros contribuidores' linhas e modifique-o com seu nome para ter certeza de obter a sintaxe correta - pode ser exigente. Add your name ## Confirmar e enviar alterações para o GitHub No lado esquerdo do VS Code há um menu com 5 ícones exibidos. Selecione o ícone de controle de versão/Controle de origem. (Atalho: Ctrl + Shift + G) Commitar alterações O explorador de arquivos exibe todos os arquivos que foram alterados após o último commit. Ao passar o mouse sobre os arquivos e clicar em `+` (mais), os arquivos são encenados. Arquivos guardados Digite algo na linha na parte superior do explorer e pressione a marca de seleção. As alterações agora estão confirmadas em sua cópia local. Agora as alterações precisam ser enviadas de volta ao GitHub. Arquivos guardados Use o ícone de três pontos para abrir o menu onde você seleciona a opção `Publicar Branch`. Isso deve abrir uma caixa de diálogo para colocar suas credenciais do GitHub. Arquivos guardados ## Envie suas alterações para revisão Neste ponto, você concluiu sua alteração, mas ela ainda reside apenas em seu repositório. Esta etapa mostrará como enviar uma solicitação ao administrador do repositório de nível superior para mesclar sua alteração. Em seu repositório no GitHub, você verá o botão `Comparar & pull request` ao lado da nova notificação de branch. Clique nesse botão. crie uma pull request Agora envie a solicitação PR - pull request. submit pull request Em breve estarei mesclando todas as suas alterações no branch master deste projeto. Você receberá um e-mail de notificação assim que as alterações forem mescladas. ## Para onde ir a partir daqui? Parabéns! Você acabou de concluir o fluxo de trabalho padrão _fork -> clone -> editar -> PR_ que você encontrará frequentemente como colaborador! Comemore sua contribuição e compartilhe com seus amigos e seguidores acessando [aplicativo da web](https://firstcontributions.github.io#social-share). Você pode se juntar à nossa equipe do slack caso precise de ajuda ou tenha alguma dúvida. [Junte-se à equipe do Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [Material adicional](../additional-material/translations/additional-material.pt_br.md) ## Tutoriais usando outras ferramentas [Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs-code-tutorial_pt_br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições | Visual Studio Code | Visual Studio Code | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | É difícil, sempre é difícil quando fazemos alguma coisa pela primeira vez. Especialmente quando você está colaborando, cometendo erros, não é nada confortável. No entanto, o open source é totalmente sobre colaboração e trabalho em equipe. Por isso, nós queremos simplificar a maneira como os novos colaboradores de código aberto aprendem e contribuem pela primeira vez. Ler artigos e assistir a tutoriais até podem ajudar, mas o que é melhor do que fazer as coisas sem bagunçar nada. Este projeto tem como objetivo orientar & simplificar a forma como os iniciantes fazem a sua primeira contribuição. Lembre-se que você aprende melhor quando está relaxado. Se você deseja fazer sua primeira contribuição, basta seguir os passos abaixo. Nós prometemos a você que será divertido! Se você não tem o Visual Studio 2017 na sua máquina, [instale-o](https://code.visualstudio.com/download). **Nota:** Este tutorial foi feito utilizando o Visual Studio Code (Versão 1.27.2) no Windows 10. Mais tarde, neste tutorial, vamos utilizar alguns atalhos no teclado. Eles podem ser diferentes em outros sistemas operacionais (mac/OS/Linux) assim como em teclados de outras linguagens (UK, DE, etc). Você pode pesquisar na lista de atalhos, buscando por "atalhos" na Paleta de Comando. ## Faça o *Fork* deste repositório fork this repository Faça um *fork* deste repositório clicando no botão *fork* (bifurcar) no canto superior direito desta página. Isso criará uma cópia deste repositório em sua conta do GitHub. O GitHub rastreia a relação entre seu repositório e o original, o qual você fez o *fork*. Você pode pensar em seu repositório como uma cópia de trabalho. Muitos dos repositórios matrizes do GitHub (ou seja, aqueles que não são *Fork* de nenhum outro repositório) tem um pequeno grupo de pessoas que podem fazer commits de modificações diretamente. Todos os outros contribuidores devem fazer um *fork* do repositório e fazer alterações no *fork*, em seguida, devem criar um Pull Request para solicitar um *Merge* (mesclagem) das modificações feitas no repositório original. Se um dos administradores do repositório gostar e aprovar as tuas mudanças, eles *mergearão* e você ganhará fama e fortuna imediatamente! Abaixo, há mais detalhes sobre como fazer isso. ## Clone o seu repositório clone this repository O próximo passo será clonar seu repositório em sua máquina para que você possa modificá-lo. Visual Studio precisa da URL do seu repositório, portanto clique no botão "clone" e então clique no ícone "copy to clipboard". **CUIDADO:** Um erro que os novatos cometem com frequência é clonar o repositório do qual você fez o fork, ao invés de clonar seu repositório. Verifique a barra de endereços do seu navegador e certifique-se de que você está clonando o seu repositório. Agora, abra o Visual Studio Code. A página principal do VS Code vai minimizar. A partir daí, pressione `F1` para abrir a barra mostrada abaixo. Perceba que já existe um `>` (maior que) no campo de texto. Você pode também chegar até o prompt de entrada pressionando `CTRL-P` e então inserindo o caracter `>`. Clone Popup (Command Popup) Você pode notar que já aí já existem alguns comandos de sugestão abaixo. Esses são os seus comandos utilizados recentemente. Então, apenas ignore-os. Clone repo Agora, digite `git clone`, apenas `git` ou `clone` (isso funcionará como uma pesquisa). Selecione a opção `Git: Clone` e então aperte `Enter`. Paste Repository URL in Cole a URL do seu repositório e aperte `Enter`. Isso vai abrir o Explorador de Arquivo onde você pode escolher onde o repositório Git será armazenado. **Importante**: Tenha certerza que este é o repositório *forkeado* e não é o original. Se não, não funcionará. Status popup Você pode ver uma janela do status no canto inferior direito do Visual Studio Code. Depois de finalizado esse processo, você pode abrir o repositório clonado (agora, uma pasta na sua máquina) e usar os botões no diálogo. ## Crie uma *branch* Abra a Paleta de Comando novamente, pressionando `F1`. Digite nele `branch` e selecione o comando `create branch` a partir das sugestões. No próximo passo, digite o nome da sua nova *branch*, por exemplo: `add-david-kroell`. Presione `Enter` e a *branch* será criada. A *branch* também está preparada para o *check out*. [*O que isso significa?*](https://www.git-scm.com/docs/git-checkout) Branches Command Palette ## Faça as mudanças necessárias Abra o arquivo `Contributors.md` e adicione o seu nome no fim da lista. Esse arquivo contém GFM (GitHub Flavored Markdown), que é uma função nativa da sintaxe do markdown. Copie uma das outras linhas dos contribuidores e modifique-a com o seu nome. Tenha certeza que a sintaxe está correta - ela pode ser exigente. Add your name ## Faça um *Commit* & um *Push* das suas mudanças para o GitHub No lado esquerdo do VS Code tem um menu com 5 ícones a amostra. Selecione o ícone de `Controle de Versão/Controle da Fonte`. (Atalho : Ctrl + Shift + G) Commit changes O Explorador de arquivos mostra todos os arquivos que foram mudados depois do último commit. Sobrepondo o mouse nos arquivos e clicando no `+` (mais) os arquivos serão colocados no *stage*. Stashed Files Escreva algo na caixa de texto, no topo do explorador e pressione o botão de *check*. As mudanças agora foram *commitadas* para a sua cópia local. Agora, as mudanças tem que serem mandadas para o GitHub. Stashed Files Use o ícone dos três pontos para abrir o menu onde você selecionará a opção `Publicar Branch`. Isso deve abrir uma caixa de diálogo para colocar as tuas credenciais do GitHub. Stashed Files ## Submeta suas mudanças para uma revisão Nesse ponto, você completou suas mudanças, mas elas ainda estão no seu repositório. Esse passo vai mostrar para você como submeter uma requisição para o administrador do repositório original para *mergear* suas mudanças. No seu repositório no GitHub você verá o botão `Compare & Pull request` próximo a notificação da branch. Clique nesse botão. create a pull request Agora, submeta o *pull request*. submit pull request Breve as suas mudanças serão *mergeadas* na branch `master` desse projeto. Você será notificado por email uma vez que as mudanças forem *mergeadas*. ## Para onde ir ? Parabéns! Você acabou de completar o fluxo de trabalho *fork -> clone -> edit -> PR* que vocẽ vai realizar frequentemente como um contribuidor! Celebre a sua contribuição e compartilhe-a com os seus amigos e seguidores indo para o [web app](https://firstcontributions.github.io#social-share). Você pode se juntar à nossa comunidade no slack, caso precise de alguma ajuda ou tenha alguma dúvida. [Faça parte da nossa comunidade no Slack!](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY) ### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriais utilizando outras ferramentas [Retorne para a página principal](https://github.com/firstcontributions/first-contributions/blob/master/translations/README.pt_br.md) ================================================ FILE: docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs2017-tutorial.pt_br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições |Visual Studio 2017|Visual Studio 2017 Edition| |---|---| É difícil. Sempre é difícil fazer algo pela primeira vez. Especialmente quando você está colaborando, cometer erros não é confortável. Mas o open sourece tem tudo a ver com colaboração e trabalho em equipe. Nós queremos simplificar a maneira de aprendizagem aos novos contribuidores de open source e ajudar em sua primeira contribuição. Lendo artigos e olhando tutoriais podem ajudar, mas o que é melhor do que realmente fazer as coisas sem estragar nada. Esse projeto visa em providenciar uma orientação e simplificar a maneira dos novatos a conseguirem a sua primeira contribuição. Lembre-se, quanto mais relaxado melhor será o aprendizado. Se você está procurando em fazer a sua primeira contribuição, siga esses passos abaixo. Nós prometemos a você que vai ser divertido. Se você não possui o Visual Studio 2017 na sua máquina, [instale-o aqui](https://www.visualstudio.com/downloads/). ## Faça um Fork deste repositório fork this repository Para fazer um Fork deste repositório, basta clicar no botão de fork no topo da página. Isso criará uma cópia do repositório na sua conta GitHub. O GitHub acompapanhará o seu Fork e o repositório principal. Em outras palavras, podemos afirmar que o seu Fork é uma cópia do repositório principal. Os respositórios de mais alto nível do GitHub (exemplo: aqueles que não há um fork de nenhum outro repositório), tem uma pequena equipe principal de pessoas que podem diretamente fazer os seus commits. Os outros contribuidores deverão criar um Fork do respositório e fazer as mudanças nesse Fork, em seguida criar um Pull Request perguntando se essas mudanças poderão ser mescladas no repositório de alto nível. Se o administrador do repositório gostar das alterações ele irá mesclar as modificações e você ganhará instantaneamente fama e fortuna! Abaixo há um tutorial de como realizar. ## Clone o seu repositório clone this repository O próximo passo será clonar seu repositório em sua máquina para que você possa modificá-lo. Visual Studio precisa da URL do seu repositório, portanto clique no botão "clone" e então clique no ícone "copy to clipboard". **CUIDADO:** Um erro que os novatos cometem com frequência é clonar o repositório do qual você fez o fork, ao invés de clonar seu repositório. Verifique a barra de endereços do seu navegador e certifique-se de que você está clonando o seu repositório. Agora é a hora de ir para o Visual Studio 2017! Você estará trabalhando na aba *Team Explorer* na maior parte do tutorial. Se ela não estiver aberta por padrão, clique em `View > Team Explorer` para abrí-la. Team Explorer *Team Explorer* tem muitas áreas e muitos botões de navegação, localizados no topo para te ajudar a achar essas diferentes áreas. Para clonar o repositório, você vai precisar estar na *Connect view*, que deve ser a padrão. Se você não conseguir ver o botão *clone*, clique no botão verde, em formato de tomada, no topo. Click the `Clone` option under **Local Git Repositories** and paste the URL to your repo in the text box. This should be the URL you copied to your clipboard from GitHub previously. Clique na opção `Clone` abaixo de **Local Git Repositories** e cole a URL do seu repositório na caixa de texto. Essa URL tem que ser a mesma que você copiou no GitHub anteriormente. Clique no botão `Clone` para iniciar o processo. Clone repo Quando o processo estiver completo, você será movido para a aba *Solution Explorer*, onde você poderá ver o conteúdo do repositório clonado. O seu parecerá um pouco diferente da foto abaixo, por que os arquivos estão em constante mudança! Solution Explorer ## Crie uma *branch* Clique de volta na aba *Team Explorer* e use o a seleção principal de navegação para mostrar as *Branchs* disponíveis. Branches view Você deve ver o repositório **first-contributions** e a branch padrão, que é chamada `main`. Clique com o botão direito na `main` e escolha `New Local Branch From...`. New branch Dê à sua branch um nome como `add-` por exemplo: `add-alonzo-church`. Deixe a caixa de seleção `Checkout branch` marcada e clique no botão `Create Branch`. Create branch Você deverá ver a sua branch nova na lista. See new branch ## Faça as mudanças necessárias Abra o arquivo `Contributors.md` e adicione o seu nome no fim da lista. Esse arquivo contém GFM (GitHub Flavored Markdown), que é uma função nativa da sintaxe do markdown. Copie uma das outras linhas dos contribuidores e modifique-a com o seu nome. Tenha certeza que a sintaxe está correta - ela pode ser exigente. Add your name ## Commit & Push changes to GitHub Volte para a aba *Team Explorer* e navegue para a aba *Changes*. Changes Coloque a informação que você queira, poste o seu *commit* e clique em `Save`. O Visual Studio relembrará isso para futuros *commits*. Git user information **NOTA:** Visual Studio usa uma pasta escondida, chamada `.vs` para salvar suas configurações e preferências pessoais. O conteúdo desta pasta **não deverá ser salvo no Git**. Se ela não estiver sido ingnorada ainda, você deve informar ao Git para ignorar essa pasta, com o intuito dela não ser mandada para o repositório. Essa pasta já foi ignorada neste repositório, então você não tem que realizar este passo. Ele está aqui somente para você ter uma referência para projetos futuros. Ignore vs folder Agora você deve ver uma lista de arquivos modificados e uma caixa de texto para digitar um cometário do *commit*. Os comentários devem ser breves, mas concretos. Não tem nada pior do que ler um comentário de um *commit* e ver algo como: `"Eu atualizei algumas coisas"`. Tire alguns segundos para realizar o seu *commit*. O seu time vai agradecer bastante mais tarde e você pode até agradecer a você mesmo! Clique em `Commit All and Push` para realizar um *commit* local e fazer um *push* das suas mudanças para o seu repositório, tudo em um único passo. **NOTA:** Um *Commit* pode ser realizado separadamente de um *Push*. Fazemos os dois juntos por conveniência. As mudanças realizadas e salvas em *commits* locais não serão refletidos no teu repositório no GitHub até que você faça um *Push*. Commit and Push A primeira vez que você realizar um *Push* para o GitHub, Visual Studio solicitará as suas credenciais do GitHub. Depois disso, ele as guardará no *cache*, para que você não precise realizar isso frequentemente. Login Depois de realizar uma operação de *Push*, abra o seu repositório no GitHub e deverá ver uma mensagem indicando um *push* recente de uma *branch*. Você pode ver suas mudanças abrindo a seleção `Branch: main` e selecionando a sua `branch`. Parabéns! Você pode compartilhar a URL da `branch` com o mundo e mostrar o seu progresso! View pushed branch on GitHub ## Submeta as suas mudanças para uma revisão Neste ponto, você completou as mudanças, mas elas ainda estão somente no seu repositório. Esse passo te mostrará como submeter essas mudanças para um administrador para que ele possa fazer um *merge* das tuas mudanças. No seu repositório no GitHub, você verá o botão `Compare & pull request` próximo à notificação da *branch*. Cloque nesse botão. create a pull request Agora submeta o *Pull Request*. submit pull request Assim que possível, essas mudanças serão *mergeadas* para a `main branch` deste projeto. Você será notificado via email, quando essa movimentação for realizada. ## Para onde ir daqui? Parabéns! Você acabou de completar o fluxo de trabalho *fork -> clone -> edit -> PR* que vocẽ vai realizar frequentemente como um contribuidor! Celebre a sua contribuição e compartilhe-a com os seus amigos e seguidores indo para o [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/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY). Você pode se juntar à nossa comunidade no slack, caso precise de alguma ajuda ou tenha alguma dúvida. [Faça parte da nossa comunidade no Slack!](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY) ### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriais utilizando outras ferramentas [Retorne para a página principal](https://github.com/firstcontributions/first-contributions/blob/master/translations/README.pt_br.md) ================================================ FILE: docs/gui-tool-tutorials/translations/Portuguese/gitkraken-tutorial.pt-br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições |Visual Studio 2017|Visual Studio 2017 Edition| |---|---| É difícil. Sempre é difícil fazer algo pela primeira vez. Especialmente quando você está colaborando, cometer erros não é confortável. Mas o open sourece tem tudo a ver com colaboração e trabalho em equipe. Nós queremos simplificar a maneira de aprendizagem aos novos contribuidores de open source e ajudar em sua primeira contribuição. Lendo artigos e olhando tutoriais podem ajudar, mas o que é melhor do que realmente fazer as coisas sem estragar nada. Esse projeto visa em providenciar uma orientação e simplificar a maneira dos novatos a conseguirem a sua primeira contribuição. Lembre-se, quanto mais relaxado melhor será o aprendizado. Se você está procurando em fazer a sua primeira contribuição, siga esses passos abaixo. Nós prometemos a você que vai ser divertido. ## Git Kraken Baixe [GitKraken](https://www.gitkraken.com), Instale e abra. Provavelmente aparecerá um "Bem-vindo ao GitKraken" com um espaço para entrar na sua conta do GitHub e permitir que o GitKraken possa ter o acesso dela. login to GitHub (opcional) Vá para Aqruivos -> Preferências e ajuste o diretório do seu projeto para a raiz de seus repositórios locais. ## Faça um Fork deste repositório Para fazer um Fork deste repositório, basta clicar no botão de fork no topo da página. fork this repository Isso criará uma cópia do repositório na sua conta GitHub. ## Clone o seu repositório No GitKraken, vá até Arquivo -> Clone Repositório. clone this repository Selecione GitHub.com no painel direito. De baixo do nome de usuário, deverá aparecer "first-contributions". Clique nesse repositório e confirme na parte inferior do painel, se aparece o local do diretório onde você quer clonar. Quando estiver tudo certo com o diretório, clique em "Clone o repositório!" ## Crie uma Branch Clique o botão branch na barra de ferramentas. Nomeie a sua branch "add-seu-nome", for example: "add-william-sutton" name your branch ## Faça mudanças necessárias e faça um commit nelas Agora abra o arquivo `Contributors.md` em um editor de texto e adicione o seu nome, em seguida salve-o. Se você estiver com o repositório aberto no GitKraken, haverá mudanças. Revise e faça um Stage nessas mudanças selecionando o commit mais recente marcado com "// WIP" e com número de arquivos modificados e o tipo de mudança. edit some file(s) Revise esses arquivos que foram modificados e decida o que colocar no Stage. O Stage é importante, pois informa o Git extamente quais arquivos modificados você quer mandar no commit. stage your changes Quando escrever uma boa mensagem no commit ("Add para a lista de Contribuidores" parece bom e descritivo) e satisfeito com as suas mudanças, você pode apertar no "Stage todas as mudanças" para fazer o Stage em todas as alterações ou "Stage Arquivo" para cada arquivo modificado individualmente. clone this repository Se você mudar de ideia, você pode fazer um Unstage (processo reverso do Stage) das sua modificações ou discartar todas elas juntas. CUIDADO: A palavra discartar fala por si só, ou seja, é uma operação destrutiva. Só faça isso, se você não quer nenhuma mundança no repositório que estiver trabalhando. Aperte commit. Parabéns, você acabou de fazer um commit de todas as suas mudanças na sua branch local do seu Fork. Em diante! ## Faça um Push nas suas modificações para o GitHub push your changes Na barra de ferramentas, clique no botão Push. origin or branch Se você quer enviar as mudanças direto para branch master, você pode enviar para a branch de origem. Caso contrário, selecione uma branch apropriada para mandar. ## Envie as suas mudanças para revisão No seu repositório do GitHub você vai ver um botão escrito: `Compare & pull request`, que fica ao lado da notificação da nova branch. Clique nesse botão. create a pull request Agora envie esse Pull Request. submit pull request Logo irei mesclar todas as suas mudanças na branch master do projeto. Você receberá uma notificação pelo e-mail quando as alterações forem mescladas. ## Onde eu posso ir a partir daqui? Parabéns! Você completou o fluxo de trabalho básico _fork -> clone -> edit -> PR_, onde você encontrará muito como contribuidor. Celebre a sua contribuição e compartilhe com seus amigos e seguidores no [web app](https://firstcontributions.github.io/#social-share). Caso precise de ajuda ou tenha alguma pergunta, você pode se juntar à nossa equipe Slack. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [Material Adicional](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriais usando outras ferramentas [Voltar para página principal](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Spanish/gitkraken-tutorial-es.md ================================================ [![Amor por el Código Abierto](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![Licencia: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Ayudantes de Código Abierto](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeras Contribuciones |GitKraken|GitKraken Edition| |---|---| Es difícil. Siempre es difícil cuando se hace algo por primera vez. Especialmente cuando se colabora, cometer errores no es algo agradable. Pero el código abierto trata sobre la colaboración y el trabajo en conjunto. Queríamos simplificar la manera en que los contribuyentes de código abierto aprenden y contribuyen por primera vez. Leer artículos y ver tutoriales puede ayudar, pero ¿qué es mejor que hacer las cosas sin estropear nada?. Este proyecto tiene como objetivo proporcionar orientación y simplificar la manera en que los novatos hacen su primera contribución. Recuerda que cuando más relajado estés, mejor aprenderás. Si buscas hacer tu primera contribución sólo sigue los simples pasos a continuación. Te lo prometemos, será divertido. ## Git Kraken Descarga [GitKraken](https://www.gitkraken.com), Instálalo y ábrelo. Deberías ver el diálogo modal "Welcome to GitKraken" - Regístrate con Github y permite el acceso a Gitkraken a tu cuenta de GitHub. login to GitHub (opcional) Dirígete a File -> Preferences y configura el directorio de tu proyecto en la raíz de tus repositorios locales. ## Bifurca (Fork) este repositorio Bifurca este repositorio clickeando en el botón fork en la parte superior derecha de esta página. fork this repository Esto creará una copia de este repositorio en su cuenta. ## Clona el repositorio En GitKraken, ve a File -> Clone Repo. clone this repository Selecciona GitHub.com en el panel derecho. Bajo tu nombre de usuario, deberías ver first-contributions. Haz click en ese repositorio y verifica la ruta completa mostrada al final del panel. Una vez estés satisfecho con la ruta, clickea "Clone the repo!". ## Crear una rama (*branch*) Clickea el botón *branch* de la barra de herramientas. Nombra tu rama "add-your-name", por ejemplo: "add-william-sutton" name your branch ## Haz los cambios necesarios y confirma (*Commit*) esos cambios Ahora abre el archivo `Contributors.md` en un editor de texto y agrégale tu nombre, luego guarda el archivo. Si tienes el repositorio abierto en GitKraken deberías ver que hay cambios. Revisa y prepara esos cambios seleccionando la confirmación (*commit*) más reciente marcada con "// WIP" y el número de archivos cambiados y el tipo de cambio. edit some file(s) Revisa los archivos que han sido cambiados y decide cuáles deseas preparar para confirmar (*stage*). La preparación es importante para decirle a git exactamente que archivos deseas asociar con esta confirmación (*commit*). stage your changes Una vez tengas un buen mensaje de confirmación (*commit*) ("Add to Contributors list" suena agradable y descriptivo) y estés feliz con tus cambios, puedes clickear "Stage all changes" para preparar todo lo modificado o "Stage File" para preparar un archivo individual. clone this repository Si cambias de idea, puedes olvidar (*unstage*) esos cambios, o puedes descartárlos todos. ADVERTENCIA: Como lo implica la palabra descartar, esta es una operación destructiva. Hazlo solo si no quieres ningún cambio(s) desde cualquier repositorio en el que te encuentres. Clickea en *commit*. Felicidades, has confirmado (*committed*) todos los cambios a la copia local de la rama de tu bifurcación (*fork*) de first-contributions.¡Adelante!. ## Sube (*push*) los cambios a GitHub push your changes Haz click en el botón *Push* en la barra de herramientas. origin or branch Envía los cambios en la rama origen si quieres que los cambios se reflejen en la rama maestra directamente, sino selecciona la rama apropiada a la cual quieres hacer el push. ## Envía tus cambios para revisión Si vas a tu repositorio en github, verás el botón `Compare & pull request`. Haz click en él. create a pull request Ahora confirma el pull request. submit pull request Pronto estaré fusionando todos sus cambios en la rama master de este proyecto. Recibirás una notificación por correo electrónico cuando los cambios hayan sido fusionados. ## ¿Cuáles son los siguientes pasos? ¡Enhorabuena! ¡Has completado el flujo de trabajo _fork -> clone -> edit -> PR_ que encontrarás habitualmente como contribuidor! Celebra tu contribución y compártela con tus amigos y seguidores yendo a [App web](https://firstcontributions.github.io/#social-share). También podrías unirte a nuestro equipo de Slack en caso de que necesites ayuda o tengas alguna pregunta. [Únete a nuestro equipo de Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriales con otras herramientas [Regresar a la página principal](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Tamil/githiub-desktop-tutorial-tamil.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # முதல் பங்களிப்புகள் | Git Bash | Git Bash பதிப்பு | | ------------------------------------------------------------------------------------------------------------------ | ---------------- | புதியதாக எதையாவது செய்யும்போது அது கடினமாக இருக்கும். குறிப்பாக ஒத்துழைவாக வேலை செய்யும்போது, பிழைகள் செய்யப்படுவது அவசியம். ஆனால் ஓப்பன்-சோர்ஸ் என்பது ஒரே குழுவாக சூழ்நிலையாக்கி இணைந்து வேலை செய்வதே ஆகும். புதிய ஓப்பன்-சோர்ஸ் பங்களிப்பாளர்கள் முதல் முறையாக எவ்வாறு கற்றுக்கொள்கிறார்கள் மற்றும் பங்களிக்கிறார்கள் என்பது எளிமையாக நடக்க வேண்டும் தன்னெருவாகும் — இதற்காக இந்தத் திட்டம் வழிகாட்டுதல்களையும், புதியவர்களுக்கு முதல் பங்களிப்பை எளிதாக்கும் படி இலக்காகக் கொண்டுள்ளது. நீங்கள் சாந்தியுடனாக எடுத்துக் கொண்டால் நல்லதாக கற்றுக் கொள்ள முடியும் என்பதை நினைவில் வைத்துக் கொள்ளுங்கள். உங்கள் முதல் பங்களிப்பினைப் போட நினைத்தால், கீழுள்ள எளிய படிகளின்படி செல்லுங்கள். நாங்கள் உங்களுக்கு வாக்குறுதி அளிக்கிறோம் — இது சுவாரஸ்யமாய் இருக்கும். உங்கள் விண்டோஸ் இயந்திரத்தில் Git Bash இல்லையெனில், [இதை நிறுவுங்கள்](https://git-scm.com/download/win). fork this repository ## இந்த ரெப்போவை Fork செய்யவும் இந்த பக்கத்தின் மேல்பகுதியில் வலது பக்கத்தில் உள்ள **Fork** பொத்தானை அழுத்தி இந்த ரெப்போகையை Fork (நகலெடுக்க) செய்யுங்கள். இது உங்கள் GitHub கணக்கில் இந்த ரெப்போவின் ஒரு நகலை உருவாக்கும். ## ரெப்போவை Clone செய்யவும் இப்பொழுது இந்த ரெப்போ உங்கள் மிஷினுக்கு clone செய்யுங்கள். முக்கியம்: அசல் (original) ரெப்போவை clone செய்ய வேண்டாம். உங்கள் கணக்கில் Fork செய்துக்கொண்டிருக்கும் உங்கள் நகலை clone செய்யுங்கள். ரெப்போவை clone செய்ய, **Code** என்பதனை கிளிக் செய்து கீழே உள்ள string ஐ copy செய்யுங்கள். copy string இப்போது நீங்கள் டெவுன்லோட் செய்த Git Bash ஆப்லிக்கேஷன் திறக்கவும். விண்டோஸ் இயந்திரத்தில் இருந்தால் கீழ்க்காணும் போன்றதாக இருக்கும். open git bash terminal இந்தக் கமாண்டை பயன்படுத்தி நீங்கள் சேமிக்க விரும்பும் கோப்புறைக்குள் செல்லவும்: `cd ` cd into a folder இந்த கட்டளையைக் கொண்டு மேலே நகலெடுத்து கொள்ளவேண்டிய string-ஐ பயன்படுத்தி ரெப்போவை clone செய்யுங்கள்: `git clone ` clone the repository இப்போது உங்கள் மாற்றங்களைச் சேர்க்க இந்த ரெப்போ அடைவை (directory) திறந்து அதை VS Code-ல் (அல்லது உங்கள் விருப்பமான எடிட்டரில்) திறக்கவும். cd into the newly cloned repo ## ஒரு கிளை (Branch) உருவாக்கவும் இப்பொழுது இந்த எளிய கமாண்டின் மூலம் ஒரு branch (கிளை) உருவாக்குங்கள். இந்த கட்டளை புதிய கிளையையும் அதிலே சுவராக நகரவும்தான் செய்கிறது. ``` git checkout -b <கிளை-பெயர்> ``` உங்கள் கிளைக்கு `<உங்கள்-பெயர்>` என பெயர் வையுங்கள். உதாரணமாக: `add-james-smith` create a branch ## தேவையான மாற்றங்களைச் செய்து சேமிக்கவும் இப்பொழுது `Contributors.md` என்ற கோப்பை உங்கள் டெக்ஸ்ட் எடிட்டரில் திறந்து, பக்கத்தின் கீழ் உங்கள் பெயரை சேர்க்கவும், பின்னர் கோப்பை சேமிக்கவும். உதாரணம்: உங்கள் பெயர் James Smith என்றால் அது இவ்வாறு இருக்கும்: [James Smith]([https://github.com/jamessmith](https://github.com/jamessmith)) இந்தக் கட்டளையை இயக்குவதால் Contributors.md-ல் மாற்றங்கள் உள்ளதா என்று காணலாம்: `git status` check the status இப்போது அந்த மாற்றங்களை உருவாக்குவோம்: முதலில் மாற்றத்தை staging பகுதிக்கு சேர்க்கவும்: `git add <கோப்பு-பெயர்>` பின்பு ஒரு commit செய்தியுடன் commit செய்யுங்கள்: `git commit -m "Add your name to the contributors list"` ``-ஐ உங்கள் பெயரால் மாற்றுங்கள். commit changes உங்கள் commit செய்து முடிந்ததா என்று பார்க்க விரும்பினால் இந்த எளிய கட்டளையை நடத்தியே பார்க்கலாம்: `git log --oneline` ## மாற்றங்களை GitHub-லுக்கு push செய்யவும் மேலுள்ள படிகள் முடிந்த பிறகு, கீழ்காணும் கட்டளையினால் உங்கள் மாற்றங்களை GitHub-லுக்கு தள்ளலாம் (push): `git push origin ` push changes ## உங்கள் மாற்றங்களை விமர்சனைக்கு (review) சமர்ப்பிக்கவும் GitHub-ல உங்கள் ரெப்போவில் சென்றால், **Compare & pull request** என்ற பட்டனை காண்பீர்கள். அதனை கிளிக் செய்யவும். create a pull request இப்போது pull request (PR) சமர்ப்பிக்கவும். submit pull request நான் விரைவில் உங்கள் மாற்றங்களை project's master (அல்லது main) கிளையில் merge (இணைக்க) செய்து கொள்வேன். மாற்றங்கள் merge ஆனதும், உங்களுக்கு ஒரு மின்னஞ்சல் அறிவிப்பு வரும். ## இங்கிருந்து அடுத்து எங்கே போகலாம்? வாழ்த்துகள்! நீங்கள் ஒரு contributor ஆக வரும்போது அடிக்கடி கடைபிடிக்கப்படும் வழிமுறை olan *Fork -> Clone -> Edit -> PR* பணிமுறையை முடித்துவிட்டீர்கள்! [வலை பயன்பாட்டிற்கு (web app) சென்று உங்கள் பங்களிப்புகளை கொண்டாடுங்கள் மற்றும் நண்பர்கள்/பின்தொடர்நிலையர்களுடன் பகிருங்கள்.](https://firstcontributions.github.io#social-share) எதையாவது உதவி வேண்டுமெனில் அல்லது கேள்விகள் இருந்தால் எங்கள் Slack குழுவில் சேருங்கள். [Slack குழுவில் சேரவும்](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [மேலும் படிக்க](../additional-material/git_workflow_scenarios/additional-material.md) ## வேறு கருவிகள் பயன்படுத்தி உள்ள பயிற்சி பாடங்கள் [முதன்மை பக்கத்திற்கு திரும்பு](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/Urdu/github-desktop-urdu.md ================================================ ٹھیک ہے 👍 آپ نے جو متن دیا ہے وہ **First Contributions** گائیڈ ہے (GitKraken ایڈیٹر کے ساتھ)۔ میں اس کو اُردو میں ترجمہ کر رہا ہوں تاکہ آسانی سے سمجھ سکیں۔ --- # پہلی شراکتیں (First Contributions) | GitKraken | GitKraken ایڈیشن | | ------------------------------------------------------------------------------------------------------------------------------------- | ---------------- | یہ مشکل ہے۔ پہلی بار کچھ کرنے پر ہمیشہ مشکل لگتا ہے۔ خاص طور پر جب آپ تعاون (collaboration) کر رہے ہوں تو غلطیاں کرنا اچھا نہیں لگتا۔ لیکن اوپن سورس کا مقصد ہی تعاون اور ایک ساتھ کام کرنا ہے۔ ہم چاہتے تھے کہ نئے لوگ آسانی سے سیکھ سکیں اور اپنی پہلی شراکت (contribution) کر سکیں۔ آرٹیکل پڑھنا اور ویڈیوز دیکھنا مددگار ہوتا ہے، لیکن اصل مزہ تب ہے جب آپ خود کر کے سیکھیں بغیر کچھ توڑے پھوڑے۔ اس پروجیکٹ کا مقصد یہ ہے کہ نئے لوگ آسانی سے اپنی پہلی شراکت کریں۔ یاد رکھیں جتنا ریلیکس رہیں گے، اتنا بہتر سیکھیں گے۔ اگر آپ پہلی بار کانٹریبیوٹ کرنا چاہتے ہیں تو نیچے دیے گئے آسان مراحل پر عمل کریں۔ یقین کریں یہ مزےدار ہوگا۔ --- ## GitKraken [GitKraken](https://www.gitkraken.com) ڈاؤن لوڈ کریں، انسٹال کریں اور کھولیں۔ آپ کو "Welcome to GitKraken" کا ڈائیلاگ باکس نظر آئے گا۔ GitHub کے ساتھ لاگ ان کریں اور GitKraken کو اپنے GitHub اکاؤنٹ تک رسائی دیں۔ (اختیاری) File -> Preferences میں جا کر اپنے پروجیکٹ کا ڈائریکٹری سیٹ کریں تاکہ وہ آپ کے مقامی ریپوزیٹریز کے ساتھ جڑ جائے۔ --- ## ریپوزیٹری کو فورک کریں اس صفحے کے اوپر دائیں طرف موجود **Fork** بٹن پر کلک کریں۔ یہ آپ کے اکاؤنٹ میں اس ریپوزیٹری کی ایک کاپی بنا دے گا۔ --- ## ریپوزیٹری کو کلون کریں GitKraken میں جائیں: File -> Clone Repo. GitHub.com منتخب کریں۔ اپنے یوزرنیم کے نیچے **first-contributions** ریپوزیٹری دکھائی دے گی۔ اسے منتخب کریں اور آخر میں دی گئی لوکل پاتھ چیک کر لیں۔ جب سب صحیح لگے تو "Clone the repo!" پر کلک کریں۔ --- ## نئی برانچ بنائیں ٹول بار میں *branch* بٹن پر کلک کریں۔ برانچ کا نام رکھیں: "add-your-name" مثال: `"add-william-sutton"` --- ## تبدیلیاں کریں اور Commit کریں `Contributors.md` فائل کو کھولیں اور اپنا نام شامل کریں۔ فائل محفوظ (save) کریں۔ اب GitKraken میں تبدیلیاں نظر آئیں گی۔ اپنی تبدیلیوں کو stage کریں اور ایک اچھا commit میسج لکھیں۔ مثال: `"Add to Contributors list"` پھر **commit** بٹن پر کلک کریں۔ مبارک ہو 🎉 آپ نے اپنی تبدیلیاں مقامی ریپوزیٹری میں محفوظ کر لی ہیں۔ --- ## تبدیلیاں GitHub پر Push کریں ٹول بار میں *Push* بٹن پر کلک کریں۔ اپنی برانچ کو GitHub پر بھیج دیں تاکہ آپ کی تبدیلیاں وہاں بھی نظر آئیں۔ --- ## Pull Request بھیجیں GitHub پر جائیں، آپ کو "Compare & pull request" کا بٹن نظر آئے گا۔ اس پر کلک کریں۔ اب اپنی pull request سبمٹ کریں۔ آپ کی تبدیلیاں ریویو کے بعد مین برانچ میں شامل کر دی جائیں گی۔ جب ایسا ہوگا آپ کو ای میل نوٹیفکیشن ملے گا۔ --- ## اگلے مراحل مبارک ہو! آپ نے وہ مکمل ورک فلو کر لیا جو ایک عام اوپن سورس کانٹریبیوٹر کو کرنا پڑتا ہے: **fork → clone → edit → PR** اپنی شراکت کا جشن منائیں 🎉 اور اسے دوستوں کے ساتھ شیئر کریں۔ اگر مزید مدد چاہیے تو آپ [Slack ٹیم](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) میں بھی شامل ہو سکتے ہیں۔ --- کیا آپ چاہتے ہیں میں اس کا **سارانس (short version)** بھی اردو میں بنا دوں تاکہ پہلی بار اوپن سورس کنٹریبیوٹ کرنے والے کو صرف بنیادی مراحل نظر آئیں؟ ================================================ FILE: docs/gui-tool-tutorials/translations/Yoruba/github-desktop-tutorial.ng_yo.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Awọn ẹbun akọkọ | GitHub Desktop | GitHub Ojú-iṣẹ Edition | | ----------------------------------------------------------------------------------------------- | ---------------------- | O le. O jẹ lile nigbagbogbo ni igba akọkọ ti o ṣe nkan. Paapa nigbati o ba n ṣe ifowosowopo, ṣiṣe awọn aṣiṣe kii ṣe nkan ti o ni itunu. Ṣugbọn orisun ṣiṣi jẹ gbogbo nipa ifowosowopo & ṣiṣẹ papọ. A fẹ lati jẹ ki o rọrun ni ọna ti awọn oluranlọwọ orisun-ìmọ tuntun kọ ẹkọ & ṣe alabapin fun igba akọkọ. Awọn nkan kika & wiwo awọn olukọni le ṣe iranlọwọ, ṣugbọn kini o dara julọ ju ṣiṣe nkan naa ni gangan laisi dabaru ohunkohun. Ise agbese yii ni ero lati pese itọnisọna & simplifying ọna ti awọn rookies ṣe ṣe ilowosi akọkọ wọn. Ranti diẹ sii ni ihuwasi ti o dara julọ ti o kọ ẹkọ. Ti o ba n wa ṣiṣe ilowosi akọkọ rẹ kan tẹle awọn igbesẹ ti o rọrun ni isalẹ. A ṣe ileri fun ọ, yoo jẹ igbadun. Ti o ko ba ni Ojú-iṣẹ GitHub lori ẹrọ rẹ, [fi sii] (https://desktop.github.com/). Ti o ba n lo ẹya ti tabili GitHub ṣaaju 1.0, [tọkasi ikẹkọ yii](github-desktop-old-version-tutorial.md). orita ibi ipamọ yii ## Orita ibi ipamọ yii Fork repo yii nipa tite lori bọtini orita ni apa ọtun oke ti oju-iwe yii. Eyi yoo ṣẹda ẹda ibi ipamọ yii sinu akọọlẹ rẹ. ## Ti ẹda ibi ipamọ naa Bayi clone repo yii si ẹrọ rẹ. PATAKI: MAA ṢE TI AWỌN REPO ORIGINAL. Lọ si orita rẹ ki o ṣe oniye rẹ. Lati ṣe oniye repo, tẹ lori "Clone tabi Download" ati lẹhinna tẹ "Ṣii ni Ojú-iṣẹ". clone this repository Ferese agbejade yoo ṣii. Tẹ "Ṣii GitHubDesktop.exe". clone this repository Lẹhin ti o tẹ “Ṣii GitHubDesktop.exe” awọn akoonu naa yoo ṣe igbasilẹ si kọnputa rẹ. clone this repository Bayi o ti daakọ awọn akoonu ti ibi ipamọ awọn ifunni akọkọ ni github si kọnputa rẹ. ## Ṣẹda ẹka kan Bayi ṣẹda ẹka kan nipa tite lori aami “Ẹka lọwọlọwọ” ni oke ati lẹhinna tẹ “Ẹka Tuntun”: name your branch Tẹ 'Ṣẹda ẹka' ## Ṣe awọn ayipada to ṣe pataki ki o ṣe awọn ayipada yẹn Bayi ṣii faili `Contributors.md` ni olootu ọrọ, yi lọ si isalẹ ti oju-iwe naa ki o fi orukọ rẹ kun, lẹhinna fi faili naa pamọ. Apeere: Ti orukọ rẹ ba jẹ James Smith, O yẹ ki o dabi eleyi. \[James Smith](https://github.com/jamessmith) O le rii pe awọn ayipada wa si Contributors.md ati pe wọn ti ṣafikun si Ojú-iṣẹ Github. check status Bayi ṣe awọn ayipada wọnyi: Kọ ifiranṣẹ naa "Ṣafikun `` si atokọ Awọn oluranlọwọ” ni aaye _ akopọ _. Ropo `` pẹlu orukọ rẹ. Tẹ bọtini ti o sọ 'Ṣe lati fi-orukọ-rẹ'. commit your changes Ni isalẹ, o le rii pe a ti ṣẹda ifaramọ naa. ṣe awọn ayipada rẹ ## Titari awọn ayipada si github Tẹ Faili-> Awọn aṣayan ati wọle si Github.com. Tẹ orukọ olumulo Github ati ọrọ igbaniwọle sii. wọle si Github Tẹ bọtini 'Tẹjade' ni apa ọtun oke. Titari awọn ayipada rẹ ## Firanṣẹ awọn ayipada rẹ fun atunyẹwo Ti o ba lọ si ibi ipamọ rẹ lori github, iwọ yoo rii bọtini 'Afiwe & fa ìbéèrè'. tẹ lori wipe bọtini. ṣẹda ibeere fifa Bayi fi ibeere fa silẹ. fi ìbéèrè fa Laipẹ Emi yoo dapọ gbogbo awọn ayipada rẹ si ẹka ọga ti iṣẹ akanṣe yii. Iwọ yoo gba imeeli iwifunni ni kete ti awọn ayipada ba ti dapọ. ## Nibo ni lati lọ lati ibi? Oriire! O kan pari boṣewa _fork -> oniye -> edit -> PR_ iṣan-iṣẹ ti iwọ yoo ba pade nigbagbogbo bi oluranlọwọ! Ṣe ayẹyẹ ilowosi rẹ ki o pin pẹlu awọn ọrẹ ati awọn ọmọlẹyin rẹ nipa lilọ si [ohun elo wẹẹbu](https://firstcontributions.github.io#social-share). O le darapọ mọ ẹgbẹ alailẹṣẹ wa ni ọran ti o nilo iranlọwọ eyikeyi tabi ni awọn ibeere eyikeyi. [Darapọ mọ ẹgbẹ alailẹṣẹ](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYVk) ### [Awọn ohun elo afikun](../additional-material/git_workflow_scenarios/additional-material.md) ## Awọn olukọni Lilo Awọn irinṣẹ miiran [Pada si oju-iwe akọkọ](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/github-desktop-tutorial-np.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # पहिलो योगदान(Contribution) | GitHub Desktop | 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). 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" मा क्लिक गर्नुहोस्। clone this repository एउटा pop up window खुल्छ त्यसमा "Open GitHubDesktop.exe" मा क्लिक गर्नुहोस्। clone this repository "Open GitHubDesktop.exe" मा क्लिक गरेपछि repo को content हरु कम्प्युटरमा download हुन्छ। clone this repository अब repo को content कम्प्युटरमा copy गरेपछि `first-contributions` नामको _repository_ GitHubDesktop मा देखिन्छ। ## Repository मा एउटा branch बनाउनुहोस् अब माथिको "Current branch" आइकनमा क्लिक गरेर शाखा(branch) बनाउनुहोस् र त्यसपछि "New branch" मा क्लिक गर्नुहोस्: make a branch अब branch को नाम दिनुहोस् . For example, "add-ram-regmi" (ब्रान्चको नाममा add शब्दको आवश्यकता छैन, तर यसमा add समावेश गर्न उचित छ किनभने यस branch को उद्देश्य तपाईंको नामलाई contributors को सूची(list)मा थप्ने हो।) 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 मा थपिएका छन्। check status अब ती परिवर्तनहरू प्रतिबद्ध(commit) गर्नुहोस्: _summary_ फिल्डमा "Add `` to Contributors list" सन्देश(commit message) लेख्नुहोस्। `` लाई आफ्नो नामले बदल्नुहोस्। `Commit to add-your-name` भन्ने बटनमा क्लिक गर्नुहोस्। commit your changes तल, तपाइँ the commit has been created भनेर देख्न सक्नुहुन्छ। commit your changes ## GitHub मा परिवर्तनहरुलाई push गर्नुहोस। File->Options मा क्लिक गर्नुहोस् र तपाईंको Github username र password टाइप गरि Github.com मा साइन इन गर्नुहोस्।। log-in to Github top right भएको `Publish` button मा क्लिक गर्नुहोस्। push your changes ## Review को लागि तपाईंको परिवर्तनहरू पेश गर्नुहोस्। यदि तपाईं आफ्नो गिटहब रिपोजिटोरी ( GitHub Repository) मा जानुहुन्छ भने, तपाइँले `Compare & pull request` बटन देख्नुहुनेछ। त्यस बटनमा क्लिक गर्नुहोस्। create a pull request अब pull request पेश गर्नुहोस्। 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) ================================================ FILE: docs/gui-tool-tutorials/translations/github-desktop-tutorial.cn.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # 第一次做贡献 | GitHub Desktop | GitHub Desktop Edition | | ----------------------------------------------------------------------------------------------- | ---------------------- | 这是一个针对初次参与者的指南。 难。做任何事情的第一次总是难的。特别是在合作时，犯错并不是一件舒服的事情。但开源就是关于合作与共同工作的。我们想要简化新开源贡献者第一次学习和贡献的方式。 阅读文章和观看教程可以帮助，但实际操作而不搞砸任何事情会更好。这个项目旨在提供指导并简化新手做出他们的第一次贡献的方式。记住，你越放松，你学得就越好。如果你在寻找做出你的第一次贡献，只需跟随下面的简单步骤。我们保证这将是有趣的。 如果你的机器上没有GitHub Desktop，请[安装它](https://desktop.github.com/)。 如果你使用的是GitHub Desktop 1.0之前的版本，请[参考这个教程](github-desktop-old-version-tutorial.md)。 fork this repository ## Fork this repository 通过点击这个页面右上角的 fork 按钮来 fork 这个repository。这将在你的账户中创建这个repository的一个副本。 ## Clone the repository 现在将这个repository克隆到你的机器上。 重要提示：不要克隆原始repository。去你的 fork repository然后克隆它。 要克隆repository，点击“Clone or Download”然后点击“Open in Desktop”。 克隆这个repository 一个弹出窗口将打开。点击“Open GitHubDesktop.exe”。 克隆这个repository 克隆这个repository 在你点击“Open GitHubDesktop.exe”后，内容将被下载到你的计算机上。 克隆这个repository 克隆这个repository 现在你已经将第一个贡献者仓库在github的内容复制到了你的计算机上。 克隆这个repository ## Create a branch 现在通过点击顶部的“Current branch”图标然后点击“New branch”来创建一个分支： 创建一个分支 将你的分支命名为。例如，“add-james-smith” 命名你的分支 点击 `Create branch` ## Make necessary changes and commit those changes 现在，转到历史标签页并通过右击然后在文本编辑器中打开Contributors.md文件。滚动到页面底部并添加你的名字，然后保存文件。 例如：如果你的名字是James Smith，它应该看起来像这样。 \[James Smith](https://github.com/jamessmith) 你可以看到Contributors.md有变化，它们已经被添加到Github Desktop。 检查状态 现在提交这些变化： 在summary字段中写上"Add to Contributors list"作为消息。 将替换为你的名字。 点击写着Commit to add-your-name的按钮。 在底部，你可以看到已经创建了提交。 提交你的变化 ## Push changes to github 点击File->Options并登录到Github.com。输入你的Github用户名和密码。 登录到Github 点击右上角的Publish按钮。 推送你的变化 推送你的变化 ## Submit your changes for review 如果你去你在github上的仓库，你会看到Compare & pull request按钮。点击那个按钮。 创建一个pull请求 创建一个拉取请求 现在提交拉取请求。 提交pull请求 很快我就会将所有的更改合并到这个项目的master分支中。一旦更改被合并，你将收到通知邮件。 ## Where to go from here? 恭喜！你刚刚完成了你会经常遇到的作为贡献者的标准fork -> clone -> edit -> PR工作流程！ 庆祝你的贡献，并通过去[web app](https://firstcontributions.github.io#social-share)与你的朋友和追随者分享。 如果你需要任何帮助或有任何问题，你可以加入我们的[slack团队](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 [回到主页](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/github-desktop-tutorial.ng_yr.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Awọn ẹbun akọkọ | GitHub Desktop | GitHub Ojú-iṣẹ Edition | | ----------------------------------------------------------------------------------------------- | ---------------------- | O le. O jẹ lile nigbagbogbo ni igba akọkọ ti o ṣe nkan. Paapa nigbati o ba n ṣe ifowosowopo, ṣiṣe awọn aṣiṣe kii ṣe nkan ti o ni itunu. Ṣugbọn orisun ṣiṣi jẹ gbogbo nipa ifowosowopo & ṣiṣẹ papọ. A fẹ lati jẹ ki o rọrun ni ọna ti awọn oluranlọwọ orisun-ìmọ tuntun kọ ẹkọ & ṣe alabapin fun igba akọkọ. Awọn nkan kika & wiwo awọn olukọni le ṣe iranlọwọ, ṣugbọn kini o dara julọ ju ṣiṣe nkan naa ni gangan laisi dabaru ohunkohun. Ise agbese yii ni ero lati pese itọnisọna & simplifying ọna ti awọn rookies ṣe ṣe ilowosi akọkọ wọn. Ranti diẹ sii ni ihuwasi ti o dara julọ ti o kọ ẹkọ. Ti o ba n wa ṣiṣe ilowosi akọkọ rẹ kan tẹle awọn igbesẹ ti o rọrun ni isalẹ. A ṣe ileri fun ọ, yoo jẹ igbadun. Ti o ko ba ni Ojú-iṣẹ GitHub lori ẹrọ rẹ, [fi sii] (https://desktop.github.com/). Ti o ba n lo ẹya ti tabili GitHub ṣaaju 1.0, [tọkasi ikẹkọ yii](github-desktop-old-version-tutorial.md). orita ibi ipamọ yii ## Orita ibi ipamọ yii Fork repo yii nipa tite lori bọtini orita ni apa ọtun oke ti oju-iwe yii. Eyi yoo ṣẹda ẹda ibi ipamọ yii sinu akọọlẹ rẹ. ## Ti ẹda ibi ipamọ naa Bayi clone repo yii si ẹrọ rẹ. PATAKI: MAA ṢE TI AWỌN REPO ORIGINAL. Lọ si orita rẹ ki o ṣe oniye rẹ. Lati ṣe oniye repo, tẹ lori "Clone tabi Download" ati lẹhinna tẹ "Ṣii ni Ojú-iṣẹ". clone this repository Ferese agbejade yoo ṣii. Tẹ "Ṣii GitHubDesktop.exe". clone this repository Lẹhin ti o tẹ “Ṣii GitHubDesktop.exe” awọn akoonu naa yoo ṣe igbasilẹ si kọnputa rẹ. clone this repository Bayi o ti daakọ awọn akoonu ti ibi ipamọ awọn ifunni akọkọ ni github si kọnputa rẹ. ## Ṣẹda ẹka kan Bayi ṣẹda ẹka kan nipa tite lori aami “Ẹka lọwọlọwọ” ni oke ati lẹhinna tẹ “Ẹka Tuntun”: name your branch Tẹ 'Ṣẹda ẹka' ## Ṣe awọn ayipada to ṣe pataki ki o ṣe awọn ayipada yẹn Bayi ṣii faili `Contributors.md` ni olootu ọrọ, yi lọ si isalẹ ti oju-iwe naa ki o fi orukọ rẹ kun, lẹhinna fi faili naa pamọ. Apeere: Ti orukọ rẹ ba jẹ James Smith, O yẹ ki o dabi eleyi. \[James Smith](https://github.com/jamessmith) O le rii pe awọn ayipada wa si Contributors.md ati pe wọn ti ṣafikun si Ojú-iṣẹ Github. check status Bayi ṣe awọn ayipada wọnyi: Kọ ifiranṣẹ naa "Ṣafikun `` si atokọ Awọn oluranlọwọ” ni aaye _ akopọ _. Ropo `` pẹlu orukọ rẹ. Tẹ bọtini ti o sọ 'Ṣe lati fi-orukọ-rẹ'. commit your changes Ni isalẹ, o le rii pe a ti ṣẹda ifaramọ naa. ṣe awọn ayipada rẹ ## Titari awọn ayipada si github Tẹ Faili-> Awọn aṣayan ati wọle si Github.com. Tẹ orukọ olumulo Github ati ọrọ igbaniwọle sii. wọle si Github Tẹ bọtini 'Tẹjade' ni apa ọtun oke. Titari awọn ayipada rẹ ## Firanṣẹ awọn ayipada rẹ fun atunyẹwo Ti o ba lọ si ibi ipamọ rẹ lori github, iwọ yoo rii bọtini 'Afiwe & fa ìbéèrè'. tẹ lori wipe bọtini. ṣẹda ibeere fifa Bayi fi ibeere fa silẹ. fi ìbéèrè fa Laipẹ Emi yoo dapọ gbogbo awọn ayipada rẹ si ẹka ọga ti iṣẹ akanṣe yii. Iwọ yoo gba imeeli iwifunni ni kete ti awọn ayipada ba ti dapọ. ## Nibo ni lati lọ lati ibi? Oriire! O kan pari boṣewa _fork -> oniye -> edit -> PR_ iṣan-iṣẹ ti iwọ yoo ba pade nigbagbogbo bi oluranlọwọ! Ṣe ayẹyẹ ilowosi rẹ ki o pin pẹlu awọn ọrẹ ati awọn ọmọlẹyin rẹ nipa lilọ si [ohun elo wẹẹbu](https://firstcontributions.github.io#social-share). O le darapọ mọ ẹgbẹ alailẹṣẹ wa ni ọran ti o nilo iranlọwọ eyikeyi tabi ni awọn ibeere eyikeyi. [Darapọ mọ ẹgbẹ alailẹṣẹ](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYVk) ### [Awọn ohun elo afikun](../additional-material/git_workflow_scenarios/additional-material.md) ## Awọn olukọni Lilo Awọn irinṣẹ miiran [Pada si oju-iwe akọkọ](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/github-desktop-tutorial.pt_br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions | GitHub Desktop | GitHub Desktop Edition | | ----------------------------------------------------------------------------------------------- | ---------------------- | É difícil. É sempre difícil fazer algo pela primeira vez. Especialmente quando se está colaborando, cometer erros não é algo agradável. Mas _open source_ (código aberto) se trata de colaboração e de trabalharmos juntos. Queremos simplificar a forma com que novos colaboradores _open source_ aprendem e contribuem pela primeira vez. Ler artigos e ver tutoriais pode ajudar, mas o que é melhor do que realmente pôr a mão na massa em um ambiente prático? Este projeto visa guiar e simplificar a forma com que os novatos fazem a sua primeira contribuição. Se quiser fazer a sua primeira contribuição, siga os passos abaixo. Se você nao tem o Github desktop na sua máquina, [instale aqui](https://desktop.github.com/). Se você está usando uma versão do Github desktop antes da 1.0, [consulte este tutorial](github-desktop-old-version-tutorial.md). fork este repositório ## Fork este repositório Fork este repositório clicando no botão fork na parte superior direita dessa página. Isso vai criar uma cópia desse repositório na sua conta. ## Clone este repositório Agora clone esse repositório na sua máquina. IMPORTANTE: NÃO CLONE O REPOSITÓRIO ORIGINAL. Vá para o seu fork e clone. Para clonar esse repositório, clique em "Clone or Download" e então clique em "Open in Desktop". clone este repositório Uma janela pop up vai aparecer. Clique em "Open GitHubDesktop.exe". clone este repositório Depois de clicar em "Open GitHubDesktop.exe" os arquivos serão baixados para o seu computador. clone este repositório Agora você copiou os arquivos do repositório first-contributions no github para o seu computador. ## Criando uma branch (ramo) Agora crie uma branch clicando na aba "Current branch" que fica no topo, depois clique em "New branch": criar uma branch Nomeie sua branch como . Por exemplo, "add-james-smith" nomeie sua branch Clique em `Create branch` ## Faça as mudanças necessárias e commit essas mudanças Agora abra o arquivo `Contributors.md` em um editor de texto, vá para o final do arquivo e adicione seu nome, depois salve o arquivo. Exemplo: Se o seu nome for James Smith, Deve ficar parecido com isso. \[James Smith](https://github.com/jamessmith) Você pode ver as alterações feitas em Contributors.md no Github Desktop. checar mudanças Agora faça commit dessas alterações: Escreva a mensagem "Add `` to Contributors list" no campo _sumary_ Substitua `` pelo seu nome. Clique no botão que diz `Commit to add-your-name`. commit suas alterações Na parte inferior, você pode ver que o commit foi criado com sucesso. commit suas alterações ## Faça o push das mudanças no github Clique em File -> Options e depois em sign-in to Github.com. Digite seu username e senha do Github. log-in no Github Clique no botão `Publish` na parte superior direita. push suas alterações ## Envie suas alterações para review Se você for até seu repositório no github, verá o botão `Compare & pull request`. Clique nesse botão criando um pull request Agora envie o pull request. enviando o pull request Em breve estarei mesclando todas as suas alterações na branch Master do projeto. Você vai receber um email de notificação assim que as alterações forem integradas. ## Qual o próximo passo? Parabéns! Você acabou de completar o fluxo _fork -> clone -> edit -> PR_ que encontrará diversas vezes como contribuidor! Comemore sua contribuição e compartilhe com seus amigos e seguidores acessando o [web app](https://firstcontributions.github.io#social-share). Você pode entrar na nossa equipe no Slack caso precise de alguma ajuda ou tenha alguma dúvida. [Entre no Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [Material adicional](../additional-material/git_workflow_senarios/additional-material.md) ## Tutoriais usando outras ferramentas [Voltar a página principal](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/github-desktop-tutorial.th.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Contributions แรก | GitHub Desktop | GitHub Desktop Edition | | ----------------------------------------------------------------------------------------------- | ---------------------- | มันเป็นเรื่องยาก, มันยากเสมอในครั้งแรกที่คุณทำอะไร โดยเฉพาะเมื่อคุณทำงานร่วมกัน, การทำผิดไม่ใช่เรื่องที่สบายใจ แต่ โอเพนซอร์ส (open source) นั้นเป็นเรื่องของการทำงานร่วมกัน และเราจึงอยากให้ผู้ที่เข้ามาใหม่ได้เรียนรู้วิธีการ "คอนทริบิ้วต์" ผลงานร่วมกับผู้อื่นใน GitHub การอ่านบทความและการดูวิดีโอสอนอาจจะช่วยให้คุณเข้าใจได้ดีขึ้น แต่มันยังไม่เท่ากับการทำจริง ๆ โดยไม่ทำผิดอะไร โครงการนี้จึงมีวัตถุประสงค์เพื่อให้ผู้ที่เข้ามาใหม่ได้เรียนรู้วิธีการ "คอนทริบิ้วต์" ผลงานร่วมกับผู้อื่นใน GitHub โดยที่ไม่พลาดอะไร ยิ่งคุณผ่อนคลายมากเท่าไหร่ คุณก็ยิ่งเรียนรู้ได้ดีมากขึ้นเท่านั้น ! ถ้าคุณอยากร่วมส่งคอนทริบิ้วชั่นครั้งแรก ให้ทำตามขั้นตอนด้านล่างนี้ แล้วคุณจะเห็นว่ามันน่าสนุกมาก ถ้าคุณยังไม่มี GitHub Desktop ในเครื่อง, [ดาวน์โหลดเลย](https://desktop.github.com/) ถ้าคุณใช้ GitHub desktop เวอร์ชั่นเก่ากว่า 1.0, [อ่านที่นี่](github-desktop-old-version-tutorial.md) fork this repository ## กด "Fork" โปรเจ็คนี้ คุณสามารถแยกโปรเจ็คหลักออกไปทำที่แอคเคาน์ส่วนตัวของคุณได้ โดยการกดที่ปุ่ม "Fork" ที่ด้านบนขวาของหน้านี้ แล้วโปรเจ็คหลักจะถูกคัดลอกนำไปใส่ไว้ในแอคเคาน์ของคุณ ## กด "Clone" โปรเจ็คนี้ ได้เวลาคัดลอกโปรเจ็คนี้ไปที่เครื่องของคุณ สำคัญ: อย่าคัดลอกโปรเจ็คหลัก ไปที่โปรเจ็คที่คุณคัดลอกไว้ในขั้นตอนก่อนหน้านี้ในแอคเคาน์ของคุณแล้วคัดลอกมัน ในการคัดลอกโปรเจ็คนี้ไปยังเครื่องของคุณ กด "Clone or Download" แล้วกด "Open in Desktop" clone this repository การแจ้งเตือนจะปรากฏขึ้นมา กดที่ "Open GitHubDesktop.exe" clone this repository หลังจากคุณกด "Open GitHubDesktop.exe" โปรเจ็คจะถูกดาวน์โหลดไปยังเครื่องของคุณ clone this repository ตอนนี้คุณได้คัดลอกเนื้อหาของโปรเจ็ค first-contributions จาก github ไปยังเครื่องของคุณแล้ว ## สร้าง branch ตอนนี้สร้าง branch โดยการคลิกที่ "Current branch" ที่ด้านบนแล้วคลิกที่ "New branch": make a branch ตั้งชื่อ branch ของคุณ . ตัวอย่างเช่น "add-james-smith" name your branch กดที่ `Create branch` ## สร้างการเปลี่ยนแปลง และ commit การเปลี่ยนแปลง ไปที่แท็บ `History` และเปิดไฟล์ `Contributors.md` ในตัวแก้ไขข้อความ (Text Editor)โดยการคลิกขวาและเปิดในตัวแก้ไขข้อความ (Text Editor) ลองเลื่อนไปที่ด้านล่างของหน้าจอและเพิ่มชื่อของคุณลงไป แล้วบันทึกไฟล์ ตัวอย่าง: ถ้าชื่อของคุณคือ James Smith ควรจะมีลักษณะดังนี้ \[James Smith](https://github.com/jamessmith) You can see that there are changes to Contributors.md and they have been added to the Github Desktop. คุณจะเห็นได้ว่ามีการเปลี่ยนแปลงในไฟล์ `Contributors.md` และมันถูกเพิ่มเข้าไปใน Github Desktop check status Commit การเปลี่ยนแปลง: เขียนข้อความ "Add `` to Contributors list" ในช่อง _summary_ แทนที่ `` ด้วยชื่อของคุณ กดที่ปุ่มที่มีข้อความ `Commit to add-your-name` commit your changes ในด้านล่างคุณจะเห็นได้ว่าการ commit ถูกสร้างขึ้น commit your changes ## "Push" โค้ดที่เปลี่ยนไปบน GitHub กดที่ `File` -> `Options` และล็อกอินเข้าสู่ Github.com พิมพ์ชื่อผู้ใช้และรหัสผ่านของ Github ของคุณ log-in to Github กดปุ่ม `Publish` ที่ด้านขวาบน push your changes ## ส่งผลงานของคุณและรอรีวิว ถ้าคุณไปที่ repository ของคุณบน Github คุณจะเห็นปุ่ม `Compare & pull request` กดที่ปุ่มนั้น create a pull request ได้เวลาส่งผลงานของคุณ submit pull request ในเร็ว ๆ นี้เราจะรวมการเปลี่ยนแปลงทั้งหมดของคุณเข้าไปใน `master` ของโปรเจคนี้ คุณจะได้รับอีเมลแจ้งเตือนเมื่อมีการเปลี่ยนแปลงที่ถูก merge ## หลังจากนี้ตองทำอะไรต่อ? Congrats! You just completed the standard _fork -> clone -> edit -> PR_ workflow that you'll encounter often as a contributor! ยินดีด้วย! คุณเพิ่งผ่านการทำงานที่มีมาตรฐาน _fork -> clone -> edit -> PR_ ที่คุณจะพบบ่อยๆ ในฐานะผู้มีส่วนร่วม(contributor)! ฉลองการมีส่วนร่วมของคุณและแบ่งปันให้เพื่อน ๆ หรือผู้ติดตามของคุณ ได้ทราบโดยการไปที่ [หน้าเว็บนี้](https://firstcontributions.github.io#social-share) คุณสามารถเข้าร่วม Slack ของเราได้หากคุณต้องการความช่วยเหลือหรือมีคำถามใด ๆ [เข้าร่วมทีม Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) ### [ข้อมูลเพิ่มเติม](../additional-material/git_workflow_scenarios/additional-material.md) ## การคอนทริบิ้วต์โดยใช้เครื่องมืออื่น ๆ [หลับไปที่หน้าหลัก](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/github-desktop-tutorial.vn.md ================================================ _Người dịch: [Ngo Phu Hien](https://github.com/FlopffyGrape)_ (một số đoạn dịch được lấy và chỉnh sửa từ [Tran Ly Vu](https://github.com/tranlyvu)) [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Những đóng góp đầu tiên | GitHub Desktop | GitHub Desktop Edition | | ----------------------------------------------------------------------------------------------- | ---------------------- | Lần đầu tiên bạn làm gì cũng có thể gặp nhiều trở ngại. Khi bạn cộng tác cũng vậy, sai lầm là điều khó tránh khỏi. Vì vậy, chúng tôi muốn đơn giản hóa quy trình học và đóng góp của bạn vào những dự án mở. Việc đọc hướng dẫn là có tác dụng, nhưng có gì tốt hơn là thực hành một cách thực tế? Dự án này nhằm mục đích hướng dẫn và đơn giản hóa cách để đóng góp vào những dự án mở trên Github cho người mới bắt đầu. Nếu bạn mong muốn thực hiện việc đóng góp đầu tiên của mình, chỉ cần làm theo các bước đơn giản bên dưới. Nếu bạn muốn hiểu rõ hơn về cách Git và Github hoạt động, xem **Chú giải thuật ngữ Tiếng Anh** ở cuối trang. Nếu bạn không có Github Desktop trên máy, [cài đặt](https://desktop.github.com/). Nếu bạn đang dùng Github Desktop phiên bản 1.0 trở xuống, [nên xem hướng dẫn này](github-desktop-old-version-tutorial.md). Copy kho dự án ## Copy kho mã nguồn (Fork) Copy kho mã nguồn này bằng cách nhấn vào nút Fork đầu trang này. Bản sao kho mã nguồn này sẽ được tạo ra trong tài khoản của bạn. ## Tải kho mã nguồn về máy (Clone) Clone sẽ cho phép bạn tải kho mã nguồn (hay còn gọi là repository) về máy. (Download locally) Để tải kho mã nguồn, nhấn vào "Clone or Download" sau đó nhấn "Open in Desktop" LƯU Ý: Đừng tải kho mã nguồn gốc. Tải kho mã nguồn mà bạn vừa copy tại tài khoản của bạn clone this repository Một cửa sổ sẽ hiện lên. Nhấn vào "Open GitHubDesktop.exe" clone this repository Sau khi bạn nhấn nút "Open GitHubDesktop.exe", kho mã nguồn sẽ tự động tải về máy bạn. clone this repository Bây giờ bạn đã tải thành công kho mã nguồn `first-contributions` trên github vào máy. ## Tạo chi nhánh (Branch) Bước tiếp theo, bạn tạo branch mới bằng cách nhấn vào biểu tượng có dòng chữ "Current branch", sau đó nhấn "New branch" make a branch Đặt tên branch vừa tạo là . Ví dụ, "add-hien-ngo" name your branch Nhấn `Create branch` ## Thực hiện những thay đổi cần thiết và commit các thay đổi vừa làm Bây giờ mở tập tin Contributors.md và thêm tên của mình vào ở cuối tập tin. Sau đó lưu lại. Ví dụ: Nếu tên bạn là Ngo Phu Hien, Bạn sẽ viết như này: \[Ngo Phu Hien](https://github.com/hien-ngo29) Lưu ý: https://github.com/hien-ngo29 là link vào tài khoản Github của bạn Bạn có thể thấy những thay đổi của Contributors.md khi mở GithubDesktop. check status Bây giờ hãy commit các thay đổi đó. Commit sẽ lưu lại các thay đổi bạn vừa làm trên máy, nhưng chưa upload lên kho mã nguồn Viết tin nhắn thay đổi: "Add `` to Contributors list" tại phần __summary__ Nhớ đổi `` thành đúng tên của bạn. Nhấn `Commit to add-tên-bạn`. commit your changes Ngay bên dưới, bạn sẽ thấy ngay commit đã được tạo. commit your changes ## Đẩy các thay đổi lên Github (Push) Push cho phép bạn upload các thay đổi bạn đã thực hiện trên máy lên kho mã nguồn chính. Chọn File->Options và đăng nhập vào tài khoản Github.com của bạn. Gõ Github username và mật khẩu. log-in to Github Nhấn vào nút `Publish` ở góc trên. push your changes ## Gửi những thay đổi của bạn để xem xét (Pull Request) Nếu bạn vào trang kho mã nguồn mà bạn vừa fork trên Github, bạn sẽ thấy nút `Compare & pull request`. Nhấn nút đó. create a pull request Bây giờ gửi yêu cầu kéo. (Pull request) submit pull request Tôi sẽ sớm hợp nhất (merge) tất cả các thay đổi của bạn vào nhánh chủ (master branch) của project này. Bạn sẽ nhận được email thông báo sau khi các thay đổi đã được hợp nhất. ## Đi đâu từ đây? Chúc mừng! Bạn vừa hoàn thành quy trình đóng góp tiêu chuẩn: Copy kho mã nguồn (fork) -> Tải về máy (clone) -> Chỉnh sửa (edit) -> Gửi yêu cầu kéo (pull request) mà bạn sẽ làm thường xuyên khi đóng góp những dự án mở! Hãy ăn mừng đóng góp của bạn và chia sẻ nó với bạn bè và những người theo dõi bằng cách truy cập [ứng dụng web](https://roshanjossey.github.io/first-contribution/#social-share). Bạn có thể tham gia slack của chúng tôi trong trường hợp bạn cần trợ giúp hoặc có câu hỏi nào. [Tham gia slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [Tài liệu](../additional-material/git_workflow_scenarios/additional-material.md) ## Hướng dẫn sử dụng các công cụ khác [Quay lại trang chính](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ## _Chú giải thuật ngữ Tiếng Anh_ **Fork**: Copy kho mã nguồn của tài khoản Github khác sang tài khoản Github của bạn. Những thay đổi bạn làm trên kho mã nguồn vừa sao chép ở tài khoản sẽ không bị ảnh hưởng ở kho mã nguồn tài khoản bên kia (nhưng nhớ phải tạo branch mới). **Clone**: Khác với nghĩa Tiếng Anh thông thường là *Sao chép*. Clone trên Git là tải kho mã nguồn về máy (Download locally). Vì thông thường khi thực hiện thay đổi trên kho mã nguồn thì bạn không nên thực hiện trực tiếp trên trang web của kho mã nguồn, tốt nhất nên tải về sau đó làm gì thì làm :). **Branch**: Nôm na là phiên bản của kho mã nguồn. Có nhiều branch khác nhau do các tài khoản khác fork và tạo hay do chính chủ tạo. Branch thông thường bạn thấy khi mở kho mã nguồn là branch `master` hay `main`. Hay các branch khác là branch phiên bản:`v1`,`v2` ,.. hay branch `wip` (Working in progress (Đang làm) ). Các branch có thể được hợp nhất lại với nhau khi tạo Pull Request và được đồng ý bởi chính chủ. Bạn có thể chọn branch khi Fork, Clone, Commit, Push trên Github nhưng theo mặc định thì branch thông thường tên `master` hay `main`. Như ở hướng dẫn khi bạn fork mã nguồn thì phải tạo branch mới rồi thực hiện thay đổi lên branch đó chứ không thực hiện thay đổi lên branch `main` được (vì bạn không có quyền). Sau đó tạo Pull Request trên trang kho mã nguồn gốc và chờ được chủ đồng ý hợp nhất vào branch `main` . **Commit**: Lưu các thay đổi mà bạn vừa làm trên máy nhưng chưa upload lên kho mã nguồn chính trên Github. Nói rõ và dể hiểu hơn, khi bạn clone kho mã nguồn lên máy, 1 thư mục ẩn sẽ được tạo là *.git* (để xem thư mục đó bạn chọn View->Hidden Items ở File Explorer). Thư mục này đóng vai trò quản lý các thay đổi bạn vừa làm trên máy hay nói nôm na là *file dự án* của Git. Các thay đổi mà bạn thực hiện sẽ được lưu trong thư mục *.git* đó sau khi bạn commit. **Push**: Upload các thay đổi bạn vừa làm trên máy lên kho mã nguồn chính. Lưu ý phải commit các thay đổi trước khi push. Bạn có thể tạo nhiều commit rồi push 1 lần. **Pull Request**: Sau khi bạn Fork một kho mã nguồn ở tài khoản khác và thực hiện thay đổi trên kho mã nguồn của tài khoản bạn. Bạn có thể tạo tin nhắn yêu cầu hợp nhất những thay đổi bạn thực hiện qua kho mã nguồn gốc bên tài khoản kia. Nói dễ hiểu là push các thay đổi của bạn thẳng lên mã nguồn gốc với điều kiện phải được chủ kho mã nguồn đồng ý và chấp nhận. Đây chính là phần thịt của đóng góp các dự án mở trên Github. ================================================ FILE: docs/gui-tool-tutorials/translations/github-windows-intellij-tutorial.pt_br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições | IntelliJ IDEA | IntelliJ IDEA | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | É difícil, sempre é difícil quando fazemos alguma coisa pela primeira vez. Especialmente quando você está colaborando, cometendo erros, não é nada confortável. No entanto, o open source é totalmente sobre colaboração & trabalho em equipe. Por isso, nós queremos simplificar a maneira como os novos colaboradores de código aberto aprendem & contribuem pela primeira vez. Ler artigos & assistir a tutoriais até podem ajudar, mas o que é melhor do que fazer as coisas sem bagunçar nada. Este projeto tem como objetivo orientar & simplificar a forma como os iniciantes fazem a sua primeira contribuição. Lembre-se que você aprende melhor quando está relaxado. Se você deseja fazer sua primeira contribuição, basta seguir os passos abaixo. Nós prometemos a você que será divertido! Se você ainda não tem o IntelliJ IDEA no seu computador, [instale-o](https://www.jetbrains.com/idea/download/#section=windows) **Observação:** Este tutorial foi feito usando o IntelliJ IDEA (versão 2019.3.2) em um computador rodando Windows 10. Posteriormente neste tutorial, faremos uso de algumas teclas de atalho, que podem ser diferentes em outros sistemas operacionais (macOS / Linux). ## Faça o Fork deste repositório fork this repository Faça um *fork* deste repositório clicando no botão *fork* (bifurcar) no canto superior direito desta página. Isso criará uma cópia deste repositório em sua conta do GitHub. O GitHub rastreia a relação entre seu repositório e o original, o qual você fez o *fork*. Você pode pensar em seu repositório como uma cópia de trabalho. Muitos dos repositórios matrizes do GitHub (ou seja, aqueles que não são *Fork* de nenhum outro repositório) tem um pequeno grupo de pessoas que podem fazer commits de modificações diretamente. Todos os outros contribuidores devem fazer um *for* do repositório e fazer alterações no *fork*, em seguida, devem criar um Pull Request para solicitar um *Merge* (mesclagem) das modificações feitas no repositório original. ## Clone seu Repositório clone this repository O próximo passo será clonar seu repositório em sua máquina para que você possa modificá-lo. Visual Studio precisa da URL do seu repositório, portanto clique no botão "clone" e então clique no ícone "copy to clipboard". **CUIDADO**: Um erro que os novatos costumam cometer é clonar o repo do qual você fez o fork, em vez de clonar seu repo. Verifique a barra de endereços do seu navegador e certifique-se de que você está clonando o seu repositório. Agora abra o IntelliJ IDEA. O IntelliJ IDEA permite que você faça um check out (em termos do Git clone) de um repositório existente e crie um novo projeto com base nos dados que você baixou. No menu principal, escolha VCS | Get from Version Control ou, se nenhum projeto estiver aberto no momento, clique em Get from Version Control na tela inicial. Na caixa de diálogo Get from Version Control dialog, especifique a URL do repositório remoto que deseja clonar (você pode clicar em Test para certificar-se de que a conexão com o repositório remoto pode ser estabelecida) ou selecione um dos serviços de hospedagem VCS à esquerda. Se você já estiver conectado ao serviço de hospedagem selecionado, a completion irá sugerir a lista de repositórios disponíveis que você pode clonar. Clique em Clone. Se quiser criar um projeto IntelliJ IDEA com base nas fontes que você clonou, clique em Sim na caixa de diálogo de confirmação. O mapeamento de raiz do Git será automaticamente definido para o diretório raiz do projeto. Se o seu projeto tiver submodelos, eles também serão clonados e automaticamente registrados como raízes do projeto. **Importante**: certifique-se de que é o repositório é o fork e não o original, caso contrário, o procedimento não funcionará. ## Crie um branch No Git, o processo de branching (ramificação) é um mecanismo poderoso que permite divergir da linha principal de desenvolvimento, por exemplo, quando você precisa trabalhar em um recurso ou congelar um determinado estado de uma base de código para um release e assim por diante. No IntelliJ IDEA, todas as operações com branches são realizadas no pop-up Git Branches. Para ativá-lo, clique no widget Git na barra de status ou pressione Ctrl + Shift + `. O nome do branch atual é exibido no widget do Git na barra de status. No pop-up branch, escolha Novo branch. Na caixa de diálogo que é aberta, especifique o nome do branch e certifique-se de que a opção Checkout branch esteja selecionada se você quiser alternar para esse branch. A nova ramificação começará a partir do HEAD atual. Se você deseja iniciar um branch de um commit anterior ao invés do branch atual HEAD, selecione este commit na aba Log da janela da ferramenta de Controle de Versão Alt + 9 e escolha New Branch no menu de contexto. ## Faça as alterações necessárias Abra ``Contributors.md`` e adicione seu nome em qualquer lugar do arquivo. Este arquivo contém GFM (GitHub Flavored Markdown), que é um tipo proprietário da sintaxe de [markdown](https://pt.wikipedia.org/wiki/Markdown). Copie uma das linhas de outros contribuidores e modifique-a com seu nome para ter certeza que você obteve a sintaxe correta. ## Commit & Push modificações para o GitHub Selecione os arquivos que deseja commitar ou uma lista de alterações inteira na guia Local Changes da janela da ferramenta de controle de versão Alt + 9 e pressione Ctrl + K ou clique no botão Commit na barra de ferramentas. A caixa de diálogo Commit Changes abrira e listara todos os arquivos que foram modificados desde o último commit, bem como todos os arquivos não versionados recém-adicionados. Insira uma mensagem de commit que faça sentido. Você pode clicar em Commit Message history (Confirmar histórico de mensagens) Ctrl + M para escolher na lista de mensagens de commits recentes. Você também pode editar a mensagem de commit mais tarde, antes de enviar o commit. Pressione Ctrl + Shift + K ou escolha VCS | Git | Push from the main menu. A caixa de diálogo Push Commits é aberta, mostrando todos os repositórios Git (para projetos de vários repositórios) e listando todos os commits feitos no branch atual em cada repositório desde o último push. ## Envie suas alterações para revisão Neste ponto, você concluiu a alteração, mas ela ainda está apenas no seu repo. Esta etapa mostrará como enviar uma solicitação ao administrador do repo matriz para mesclar sua alteração. Em seu repo no GitHub, você verá o botão `Compare & pull request` ao lado da notificação do novo branch, clique nesse botão. create a pull request Agora submeta o pull request. submit pull request Em breve estarei mesclando todas as suas alterações no branch master deste projeto. Você receberá um e-mail de notificação assim que as alterações forem integradas. ## Para onde ir agora? Parabéns! Você acabou de completar o padrão _fork -> clone -> edit -> PR_ workflow que você encontrará frequentemente como um contribuidor! Comemore sua contribuição e compartilhe-a com seus amigos e seguidores acessando o [web app](https://firstcontributions.github.io/#social-share). Você pode se juntar a nossa equipe slack caso precise de alguma ajuda ou tenha alguma dúvida. [Junte-se ao time slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). Agora vamos começar a contribuir para outros projetos, compilamos uma lista de projetos com questões fáceis para você começar. [Confira a lista de projetos no web app](https://firstcontributions.github.io/#project-list). ### [Material Adicional](../../additional-material/translations/Portugues/additional-material.pt_br.md). ## Tutoriais usando outras ferramentas [Voltar a página principal](https://github.com/firstcontributions/first-contributions/blob/master/translations/README.pt_br.md) ## Autopromoção Se você gostou deste projeto, de star no GitHub. Se você gostou dessa tradução me siga no GitHub [Vitor Matias](https://github.com/VitorCMatias). ================================================ FILE: docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial-hi.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/CodeWithAjaySaini) # First Contributions | Visual Studio Code | Visual Studio Code | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | यह मुश्किल है। पहली बार जब आप कुछ करते हैं तो यह हमेशा कठिन होता है। खासकर जब आप सहयोग कर रहे हों, तो गलतियाँ करना सहज बात नहीं है। लेकिन ओपन सोर्स सहयोग और एक साथ काम करने के बारे में है। हम नए ओपन-सोर्स योगदानकर्ताओं के पहली बार सीखने और योगदान करने के तरीके को सरल बनाना चाहते थे। लेख पढ़ना और ट्यूटोरियल देखना मदद कर सकता है, लेकिन वास्तव में कुछ भी गड़बड़ किए बिना सामान करने से बेहतर क्या हो सकता है। इस परियोजना का उद्देश्य मार्गदर्शन प्रदान करना और धोखेबाज़ों द्वारा अपना पहला योगदान देने के तरीके को सरल बनाना है। याद रखें कि आप जितने अधिक आराम से होंगे, आप उतना ही बेहतर सीखेंगे। यदि आप अपना पहला योगदान करना चाहते हैं, तो बस नीचे दिए गए सरल चरणों का पालन करें। हम आपसे वादा करते हैं, यह मजेदार होगा। यदि आपकी मशीन पर विजुअल स्टूडियो कोड नहीं है, [install it](https://code.visualstudio.com/download). **सूचना:** यह ट्यूटोरियल विंडोज 10 मशीन पर विजुअल स्टूडियो कोड (संस्करण 1.27.2) का उपयोग करके बनाया गया था। बाद में इस ट्यूटोरियल में हम कुछ कीबोर्ड शॉर्टकट का उपयोग करेंगे। ये अन्य ऑपरेटिंग सिस्टम (मैकोज़/लिनक्स) के साथ-साथ कीबोर्ड भाषा (यूके, डीई, आदि) पर भिन्न हो सकते हैं। आप कमांड पैलेट में "शॉर्टकट" खोजकर अपने शॉर्टकट की सूची देख सकते हैं। ## इस भंडार को फोर्क करें fork this repository इस रेपो को फोर्क करने के लिए इस पेज के ऊपर दाईं ओर फोर्क बटन पर क्लिक करें। यह आपके GitHub खाते में इस रिपॉजिटरी की एक प्रति बनाएगा। गिटहब आपके रेपो और उस रेपो के बीच संबंधों का ट्रैक रखता है जिसे आपने इसे फोर्क किया है। आप अपने रेपो को एक कार्यशील प्रति के रूप में सोच सकते हैं। अधिकांश शीर्ष-स्तरीय गिटहब रेपो (यानी किसी अन्य रेपो से फोर्क नहीं किए गए) में लोगों की एक छोटी सी कोर टीम होती है जो सीधे बदलाव कर सकती है। अन्य सभी योगदानकर्ताओं को रेपो को फोर्क करना होगा और फोर्क में परिवर्तन करना होगा, फिर एक पुल अनुरोध बनाना होगा ताकि उनके परिवर्तनों को शीर्ष-स्तरीय रेपो में वापस विलय करने के लिए कहा जा सके। यदि शीर्ष-स्तरीय रेपो व्यवस्थापक परिवर्तनों को पसंद करता है तो उन्हें विलय कर दिया जाएगा और आपको तुरंत प्रसिद्धि और भाग्य प्राप्त होगा! इसे बाद में कैसे करें, इसके बारे में अधिक। ## अपने भंडार को क्लोन करें clone this repository अगला कदम अपने रेपो को अपनी मशीन पर क्लोन करना है ताकि आप बदलाव करना शुरू कर सकें। वीएस कोड को आपके रेपो के यूआरएल की जरूरत है, इसलिए "क्लोन" बटन पर क्लिक करें और फिर "क्लिपबोर्ड पर कॉपी करें" आइकन पर क्लिक करें। **सावधान:** एक गलती जो नए योगदानकर्ता अक्सर करते हैं, वह है रेपो का क्लोन बनाना जो आपने अपने रेपो को क्लोन करने के बजाय _from_ को फोर्क किया था। अपने ब्राउज़र के एड्रेस बार की जाँच करें और सुनिश्चित करें कि आप अपने रेपो की क्लोनिंग कर रहे हैं। अब विजुअल स्टूडियो कोड खोलें। वीएस कोड का वेलकम पेज खुल जाएगा। वहां से नीचे दिखाए गए बार को खोलने के लिए `F1` दबाएं। ध्यान दें कि टेक्स्ट फ़ील्ड में पहले से ही एक `>` (इससे बड़ा) चिन्ह है। आप `CTRL-P` दबाकर इनपुट प्रॉम्प्ट पर भी जा सकते हैं और फिर `>` वर्ण टाइप कर सकते हैं। Clone Popup (Command Popup) आप देख सकते हैं कि नीचे सूचीबद्ध कुछ अस्पष्ट आदेश पहले से ही हैं। वे मेरे हाल ही में उपयोग किए गए आदेश हैं। तो बस उनकी परवाह मत करो। Clone repo अब 'गिट क्लोन' टाइप करें, केवल 'गिट' या 'क्लोन' (यह एक खोज की तरह काम करता है)। प्रविष्टि `गिट: क्लोन` का चयन करें और `एंटर` दबाएं Paste Repository URL in अपनी रिपॉजिटरी का URL पेस्ट करें और `Enter` दबाएं। यह एक फ़ाइल एक्सप्लोरर खोलेगा जहाँ आप तब चुन सकते हैं जहाँ Git रिपॉजिटरी को संग्रहीत किया जाना चाहिए। **महत्वपूर्ण**: सुनिश्चित करें कि यह फोर्कड रिपोजिटरी है और मूल नहीं है, अन्यथा यह काम नहीं करेगा। Status popup आपको विजुअल स्टूडियो कोड के नीचे दाईं ओर एक स्टेटस पॉपअप देखना चाहिए। इसके समाप्त होने के बाद, आप संवाद में बटनों का उपयोग करके क्लोन रिपॉजिटरी (अब आपकी मशीन पर एक फ़ोल्डर) खोल सकते हैं। ## एक शाखा बनाएं `F1` दबाकर फिर से कमांड पैलेट खोलें। `शाखा` टाइप करें और वहां से `शाखा बनाएं` कमांड चुनें। अगले चरण में अपनी नई शाखा का नाम टाइप करें, उदाहरण के लिए `ऐड-डेविड-क्रोल`। एंटर दबाएं और ब्रांच बन जाएगी. The branch is also already checked out. [What does checkout mean?](https://www.git-scm.com/docs/git-checkout) Branches Command Palette ## आवश्यक परिवर्तन करें `Contributors.md` खोलें और फ़ाइल में कहीं भी अपना नाम जोड़ें। इस फ़ाइल में GFM (GitHub Flavored Markdown) है जो markdown सिंटैक्स का मालिकाना स्वाद है। अन्य योगदानकर्ताओं में से एक की प्रतिलिपि बनाएँ' लाइनों और इसे अपने नाम के साथ संशोधित करें यह सुनिश्चित करने के लिए कि आपको सिंटैक्स सही मिलता है - यह पिक्य हो सकता है। Add your name ## गिटहब में बदलाव करें और पुश करें वीएस कोड के बाईं ओर एक मेनू है जिसमें 5 आइकन प्रदर्शित होते हैं। संस्करण नियंत्रण/स्रोत नियंत्रण चिह्न का चयन करें। (शॉर्टकट : Ctrl + Shift + G) Commit changes फ़ाइल एक्सप्लोरर उन सभी फाइलों को प्रदर्शित करता है जिन्हें अंतिम प्रतिबद्धता के बाद बदल दिया गया था। फाइलों को मँडराकर और `+` (प्लस) पर क्लिक करके फाइलों का मंचन किया जाता है। Stashed Files एक्सप्लोरर के ऊपर लाइन में कुछ टाइप करें और चेकमार्क दबाएं। परिवर्तन अब आपकी स्थानीय प्रति के लिए प्रतिबद्ध हैं। अब परिवर्तनों को वापस GitHub पर धकेलना होगा। Stashed Files मेनू खोलने के लिए थ्री-डॉट आइकन का उपयोग करें जहां आप `पब्लिश ब्रांच` विकल्प का चयन करते हैं। यह आपके GitHub क्रेडेंशियल्स को डालने के लिए एक डायलॉग खोलना चाहिए। स्टैश की गई फ़ाइलें ## समीक्षा के लिए अपने परिवर्तन सबमिट करें इस बिंदु पर आपने अपना परिवर्तन पूरा कर लिया है लेकिन यह अभी भी केवल आपके रेपो में रहता है। यह चरण आपको दिखाएगा कि अपने परिवर्तन को मर्ज करने के लिए शीर्ष-स्तरीय रेपो के व्यवस्थापक को अनुरोध कैसे सबमिट करें। गिटहब पर अपने रेपो में आपको नई शाखा अधिसूचना के बगल में `तुलना और पुल अनुरोध` बटन दिखाई देगा। उस बटन पर क्लिक करें। एक पुल अनुरोध बनाएं अब पुल रिक्वेस्ट सबमिट करें। पुल अनुरोध सबमिट करें जल्द ही मैं आपके सभी परिवर्तनों को इस परियोजना की मास्टर शाखा में मिला दूंगा। परिवर्तनों को मर्ज कर दिए जाने के बाद आपको एक सूचना ईमेल प्राप्त होगी। ## यहाँ से कहाँ जाएं? बधाई! आपने अभी-अभी मानक _fork -> क्लोन -> संपादित करें -> PR_ वर्कफ़्लो पूरा किया है जिसका आप अक्सर एक योगदानकर्ता के रूप में सामना करेंगे! अपने योगदान का जश्न मनाएं और [वेब ऐप](https://firstcontributions.github.io#social-share) पर जाकर इसे अपने दोस्तों और अनुयायियों के साथ साझा करें। यदि आपको किसी सहायता की आवश्यकता हो या कोई प्रश्न पूछना हो तो आप हमारी सुस्त टीम में शामिल हो सकते हैं। [स्लैक टीम में शामिल हों](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)। ### [अतिरिक्त सामग्री](../additional-material/git_workflow_scenarios/additional-material.md) ## अन्य टूल्स का उपयोग करने वाले ट्यूटोरियल [मुख्य पृष्ठ पर वापस जाएं](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial.ml.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # ആദ്യ സംഭാവനകൾ (First Contributions) | Visual Studio Code | Visual Studio Code | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | ആദ്യമായി ഒരു കാര്യം ചെയ്യുക എന്നുള്ളത് വളരെ ബുദ്ധിമുട്ടാണ്. പ്രത്യേകിച്ച്, മറ്റു പലരുടെയും ഒപ്പം ജോലി ചെയ്യുമ്പോൾ തെറ്റ് വരുന്നത് അത്ര സുഖകരമായ കാര്യം അല്ല. സ്വതന്ത്ര സോഫ്റ്റ്‌വെയറിലേക്ക് ആദ്യമായി സംഭാവന ചെയ്യുന്നവർക്ക് അതിനെ പറ്റി പഠിക്കാനും പങ്കാളിയാകുവാനും വേണ്ടി കുറച്ച്‌കൂടെ എളുപ്പമായ എന്തെങ്കിലും ഉണ്ടാക്കണമെന്നായിരുന്നു ഞങ്ങളുടെ ആഗ്രഹം. ലേഖനങ്ങൾ വായിക്കുന്നതും വീഡിയോകൾ കാണുന്നതും ഒക്കെ സഹായകരമാണ്. പക്ഷേ ചെയ്ത് തന്നെ പഠിക്കുന്നതല്ലേ ഏറ്റവും നല്ലത്? ഈ പ്രൊജക്റ്റ് ഇതിനെ പറ്റി പരിചയം ഇല്ലാത്ത ഒരാൾക്ക് ആദ്യത്തെ സംഭാവന നല്കാൻ ഉള്ള ഒരു വഴികാട്ടി ആണ്. നിങ്ങൾ എത്രത്തോളം സ്വസ്‌ഥമായിരിക്കുന്നുവോ അത്രയും നന്നായി പഠിക്കുമെന്ന് ഓർക്കുക. നിങ്ങളും നിങ്ങളുടെ ആദ്യ സംഭാവന നൽകാൻ ആഗ്രഹിക്കുന്നുവെങ്കിൽ, താഴെ പറയുന്നത് പോലെ ചെയ്യുക. ഞങ്ങൾ നിങ്ങൾക്ക് വാഗ്ദാനം ചെയ്യുന്നു, ഇത് രസകരമായിരിക്കും. നിങ്ങളുടെ മെകമ്പ്യൂട്ടറിൽ വിഷ്വൽ സ്റ്റുഡിയോ കോഡ് ഇല്ലെങ്കിൽ, [ഇത് ഇൻസ്റ്റാൾ ചെയ്യുക](https://code.visualstudio.com/download). **അറിയിപ്പ്:** ഈ പരിശീലനപദ്ധതി ഒരു Windows 10 മെഷീനിൽ വിഷ്വൽ സ്റ്റുഡിയോ കോഡ് (പതിപ്പ് 1.27.2) ഉപയോഗിച്ചാണ് നിർമ്മിച്ചിരിക്കുന്നത്. ഈ ട്യൂട്ടോറിയലിൽ ഞങ്ങൾ ചില കീബോർഡ് കുറുക്കുവഴികൾ ഉപയോഗിക്കുന്നതായിരിക്കും. മറ്റ് ഓപ്പറേറ്റിംഗ് സിസ്റ്റങ്ങളിലും (macOS/Linux) കീബോർഡ് ഭാഷയിലും (UK, DE, മുതലായവ) ഇവ വ്യത്യാസമായിരിക്കാം. കമാൻഡ് പാലറ്റിൽ "shortcut" തിരഞ്ഞുകൊണ്ട് നിങ്ങൾക്ക് കുറുക്കുവഴികളുടെ പട്ടികയിലൂടെ കടന്നുപോകാം. ## ഈ റെപ്പോസിറ്ററി ഫോർക്ക് (fork) ചെയ്യുക fork this repository ഈ പേജിന്റെ ഏറ്റവും മുകളിൽ ഉള്ള ഫോർക്ക് ബട്ടൺ ഉപയോഗിച്ച് ഈ റെപ്പോസിറ്ററി ഫോർക്ക് ചെയ്യുക. ഇങ്ങനെ ചെയ്യുമ്പോൾ നിങ്ങളുടെ അക്കൗണ്ടിൽ ഈ റെപ്പോസിറ്ററിയുടെ ഒരു പകർപ്പ് സൃഷ്ടിക്കപ്പെടുന്നു. GitHub നിങ്ങളുടെ റിപ്പോയും നിങ്ങൾ ഫോർക്ക് ചെയ്ത റിപ്പോയും തമ്മിലുള്ള ബന്ധത്തിന്റെ ട്രാക്ക് സൂക്ഷിക്കുന്നു. നിങ്ങളുടെ റിപ്പോ ഒരു പ്രവർത്തന പകർപ്പായി നിങ്ങൾക്ക് ചിന്തിക്കാം. മിക്ക ഉയർന്ന തലത്തിലുള്ള GitHub റിപ്പോകൾക്കും (അതായത് മറ്റേതെങ്കിലും റിപ്പോയിൽ നിന്നും ഫോർക്ക് ചെയ്യാത്തവ) നേരിട്ട് മാറ്റങ്ങൾ വരുത്താൻ കഴിയുന്ന ഒരു ചെറിയ കോർ സംഘം ഉണ്ട്. മറ്റെല്ലാ സംഭാവകരും റിപ്പോ ഫോർക്ക് ചെയ്യുകയും ഫോർക്കിൽ മാറ്റങ്ങൾ വരുത്തുകയും വേണം, തുടർന്ന് അവരുടെ മാറ്റങ്ങൾ ഈ ഉയർന്ന തലത്തിലുള്ള റിപ്പോയിലേക്ക് വീണ്ടും ലയിപ്പിക്കുന്നതിനുവേണ്ടി ഒരു പുൾ അഭ്യർത്ഥന(pull request) സൃഷ്ടിക്കണം. ഉയർന്ന തലത്തിലുള്ള റിപ്പോ അഡ്‌മിനിസ്‌ട്രേറ്റർക്ക് മാറ്റങ്ങൾ ഇഷ്‌ടപ്പെട്ടാൽ അവ ലയിപ്പിക്കുകയും നിങ്ങൾക്ക് തൽക്ഷണം പ്രശസ്തി ലഭിക്കുകയും ചെയ്യും! ## ഈ റെപ്പോസിറ്ററി ക്ലോൺ (clone) ചെയ്യുക clone this repository നിങ്ങളുടെ മെഷീനിലേക്ക് നിങ്ങളുടെ റിപ്പോ ക്ലോൺ ചെയ്യുക എന്നതാണ് അടുത്ത ഘട്ടം, അതുവഴി നിങ്ങൾക്ക് മാറ്റങ്ങൾ വരുത്താൻ ആരംഭിക്കാം. VS കോഡിന് നിങ്ങളുടെ റിപ്പോയുടെ URL ആവശ്യമാണ്, അതിനാൽ കോഡ് ബട്ടണിൽ ക്ലിക്കുചെയ്‌ത് "copy to clipboard" ഐക്കണിൽ ക്ലിക്കുചെയ്യുക. **സൂക്ഷിക്കുക:** പുതിയ സംഭാവകർ പലപ്പോഴും ചെയ്യുന്ന ഒരു തെറ്റ് എന്തെന്നാൽ, നിങ്ങളുടെ റിപ്പോ ക്ലോൺ ചെയ്യുന്നതിനുപകരം നിങ്ങൾ _ഫോർക്ക് ചെയ്യാൻ ഉപയോഗിച്ച റിപ്പോ_ ക്ലോൺ ചെയ്യുക എന്നതാണ്. നിങ്ങളുടെ ബ്രൗസറിന്റെ address ബാർ പരിശോധിച്ച് നിങ്ങളുടെ റിപ്പോ തന്നെയാണ് ക്ലോൺ ചെയ്യുന്നതെന്ന് ഉറപ്പാക്കുക. ഇപ്പോൾ വിഷ്വൽ സ്റ്റുഡിയോ കോഡ് തുറക്കുക. വിഎസ് കോഡിന്റെ സ്വാഗത പേജ് പോപ്പ് അപ്പ് ചെയ്യും. താഴെ കാണിച്ചിരിക്കുന്ന ബാർ തുറക്കാൻ അവിടെ നിന്ന് `F1` അമർത്തുക. ടെക്സ്റ്റ് ഫീൽഡിൽ ഇതിനകം തന്നെ `>` ചിഹ്നമുണ്ടെന്ന് ശ്രദ്ധിക്കുക. മറ്റൊരു മാർഗ്ഗം `CTRL-P` അമർത്തിക്കൊണ്ട് നിങ്ങൾ ഇൻപുട്ട് പ്രോംപ്റ്റിലേക്ക് പോയിട്ട്, `>` ടൈപ്പ് ചെയ്യുന്നതാണ്. Clone Popup (Command Popup) ഈ ചിത്രത്തിൽ ചില അവ്യക്തമായ കമാൻഡുകൾ താഴെ ലിസ്റ്റ് ചെയ്തിരിക്കുന്നത് നിങ്ങൾ ശ്രദ്ധിച്ചേക്കാം. ഞാൻ അടുത്തിടെ ഉപയോഗിച്ച കമാൻഡുകൾ ഇവയാണ്. അതുകൊണ്ട് അവരെ കാര്യമാക്കേണ്ട. Clone repo അടുത്തതായി `git clone` എന്ന് ടൈപ്പ് ചെയ്യുക. 'Git: Clone' എന്ന എൻട്രി തിരഞ്ഞെടുത്ത് 'Enter' അമർത്തുക. Paste Repository URL in നിങ്ങളുടെ റിപ്പോസിറ്ററിയുടെ URL പേസ്റ്റ് ചെയ്യുക, `Enter` അമർത്തുക. ഇത് ഒരു ഫയൽ എക്സ്പ്ലോറർ തുറക്കും, അവിടെ നിങ്ങൾക്ക് Git റിപ്പോസിറ്ററി എവിടെ സൂക്ഷിക്കണമെന്ന് തിരഞ്ഞെടുക്കാം. **അറിയിപ്പ്**: ഇത് ഫോർക്ക്ഡ് റിപ്പോസിറ്ററി ആണെന്നും ഒറിജിനൽ അല്ലെന്നും ഉറപ്പാക്കുക, അല്ലാത്തപക്ഷം ഇത് പ്രവർത്തിക്കില്ല. Status popup വിഷ്വൽ സ്റ്റുഡിയോ കോഡിന്റെ ചുവടെ വലതുവശത്ത് നിങ്ങൾ ഒരു സ്റ്റാറ്റസ് പോപ്പ്അപ്പ് കാണും. ഇത് പൂർത്തിയായ ശേഷം, ഡയലോഗിലെ ബട്ടണുകൾ ഉപയോഗിച്ച് നിങ്ങൾക്ക് ക്ലോൺ ചെയ്ത റിപ്പോസിറ്ററി (ഇപ്പോൾ നിങ്ങളുടെ മെഷീനിലെ ഒരു ഫോൾഡർ) തുറക്കാൻ കഴിയും. ## ഒരു ശാഖ (ബ്രാഞ്ച്, Branch) ഉണ്ടാക്കുക `F1` അമർത്തി കമാൻഡ് പാലറ്റ് വീണ്ടും തുറക്കുക. `git branch` എന്ന് ടൈപ്പ് ചെയ്ത് അവിടെ നിന്ന് `create branch` എന്ന കമാൻഡ് തിരഞ്ഞെടുക്കുക. അടുത്ത ഘട്ടത്തിൽ നിങ്ങളുടെ പുതിയ ബ്രാഞ്ചിന്റെ പേര് ടൈപ്പ് ചെയ്യുക, ഉദാഹരണത്തിന് `add-david-kroell`. Enter അമർത്തുക, ബ്രാഞ്ച് സൃഷ്ടിക്കപ്പെടും. ബ്രാഞ്ചും ഇതിനകം ചെക്ക് ഔട്ട് ആയി. [ചെക്ക്ഔട്ട് എന്നാൽ എന്താണ് അർത്ഥമാക്കുന്നത്?](https://www.git-scm.com/docs/git-checkout) Branches Command Palette ## ആവശ്യമായ മാറ്റങ്ങൾ വരുത്തുക `Contributors.md` തുറന്ന് ഫയലിൽ എവിടെയും നിങ്ങളുടെ പേര് ചേർക്കുക. ഈ ഫയലിൽ മാർക്ക്ഡൗൺ വാക്യഘടനയുടെ ഉടമസ്ഥാവകാശമുള്ള GFM (GitHub Flavored Markdown) അടങ്ങിയിരിക്കുന്നു. നിങ്ങൾക്ക് വാക്യഘടന ശരിയാണെന്ന് ഉറപ്പാക്കാൻ മറ്റ് സംഭാവകരുടെ ലൈനുകളിൽ ഒന്ന് പകർത്തി അത് നിങ്ങളുടെ പേരിനൊപ്പം പരിഷ്‌ക്കരിക്കുക. മാറ്റം രജിസ്റ്റർ ചെയ്യുന്നതിനായി ഫയൽ save ചെയ്യുക. Add your name ## GitHub-ലേക്ക് മാറ്റങ്ങൾ commit ചെയ്ത ശേഷം push ചെയ്യുക വിഎസ് കോഡിന്റെ ഇടതുവശത്ത് 5 ഐക്കണുകൾ പ്രദർശിപ്പിച്ചിരിക്കുന്ന ഒരു മെനുവാണ്.version control/Source Control ഐക്കൺ തിരഞ്ഞെടുക്കുക. (കുറുക്കുവഴി: Ctrl + Shift + G) Commit changes അവസാന കമ്മിറ്റിന് ശേഷം മാറ്റിയ എല്ലാ ഫയലുകളും file explorer പ്രദർശിപ്പിക്കുന്നു. ഫയലിന്റെ പേരിനു മുകളിൽ കഴ്‌സർ ഹോവർ ചെയ്ത ശേഷം `+` (പ്ലസ്) ക്ലിക്ക് ചെയ്യുന്നതിലൂടെ ഫയലുകൾ staged ആയി മാറുന്നു. Stashed Files എക്സ്പ്ലോററിന് മുകളിലുള്ള വരിയിൽ എന്തെങ്കിലും ടൈപ്പ് ചെയ്ത് ചെക്ക്മാർക്ക് അമർത്തുക. മാറ്റങ്ങൾ ഇപ്പോൾ നിങ്ങളുടെ പ്രാദേശിക പകർപ്പിൽ committed ആയി. ഇപ്പോൾ മാറ്റങ്ങൾ GitHub-ലേക്ക് തിരികെ മാറ്റേണ്ടതുണ്ട്. Stashed Files മെനു തുറക്കാൻ മൂന്ന് കുത്തുകളുള്ള ഐക്കൺ ഉപയോഗിക്കുക, തുടർന്ന് നിങ്ങൾ `പബ്ലിഷ് ബ്രാഞ്ച്` ഓപ്‌ഷൻ അമർത്തുക. നിങ്ങളുടെ GitHub ക്രെഡൻഷ്യലുകൾ ഉൾപ്പെടുത്തുന്നതിന് ഇത് ഒരു ഡയലോഗ് തുറക്കും. Stashed Files ## നിങ്ങളുടെ മാറ്റങ്ങൾ അവലോകനത്തിനായി സമർപ്പിക്കുക ഈ സമയത്ത് നിങ്ങൾ നിങ്ങളുടെ മാറ്റം പൂർത്തിയാക്കി, പക്ഷേ അത് ഇപ്പോഴും നിങ്ങളുടെ റിപ്പോയിൽ മാത്രമേ വസിക്കുന്നുള്ളൂ. നിങ്ങളുടെ മാറ്റം ലയിപ്പിക്കുന്നതിന് ഉയർന്ന തലത്തിലുള്ള റിപ്പോയുടെ അഡ്മിനിസ്ട്രേറ്റർക്ക് ഒരു അഭ്യർത്ഥന സമർപ്പിക്കുന്നത് എങ്ങനെയെന്ന് ഈ ഘട്ടം നിങ്ങളെ കാണിക്കും. GitHub-ലെ നിങ്ങളുടെ റിപ്പോയിൽ പുതിയ ബ്രാഞ്ച് notification അടുത്തുള്ള `Compare & pull request` ബട്ടൺ നിങ്ങൾ കാണും. ആ ബട്ടണിൽ ക്ലിക്ക് ചെയ്യുക. create a pull request ഇപ്പോൾ പുൾ റിക്വസ്റ്റ് സമർപ്പിക്കുക. submit pull request ഉടൻ തന്നെ നിങ്ങളുടെ എല്ലാ മാറ്റങ്ങളും ഈ പ്രോജക്റ്റിന്റെ മാസ്റ്റർ ബ്രാഞ്ചിലേക്ക് ഞാൻ ലയിപ്പിക്കും. മാറ്റങ്ങൾ ലയിച്ചുകഴിഞ്ഞാൽ നിങ്ങൾക്ക് ഒരു അറിയിപ്പ് ഇമെയിൽ ലഭിക്കും. ## ഇവിടെ നിന്ന് എങ്ങോട്ട് പോകണം? അഭിനന്ദനങ്ങൾ! ഒരു സംഭാവകൻ എന്ന നിലയിൽ നിങ്ങൾ പലപ്പോഴും അഭിമുഖീകരിക്കുന്ന സ്റ്റാൻഡേർഡ് _fork -> clone -> edit -> PR_ വർക്ക്ഫ്ലോ നിങ്ങൾ ഇപ്പോൾ പൂർത്തിയാക്കി! [വെബ് ആപ്പ്](https://firstcontributions.github.io#social-share) എന്നതിലേക്ക് പോയി നിങ്ങളുടെ സംഭാവനകൾ ആഘോഷിക്കുകയും സുഹൃത്തുക്കളുമായും പിന്തുടരുന്നവരുമായും അത് പങ്കിടുകയും ചെയ്യുക. നിങ്ങൾക്ക് എന്തെങ്കിലും സഹായം ആവശ്യമുണ്ടെങ്കിൽ അല്ലെങ്കിൽ എന്തെങ്കിലും ചോദ്യങ്ങൾ ഉണ്ടെങ്കിൽ ഞങ്ങളുടെ സ്ലാക്ക് ടീമിൽ ചേരാം. [സ്ലാക്ക് ടീമിൽ ചേരുക](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [അധിക മെറ്റീരിയൽ](../additional-material/git_workflow_scenarios/additional-material.md) ## മറ്റ് ടൂളുകൾ ഉപയോഗിച്ചുള്ള ട്യൂട്ടോറിയലുകൾ [പ്രധാന പേജിലേക്ക് മടങ്ങുക](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial.pt_br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições | Visual Studio Code | Visual Studio Code | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | É difícil. É sempre difícil a primeira vez que você faz algo. Especialmente quando você está colaborando, cometer erros não é uma coisa confortável. Mas o código aberto tem tudo a ver com colaboração e trabalho em conjunto. Queríamos simplificar a maneira como os novos colaboradores de código aberto aprendem e contribuem pela primeira vez. Ler artigos e assistir a tutoriais pode ajudar, mas o que é melhor do que realmente fazer as coisas sem estragar nada. Este projeto visa fornecer orientação e simplificar a maneira como os novatos fazem sua primeira contribuição. Lembre-se, quanto mais relaxado você estiver, melhor você aprenderá. Se você está procurando fazer sua primeira contribuição, basta seguir os passos simples abaixo. Nós prometemos a você, vai ser divertido. Se você não tiver o Visual Studio Code em sua máquina, [instale-o](https://code.visualstudio.com/download). **Atenção:** Este tutorial foi feito usando o Visual Studio Code (Versão 1.27.2) em uma máquina Windows 10. Mais adiante neste tutorial, usaremos alguns atalhos de teclado. Eles podem diferir em outros sistemas operacionais (macOS/Linux), bem como no idioma do teclado (UK, DE, etc). Você pode percorrer sua lista de atalhos pesquisando "atalho" na Paleta de Comandos. ## Fork este repositório fork this repository Fork este repositório clicando no botão fork no canto superior direito desta página. Isso criará uma cópia deste repositório em sua conta do GitHub. O GitHub acompanha o relacionamento entre seu repositório e aquele do qual você o bifurcou. Você pode pensar em seu repositório como uma cópia de trabalho. A maioria dos repositórios de alto nível do GitHub (ou seja, aqueles que não são bifurcados de nenhum outro repositório) têm uma pequena equipe principal de pessoas que podem confirmar alterações diretamente. Todos os outros contribuidores devem bifurcar o repositório e fazer alterações na bifurcação e, em seguida, criar uma solicitação de pull para solicitar que suas alterações sejam mescladas novamente no repositório de nível superior. Se o administrador de repo de nível superior gostar das alterações, elas serão mescladas e você ganhará fama e fortuna instantâneas! Mais sobre como fazer isso mais tarde. ## Clone seu repositório clone this repository A próxima etapa é clonar seu repositório para sua máquina para que você possa começar a fazer alterações. O VS Code precisa do URL do seu repositório, então clique no botão "clone" e depois clique no ícone "copiar para a área de transferência". **CUIDADO:** Um erro que os novos contribuidores costumam cometer é clonar o repositório que você bifurcou _de_ em vez de clonar seu repositório. Verifique a barra de endereços do seu navegador e certifique-se de estar clonando seu repositório. Agora abra o Visual Studio Code. A página de boas-vindas do VS Code aparecerá. A partir daí, pressione `F1` para abrir a barra mostrada abaixo. Observe que já existe um sinal `>` (maior que) no campo de texto. Você também pode acessar o prompt de entrada pressionando `CTRL-P` e digite o caractere `>`. Clone Popup (Command Popup) Você pode notar que já existem alguns comandos obscuros listados abaixo. Esses são meus comandos usados recentemente. Então, simplesmente não se importe com eles. Clone repo Agora digite `git clone`, apenas `git` ou `clone` (funciona como uma pesquisa). Selecione a entrada `Git: Clone` e pressione `Entrar` Colar URL do repositório Cole a URL do seu repositório e pressione `Entrar`. Isso abrirá um File Explorer onde você pode escolher onde o repositório Git deve ser armazenado. **Importante**: Certifique-se de que é o repositório bifurcado e não o original, caso contrário não funcionará. Status popup Você deve ver um pop-up de status no canto inferior direito do Visual Studio Code. Depois de terminar, você pode abrir o repositório clonado (agora uma pasta em sua máquina) usando os botões da caixa de diálogo. ## Criar uma branch Abra a paleta de comandos novamente pressionando `F1`. Digite `branch` e selecione o comando `criar branch` a partir daí. Na próxima etapa digite o nome do seu novo branch, por exemplo `add-david-kroell`. Pressione enter e a ramificação será criada. A filial também já foi verificada. [O que significa checkout?](https://www.git-scm.com/docs/git-checkout) Branches Command Palette ## Faça as alterações necessárias Abra `Contributors.md` e adicione seu nome em qualquer lugar do arquivo. Este arquivo contém GFM (GitHub Flavored Markdown), que é um sabor proprietário da sintaxe markdown. Copie um dos outros contribuidores' linhas e modifique-o com seu nome para ter certeza de obter a sintaxe correta - pode ser exigente. Add your name ## Confirmar e enviar alterações para o GitHub No lado esquerdo do VS Code há um menu com 5 ícones exibidos. Selecione o ícone de controle de versão/Controle de origem. (Atalho: Ctrl + Shift + G) Commitar alterações O explorador de arquivos exibe todos os arquivos que foram alterados após o último commit. Ao passar o mouse sobre os arquivos e clicar em `+` (mais), os arquivos são encenados. Arquivos guardados Digite algo na linha na parte superior do explorer e pressione a marca de seleção. As alterações agora estão confirmadas em sua cópia local. Agora as alterações precisam ser enviadas de volta ao GitHub. Arquivos guardados Use o ícone de três pontos para abrir o menu onde você seleciona a opção `Publicar Branch`. Isso deve abrir uma caixa de diálogo para colocar suas credenciais do GitHub. Arquivos guardados ## Envie suas alterações para revisão Neste ponto, você concluiu sua alteração, mas ela ainda reside apenas em seu repositório. Esta etapa mostrará como enviar uma solicitação ao administrador do repositório de nível superior para mesclar sua alteração. Em seu repositório no GitHub, você verá o botão `Comparar & pull request` ao lado da nova notificação de branch. Clique nesse botão. crie uma pull request Agora envie a solicitação PR - pull request. submit pull request Em breve estarei mesclando todas as suas alterações no branch master deste projeto. Você receberá um e-mail de notificação assim que as alterações forem mescladas. ## Para onde ir a partir daqui? Parabéns! Você acabou de concluir o fluxo de trabalho padrão _fork -> clone -> editar -> PR_ que você encontrará frequentemente como colaborador! Comemore sua contribuição e compartilhe com seus amigos e seguidores acessando [aplicativo da web](https://firstcontributions.github.io#social-share). Você pode se juntar à nossa equipe do slack caso precise de ajuda ou tenha alguma dúvida. [Junte-se à equipe do Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [Material adicional](../additional-material/translations/additional-material.pt_br.md) ## Tutoriais usando outras ferramentas [Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial_id.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Kontribusi Pertama | Visual Studio Code | Visual Studio Code | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | Sulit. Memang selalu sulit melakukan sesuatu untuk pertama kali. Khususnya ketika kamu berkolaborasi, membuat sebuah masalah bukanlah hal yang mengenakkan. Tetapi proyek terbuka berarti kolaborasi dan kerjasama. Kami ingin menyederhanakan cara belajar bagi kontributor dan cara berkontribusi untuk pertama kali. Membaca artikel & menonton tutorial bisa membantu, tetapi lebih baik praktek langsung tanpa membuat masalah apapun pada proyek. Laman ini bertujuan untuk memberikan panduan & menyederhanakan cara bagi pemula untuk membuat kontribusi pertama. Ingat semakin santai kamu, maka semakin baik kamu belajar. Jika kamu ingin membuat kontribusi pertama, cukup ikuti langkah-langkah sederhana di bawah ini. Kami janji, ini akan menyenangkan kok. Jika kamu belum punya Visual Studio Code pada perangkat mu, [install disini](https://code.visualstudio.com/download). **Perlu Diingat:** Tutorial ini dibuat menggunakan Visual Studio Code (Versi 1.27.2) pada Windows 10. Nanti dalam tutorial ini kita akan menggunakan beberapa shortcut keyboard. Ini mungkin berbeda pada sistem operasi lain (macOS/Linux) serta bahasa keyboard (UK, DE, dll). Kamu dapat menelusuri daftar pintasan mu dengan mencari "shortcut" di Palet Perintah. ## Fork repositori ini fork this repository Fork repo ini dengan mengklik tombol fork di kanan atas halaman ini. Ini akan membuat salinan repositori ini di akun GitHub Anda. GitHub selalu menjaga repo mu dan sumber repo yang sudah kamu fork supaya tetap pada jalurnya. Kamu bisa menganggap repo mu sebagai salinan pekerjaan. Sebagian besar repo GitHub tingkat atas (yaitu yang tidak di-copy dari repo lain mana pun) mempunyai tim inti yang terdiri dari orang-orang yang dapat langsung melakukan perubahan. Semua kontributor lain harus melakukan fork repo dan membuat perubahan pada fork, lalu membuat Pull Request untuk meminta perubahan mereka digabungkan kembali ke repo tingkat atas. Jika administrator repo tingkat atas menyukai perubahan, mereka akan menggabungkan perubahan mu dan kamu bisa mendapatkan reputasi dan nasib baik! Lebih lanjut tentang cara melakukannya akan dibahas nanti. ## Klon Repositori mu clone this repository Langkah selanjutnya adalah mengkloning repo mu ke perangkat mu sehingga bisa segera mulai membuat perubahan. VS Code membutuhkan URL repo mu agar terhubung, jadi klik tombol "clone" dan kemudian klik ikon "copy to clipboard". **HATI-HATI:** Satu kesalahan yang sering dilakukan oleh kontributor baru adalah mengkloning repo utama yang kamu fork _sumbernya_ daripada mengkloning repo mu sendiri. Periksa alamat browser mu dan pastikan kamu mengkloning repo mu sendiri. Sekarang buka Visual Studio Code. Halaman selamat datang dari VS Code akan muncul. Dari sana tekan `F1` untuk membuka bar yang ditunjukkan di bawah ini. Perhatikan bahwa sudah ada tanda `>` (lebih besar dari) di kolom teks. Anda juga dapat membuka input prompt dengan menekan `CTRL-P` lalu ketik `>`. Clone Popup (Command Popup) Anda mungkin memperhatikan bahwa sudah ada beberapa perintah tidak jelas yang tercantum di bawah ini. Itu adalah perintah yang digunakan baru-baru ini. Jadi, hiraukan saja. Clone repo Sekarang ketik `git clone`, hanya `git` atau `clone` (berfungsi seperti melakukan pencarian). Pilih Entri `Git: Clone` dan tekan `Enter` Paste Repository URL in Tempelkan URL repositori kamu dan tekan `Enter`. Ini akan membuka File Explorer di mana kamu dapat memilih di mana repositori Git harus disimpan **Penting**: Pastikan itu adalah repositori yang kamu fork dan bukan yang asli, jika tidak maka tidak akan berfungsi Status popup Kamu akan melihat status popup di kanan bawah Visual Studio Code. Setelah selesai, kamu dapat membuka repositori kloning (di folder yang sudah kamu pilih) menggunakan tombol di dialog. ## Membuat Cabang (Branch) Buka kembali palet perintah dengan menekan `F1`. Ketik `branch` dan pilih perintah `create branch` dari sana. Pada langkah berikutnya ketik nama cabang baru kamu, misalnya `add-david-kroell`. Tekan enter dan cabang akan dibuat. Cabang juga sudah siap dipakai. [Apa artinya checkout?](https://www.git-scm.com/docs/git-checkout) Branches Command Palette ## Buat Perubahan yang diperlukan Buka `Contributors.md` dan tambahkan nama kamu di mana saja di file. File ini berisi GFM (GitHub Flavoured Markdown) yang merupakan ciri khas sintaks markdown. Salin salah satu kontributor lain' baris dan modifikasi dengan nama mu untuk memastikan kamu menggunakan sintaks yang benar - itu bisa pilih-pilih Add your name ## Commit & Push perubahan ke GitHub Di sisi kiri VS Code adalah menu dengan 5 ikon yang ditampilkan. Pilih ikon versi kontrol/Sumber Kontrol. (Pintasan: Ctrl + Shift + G) Commit changes File explorer menampilkan semua file yang diubah setelah komit terakhir. Dengan mengarahkan penunjuk pada file dan mengklik `+` (plus) file akan disiapkan. Stashed Files Ketik sesuatu pada baris di atas explorer dan tekan tanda centang. Perubahan telah tersimpan pada salinan lokal kamu. Sekarang perubahan harus di _push_ kembali ke GitHub. Stashed Files Gunakan ikon titik tiga untuk membuka menu tempat kamu akan memilih opsi `Publish Branch`. Ini akan membuka dialog untuk memasukkan kredensial GitHub kamu. Stashed Files ## Submit perubahan mu untuk diperiksa Dititik ini kamu telah menyelesaikan perubahan mu tetapi masih berada di repo mu sendiri. Langkah ini akan menunjukkan bagaimana cara mengirimkan permintaan ke administrator repo tingkat atas untuk menggabungkan perubahan Pada repo mu di GitHub, kamu akan melihat tombol `Compare & pull request` di sebelah pemberitahuan cabang baru. Klik tombol itu. create a pull request Sekarang kirimkan permintaan _pull_. submit pull request Segera saya akan menggabungkan semua perubahan mu ke dalam cabang utama proyek ini. Kamu akan mendapatkan email pemberitahuan setelah perubahan digabungkan. ## Kemana lagi setelah ini? Selamat! kamu baru saja menyelesaikan alur kerja _fork -> clone -> edit -> PR_ standar yang akan sering kamu temui sebagai kontributor! Rayakan kontribusi mu dan bagikan dengan teman dan pengikut kamu dengan membuka [web app](https://firstcontributions.github.io#social-share). Kamu dapat bergabung dengan tim slack kami jika memerlukan bantuan atau memiliki pertanyaan. [Bergabung dengan tim Slack](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY). ### [ Materi tambahan ](../../additional-material/translations/additional-material.id.md) ## Tutorial menggunakan Alat lain [Kembali ke halaman utama](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial_pt_br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições | Visual Studio Code | Visual Studio Code | | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | É difícil, sempre é difícil quando fazemos alguma coisa pela primeira vez. Especialmente quando você está colaborando, cometendo erros, não é nada confortável. No entanto, o open source é totalmente sobre colaboração e trabalho em equipe. Por isso, nós queremos simplificar a maneira como os novos colaboradores de código aberto aprendem e contribuem pela primeira vez. Ler artigos e assistir a tutoriais até podem ajudar, mas o que é melhor do que fazer as coisas sem bagunçar nada. Este projeto tem como objetivo orientar & simplificar a forma como os iniciantes fazem a sua primeira contribuição. Lembre-se que você aprende melhor quando está relaxado. Se você deseja fazer sua primeira contribuição, basta seguir os passos abaixo. Nós prometemos a você que será divertido! Se você não tem o Visual Studio 2017 na sua máquina, [instale-o](https://code.visualstudio.com/download). **Nota:** Este tutorial foi feito utilizando o Visual Studio Code (Versão 1.27.2) no Windows 10. Mais tarde, neste tutorial, vamos utilizar alguns atalhos no teclado. Eles podem ser diferentes em outros sistemas operacionais (mac/OS/Linux) assim como em teclados de outras linguagens (UK, DE, etc). Você pode pesquisar na lista de atalhos, buscando por "atalhos" na Paleta de Comando. ## Faça o *Fork* deste repositório fork this repository Faça um *fork* deste repositório clicando no botão *fork* (bifurcar) no canto superior direito desta página. Isso criará uma cópia deste repositório em sua conta do GitHub. O GitHub rastreia a relação entre seu repositório e o original, o qual você fez o *fork*. Você pode pensar em seu repositório como uma cópia de trabalho. Muitos dos repositórios matrizes do GitHub (ou seja, aqueles que não são *Fork* de nenhum outro repositório) tem um pequeno grupo de pessoas que podem fazer commits de modificações diretamente. Todos os outros contribuidores devem fazer um *fork* do repositório e fazer alterações no *fork*, em seguida, devem criar um Pull Request para solicitar um *Merge* (mesclagem) das modificações feitas no repositório original. Se um dos administradores do repositório gostar e aprovar as tuas mudanças, eles *mergearão* e você ganhará fama e fortuna imediatamente! Abaixo, há mais detalhes sobre como fazer isso. ## Clone o seu repositório clone this repository O próximo passo será clonar seu repositório em sua máquina para que você possa modificá-lo. Visual Studio precisa da URL do seu repositório, portanto clique no botão "clone" e então clique no ícone "copy to clipboard". **CUIDADO:** Um erro que os novatos cometem com frequência é clonar o repositório do qual você fez o fork, ao invés de clonar seu repositório. Verifique a barra de endereços do seu navegador e certifique-se de que você está clonando o seu repositório. Agora, abra o Visual Studio Code. A página principal do VS Code vai minimizar. A partir daí, pressione `F1` para abrir a barra mostrada abaixo. Perceba que já existe um `>` (maior que) no campo de texto. Você pode também chegar até o prompt de entrada pressionando `CTRL-P` e então inserindo o caracter `>`. Clone Popup (Command Popup) Você pode notar que já aí já existem alguns comandos de sugestão abaixo. Esses são os seus comandos utilizados recentemente. Então, apenas ignore-os. Clone repo Agora, digite `git clone`, apenas `git` ou `clone` (isso funcionará como uma pesquisa). Selecione a opção `Git: Clone` e então aperte `Enter`. Paste Repository URL in Cole a URL do seu repositório e aperte `Enter`. Isso vai abrir o Explorador de Arquivo onde você pode escolher onde o repositório Git será armazenado. **Importante**: Tenha certerza que este é o repositório *forkeado* e não é o original. Se não, não funcionará. Status popup Você pode ver uma janela do status no canto inferior direito do Visual Studio Code. Depois de finalizado esse processo, você pode abrir o repositório clonado (agora, uma pasta na sua máquina) e usar os botões no diálogo. ## Crie uma *branch* Abra a Paleta de Comando novamente, pressionando `F1`. Digite nele `branch` e selecione o comando `create branch` a partir das sugestões. No próximo passo, digite o nome da sua nova *branch*, por exemplo: `add-david-kroell`. Presione `Enter` e a *branch* será criada. A *branch* também está preparada para o *check out*. [*O que isso significa?*](https://www.git-scm.com/docs/git-checkout) Branches Command Palette ## Faça as mudanças necessárias Abra o arquivo `Contributors.md` e adicione o seu nome no fim da lista. Esse arquivo contém GFM (GitHub Flavored Markdown), que é uma função nativa da sintaxe do markdown. Copie uma das outras linhas dos contribuidores e modifique-a com o seu nome. Tenha certeza que a sintaxe está correta - ela pode ser exigente. Add your name ## Faça um *Commit* & um *Push* das suas mudanças para o GitHub No lado esquerdo do VS Code tem um menu com 5 ícones a amostra. Selecione o ícone de `Controle de Versão/Controle da Fonte`. (Atalho : Ctrl + Shift + G) Commit changes O Explorador de arquivos mostra todos os arquivos que foram mudados depois do último commit. Sobrepondo o mouse nos arquivos e clicando no `+` (mais) os arquivos serão colocados no *stage*. Stashed Files Escreva algo na caixa de texto, no topo do explorador e pressione o botão de *check*. As mudanças agora foram *commitadas* para a sua cópia local. Agora, as mudanças tem que serem mandadas para o GitHub. Stashed Files Use o ícone dos três pontos para abrir o menu onde você selecionará a opção `Publicar Branch`. Isso deve abrir uma caixa de diálogo para colocar as tuas credenciais do GitHub. Stashed Files ## Submeta suas mudanças para uma revisão Nesse ponto, você completou suas mudanças, mas elas ainda estão no seu repositório. Esse passo vai mostrar para você como submeter uma requisição para o administrador do repositório original para *mergear* suas mudanças. No seu repositório no GitHub você verá o botão `Compare & Pull request` próximo a notificação da branch. Clique nesse botão. create a pull request Agora, submeta o *pull request*. submit pull request Breve as suas mudanças serão *mergeadas* na branch `master` desse projeto. Você será notificado por email uma vez que as mudanças forem *mergeadas*. ## Para onde ir ? Parabéns! Você acabou de completar o fluxo de trabalho *fork -> clone -> edit -> PR* que vocẽ vai realizar frequentemente como um contribuidor! Celebre a sua contribuição e compartilhe-a com os seus amigos e seguidores indo para o [web app](https://firstcontributions.github.io#social-share). Você pode se juntar à nossa comunidade no slack, caso precise de alguma ajuda ou tenha alguma dúvida. [Faça parte da nossa comunidade no Slack!](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY) ### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriais utilizando outras ferramentas [Retorne para a página principal](https://github.com/firstcontributions/first-contributions/blob/master/translations/README.pt_br.md) ================================================ FILE: docs/gui-tool-tutorials/translations/github-windows-vs2017-tutorial.pt_br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições |Visual Studio 2017|Visual Studio 2017 Edition| |---|---| É difícil. Sempre é difícil fazer algo pela primeira vez. Especialmente quando você está colaborando, cometer erros não é confortável. Mas o open sourece tem tudo a ver com colaboração e trabalho em equipe. Nós queremos simplificar a maneira de aprendizagem aos novos contribuidores de open source e ajudar em sua primeira contribuição. Lendo artigos e olhando tutoriais podem ajudar, mas o que é melhor do que realmente fazer as coisas sem estragar nada. Esse projeto visa em providenciar uma orientação e simplificar a maneira dos novatos a conseguirem a sua primeira contribuição. Lembre-se, quanto mais relaxado melhor será o aprendizado. Se você está procurando em fazer a sua primeira contribuição, siga esses passos abaixo. Nós prometemos a você que vai ser divertido. Se você não possui o Visual Studio 2017 na sua máquina, [instale-o aqui](https://www.visualstudio.com/downloads/). ## Faça um Fork deste repositório fork this repository Para fazer um Fork deste repositório, basta clicar no botão de fork no topo da página. Isso criará uma cópia do repositório na sua conta GitHub. O GitHub acompapanhará o seu Fork e o repositório principal. Em outras palavras, podemos afirmar que o seu Fork é uma cópia do repositório principal. Os respositórios de mais alto nível do GitHub (exemplo: aqueles que não há um fork de nenhum outro repositório), tem uma pequena equipe principal de pessoas que podem diretamente fazer os seus commits. Os outros contribuidores deverão criar um Fork do respositório e fazer as mudanças nesse Fork, em seguida criar um Pull Request perguntando se essas mudanças poderão ser mescladas no repositório de alto nível. Se o administrador do repositório gostar das alterações ele irá mesclar as modificações e você ganhará instantaneamente fama e fortuna! Abaixo há um tutorial de como realizar. ## Clone o seu repositório clone this repository O próximo passo será clonar seu repositório em sua máquina para que você possa modificá-lo. Visual Studio precisa da URL do seu repositório, portanto clique no botão "clone" e então clique no ícone "copy to clipboard". **CUIDADO:** Um erro que os novatos cometem com frequência é clonar o repositório do qual você fez o fork, ao invés de clonar seu repositório. Verifique a barra de endereços do seu navegador e certifique-se de que você está clonando o seu repositório. Agora é a hora de ir para o Visual Studio 2017! Você estará trabalhando na aba *Team Explorer* na maior parte do tutorial. Se ela não estiver aberta por padrão, clique em `View > Team Explorer` para abrí-la. Team Explorer *Team Explorer* tem muitas áreas e muitos botões de navegação, localizados no topo para te ajudar a achar essas diferentes áreas. Para clonar o repositório, você vai precisar estar na *Connect view*, que deve ser a padrão. Se você não conseguir ver o botão *clone*, clique no botão verde, em formato de tomada, no topo. Click the `Clone` option under **Local Git Repositories** and paste the URL to your repo in the text box. This should be the URL you copied to your clipboard from GitHub previously. Clique na opção `Clone` abaixo de **Local Git Repositories** e cole a URL do seu repositório na caixa de texto. Essa URL tem que ser a mesma que você copiou no GitHub anteriormente. Clique no botão `Clone` para iniciar o processo. Clone repo Quando o processo estiver completo, você será movido para a aba *Solution Explorer*, onde você poderá ver o conteúdo do repositório clonado. O seu parecerá um pouco diferente da foto abaixo, por que os arquivos estão em constante mudança! Solution Explorer ## Crie uma *branch* Clique de volta na aba *Team Explorer* e use o a seleção principal de navegação para mostrar as *Branchs* disponíveis. Branches view Você deve ver o repositório **first-contributions** e a branch padrão, que é chamada `main`. Clique com o botão direito na `main` e escolha `New Local Branch From...`. New branch Dê à sua branch um nome como `add-` por exemplo: `add-alonzo-church`. Deixe a caixa de seleção `Checkout branch` marcada e clique no botão `Create Branch`. Create branch Você deverá ver a sua branch nova na lista. See new branch ## Faça as mudanças necessárias Abra o arquivo `Contributors.md` e adicione o seu nome no fim da lista. Esse arquivo contém GFM (GitHub Flavored Markdown), que é uma função nativa da sintaxe do markdown. Copie uma das outras linhas dos contribuidores e modifique-a com o seu nome. Tenha certeza que a sintaxe está correta - ela pode ser exigente. Add your name ## Commit & Push changes to GitHub Volte para a aba *Team Explorer* e navegue para a aba *Changes*. Changes Coloque a informação que você queira, poste o seu *commit* e clique em `Save`. O Visual Studio relembrará isso para futuros *commits*. Git user information **NOTA:** Visual Studio usa uma pasta escondida, chamada `.vs` para salvar suas configurações e preferências pessoais. O conteúdo desta pasta **não deverá ser salvo no Git**. Se ela não estiver sido ingnorada ainda, você deve informar ao Git para ignorar essa pasta, com o intuito dela não ser mandada para o repositório. Essa pasta já foi ignorada neste repositório, então você não tem que realizar este passo. Ele está aqui somente para você ter uma referência para projetos futuros. Ignore vs folder Agora você deve ver uma lista de arquivos modificados e uma caixa de texto para digitar um cometário do *commit*. Os comentários devem ser breves, mas concretos. Não tem nada pior do que ler um comentário de um *commit* e ver algo como: `"Eu atualizei algumas coisas"`. Tire alguns segundos para realizar o seu *commit*. O seu time vai agradecer bastante mais tarde e você pode até agradecer a você mesmo! Clique em `Commit All and Push` para realizar um *commit* local e fazer um *push* das suas mudanças para o seu repositório, tudo em um único passo. **NOTA:** Um *Commit* pode ser realizado separadamente de um *Push*. Fazemos os dois juntos por conveniência. As mudanças realizadas e salvas em *commits* locais não serão refletidos no teu repositório no GitHub até que você faça um *Push*. Commit and Push A primeira vez que você realizar um *Push* para o GitHub, Visual Studio solicitará as suas credenciais do GitHub. Depois disso, ele as guardará no *cache*, para que você não precise realizar isso frequentemente. Login Depois de realizar uma operação de *Push*, abra o seu repositório no GitHub e deverá ver uma mensagem indicando um *push* recente de uma *branch*. Você pode ver suas mudanças abrindo a seleção `Branch: main` e selecionando a sua `branch`. Parabéns! Você pode compartilhar a URL da `branch` com o mundo e mostrar o seu progresso! View pushed branch on GitHub ## Submeta as suas mudanças para uma revisão Neste ponto, você completou as mudanças, mas elas ainda estão somente no seu repositório. Esse passo te mostrará como submeter essas mudanças para um administrador para que ele possa fazer um *merge* das tuas mudanças. No seu repositório no GitHub, você verá o botão `Compare & pull request` próximo à notificação da *branch*. Cloque nesse botão. create a pull request Agora submeta o *Pull Request*. submit pull request Assim que possível, essas mudanças serão *mergeadas* para a `main branch` deste projeto. Você será notificado via email, quando essa movimentação for realizada. ## Para onde ir daqui? Parabéns! Você acabou de completar o fluxo de trabalho *fork -> clone -> edit -> PR* que vocẽ vai realizar frequentemente como um contribuidor! Celebre a sua contribuição e compartilhe-a com os seus amigos e seguidores indo para o [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/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY). Você pode se juntar à nossa comunidade no slack, caso precise de alguma ajuda ou tenha alguma dúvida. [Faça parte da nossa comunidade no Slack!](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY) ### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriais utilizando outras ferramentas [Retorne para a página principal](https://github.com/firstcontributions/first-contributions/blob/master/translations/README.pt_br.md) ================================================ FILE: docs/gui-tool-tutorials/translations/gitkraken-tutorial-es.md ================================================ [![Amor por el Código Abierto](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![Licencia: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Ayudantes de Código Abierto](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeras Contribuciones |GitKraken|GitKraken Edition| |---|---| Es difícil. Siempre es difícil cuando se hace algo por primera vez. Especialmente cuando se colabora, cometer errores no es algo agradable. Pero el código abierto trata sobre la colaboración y el trabajo en conjunto. Queríamos simplificar la manera en que los contribuyentes de código abierto aprenden y contribuyen por primera vez. Leer artículos y ver tutoriales puede ayudar, pero ¿qué es mejor que hacer las cosas sin estropear nada?. Este proyecto tiene como objetivo proporcionar orientación y simplificar la manera en que los novatos hacen su primera contribución. Recuerda que cuando más relajado estés, mejor aprenderás. Si buscas hacer tu primera contribución sólo sigue los simples pasos a continuación. Te lo prometemos, será divertido. ## Git Kraken Descarga [GitKraken](https://www.gitkraken.com), Instálalo y ábrelo. Deberías ver el diálogo modal "Welcome to GitKraken" - Regístrate con Github y permite el acceso a Gitkraken a tu cuenta de GitHub. login to GitHub (opcional) Dirígete a File -> Preferences y configura el directorio de tu proyecto en la raíz de tus repositorios locales. ## Bifurca (Fork) este repositorio Bifurca este repositorio clickeando en el botón fork en la parte superior derecha de esta página. fork this repository Esto creará una copia de este repositorio en su cuenta. ## Clona el repositorio En GitKraken, ve a File -> Clone Repo. clone this repository Selecciona GitHub.com en el panel derecho. Bajo tu nombre de usuario, deberías ver first-contributions. Haz click en ese repositorio y verifica la ruta completa mostrada al final del panel. Una vez estés satisfecho con la ruta, clickea "Clone the repo!". ## Crear una rama (*branch*) Clickea el botón *branch* de la barra de herramientas. Nombra tu rama "add-your-name", por ejemplo: "add-william-sutton" name your branch ## Haz los cambios necesarios y confirma (*Commit*) esos cambios Ahora abre el archivo `Contributors.md` en un editor de texto y agrégale tu nombre, luego guarda el archivo. Si tienes el repositorio abierto en GitKraken deberías ver que hay cambios. Revisa y prepara esos cambios seleccionando la confirmación (*commit*) más reciente marcada con "// WIP" y el número de archivos cambiados y el tipo de cambio. edit some file(s) Revisa los archivos que han sido cambiados y decide cuáles deseas preparar para confirmar (*stage*). La preparación es importante para decirle a git exactamente que archivos deseas asociar con esta confirmación (*commit*). stage your changes Una vez tengas un buen mensaje de confirmación (*commit*) ("Add to Contributors list" suena agradable y descriptivo) y estés feliz con tus cambios, puedes clickear "Stage all changes" para preparar todo lo modificado o "Stage File" para preparar un archivo individual. clone this repository Si cambias de idea, puedes olvidar (*unstage*) esos cambios, o puedes descartárlos todos. ADVERTENCIA: Como lo implica la palabra descartar, esta es una operación destructiva. Hazlo solo si no quieres ningún cambio(s) desde cualquier repositorio en el que te encuentres. Clickea en *commit*. Felicidades, has confirmado (*committed*) todos los cambios a la copia local de la rama de tu bifurcación (*fork*) de first-contributions.¡Adelante!. ## Sube (*push*) los cambios a GitHub push your changes Haz click en el botón *Push* en la barra de herramientas. origin or branch Envía los cambios en la rama origen si quieres que los cambios se reflejen en la rama maestra directamente, sino selecciona la rama apropiada a la cual quieres hacer el push. ## Envía tus cambios para revisión Si vas a tu repositorio en github, verás el botón `Compare & pull request`. Haz click en él. create a pull request Ahora confirma el pull request. submit pull request Pronto estaré fusionando todos sus cambios en la rama master de este proyecto. Recibirás una notificación por correo electrónico cuando los cambios hayan sido fusionados. ## ¿Cuáles son los siguientes pasos? ¡Enhorabuena! ¡Has completado el flujo de trabajo _fork -> clone -> edit -> PR_ que encontrarás habitualmente como contribuidor! Celebra tu contribución y compártela con tus amigos y seguidores yendo a [App web](https://firstcontributions.github.io/#social-share). También podrías unirte a nuestro equipo de Slack en caso de que necesites ayuda o tengas alguna pregunta. [Únete a nuestro equipo de Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriales con otras herramientas [Regresar a la página principal](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/gitkraken-tutorial-fr.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Première Contribution |GitKraken|GitKraken Edition| |---|---| C'est difficile. C'est toujours difficile, quand on fait quelque chose pour la première fois. Surtout lorsque vous collaborez, faire des erreurs n'est pas une chose confortable. Mais l'open source concerne avant tout la collaboration et le travail en équipe. Nous voulions simplifier la manière dont les nouveaux contributeurs open source apprennent et contribuent pour la première fois. Lire des articles et regarder des tutoriels peut aider, mais quoi de mieux que de vraiment faire les choses sans tout gâcher. Ce projet vise à fournir des conseils et à simplifier la manière dont les novices font leur première contribution. Rappelez-vous, plus vous êtes détendu, mieux vous apprenez. Si vous cherchez à faire votre première contribution, suivez simplement les étapes simples ci-dessous. Nous vous promettons que ce sera amusant ## Git Kraken Télécharger [GitKraken](https://www.gitkraken.com), Installer et l'ouvrir. Vous devriez lire "Welcome to GitKraken" - Enregistrer vous via Github en cliquant sur "Sign in with GitHub" et autoriser GitKraken à accéder à votre compte GitHub account. login to GitHub (optionnel) Allez dans Fichier (File) -> Préférences (Preferences) et définissez votre répertoire de projet à la racine de vos dépôts locaux. ## Forker ce dépôt Forker ce dépôt en cliquant sur le bouton Fork en haut de cette page. dupliquez ce dépôt Cela créera une copie de ce dépôt dans votre compte. ## Cloner le dépôt Dans GitKraken, aller à File -> Clone Repo. clone this repository Selectionner GitHub.com dans le panneau de droite. Sous votre username, vous devriez voir first-contributions apparaître. Cliquer sur ce dépôt et vérifier le chemin complet vers le dossier en bas du panneau d'affichage. Une fois que vous êtes satisfait du chemin, cliquez sur "Clone the repo!". ## Créer une branche Cliquez sur le bouton "branche" dans la barre d'outils. Nommez votre branche "add-your-name", par exemple : "add-william-sutton". name your branch ## Effectuez et validez des modifications. Ouvrez maintenant le fichier Contributors.md dans un éditeur de texte et ajoutez-y votre nom, puis enregistrez le fichier. Si vous avez le dépôt ouvert dans GitKraken, vous verrez qu'il y a des modifications. Examinez et mettez en scène ces modifications en sélectionnant le dernier commit marqué par "// WIP" et le nombre de fichiers modifiés ainsi que le type de modification. edit some file(s) Examinez les fichiers qui ont été modifiés et décidez de ceux que vous souhaitez "stage". "Staging" est important pour indiquer à git exactement quelles modifications de fichier vous souhaitez associer à ce commit. stage your changes Once you have a good commit message ("Add to Contributors list" sounds nice and descriptive) and are happy with your changes, you can hit "Stage all changes" to stage everything that is modified or "Stage File" to stage an individual file. Lorsque vous avez un bon message de commit ("Add to Contributors list" semble joli et descriptif) et que vous êtes satisfait de vos modifications, vous pouvez cliquer sur "Stage all changes" pour "stage" tout ce qui est modifié ou "Stage File" pour ajouter un fichier individuel. clone this repository Si vous changez d'avis, vous pouvez "unstage" ces modifications, ou vous pouvez les supprimer complètement. ATTENTION : Comme le mot supprimer l'indique, c'est une opération destructrice. Faites-le seulement si vous ne voulez aucune modification(s) du dépôt dans lequel vous vous trouvez. Appuyez sur "commit". Félicitations, vous avez validé toutes les modifications dans votre copie locale de votre branche de votre fork de first-contributions. En avant ! ## Push changes to GitHub push your changes Cliquez sur le bouton Push dans la barre d'outils. origin or branch Soumettez les modifications sur la branche origin si vous souhaitez que les modifications se reflètent directement dans la branche master, sinon sélectionnez la branche appropriée que vous souhaitez pousser (push). ## Soumettez vos modifications pour revision (review) Si vous allez sur votre dépôt sur GitHub, vous verrez le bouton Compare & pull request. Cliquez sur ce bouton. create a pull request Maintenant, soumettez la pull request. submit pull request Bientôt, je fusionnerai toutes vos modifications dans la branche master de ce projet. Vous recevrez un e-mail de notification une fois les modifications fusionnées (merge). ## Que faire ensuite ? Félicitations ! Vous venez de terminer le workflow standard fork -> clone -> edit -> PR que vous rencontrerez souvent en tant que contributeur ! Célébrez votre contribution et partagez-la avec vos amis et abonnés en vous rendant sur l'application [web](https://firstcontributions.github.io/#social-share). Vous pouvez rejoindre notre équipe Slack si vous avez besoin d'aide ou si vous avez des questions. [Rejoignez l'équipe Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [Autre-Materiel](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriels avec d'autres outils [Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/gitkraken-tutorial.pt-br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições |Visual Studio 2017|Visual Studio 2017 Edition| |---|---| É difícil. Sempre é difícil fazer algo pela primeira vez. Especialmente quando você está colaborando, cometer erros não é confortável. Mas o open sourece tem tudo a ver com colaboração e trabalho em equipe. Nós queremos simplificar a maneira de aprendizagem aos novos contribuidores de open source e ajudar em sua primeira contribuição. Lendo artigos e olhando tutoriais podem ajudar, mas o que é melhor do que realmente fazer as coisas sem estragar nada. Esse projeto visa em providenciar uma orientação e simplificar a maneira dos novatos a conseguirem a sua primeira contribuição. Lembre-se, quanto mais relaxado melhor será o aprendizado. Se você está procurando em fazer a sua primeira contribuição, siga esses passos abaixo. Nós prometemos a você que vai ser divertido. ## Git Kraken Baixe [GitKraken](https://www.gitkraken.com), Instale e abra. Provavelmente aparecerá um "Bem-vindo ao GitKraken" com um espaço para entrar na sua conta do GitHub e permitir que o GitKraken possa ter o acesso dela. login to GitHub (opcional) Vá para Aqruivos -> Preferências e ajuste o diretório do seu projeto para a raiz de seus repositórios locais. ## Faça um Fork deste repositório Para fazer um Fork deste repositório, basta clicar no botão de fork no topo da página. fork this repository Isso criará uma cópia do repositório na sua conta GitHub. ## Clone o seu repositório No GitKraken, vá até Arquivo -> Clone Repositório. clone this repository Selecione GitHub.com no painel direito. De baixo do nome de usuário, deverá aparecer "first-contributions". Clique nesse repositório e confirme na parte inferior do painel, se aparece o local do diretório onde você quer clonar. Quando estiver tudo certo com o diretório, clique em "Clone o repositório!" ## Crie uma Branch Clique o botão branch na barra de ferramentas. Nomeie a sua branch "add-seu-nome", for example: "add-william-sutton" name your branch ## Faça mudanças necessárias e faça um commit nelas Agora abra o arquivo `Contributors.md` em um editor de texto e adicione o seu nome, em seguida salve-o. Se você estiver com o repositório aberto no GitKraken, haverá mudanças. Revise e faça um Stage nessas mudanças selecionando o commit mais recente marcado com "// WIP" e com número de arquivos modificados e o tipo de mudança. edit some file(s) Revise esses arquivos que foram modificados e decida o que colocar no Stage. O Stage é importante, pois informa o Git extamente quais arquivos modificados você quer mandar no commit. stage your changes Quando escrever uma boa mensagem no commit ("Add para a lista de Contribuidores" parece bom e descritivo) e satisfeito com as suas mudanças, você pode apertar no "Stage todas as mudanças" para fazer o Stage em todas as alterações ou "Stage Arquivo" para cada arquivo modificado individualmente. clone this repository Se você mudar de ideia, você pode fazer um Unstage (processo reverso do Stage) das sua modificações ou discartar todas elas juntas. CUIDADO: A palavra discartar fala por si só, ou seja, é uma operação destrutiva. Só faça isso, se você não quer nenhuma mundança no repositório que estiver trabalhando. Aperte commit. Parabéns, você acabou de fazer um commit de todas as suas mudanças na sua branch local do seu Fork. Em diante! ## Faça um Push nas suas modificações para o GitHub push your changes Na barra de ferramentas, clique no botão Push. origin or branch Se você quer enviar as mudanças direto para branch master, você pode enviar para a branch de origem. Caso contrário, selecione uma branch apropriada para mandar. ## Envie as suas mudanças para revisão No seu repositório do GitHub você vai ver um botão escrito: `Compare & pull request`, que fica ao lado da notificação da nova branch. Clique nesse botão. create a pull request Agora envie esse Pull Request. submit pull request Logo irei mesclar todas as suas mudanças na branch master do projeto. Você receberá uma notificação pelo e-mail quando as alterações forem mescladas. ## Onde eu posso ir a partir daqui? Parabéns! Você completou o fluxo de trabalho básico _fork -> clone -> edit -> PR_, onde você encontrará muito como contribuidor. Celebre a sua contribuição e compartilhe com seus amigos e seguidores no [web app](https://firstcontributions.github.io/#social-share). Caso precise de ajuda ou tenha alguma pergunta, você pode se juntar à nossa equipe Slack. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [Material Adicional](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriais usando outras ferramentas [Voltar para página principal](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/gui-tool-tutorials/translations/malayalam/githiub-desktop-tutorial-ml.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # ആദ്യ സംഭാവനകൾ | Git Bash | Git Bash Edition | | ------------------------------------------------------------------------------------------------------------------ | ---------------- | ഇത് ബുദ്ധിമുട്ടാണ്. നിങ്ങൾ ആദ്യമായി എന്തെങ്കിലും ചെയ്യുമ്പോൾ എല്ലായ്പ്പോഴും ബുദ്ധിമുട്ടാണ്. പ്രത്യേകിച്ചും നിങ്ങൾ സഹകരിക്കുമ്പോൾ, തെറ്റുകൾ വരുത്തുന്നത് സുഖകരമായ കാര്യമല്ല. എന്നാൽ ഓപ്പൺ സോഴ്‌സ് എന്നത് സഹകരിച്ച് പ്രവർത്തിക്കുന്നതിനും ഒരുമിച്ച് പ്രവർത്തിക്കുന്നതിനുമാണ്. പുതിയ ഓപ്പൺ സോഴ്‌സ് സംഭാവകർ ആദ്യമായി പഠിക്കുകയും സംഭാവന ചെയ്യുകയും ചെയ്യുന്ന രീതി ലളിതമാക്കാൻ ഞങ്ങൾ ആഗ്രഹിക്കുന്നു. ലേഖനങ്ങൾ വായിക്കുന്നതും ട്യൂട്ടോറിയലുകൾ കാണുന്നതും സഹായിക്കും, എന്നാൽ യാതൊന്നും കുഴപ്പത്തിലാക്കാതെ കാര്യങ്ങൾ ചെയ്യുന്നതിനേക്കാൾ നല്ലത് എന്താണ്. ഈ പ്രോജക്റ്റ് മാർഗ്ഗനിർദ്ദേശം നൽകാനും പുതുമുഖങ്ങൾ അവരുടെ ആദ്യ സംഭാവന നൽകുന്ന രീതി ലളിതമാക്കാനും ലക്ഷ്യമിടുന്നു. നിങ്ങൾ എത്രത്തോളം വിശ്രമിക്കുന്നുവോ അത്രയും നന്നായി പഠിക്കുമെന്ന് ഓർക്കുക. നിങ്ങളുടെ ആദ്യ സംഭാവന നൽകാൻ നിങ്ങൾ ആഗ്രഹിക്കുന്നുവെങ്കിൽ, ചുവടെയുള്ള ലളിതമായ ഘട്ടങ്ങൾ പിന്തുടരുക. ഞങ്ങൾ നിങ്ങൾക്ക് വാഗ്ദാനം ചെയ്യുന്നു, അത് രസകരമായിരിക്കും. നിങ്ങളുടെ വിൻഡോസ് മെഷീനിൽ ഗീത് ബാഷ് ഇല്ലെങ്കിൽ, [install it](https://git-scm.com/download/win). fork this repository ## ഈ ശേഖരം ഫോർക്ക് ചെയ്യുക ഈ പേജിൻ്റെ മുകളിൽ വലതുവശത്തുള്ള ഫോർക്ക് ബട്ടണിൽ ക്ലിക്കുചെയ്ത് ഈ റിപ്പോ ഫോർക്ക് ചെയ്യുക. ഇത് നിങ്ങളുടെ അക്കൗണ്ടിൽ ഈ ശേഖരത്തിൻ്റെ ഒരു പകർപ്പ് സൃഷ്ടിക്കും. ## ശേഖരം ക്ലോൺ ചെയ്യുക ഇപ്പോൾ ഈ റിപ്പോ നിങ്ങളുടെ മെഷീനിലേക്ക് ക്ലോൺ ചെയ്യുക. പ്രധാനപ്പെട്ടത്: ഒറിജിനൽ റിപ്പോ ക്ലോൺ ചെയ്യരുത്. നിങ്ങളുടെ നാൽക്കവലയിലേക്ക് പോയി അത് ക്ലോൺ ചെയ്യുക. റിപ്പോ ക്ലോൺ ചെയ്യാൻ, "കോഡ്" ക്ലിക്ക് ചെയ്യുക, തുടർന്ന് താഴെയുള്ള സ്ട്രിംഗ് പകർത്തുക. copy string നിങ്ങൾ ഇപ്പോൾ ഡൗൺലോഡ് ചെയ്ത ഗീത് ബാഷ് ആപ്ലിക്കേഷൻ തുറക്കുക. ഇത് വിൻഡോസ് മെഷീനിലാണെങ്കിൽ താഴെയുള്ള ചിത്രം പോലെയായിരിക്കണം. open git bash terminal ഈ കമാൻഡ് ഉപയോഗിച്ച് ഈ പ്രോജക്റ്റ് സംരക്ഷിക്കാൻ നിങ്ങൾ ആഗ്രഹിക്കുന്ന ഫോൾഡറിലേക്ക് പോകുക `cd ` cd into a folder ഈ കമാൻഡ് ഉപയോഗിച്ച് റിപ്പോസിറ്ററി ക്ലോൺ ചെയ്യുന്നതിന് മുകളിലുള്ള ഘട്ടത്തിൽ നിങ്ങൾ പകർത്തിയ സ്ട്രിംഗ് ഉപയോഗിക്കുക `git clone ` clone the repository നിങ്ങളുടെ മാറ്റങ്ങൾ വരുത്താൻ റിപ്പോ ഉള്ള ഡയറക്ടറിയിലേക്ക് പോയി അത് vs കോഡിൽ തുറക്കുക. cd into the newly cloned repo ## Create a branch ഇപ്പോൾ ഈ ലളിതമായ കമാൻഡ് ഉപയോഗിച്ച് ഒരു ബ്രാഞ്ച് സൃഷ്ടിക്കുക. ഈ കമാൻഡ് നിങ്ങൾക്കായി ഒരു ശാഖ സൃഷ്ടിക്കുക മാത്രമല്ല, ആ ബ്രാഞ്ചിലേക്ക് മാറാനും നിങ്ങളെ അനുവദിക്കുന്നു. ``` git checkout -b <ശാഖ-നാമം> ``` നിങ്ങളുടെ ശാഖയ്ക്ക് പേര് നൽകുക `<നിങ്ങളുടെ പേര് ചേർക്കുക>`. ഉദാഹരണത്തിന്, "ആഡ്-ജെയിംസ്-സ്മിത്ത്" create a branch ## ആവശ്യമായ മാറ്റങ്ങൾ വരുത്തുകയും ആ മാറ്റങ്ങൾ വരുത്തുകയും ചെയ്യുക ഇപ്പോൾ ഒരു ടെക്സ്റ്റ് എഡിറ്ററിൽ `Contributors.md` ഫയൽ തുറക്കുക, പേജിൻ്റെ താഴേക്ക് സ്ക്രോൾ ചെയ്ത് അതിൽ നിങ്ങളുടെ പേര് ചേർക്കുക, തുടർന്ന് ഫയൽ സംരക്ഷിക്കുക. ഉദാഹരണം: നിങ്ങളുടെ പേര് ജെയിംസ് സ്മിത്ത് എന്നാണെങ്കിൽ, അത് ഇതുപോലെ ആയിരിക്കണം. \[James Smith](https://github.com/jamessmith) ഈ കമാൻഡ് പ്രവർത്തിപ്പിക്കുന്നതിലൂടെ Contributors.md-ൽ മാറ്റങ്ങൾ ഉണ്ടെന്ന് നിങ്ങൾക്ക് കാണാൻ കഴിയും `git status` check the status ഇപ്പോൾ ആ മാറ്റങ്ങൾ വരുത്തുക: ആദ്യം ഉപയോഗിച്ച് സ്റ്റേജിംഗ് ഏരിയയിൽ നിങ്ങൾ വരുത്തിയ മാറ്റം ചേർക്കുക `git add ഫയലിൻ്റെ പേര്` തുടർന്ന് ഈ കമാൻഡ് പാടി ഒരു കമ്മിറ്റ് സന്ദേശം എഴുതുക `git commit -m "സംഭാവകരുടെ പട്ടികയിൽ നിങ്ങളുടെ പേര് ചേർക്കുക"` നിങ്ങളുടെ പേര് ഉപയോഗിച്ച് `` മാറ്റിസ്ഥാപിക്കുക. commit changes നിങ്ങളുടെ പ്രതിബദ്ധത പൂർത്തീകരിച്ചിട്ടുണ്ടോ എന്നറിയാൻ നിങ്ങൾക്ക് ഒരു ലളിതമായ `git log --oneline` കമാൻഡ് പ്രവർത്തിപ്പിക്കാം. ## മാറ്റങ്ങൾ Github-ലേക്ക് പുഷ് ചെയ്യുക മുകളിലുള്ള ഘട്ടങ്ങൾ പൂർത്തിയാക്കിക്കഴിഞ്ഞാൽ, ഈ കമാൻഡ് ഉപയോഗിച്ച് നിങ്ങൾക്ക് മാറ്റങ്ങൾ വരുത്താൻ കഴിയും `git push origin ` push changes ## നിങ്ങളുടെ മാറ്റങ്ങൾ അവലോകനത്തിനായി സമർപ്പിക്കുക നിങ്ങൾ github-ൽ നിങ്ങളുടെ ശേഖരണത്തിലേക്ക് പോയാൽ, നിങ്ങൾ `Compare & pull request` ബട്ടൺ കാണും. ആ ബട്ടണിൽ ക്ലിക്ക് ചെയ്യുക. create a pull request ഇപ്പോൾ പുൾ റിക്വസ്റ്റ് സമർപ്പിക്കുക. submit pull request ഉടൻ തന്നെ നിങ്ങളുടെ എല്ലാ മാറ്റങ്ങളും ഈ പ്രോജക്റ്റിൻ്റെ മാസ്റ്റർ ബ്രാഞ്ചിലേക്ക് ഞാൻ ലയിപ്പിക്കും. മാറ്റങ്ങൾ ലയിച്ചുകഴിഞ്ഞാൽ നിങ്ങൾക്ക് ഒരു അറിയിപ്പ് ഇമെയിൽ ലഭിക്കും. ## ഇവിടെ നിന്ന് എവിടെ പോകണം? അഭിനന്ദനങ്ങൾ! നിങ്ങൾ ഒരു സംഭാവകൻ എന്ന നിലയിൽ പലപ്പോഴും കണ്ടുമുട്ടുന്ന സ്റ്റാൻഡേർഡ് _ഫോർക്ക് -> ക്ലോൺ -> എഡിറ്റ് -> PR_ വർക്ക്ഫ്ലോ പൂർത്തിയാക്കി! [വെബ് ആപ്പ്](https://firstcontributions.github.io#social-share) എന്നതിലേക്ക് പോയി നിങ്ങളുടെ സംഭാവനകൾ ആഘോഷിക്കുകയും സുഹൃത്തുക്കളുമായും പിന്തുടരുന്നവരുമായും അത് പങ്കിടുകയും ചെയ്യുക. നിങ്ങൾക്ക് എന്തെങ്കിലും സഹായം ആവശ്യമുണ്ടെങ്കിൽ അല്ലെങ്കിൽ എന്തെങ്കിലും ചോദ്യങ്ങൾ ഉണ്ടെങ്കിൽ ഞങ്ങളുടെ സ്ലാക്ക് ടീമിൽ ചേരാം. [സ്ലാക്ക് ടീമിൽ ചേരുക](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). ### [അധിക മെറ്റീരിയൽ](../additional-material/git_workflow_scenarios/additional-material.md) ## മറ്റ് ടൂളുകൾ ഉപയോഗിച്ചുള്ള ട്യൂട്ടോറിയലുകൾ [പ്രധാന താളിലേക്ക് മടങ്ങുക](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) ================================================ FILE: docs/how-to-contribute-to-open-source-projects.md ================================================ # How to Contribute to Open Source: A Comprehensive Guide for Beginners TL;DR If you're eager to do your first pull request to an open source project, follow the instructions in [Readme](https://github.com/firstcontributions/first-contributions) Contributing to open source is one of the most rewarding ways to grow as a developer, build your portfolio, and give back to the community. Whether you're a seasoned programmer or just starting out, open source offers endless opportunities to learn, collaborate, and make an impact. In this guide, we’ll walk you through everything you need to know about contributing to open source, from finding the right project to making your first contribution. ## Why Contribute to Open Source? Before diving into the "how," let’s explore the "why." Contributing to open source offers numerous benefits: * Skill Development: Open source projects expose you to real-world codebases, helping you improve your coding, debugging, and collaboration skills. * Portfolio Building: Contributions to well-known projects can enhance your resume and GitHub profile, making you stand out to potential employers. * Networking: You’ll connect with developers worldwide, learn from experts, and become part of a global community. * Giving Back: Open source powers much of the software we use daily. Contributing is a way to support the tools and technologies you rely on. * Career Opportunities: Many companies actively seek developers with open source experience, as it demonstrates initiative and teamwork. ## How to Get Started with Open Source Contributions ### 1. Choose the Right Project Finding the right project is crucial. Look for projects that align with your interests, skill level, and goals. Here’s how to find them: * Explore GitHub: Use GitHub’s Explore page or search for topics like "good-first-issue" or "help-wanted." * Check Open Source Programs: Programs like Google Summer of Code or Hacktoberfest are great for beginners. * Follow Your Tools: Contribute to libraries, frameworks, or tools you already use. ### 2. Understand the Project Before contributing, take time to understand the project: * Read the Documentation: Start with the README file, contribution guidelines, and code of conduct. * Explore the Codebase: Familiarize yourself with the project structure and coding style. * Join the Community: Participate in discussions on forums, Slack, or Discord to get a feel for the community. ### 3. Start Small Begin with small, manageable tasks to build confidence: * Fix Bugs: Look for issues labeled "good-first-issue" or "beginner-friendly." * Improve Documentation: Documentation updates are often overlooked but highly valuable. * Write Tests: Adding tests is a great way to contribute and learn about the codebase. ### 4. Follow Best Practices When contributing, adhere to the project’s guidelines: * Fork and Clone: Fork the repository and clone it to your local machine. * Create a Branch: Work on a separate branch for your changes. * Write Clean Code: Follow the project’s coding standards and write clear, concise code. * Test Your Changes: Ensure your changes don’t break existing functionality. * Submit a Pull Request (PR): Write a clear PR description, reference related issues, and be open to feedback. ## Tips for Success in Open Source Communicate Effectively: Be respectful and professional in all interactions. Ask questions when unclear about requirements. Thank reviewers for their time and feedback. Stay patient during the review process Be Consistent: Regular contributions, even small ones, can have a big impact over time. Learn from Feedback: Code reviews are a learning opportunity. Embrace feedback and improve your skills. Give Back: Once you’re comfortable, help others by reviewing PRs, answering questions, or mentoring newcomers. ## Common Challenges and How to Overcome Them * Imposter Syndrome: Many beginners feel they’re not skilled enough to contribute. Remember, everyone starts somewhere, and even small contributions matter. * Finding Time: Start with small, manageable tasks. Even 30 minutes a week can make a difference. * Navigating Large Codebases: Break down the learning process: - Start by reading the documentation thoroughly - Focus on understanding one component at a time - Use debugging tools to trace code execution - Don't hesitate to ask for clarification ## Conclusion Contributing to open source is a journey that offers immense personal and professional growth. By starting small, staying consistent, and engaging with the community, you can make meaningful contributions while honing your skills. Remember, open source thrives on collaboration, and every contribution—no matter how small—helps build a better digital world. Ready to take the plunge? Find a project that excites you, make your first contribution, and join the global open source movement today! Open source is more than just code — it’s about people, collaboration, and continuous learning. By taking small, consistent steps and engaging with the community, you’ll not only grow as a developer but also make meaningful contributions to projects used by millions. ================================================ FILE: docs/translations/README.afk.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Eerste Bydraes Dit is moeilik. Dit is altyd moeilik om die eerste keer iets te doen. Veral wanneer jy saamwerk, maak foute nie 'n gemaklike ding nie. Ons wou die manier waarop nuwe open source bydraers vir die eerste keer leer en bydra, vereenvoudig. Lees artikels en kyk tutoriale kan help, maar wat is beter as om die goed in die praktyk te doen? Hierdie projek het ten doel om leiding te gee en die manier waarop beginners hul eerste bydrae maak, te vereenvoudig. As jy jou eerste bydrae wil maak, volg die onderstaande stappe. #### *As jy nie gemaklik is met die opdraglyn nie, [is daar tutoriale wat GUI-instrumente gebruik.](#Bykomende-materiaal )* vurk hierdie bewaarplek As jy nie git op jou masjien het nie, [installeer dit]( https://help.github.com/articles/set-up-git/). ## Vork hierdie bewaarplek Vork hierdie repo deur op die vurk knoppie bo-aan hierdie bladsy te klik. Dit sal 'n kopie van hierdie repository in u rekening skep. ## Klone die repository kloon hierdie bewaarplek Klone nou die vurk repo aan jou masjien. Gaan na jou GitHub-rekening, maak die vurk repo oop, klik op die kloonknop en klik dan op die kopie na die knipbord- ikoon. Open 'n terminaal en voer die volgende git opdrag uit: ```bash git clone "url you just copied" ``` waar "url jy net gekopieer" het (sonder die aanhalingstekens) is die url na hierdie repository (jou vurk van hierdie projek). Sien die vorige stappe om die url te verkry. kopieer URL na knipbord Byvoorbeeld: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` waar `this-is-you` jou GitHub gebruikersnaam is. Hier kopieer jy die inhoud van die eerste bydrae repository in GitHub na jou rekenaar. ## Skep 'n tak Verander na die repository gids op jou rekenaar (as jy nie reeds daar is nie): ```bash cd first-contributions ``` Skep nou 'n tak met die git `checkout` opdrag: ```bash git checkout -b ``` Byvoorbeeld: ```bash git checkout -b add-alonzo-church ``` (Die naam van die tak hoef nie die woord by te voeg nie, maar dit is 'n redelike ding om in te sluit omdat die doel van hierdie tak is om jou naam by 'n lys te voeg.) ## Maak die nodige veranderinge en verbind die veranderinge Nou oop `Contributors.md` lêer in 'n teksredigeerder, voeg jou naam daarby. Moet dit nie aan die begin of einde van die lêer byvoeg nie. Sit dit oral tussenin. Stoor nou die lêer. git status As u na die projekgids gaan en die opdrag uitvoer `git status`, sal u sien dat daar veranderinge is. Voeg die veranderinge by die tak wat jy net geskep het deur die `git add` opdrag te gebruik: ```bash git add Contributors.md ``` Doen nou die veranderinge deur die `git commit` opdrag te gebruik: ```bash git commit -m "Add to Contributors list" ``` vervang `` met jou naam. ## Druk veranderinge na GitHub Druk jou veranderinge deur die opdrag te gebruik `git push`: ```bash git push origin ``` vervang `` met die naam van die tak wat jy vroeër geskep het. ## Dien jou veranderinge in vir hersiening As jy na jou repository op GitHub gaan, sal jy 'n `Compare & pull` requestknoppie sien. Klik op daardie knoppie. skep ’n trekkerversoek Dien nou die trekversoek in. dien die trekkerversoek in Binnekort sal ek al jou veranderinge in die meestertak van hierdie projek saamsmelt. U sal 'n kennisgewing-e-pos ontvang sodra die veranderinge saamgesmelt is. ## Waarheen gaan jy vandaan? Geluk! Jy het net die standaardvurk voltooi -> klone -> wysig -> PR- werkvloei wat jy dikwels as 'n bydraer sal ervaar! Vier jou bydrae en deel dit met jou vriende en volgelinge deur na die [webprogram te](https://firstcontributions.github.io/#social-share) gaan . Kom ons begin met die bydrae tot ander projekte. Ons het 'n lys van projekte saamgestel met maklike probleme waarmee u kan begin. Kyk na [die lys van projekte in die web app](https://firstcontributions.github.io/#project-list). ### [Bykomende materiaal](../additional-material/git_workflow_scenarios/additional-material.md) | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visuele Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visuele Studio Kode](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.al.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Kontributet e Para Është gjithmonë e vështirë hera e parë kur bën diçka. Sidomos kur bashkëpunon, të bësh gabime nuk është një ndjenjë e mirë. Ne duam ta thjeshtësojmë mënyrën se si kontribuesit e open-source mësojnë dhe kontribuojnë për herë të parë. Leximi i artikujve & shikimi i tutorialve ndihmojnë, por ç'është më mirë se sa ta bësh këtë gjë në një vend praktike? Ky projekt synon të udhëzojë & të thjeshtësojë mënyrën se si fillestarët bëjnë kontributin e tyre të parë. Nëse dëshiron të bësh kontributin tënd të parë, ndiqi hapat më poshtë. forko këtë repozitor #### Nëse nuk e ke git në kompjuterin tënd, [instaloje](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Forko këtë repozitor Forko këtë repozitor duke klikuar në butonin fork në krye të kësaj faqeje. Kjo do të krijojë një kopje të këtij repozitori në llogarinë tënde. ## Klono repozitorin klono këtë repozitor Tani klono repozitorin e forkuar në kompjuterin tënd. Shko në llogarinë tënde të GitHub, hap repozitorin e forkuar, kliko butonin code dhe më pas kliko ikonën _kopjo në clipboard_. Hap një terminal dhe ekzekuto komandën vijuese të git: ```bash git clone "url që sapo e kopjove" ``` Ku "url që sapo e kopjove" (pa thonjëzat) është url-ja e këtij repozitori (forku yt i këtij projekti). Shiko hapat e mëparshëm për të marrë url-në. kopjo URL në clipboard Për shembull: ```bash git clone git@github.com:ky-je-ti/first-contributions.git ``` Ku `ky-je-ti` është emri i përdoruesit tënd të GitHub. Këtu je duke kopjuar përmbajtjen e repozitorit first-contributions në GitHub në kompjuterin tënd. ## Krijo një degë Ndrysho direktorinë e repozitorit në kompjuterin tënd (nëse nuk je tashmë atje): ```bash cd first-contributions ``` Tani krijo një degë duke përdorur komandën `git switch`: ```bash git switch -c emri-jot-i-deges-se-re ``` Për shembull: ```bash git switch -c shto-john-doe ``` ## Bëj ndryshimet e nevojshme dhe kryej ato ndryshime Tani hap skedarin `Contributors.md` në një editor teksti, shto emrin tënd tek ai. Mos e shto në fillim ose në fund të skedarit. Vendose diku në mes. Tani, ruaje skedarin. git status Nëse shkon në direktorinë e projektit dhe ekzekuton komandën `git status`, do të shohësh se ka ndryshime. Shto ato ndryshime në degën që sapo e krijove duke përdorur komandën `git add`: ```bash git add Contributors.md ``` Tani kryej ato ndryshime duke përdorur komandën `git commit`: ```bash git commit -m "Add emri-yt to Contributors list" ``` Duke zëvendësuar `emri-yt` me emrin tënd. ## Shty ndryshimet në GitHub Shty ndryshimet e tua duke përdorur komandën `git push`: ```bash git push -u origin emri-jot-i-deges-se-re ``` Duke zëvendësuar `emri-jot-i-deges-se-re` me emrin e degës që krijove më parë.
Nëse merr ndonjë gabim gjatë shtyrjes, kliko këtu: - ### Gabim i Autentikimit 
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//first-contributions.git/'
Shko te [tutoriali i GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) mbi gjenerimin dhe konfigurimin e një çelësi SSH në llogarinë tënde.
## Dërgo ndryshimet e tua për rishikim Nëse shkon në repozitorin tënd në GitHub, do të shohësh një buton `Compare & pull request`. Kliko në atë buton. krijo një pull request Tani dërgo pull request. dërgo pull request Së shpejti unë do t'i bashkoj të gjitha ndryshimet tuaja në degën kryesore të këtij projekti. Do të marrësh një email njoftimi pasi ndryshimet të jenë bashkuar. ## Ku të shkosh nga këtu? Urime! Sapo përfundove rrjedhën standarde _fork -> clone -> edit -> pull request_ që do ta hasësh shpesh si kontribues! Festo kontributin tënd dhe shpërndaje me miqtë e tu dhe ndjekësit duke shkuar te [web app](https://firstcontributions.github.io/#social-share). Mund të bashkohesh në ekipin tonë slack në rast se ke nevojë për ndonjë ndihmë ose ke ndonjë pyetje. [Bashkohu në ekipin slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-29qhyr9lt-Bi7WLbgGIFqV7aCEG_grvg). Tani le të fillojmë me kontributin në projekte të tjera. Ne kemi përmbledhur një listë projektesh me probleme të lehta që mund të fillosh. Shiko [listën e projekteve në web app](https://firstcontributions.github.io/#project-list). ### [Materiale shtesë](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriale duke përdorur vegla të tjera | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.am.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) ## የመጀመሪያ አስተዋፅኦዎች ይህ ፕሮጀክት ጀማሪዎች የመጀመሪያ አስተዋጾ የሚያደርጉበትን መንገድ ለማቅለል እና ለመምራት ያለመ ነው። የመጀመሪያዎን አስተዋፅዖ ለማድረግ ከፈለጉ ከታች ያሉትን ደረጃዎች ይከተሉ። _በcommand line(ተርሚናል) ካልተመቸዎት፣ [የGUI መሳሪያዎችን ለመጠቀም አጋዥ ስልጠናዎች እዚህ ያገኛሉ።](#የሌሎች-መሳሪያዎች-አጠቃቀም-አጋዥ-ስልጠናዎች)_ ማከማቻውን 'ፎርክ' ያድርጉ ### በማሽንዎ ላይ ጊት(git) ከሌለዎት ፤ [ይጫኑት](https://docs.github.com/en/get-started/quickstart/set-up-git) ። ## ይህንን ማከማቻ **fork** ያድርጉ በዚህ ገጽ ላይኛው ክፍል ላይ ያለውን የfork button ጠቅ በማድረግ ይህንን ማከማቻ fork ያድርጉት። ይህ በእርስዎ account ውስጥ የዚህን repository ቅጂ ይፈጥራል። ## የማከማቻውን ተመሳሳይ ይፍጠሩ (Clone) የማከማቻውን ቅጂ ይፍጠሩ አሁን fork የተደረገውን ማከማቻ (repository) ቅጂ በማሽንዎ(በኮምፒውተርዎ) ይፍጥሩ። ወደ GitHub (account)መለያዎ ይሂዱ፤ fork የተደረገውን ማከማቻ ይክፈቱ፤ ኮድ የሚለውን button ጠቅ ያድርጉ እና ከዚያ *ወደ clipboard ቅዳ* የሚለውን ጠቅ ያድርጉ:: ተርሚናል ይክፈቱ እና የሚከተለውን የgit ትዕዛዝ run ያድርጉ: ```bash git clone "የቀዱትን url" ``` "አሁን የገለበጡት url" (ያለ ጥቅስ ምልክቶቹ) የማከማቻው (የዚህ ፕሮጀክት fork) url ነው። urlን ለማግኘት የቀደመውን ደረጃዎች ይመልከቱ። 'URL'ኡን ወደ ክሊፕቦርድ ኮፒ ያድርጉ ለምሳሌ:- ```bash git clone git@github.com:ይህ-እርስዎ-ኖት/first-contributions.git ``` 'ይህ-እርስዎ-ኖት' የእርሶ GitHub ተጠቃሚ username ነው። አሁን በ GitHub ላይ ያለውን የመጀመሪያ አስተዋፅዖ(first-contributions) ማከማቻ ይዘቶችን ወደ ኮምፒውተርዎ እየገለበጡ ነው። ## ቅርንጫፍ ይፍጠሩ በኮምፒተርዎ ላይ ወዳለው የማከማቻ ማህደር ይግቡ (እዚያው ከሌሉ ማለት ነው!)፡ ```bash cd first-contributions ``` አሁን የ‹git switch› ትዕዛዝን በመጠቀም ቅርንጫፍ ይፍጠሩ፡ ```bash git switch -c የእርስዎ-አዲሱ-ቅርንጫፍ-ስም ``` ለምሳሌ:- ```bash git switch -c ይሁን-አለማየሁ ``` ## አስፈላጊ ለውጦችን ያድርጉ እና ለውጦችን ይፈጥሙ (commit) አሁን የ‹[Contributors.md](http://contributors.md/)› ፋይልን በጽሑፍ አርታኢ ውስጥ ይክፈቱ እና ስምዎትን ይጨምሩበት። በፋይሉ መጀመሪያ ወይም መጨረሻ ላይ አይጨምሩት። በመካከል የትኛውም ቦታ ላይ ያስቀምጡት። አሁን, ፋይሉን save ያድርጉ። የ'ጊት' ሁኔታ ወደ የፕሮጀክት ማህደሩ ሄደው ይህን ትዕዛዝ (`git status`) ከፈጸሙ፣ ለውጦች እንዳሉ ያያሉ። የ‹git add› ትዕዛዙን በመጠቀም እነዚያን ለውጦች ወደ ፈጠሩት ቅርንጫፍ ያክሉ። ```bash git add Contributors.md ``` አሁን የ‹git commit› ትዕዛዙን በመጠቀም እነዚህን ለውጦች ያድርጉ፡: ```bash git commit -m "የአስተዋጽዖ አበርካቾች ዝርዝር ውስጥ የእርስዎን-ስም ያክሉ" ``` 'የእርስዎን-ስም' የሚለውን በስምዎ ይተኩ፡፡ ## ለውጦችን ወደ GitHub ይግፉ ‹git push› የሚለውን ትዕዛዝ በመጠቀም ለውጦችዎን ይግፉ፡፡ ```bash git push -u origin የእርስዎ-ቅርንጫፍ-ስም ``` ቀደም ብለዉ በፈጠሩት የቅርንጫፍ ስም 'የእርስዎን-ቅርንጫፍ-ስም'ን ይትኩ።
በመግፋት ላይ ማንኛውም ስህተት ካጋጠሞት ፤ እዚህ ጠቅ ያድርግ: - Authentication Error 
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//first-contributions.git/'
Go to [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account.
## ለውጦችዎን ለግምገማ ያስገቡ (Pull request) በ GitHub ላይ ወደ ማከማቻዎ ከሄዱ፣ ‘compare & pull request' የሚለውን ቁልፍ ያያሉ። በዚያ ቁልፍ ላይ ጠቅ ያድርጉ። የለውጦቹን ግምገማ(pull request) ይፍጠሩ አሁን pull request ያስገቡ። ለውጦችዎን ለግምገማ ያስገቡ በቅርቡ ሁሉንም ለውጦችዎን ወደዚህ ፕሮጀክት ዋና ቅርንጫፍ አዋህዳቸዋለሁ። ለውጦቹ ከተዋሃዱ በኋላ የማሳወቂያ 'ኢይሜል' ይደርስዎታል። ## ከዚህስ ወዴት ልሂድ? እንኳን ደስ ያሎዎት! ልክ እንደ አስተዋጽዖ አበርካች የሚያጋጥሙትን መደበኛ _fork -> clone -> edit -> pull request_ የስራ ፍሰትን አጠናቀዋል! አስተዋጾዎን ያጣጣጥሙ እና ወደ [ድህረ-ግፅ](https://firstcontributions.github.io/#social-share) በመሄድ ለጓደኞችዎ እና ተከታዮችዎ ያካፍሉ። ተጨማሪ ልምምድ ከፈለጉ በዚህ ሊንክ [code contributions](https://github.com/roshanjossey/code-contributions) ይግቡ. አሁን ለሌሎች ፕሮጀክቶች በማበርከት እንጀምር። እርስዎ ሊጀምሩባቸው የሚችሉ ቀላል ጉዳዮች ያላቸውን የፕሮጀክቶች ዝርዝር አዘጋጅተናል። [በዚህ ሊንክ በመግባት በድር መተግበሪያ ውስጥ ያሉትን የፕሮጀክቶች ዝርዝር ይመልከቱ።](https://firstcontributions.github.io/#project-list) ## [ተጨማሪ ቁሳቁስ](docs/additional-material/git_workflow_scenarios/additional-material.md) ## የሌሎች መሳሪያዎች አጠቃቀም አጋዥ ስልጠናዎች | የGitHub ዴስክቶፕ መተግበሪያ | ቪዥዋል ስቱዲዮ 2017 | GitKraken ፕሮግራም | VS ኮድ አርታዒ | Sourcetree መተግበሪያ | IntelliJ IDEA ፕሮግራም | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](https://github.com/firstcontributions/first-contributions/blob/main/docs/gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](https://github.com/firstcontributions/first-contributions/blob/main/docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](https://github.com/firstcontributions/first-contributions/blob/main/docs/gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](https://github.com/firstcontributions/first-contributions/blob/main/docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](https://github.com/firstcontributions/first-contributions/blob/main/docs/gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](https://github.com/firstcontributions/first-contributions/blob/main/docs/gui-tool-tutorials/github-windows-intellij-tutorial.md) |

================================================ FILE: docs/translations/README.ar.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) #
مساهمتك الأولى
الصعوبة متوقعة عندما تبدأ بأي عمل جديد، خصوصاً إذا كان العمل يتضمن أشخاصًا آخرين، مما يجعل الوقوع في الخطأ مزعجًا.
لكن المساهمة في مشاريع مفتوحة المصدر يتطلب ويتوقع الخطأ ولهذا السبب سيساعدك الآخرون في تصحيح هذا الخطأ.
في هذا المشروع هدفنا هو تسهيل الطريق لمساهمتك الأولى.
قراءة ومتابعة التعليمات المتاحة على الإنترنت ستساعدك بالتأكيد. ومع ذلك، ستستفيد بشكل أكبر إذا استطعت المشاركة في مشروع معين دون الخوف من الوقوع في الأخطاء. يهدف هذا المشروع إلى تقديم توجيهات وإرشادات أولية لمساعدتك في البدء بأول مساهمة لك. تذكر أن الخطأ أمر متوقع، والهدف الأسمى هو التعلم من هذه البيئة. نشجعك على أن تركز أثناء متابعة الخطوات التالية لإكمال مساهمتك الأولى. نعدك بأنك ستستمتع بالتجربة وسوف تستفيد منها
إذا لم يكن لديك git على الجهاز الخاص بك،قم بتثبيته من هنا
##
أنشئ تفرّعًا من هذا المشروع - Fork this Repository
قم بعمل Fork لهذا المستودع
أنشئ تفرّعًا من هذا المشروع بالضغط على زر Fork في أعلى هذه الصفحة. من خلال ذلك ستنشأ نسخة من هذا المشروع على حسابك الخاص.
##
استنسخ هذا المشروع - Clone the repository
انسخ هذا المستودع
استنسخ هذا المشروع على جهازك. انقر على زر Clone ثم انقر على أيقونة Copy to clipboard
انسخ الرابط إلى الحافظة
افتح terminal واكتُب الأمر التالي:
```bash git clone "url you just copied" ```
قم باستبدال "url you just copied" بالرابط الذي نسخته من الخطوة السابقة، هذا الرابط يحتوي على المشروع.
على سبيل المثال:
```bash git clone https://github.com/this-is-you/first-contributions.git ```
في هذا المثال لاحظ 'this-is-you' سيكون اسم حسابك في موقع github يليه رابط المشروع الذي فرقته في أول خطوة، هذا الأمر سينسخ محتويات المشروع على جهازك لتتمكن من التعديل عليه بحرية.

##
إنشاء فرع - Create a branch
انتقل إلى المجلد الذي يحتوي على المشروع عن طريق الأمر التالي:
```bash cd first-contributions ```
الآن قم بإنشاء فرع عن طريق الأمر التالي:
```bash git checkout -b "add-your-name" ```
اسمك بدل add-your-name
على سبيل المثال:
```bash git checkout -b "add-alonzo-church" ```
##
قم بإجراء التعديلات المطلوبة وأتممها
الآن قم بفتح الملف "Contributors.md" في محرر النصوص المفضل لديك وأضف اسمك ثم احفظ الملف. بعد ذلك اذهب إلى terminal واكتب الأمر git status. هذا الأمر سيظهر لك التغييرات التي حدثت في المشروع. لإضافة هذه التغييرات قم بإضافتها عن طريق هذا الأمر git add.
```bash git add Contributors.md ```
الآن قم بإتمام التغييرات باستخدام الأمر git commit.
```bash git commit -m "Add to Contributors list" ```
استبدل <your-name> باسمك.

##
ارفع التغييرات إلى Push changes to Github - Github
ارفع التغييرات عن طريق الأمر git push
```bash git push origin "add-your-name" ```
استبدل <add-your-name> باسم الفرع الذي أنشأته من قبل.

سلم تغيراتك للمراجعة

في صفحة المشروع الخاصة بك يوجد زر Compare & pull request. اضغط على هذا الزر.
أنشئ طلب سحب (Pull Request)
والآن سلم طلبك لتتم مراجعته
إرسال طلب السحب
بعد المراجعة سوف أقوم بدمج تغييراتك إلى الفرع الرئيسي في المشروع. سيتم تنبيهك عن طريق البريد الإلكتروني بذلك.
الفرع الرئيسي الخاص بك لن يحتوي على هذه التغييرات. عليك مزامنته مع الفرع الرئيسي عن طريق الخطوات التالية.
##
مزامنة نسختك مع المشروع الرئيسي
الخطوة الأولى، انتقل إلى الفرع الرئيسي.
```bash git checkout master ```
ثانياً، أضف رابط مشروعي كـupstream remote url.
```bash git remote add upstream https://github.com/Roshanjossey/first-contributions ```
بهذه الطريقة نخبر git أن هناك نسخة أخرى من هذا المشروع في هذا الرابط ونسميها upstream. بعد أن أوافق على تغييراتك، قم بسحب النسخة الجديدة من المشروع عن طريق الأمر التالي:
```bash git fetch upstream ```
هنا سنقوم بسحب جميع التغييرات من (upstream remote). والآن، عليك أن تدمج التحديثات الجديدة من فرعي إلى فرعك الرئيسي.
```bash git rebase upstream/master ```
وهنا تطبق التغييرات إلى الفرع الرئيسي. إذا رفعت التغييرات لفرعك الرئيسي سيتم تحديث مشروعك
```bash git push origin master ```
لاحظ أنك ترفع إلى remote اسمه origin.

##
توجيهات بإستخدام أدوات أخرى
| GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.arm.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Առաջին ներդրումները Այս նախագիծը նպատակ ունի պարզեցնել և ուղղորդել, թե ինչպես են սկսնակները կատարում իրենց առաջին ներդրումը: Եթե ​​ցանկանում եք կատարել ձեր առաջին ներդրումը, հետևեք ստորև նշված քայլերին. _Եթե ​​ձեզ դուր չի գալիս հրամանի տողը, [այստեղ կան ձեռնարկներ՝ օգտագործելով GUI գործիքները](#tutorials-using-other-tools)_ վալեցրու այս պահեստը #### Եթե ​​դուք չունեք git ձեր մեքենայի վրա, [տեղադրեք այն](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Պատառաքաղեք այս պահոցը Պատառաքաղեք այս պահոցը՝ սեղմելով այս էջի վերևի պատառաքաղի կոճակը: Այս կստեղծի այս պահոցի պատճենը ձեր հաշվում. ## Կլոնավորեք պահեստը պատճենիր այս պահեստը Այժմ կլոնավորեք պատառաքաղված պահոցը ձեր մեքենայի մեջ: Գնացեք ձեր GitHub հաշիվ, բացեք պատառաքաղված պահոցը, սեղմեք կոճակի կոճակը և սեղմեք _copy to clipboard_ պատկերակը. Բացեք տերմինալ և գործարկեք հետևյալ git հրամանը: ```bash git clone "url-ը որ դուք հենց նոր պատճենեցիք" ``` որտեղ «url-ը, որը հենց նոր պատճենեցիր» (առանց չակերտների) այս պահոցի url-ն է (այս նախագծի ձեր պատառաքաղը): Դիտեք նախորդ քայլերը՝ URL-ը ստանալու համար պատճենիր URL-ը կրծքաթելին Օրինակ: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` որտեղ `this-is-you` ձեր GitHub օգտանունն է: Այստեղ դուք պատճենում եք GitHub-ի առաջին ներդրումների պահոցի բովանդակությունը ձեր համակարգչում. ## Ստեղծեք մասնաճյուղ Փոխեք ձեր համակարգչի պահեստի գրացուցակը (եթե արդեն այնտեղ չեք): ```bash cd first-contributions ``` Այժմ ստեղծեք մասնաճյուղ՝ օգտագործելով «git switch» հրամանը: ```bash git switch -c քո-նոր-մասնաճյուղի-անունը ``` Օրինակ: ```bash git switch -c add-sarkis-cult ``` ## Կատարեք անհրաժեշտ փոփոխությունները և commit կատարեք այդ փոփոխությունները Այժմ բացեք `Contributors.md` ֆայլը տեքստային խմբագրիչում, ավելացրեք ձեր անունը դրան: Մի ավելացրեք այն ֆայլի սկզբում կամ վերջում: Տեղադրեք այն ցանկացած տեղ արանքում: Այժմ պահեք ֆայլը. git-ի վիճակը Եթե ​​գնաք նախագծի գրացուցակ և կատարեք `git status` հրամանը, կտեսնեք, որ փոփոխություններ կան. Ավելացրե՛ք այդ փոփոխությունները այն ճյուղին, որը հենց նոր ստեղծեցիք՝ օգտագործելով `git add` հրամանը: ```bash git add Contributors.md ``` Այժմ կատարեք այդ փոփոխությունները՝ օգտագործելով `git commit` հրամանը: ```bash git commit -m "Add your-name to Contributors list" ``` `your-name` փոխարինելով ձեր անունով. ## Փոփոխությունները մղեք GitHub-ին Կատարեք ձեր փոփոխությունները՝ օգտագործելով `git push` հրամանը: ```bash git push -u origin your-branch-name ``` `your-branch-name`-ը փոխարինելով ավելի վաղ ստեղծված մասնաճյուղի անունով.
Եթե ​​հրելիս սխալներ եք ստանում, սեղմեք այստեղ. - ### Վավերացման սխալ 
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//first-contributions.git/'
Գնացեք [GitHub-ի ձեռնարկ](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ձեր հաշվի համար SSH բանալի ստեղծելու և կազմաձևելու վերաբերյալ.
## Ներկայացրեք ձեր փոփոխությունները վերանայման Եթե ​​գնաք ձեր պահոց GitHub-ում, կտեսնեք `Compare & pull request` կոճակը: Սեղմեք այդ կոճակի վրա. ստեղծիր pull request Այժմ ներկայացրեք pull request-ը. ուղարկիր pull request Շուտով ես կմիավորեմ ձեր բոլոր փոփոխությունները այս նախագծի հիմնական ճյուղի մեջ: Փոփոխությունները միաձուլվելուց հետո դուք կստանաք ծանուցման նամակ. ## Որտեղ գնալ այստեղից? Շնորհավորում եմ Դուք հենց նոր ավարտեցիք ստանդարտ _fork -> clone -> edit -> pull request_ աշխատանքային հոսքը, որը հաճախ կհանդիպեք որպես ներդրող! Նշեք ձեր ներդրումը և կիսվեք այն ձեր ընկերների և հետևորդների հետ՝ գնալով [վեբ հավելված](https://firstcontributions.github.io/#social-share). Եթե ցանկանում եք ավելի շատ փորձ ձեռք բերել, տեսեք [ծածկագրի ներդրումները](https://github.com/roshanjossey/code-contributions)։ Հիմա եկեք սկսենք ձեր ներդրումն ունենալ այլ նախագծերում: Մենք կազմել ենք հեշտ խնդիրներ ունեցող նախագծերի ցանկ, որոնցից կարող եք սկսել: Ստուգեք [վեբ հավելվածի նախագծերի ցանկը](https://firstcontributions.github.io/#project-list). ### [Լրացուցիչ նյութ](additional-material/git_workflow_scenarios/additional-material.md) ## Ձեռնարկներ՝ օգտագործելով այլ գործիքներ | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) |

Այս նախագծին աջակցում են:

================================================ FILE: docs/translations/README.assamese.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions এই প্ৰকল্পই আৰম্ভণকাৰীসকলৰ বাবে প্ৰথম অৱদানটো সহজ আৰু পোষকভাৱে কৰিবলৈ সহায় কৰে। যদি আপুনি আপোনাৰ প্রথম অৱদানটো কৰিবলৈ বিচাৰে, তলত দিয়া পদক্ষেপসমূহ অনুসৰণ কৰক। যদি আপুনি command lineৰ সৈতে আৰামদায়ক নোহোৱাঁ, GUI tools ব্যৱহাৰ কৰি ইয়াত টিউট’ৰিয়েল আছে। এই ৰেপ'জিটৰীটো ফৰ্ক কৰক যদি আপোনাৰ মেচিনত git নাই, ইনষ্টল কৰক [install it](https://docs.github.com/en/get-started/quickstart/set-up-git). ## এই ৰেপ'জিট'ৰিটো Fork কৰক এই পৃষ্ঠাৰ ওপৰত থকা fork বুটামত ক্লিক কৰি এই ৰেপ'জিট'ৰিটো Fork কৰক। এইটো আপোনাৰ একাউণ্টত এই ৰেপ'জিট'ৰিটোৰ এটা কপি সৃষ্টি কৰিব। ## ৰেপ'জিট'ৰিটো ক্লোন কৰক এই ৰেপ'জিটৰীটো ক্ল'ন কৰক এতিয়া fork কৰা ৰেপ'জিট'ৰিটো আপোনাৰ মেচিনত ক্লোন কৰক। আপোনাৰ GitHub একাউণ্টত যাওক, fork কৰা ৰেপ'জিট'ৰিটো খোলক, code বুটামত ক্লিক কৰক আৰু তাৰপিছত copy to clipboard আইকনটোত ক্লিক কৰক। টাৰ্মিনেল খোলক আৰু নিম্নলিখিত git কমাণ্ডটো চলাওক: ```bash git clone "url you just copied" ``` য'ত "url you just copied" (নাম উদ্ধৃতিহীন) হৈছে এই ৰেপ'জিট'ৰিটোৰ url (এই প্ৰকল্পৰ আপোনাৰ fork)। url পোৱা আগৰ পদক্ষেপসমূহ চাওক। ইউ.আৰ.এল.টো ক্লিপব'ৰ্ডলৈ কপি কৰক উদাহৰণ স্বৰূপে ```bash git clone git@github.com:this-is-you/first-contributions.git ``` য'ত this-is-you হৈছে আপোনাৰ GitHub ইউজাৰনেম। ইয়াত আপুনি first-contributions ৰেপ'জিট'ৰিটোৰ বিষয়বস্তু GitHub ৰ পৰা আপোনাৰ কম্পিউটাৰত কপি কৰি থৈছা। ## Branch সৃষ্টি কৰক আপোনাৰ কম্পিউটাৰৰ ৰেপ'জিট'ৰিৰ ডাইৰেক্টৰীত পৰিৱৰ্তন কৰক (যদি আপুনি ইতিমধ্যেই তাত নোহোৱাঁ): ```bash cd first-contributions ``` এতিয়া git switch কমাণ্ড ব্যৱহাৰ কৰি এখন শাখা সৃষ্টি কৰক: ```bash git switch -c <আপোনাৰ-নতুন-শাখা-নাম-যোগ-বনাওক> ``` উদাহৰণ স্বৰূপে ```bash git switch -c add-alonzo-church ```
যদি আপুনি git switch ব্যৱহাৰ কৰি কোনো ত্ৰুটি পায়, ইয়াত ক্লিক কৰক: যদি আপুনি "Git: ‘switch’ is not a git command. See ‘git –help’" ত্ৰুটি পায়, তেতিয়া আপুনি পুরণি সংস্কৰণৰ git ব্যৱহাৰ কৰি থকা সম্ভাৱনা আছে। এই ক্ষেত্ৰত, git switchৰ পৰিবৰ্তে git checkout ব্যৱহাৰ কৰাৰ চেষ্টা কৰক: ```bash git checkout -b your-new-branch-name ```
## প্ৰয়োজনীয় পৰিবৰ্তন কৰক আৰু সেই পৰিবৰ্তনসমূহ Commit কৰক এতিয়া Contributors.md ফাইলটো এটা টেক্সট সম্পাদকত খোলক। আপোনাৰ নামটো ইয়াত যোগ কৰক। নামটো ফাইলৰ আৰম্ভণিতে বা শেষত যোগ নকৰিব। নামটো মাজৰ যিকোনো স্থানত ৰাখক। এতিয়া, ফাইলটো সংৰক্ষণ(save) কৰক। কমাণ্ড দেখুৱোৱা উদাহৰণ যদি আপুনি প্ৰকল্প ডাইৰেক্টৰীত যোৱা আৰু কমাণ্ড `git status` চলোৱা, আপুনি পৰিবৰ্তনসমূহ দেখিব। এই পৰিবৰ্তনসমূহকে আপুনি সৃষ্টি কৰা নতুন শাখাত যোগ কৰিবলৈ `git add` কমাণ্ডটো ব্যৱহাৰ কৰক: ```bash git add Contributors.md ``` এতিয়া সেই পৰিবৰ্তনসমূহ `git commit` কমাণ্ড ব্যৱহাৰ কৰি commit কৰক: ```bash git commit -m "Add <আপোনাৰ-নাম> to Contributors list" ``` আপোনাৰ-নাম স্থলৱি দি আপোনাৰ নাম যোগ কৰক: ## পৰিবৰ্তনসমূহ GitHub ত Push কৰক আপোনাৰ পৰিবৰ্তনসমূহ নিম্নলিখিত কমাণ্ড ব্যৱহাৰ কৰি GitHub ত Push কৰক: ```bash git push -u origin your-branch-name ``` নিম্নলিখিত কমাণ্ডটো ব্যৱহাৰ কৰক, `your-branch-name` স্থলৱি দি আপোনাৰ শাখাৰ নাম যোগ কৰক:
যদি আপুনি Push কৰাৰ সময়ত কোনো ত্ৰুটি পায়, ইয়াত ক্লিক কৰক: - ### প্ৰমাণীকৰণ ত্ৰুটি 
remote: পাসৱৰ্ড প্ৰমাণীকৰণৰ সহায়তা অপসাৰণ কৰা হৈছিল 13 আগষ্ট, 2021 তাৰিখে
  remote: অনুগ্ৰহ কৰি চাওক:: https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ অধিক তথ্যৰ বাবে
অনুগ্ৰহ কৰি এইটো চাওক: 'https://github.com//first-contributions.git/'
যাওক [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) SSH কী সৃষ্ট আৰু কনফিগাৰ কৰাৰ জন্য যোৱা আপুনি 'git remote -v' কমাণ্ডটো চলাব পাৰে আপোনাৰ দূৰৱর্তী ঠিকনাটো পৰীক্ষা কৰিবলৈ। যদি ইয়াৰ আউটপুটটি এইদৰে দেখায়: 
origin	https://github.com/your-username/your_repo.git (fetch)
  origin	https://github.com/your-username/your_repo.git (push)
কমাণ্ড ব্যৱহাৰ কৰি ইয়াক পৰিবৰ্তন কৰক: ```bash git remote set-url origin git@github.com:your-username/your_repo.git ``` নহলে আপুনি কেতিয়াও লগইনৰ বাবে নিৰ্দিষ্ট নাম আৰু পাছৱৰ্ড দিয়া হব আৰু লগইন ত্ৰুটি হব।
## আপোনাৰ পৰিবৰ্তনসমূহ পৰ্যালোচনাৰ বাবে জমা দিয়ক যদি আপুনি GitHub ত আপোনাৰ ৰেপ'জিট'ৰিটোত যায়, আপুনি `Compare & pull request` বুটামটো দেখিব। এই বুটামটোত ক্লিক কৰক। এখন পুল ৰিকুৱেষ্ট সৃষ্টি কৰক Pull Request জমা দিয়ক পুল ৰিকুৱেষ্ট জমা কৰক আপোনাৰ পৰিবৰ্তনসমূহ তাড়তে প্ৰকল্পৰ মুখ্য শাখাত মিলাই দিম। পৰিবৰ্তনসমূহ মিলোৱা হ'লে আপুনি এটা অৱগতিমূলক ইমেইল লাভ কৰিব। ## য়াৰ পৰা ক’লৈ যাব? অভিনন্দন! আপুনি কেৱল সম্পূৰ্ণ কৰিলে fork -> clone -> edit -> pull request কাৰ্যধাৰাটোৰ মানসংগত ৰূপ যি প্ৰায়ে এক অবদানকাৰী হিচাপে সন্মুখীন হ'ব! আপোনাৰ অৱদান উদযাপন কৰক আৰু আপোনাৰ বন্ধু আৰু অনুসাৰকসকলৰ সৈতে ইয়াক শেয়াৰ কৰক [web app](https://firstcontributions.github.io/#social-share). যদি আপুনি অধিক অনুশীলন কৰিব বিচাৰে, [code contributions](https://github.com/roshanjossey/code-contributions) পৰীক্ষা কৰক। এতিয়া আপোনাক আন প্ৰকল্পত অৱদান কৰিবলৈ আৰম্ভ কৰা যাক। আমি সহজ সমস্যাসমূহ সহ কিছু প্ৰকল্পৰ তালিকা সংকলন কৰিছো যাৰ সহায়ত আপুনি আৰম্ভ কৰিব পাৰে। [ৱেব এপত প্ৰকল্পসমূহৰ তালিকা পৰীক্ষা কৰক](https://firstcontributions.github.io/#project-list). ### [অতিৰিক্ত সামগ্ৰী](additional-material/git_workflow_scenarios/additional-material.md) ## অন্য সঁজুলিসমূহ ব্যৱহাৰ কৰি টিউট'ৰিয়েলসকল | GitHub Desktop এপ্লিকেচন | Visual Studio ২০১৭ | GitKraken এপ্লিকেচন | VS Code সম্পা | Sourcetree এপ্লিকেচন | IntelliJ IDEA এপ্লিকেচন | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) |

এই প্ৰকল্পৰ সহায়ত:

================================================ FILE: docs/translations/README.aze.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # İlk töhfələr Bu layihə yeni başlayanların ilk töhfələrini vermə yollarını sadələşdirmək və istiqamətləndirmək məqsədini daşıyır. İlk töhfənizi vermək istəyirsinizsə, aşağıdakı addımları izləyin. _Əgər komanda sətri ilə rahat deyilsinizsə, [burada GUI alətlərindən istifadə edən təlimatlar tapa bilərsiniz.](#Digər-alətlərin-istifadəsi-üçün-təlimlər)_ bu anbarı çatal et #### Maşınınızda (yəni, kompüterinizdə) GIT yoxdursa, [buradan quraşdıra bilərsiniz](https://help.github.com/articles/set-up-git/). ## Layihəni "çəngəlləmək" Səhifənin yuxarı hissəsindəki "Fork" düyməsini vuraraq bu layihəni çəngəlləyin. Bu hesabınızda deponun bir kopyasını yaradacaqdır. ## Deponu (Repository) klonlaşdırma bu anbarı surətini çıxar İndi çəngəlli deponu kompüterinizə klonlaşdırın. GitHub hesabınıza daxil olun, çəngəlli deponu açın, kod düyməsinə vurun və sonra _copy to clipboard_ simgəsinə klikləyin. Daha sonra terminalı açın və aşağıdakı git komandasını daxil edin: ```bash git clone "kopyaladığınız-url" ``` "kopyaladığınız-url" (dırnaq işarəsi olmadan) yerinə bu deponun GitHub səhifəsindən aldığınız linki kopyalayın. URL-i panoya kopyala Misal üçün: ```bash git clone https://github.com/istifadəçi-adı/first-contributions.git ``` `istifadəçi-adı` sizin GitHub istifadəçi adınızdır. Burada siz GitHub-da ilk töhfələr deposunun məzmununu kompüterinizə köçürürsünüz. ## Budaq (Branch) yaratmaq Kompüterinizdəki depo qovluğuna keçin (əgər orada deyilsinizsə): ```bash cd first-contributions ``` `git checkout` əmrini istifadə edərək bir Budaq (Branch) yaradın: ```bash git checkout -b ``` Misal üçün: ```bash git checkout -b add-alonzo-church ``` ## Lazımi dəyişiklikləri edin və bu dəyişiklikləri həyata keçirin İndi `Contributors.md` faylını mətn redaktorunda açın, adınızı əlavə edin. Faylın əvvəlinə və ya sonuna əlavə etməyin. Arada bir yerə qoyun. İndi faylı yadda saxlayın. git vəziyyəti Layihə qovluğuna gedib `git status` əmrini icra etsəniz, dəyişikliklərin olduğunu görəcəksiniz. Bu dəyişiklikləri `git add` əmrindən istifadə edərək yaratdığınız Budağa əlavə edin: ```bash git add Contributors.md ``` İndi `git commit` əmrindən istifadə edərək bu dəyişiklikləri edin: adınızla `` ilə əvəz olunsun. ## Dəyişiklikləri GitHub-a itələyin (push) Dəyişikliklərinizi "git push" əmrindən istifadə edərək itələyin: ```bash git push origin ``` `` yerinə öz istifadəçi adınızı daxil edin. ## Dəyişikliklərinizi nəzərdən keçirmək üçün göndərin GitHub-dakı deponuza daxil olsanız, bir `Compare & pull request` düyməsini görəcəksiniz. Bu düyməni vurun. çəkiliş sorğusu yarat İndi çəkmə tələbini (pull request) göndərin. çəkiliş sorğusunu göndər Tezliklə bütün dəyişikliklərinizi bu layihənin master filialına birləşdirəcəyəm. Dəyişikliklər birləşdirildikdən sonra bildiriş e-poçtu alacaqsınız. ## Bundan sonra nə edə bilərəm? Təbriklər! Töhfə olaraq tez-tez qarşılaşacağınız standart _fork -> clone -> edit -> pull request_ tamamlamısınız! Töhfənizi qeyd edin və [veb tətbiqə](https://firstcontributions.github.io/#social-share) girərək dostlarınız və izləyicilərinizlə bölüşün. Daha çox təcrübə istəyirsinizsə, yoxlayın [kod töhfələri](https://github.com/roshanjossey/code-contributions). İndi başqa layihələrə töhfə verməyə başlayaq. Başlaya biləcəyiniz asan məsələləri olan layihələrin siyahısını hazırladıq, [siyahıya baxın](https://firstcontributions.github.io/#project-list). ### [Əlavə Məlumat](additional-material/git_workflow_scenarios/additional-material.md) ## Digər alətlərin istifadəsi üçün təlimlər | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.bg.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Първи стъпки Трудно е. Когато правиш нещо за пръв път винаги е трудно. Още повече, когато се работи съвместно с други хора. Затова решихме да опростим процеса на учене за новобранците в допринасянето към отворен софтуер. Четенето на статии и гледането на видео уроци помага, но има ли по-добър учител от практиката в защитена среда? Целта на този проект е да напътства и опрости първите стъпки на новобранците в участието и приноса към отворен софтуер. Ако искате да направите първата си контрибуция и да станете част от обществото на отворен софтуер, следвайте стъпките по-долу. #### *Ако не се чувствате комфортно използвайки command line (терминал), [ето и уроци за използването на програми с графичен интерфейс](#Уроци-за-иползването-на-други-приложения)* форкни това хранилище Ако нямате git на вашия компютър, [инсталирайте го]( https://help.github.com/articles/set-up-git/). ## Направете Разклонение (Fork) на това хранилище (repository) Направете разклонение на хранилището като натиснете бутона "Fork" в горната част на тази страница. Това ще направи копие на това хранилище във вашия GitHub профил. ## Клонирайте това хранилище клонирай това хранилище Сега клонирайте локално на вашия компютър разклоненото хранилище. Отидете във вашия GitHub профил, отворете разклоненото хранилище, кликнете на бутона 'Clone' и копирайте линка или натиснете иконката 'copy to clipboard' (копирай в клипборда). Отворете терминал и въведете следната команда ```bash git clone "линка който току-що копирахте" ``` като на мястото на "URL-а който току-що копирахте" (без кавичките) поставете линка към това хранилище (Вашето Разклонение на този проект). Вижте предните стъпки за това как да се сдобиете с линка. копирай URL в клипборда Например: ```bash git clone https://github.com/това-си-ти/first-contributions.git ``` Като на мястото на `това си ти` се намира вашето потребителско име. В тази стъпка вие направихте копие на съдържанието на GitHub хванилището на 'first contributions' във вашия компютър. ## Създайте клон (branch) Стигнете до местоположението във вашия компютър, където копирахте хранилището (ако вече не се намирате там): ```bash cd first-contributions ``` Сега създайте клон използвайки командата `git switch -c`: ```bash git switch -c <име на новия клон> ``` Например: ```bash git switch -c add-alonzo-church ``` (Името на клона не е задължително да съдържа думата *add*, но е препоръчително, защото целта на този клон е да добавите името си към списък.) ## Направете нужните промени и ги commit-нете Сега отворете файла `Contributors.md` в текстов редактор и добавете името си в него. Не го добавяйте в началото или края на файла. Поставете го някъде посредата. Сега запазете промените. git статус Ако навигирате през терминала до директорията на проекта и въведете командата `git status`, ще видите че има променени файлове. ДОбавете тези промени към клона, който създадохте, използвайки командата `git add`: ```bash git add Contributors.md ``` Сега commit-нете тези промени с командата `git commit`: ```bash git commit -m "Add to Contributors list" ``` като смените `` с вашето име. ## Качете (Push) промените в GitHub Качете вашите промени като въведете командата `git push`: ```bash git push origin <добави името на твоя клон> ``` сменяйки `<клон името>` с името на клона, който създадохте по-рано. ## Предайте (submit) вашите промени за рецензия Ако отидете във вашето хранилище в GitHub, ще видите бутона `Compare & pull request`. Натиснете го. Създай pull request Сега предайте вашите промени за рецензия. изпрати pull request Скоро аз ще слея (merge) всички ваши промени в главния клон (мастер branch) на този проект. Вие ще бъдете уведомени по електронната поща когато това се случи. ## От тук накъде? Поздравления! Вие току що изпълнихте стандарните _fork -> clone -> edit -> PR_ операции, които ще срещнете като сътрудник! Отпразнувайте вашия принос и го споделете с приятели и последователи като посетите [уеб приложението](https://firstcontributions.github.io/#social-share). Ако бихте искали повече практика, разгледайте [код приноси](https://github.com/roshanjossey/code-contributions). Време да започнете да допринасяте и към други приекти. Ние сме съставили списък с проекти съдържащи лесни проблеми, които са лесни за начало. Проверете [списъка от приекти в уеб приложението](https://firstcontributions.github.io/#project-list). ### [Допълнителни материали](../additional-material/git_workflow_scenarios/additional-material.md) ## Уроци за иползването на други приложения | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.bih.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Prvi doprinosi Ovaj projekat ima za cilj da pruži konkretne korake i olakša način na koji početnici prilažu svoje prve doprinose (eng. contributions). Ukoliko ste se prepoznali u tekstu iznad i zelite da probate i doprinesete ovome ili nekom drugom projektu, pratite slijedece korake. #### _Ukoliko niste bas sigurni u vas rad sa komandnom linijom/terminalom (terminal -> za macOs), [mozete koristit ovaj link kroz GUI alate.](#Uputstva-za-druge-alate)_ Napravite fork repozitorijuma Ukoliko nemate git instaliran na vašoj mašini, [instalirajte ga ovde](https://help.github.com/articles/set-up-git/). ## Uradite fork repozitorijuma Uradite račvanje (fork) tako što ćete kliknuti na dugme _fork_ na vrhu stranice. Ovako pravite kopiju repozitorijuma na vašoj github stranici. ## Klonirajte repozitorijum kloniraj ovaj repozitorij Slijedeće, klonirajte repozitorijum koji ste prethodno račvali (fork). Posjetite svoj GitHub profil, otvorite repozitorijum koji ste račvali, kliknite na _clone_ (kloniraj/kopiraj) dugme i kliknite na ikonicu _copy to clipboard_. Otvorite terminal i upišite slijedece git komande: ``` git clone "url koji ste prethodno kopirali sa vaseg github profila" (bez navodnika i razmaka) ``` kopiraj URL u međuspremnik Na primjer: ``` git clone https://github.com/ovo-ste-vi/first-contributions.git ``` Gdje je umjesto `ovo-ste-vi` upisano vaše _github_ korisničko ime. Ovim kopirate sadržaj repozitorijuma _first-contributions_ na vašu mašinu. ## Pravljenje grane _branch_ Prebacite se u radni direktorij na vašoj mašini: ``` cd first-contributions (ili pratite gdje se tacno nalazi na vasoj masini) ``` Pa zatim napravite novo grananje _branch_ koristeći `git checkout` comandu: ``` git checkout -b ``` Na primer: ``` git checkout -b add-alonzo-church ``` (Naziv grane ne mora da sadrži _add_ na početku ili vase _ime_, ali je zgodno uključiti ga jer je svrha ove grane da doda vaše ime na listu. ## Napravite potrebne izmjene i potvrdite promjene Otvorite `Contributors.md` fajl u tekst editoru i dodajte vaše ime. Nemojte dodavati ime na sam početak ili kraj. Stavite ga negdje u sredinu. Potom sačuvajte fajl. status gita Ukoliko odete u radni direktorijum i izvršite komandu `git status`, primjetit ce te da postoje promjene. Dodajte ove promjene u granu koju ste gore napravili koristeći `git add` komandu: ``` git add Contributors.md ``` Sada potvrdite ove promjene koristeći `git commit` komandu: ``` git commit -m "Add to Contributors list" ``` Gdje umjesto `` upisujete svoje ime. ## Push changes to GitHub Pošaljite izmjene u repozitorijum na GitHub nalogu `git push`: ``` git push origin ``` gdje umjesto `` stavljate ime vašeg grananja koje ste prethodno napravili. ## Pošaljite izmjene na reviziju Ukoliko odete na repozitorijum na vašem GitHub profilu primetićete `Compare & pull request` Dugme. Kliknite na njega. kreirajte zahtjev za povlačenje a potom pošaljite zahtjev klikom na dugme _Create pull request_. pošalji zahtjev za povlačenje Nakon toga, admin će spojiti promjene koje ste napravili sa master granom projekta. Dobićete mejl potvrde kada se grane spoje. ## Šta dalje? Čestitamo! Završili ste standardni _fork -> clone -> edit -> PR_ tok koji će vas pratiti kroz vaš čitav programerski život! Proslavite tako što ćete podjeliti vaš doprinos sa prijateljima i pratiocima otvaranjem [stranice](https://firstcontributions.github.io/#social-share). A sada, možemo početi sa doprinosima drugim projektima. Napravili smo spisak projekata sa jednostavnim problemima na kojima možete početi da radite. Posetite stranicu sa [the list of projects na našem sajtu](https://firstcontributions.github.io/#project-list). ### [Dodatni materijali](../additional-material/git_workflow_scenarios/additional-material.md) ## Uputstva za druge alate | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.bn.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # প্রথম অবদানসমূহ এই প্রকল্পের উদ্দেশ্য হলো নতুন ডেভেলপারদের তাদের প্রথম অবদানটি সহজ করা এবং নির্দেশনা দেওয়া। যদি আপনি আপনার প্রথম অবদান করতে চান, তবে নীচের ধাপগুলি অনুসরণ করুন। প্রবন্ধ পড়ে এবং টিউটোরিয়াল দেখে অনেক কিছুই শেখা যায়, কিন্তু ব্যবহারিক পদ্ধতিতে কাজ করার চেয়ে উপযোগী কিছু হতে পারে না। এই প্রজেক্টের লক্ষ্য হচ্ছে নবীনদের দিকনির্দেশনা দেওয়া আর সেই সাথে তাদের প্রথম অবদান রাখার কাজটি সহজ করে তোলা। আপনি যদি ওপেন সোর্সে আপনার প্রথম অবদান রাখতে চান, তাহলে নিচের সহজ ধাপগুলো অনুসরণ করুন। কথা দিচ্ছি, এই প্রক্রিয়াটি অত্যন্ত মজার ও আনন্দদায়ক। #### _যদি কমান্ড লাইনে সমস্যা হয়, [তবে নীচে একটি GUI টুল ব্যবহার করে টিউটোরিয়াল দেওয়া হয়েছে।](#অন্যান্য-টুল-ব্যবহারের-টিউটোরিয়াল)_ এই রিপোজিটরি ফর্ক করুন আপনার কম্পিউটারে গিট না থাকলে, [ ইনস্টল করুন ](https://help.github.com/articles/set-up-git/)। ## এই রিপোজিটরি ফর্ক করুন এই রিপোজিটরি ফর্ক করতে 'ক্লিক এর মাধ্যমে' এই পৃষ্ঠার উপরে ফর্ক বাটনে ক্লিক করুন। এটি আপনার অ্যাকাউন্টে এই রিপোজিটরির একটি কপি তৈরি করবে। ## রিপোজিটরি ক্লোন করুন এই রিপোজিটরি ক্লোন করুন এখন এই রিপোজিটরিটি আপনার কম্পিউটারে ক্লোন করুন। এজন্যে প্রথমে ক্লোন(Clone) বাটনে ক্লিক করুন। এরপর ক্লিক করুন _ক্লিপবোর্ডে কপি করুন(copy to clipboard)_ আইকনটিতে। আপনার টার্মিনাল (উইন্ডোজের ক্ষেত্রে কমান্ড প্রম্পট (CMD)) চালু করুন এবং নিচের কমান্ড রান করুন : ```bash git clone "url you just copied" ``` যেখানে "url you just copied" (উদ্ধৃতি চিহ্ন ব্যতীত) হচ্ছে এই রিপোজিটরির ইউআরএল যা আপনি পূর্বের ধাপেই পেয়েছেন। ইউআরএল ক্লিপবোর্ডে কপি করুন যেমন: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` এখানে `this-is-you` হচ্ছে আপনার গিটহাব ইউজারনেম। এই কমান্ডটির মাধ্যমে আপনার কম্পিউটারে গিটহাবে অবস্থিত first-contributions রিপোজিটরির একটি কপি তৈরি হবে। ## একটি ব্রাঞ্চ তৈরি করুন আপনার কম্পিউটারে রিপোজিটরির ডিরেক্টরিতে যান (যদি এখনো অন্য ডিরেক্টরিতে থাকেন) : ```bash cd first-contributions ``` এখন `git switch` কমান্ডের মাধ্যমে একটি ব্রাঞ্চ তৈরি করুন : ```bash git switch -c ``` যেমন : ```bash git switch -c add-alonzo-church ``` (ব্রাঞ্চের নামে _add_ শব্দটি যুক্ত থাকা জরুরী নয়। তবে এই ব্রাঞ্চের উদ্দেশ্য যেহেতু আপনার নাম তালিকাভুক্ত করা, সেহেতু _add_ শব্দটি যুক্ত থাকাই কাম্য।) ## প্রয়োজনীয় পরিবর্তন করুন ও পরিবর্তনগুলো কমিট করুন এখন যে কোন টেক্সট এডিটরে `Contributors.md` ফাইলটি খুলুন, এতে আপনার নাম যুক্ত করুন, অতঃপর ফাইলটি সেভ করুন। এবার প্রজেক্ট ডিরেক্টরি থেকে `git status` কমান্ড রান করলে আপনি পরিবর্তনগুলো দেখতে পাবেন। `git add` কমান্ড দ্বারা এই পরিবর্তনগুলো আপনার তৈরি ব্রাঞ্চে যুক্ত করুন : ```bash git add Contributors.md ``` এরপর `git commit` কমান্ড ব্যবহার করে এই পরিবর্তনগুলো কমিট করুন : ```bash git commit -m "Add to Contributors list" ``` ``-এর বদলে আপনার নাম লিখতে ভুলবেন না। ## পরিবর্তনগুলো গিটহাবে পুশ করা `git push` কমান্ড ব্যবহার করে পরিবর্তনগুলো পুশ করুন : ```bash git push origin -u ``` এক্ষেত্রে ``-এর বদলে পূর্বে আপনার তৈরি ব্রাঞ্চের নাম লিখুন।
পুশ করতে সমস্যা হলে এখানে ক্লিক করুন: - ### অথ্যানটিকেশনে সমস্যা 
remote: পাসওয়ার্ড অথ্যানটিকেশনের সাপোর্ট আগস্ট ১৩, ২০২১ থেকে আর নেই। Personal access token ব্যাবহার করুন।
  remote: https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ তে আরো তথ্য পাবেন।
  fatal: Authentication failed for 'https://github.com//first-contributions.git/'
[GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) এ আপনার একাউন্টে SSH key generation এবং configuration এর আরো তথ্য পাবেন।
## রিভিউয়ের জন্য আপনার পরিবর্তনগুলো জমা দিন আপনার গিটহাব রিপোজিটরিতে `Compare & pull request` বাটনে ক্লিক করুন। পুল রিকোয়েস্ট তৈরি করুন এখন _পুল রিকোয়েস্ট_ সাবমিট করুন। পুল রিকোয়েস্ট জমা দিন শীঘ্রই আমি এই প্রজেক্টের মাস্টার ব্রাঞ্চে আপনার সমস্ত পরিবর্তন গুলো মার্জ করব। পরিবর্তনগুলি একত্রিত হয়ে গেলে আপনি একটি নিশ্চিতকরণ ই-মেইল পাবেন৷ ## এরপর কী করব? আপনার অবদানের আনন্দ উপভোগ করুন এবং [ওয়েব অ্যাপ](https://firstcontributions.github.io/#social-share)-এর মাধ্যমে বন্ধু ও অনুসরণকারীদের সাথে শেয়ার করুন। যদি আপনি আরও অনুশীলন করতে চান, তাহলে [কোড অবদানগুলি](https://github.com/roshanjossey/code-contributions) চেকআউট করুন। এখন আপনি অন্যান্য প্রজেক্টগুলোতেও অবদান রাখতে পারেন। আপনার সুবিধার্থে আমরা সহজ সমস্যা সম্বলিত প্রজেক্টগুলোর একটি তালিকা তৈরি করেছি। ওয়েব অ্যাপে [প্রজেক্টগুলোর তালিকা](https://firstcontributions.github.io/#project-list) দেখুন। ### [ অতিরিক্ত উপাদানসমূহ ](../additional-material/git_workflow_scenarios/additional-material.md) ## অন্যান্য টুল ব্যবহারের টিউটোরিয়াল | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [গিটহাব ডেস্কটপ](../gui-tool-tutorials/github-desktop-tutorial.md) | [ভিজুয়্যাল স্টুডিও ২০১৭](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [গিটক্র্যাকেন](../gui-tool-tutorials/gitkraken-tutorial.md) | [ভিজুয়্যাল স্টুডিও কোড](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [আটলাসিয়ান সোর্সট্রি](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [ইন্টেলিজ আইডিয়া](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.by.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Першы ўклад у праект Складана. Заўсёды складана пачынаць нешта з самага пачатку. Даволі непрыемна рабіць памылкі, асабліва калі вы працуеце ў камандзе. Увесь open source складаецца з супрацоўніцтва і сумеснай працы. Мы хочам аблегчыць першыя крокі ў навучанні і супрацоўніцтве пачаткоўцам распрацоўнікам. Чытанне артыкулаў і падручнікаў можа дапамагчы, але што можа быць лепш, чым сапраўдны практычны вопыт, без рызыкі што-небудзь сапсаваць. Мэта гэтага праекта - належным чынам накіраваць маладых навабранцаў, а таксама даць ім магчымасць зрабіць іх першы ўклад. Памятаеце: чым менш вы напружаныя, тым лепш вы вучыцеся. Калі вы шукаеце магчымасць ажыццявіць свой першы ўклад, проста прытрымлівайцеся простым крокам, размешчаным ніжэй. Абяцаем, будзе цікава. стварыць форк гэтага рэпазітара Калі ў вас не ўсталяваны git на кампутары, [ ўсталюйце яго ]( https://help.github.com/articles/set-up-git/ ) ## Стварыце асобную галінку Стварыце асобную галінку, націснуўшы на кнопку `fork` зверху гэтай старонкі. Такім чынам вы створыце копію гэтага рэпазітара ў сваім запісе. ## Капіюйце рэпазітар кланаваць гэты рэпазітар Цяпер каб скапіяваць ваш рэпазітар на персанальны кампутар. Націсніце на кнопку `clone`, а затым на абразок `copy to clipboard`, каб скапіяваць спасылку. Адкрыйце тэрмінал і запусціце наступную git каманду: ```bash git clone "url you just copied" ``` Дзе "url you just copied" (без двукоссяў) гэта спасылка на ваш рэпазітар. Паглядзіце папярэднія крокі, каб атрымаць гэтую спасылку. скапіяваць URL-адрас у буфер абмену Напрыклад: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` Дзе `this-is-you` ваш лагін на github. Такім чынам вы капіруеце рэпазітар 'first-contributions' з GitHub на ваш персанальны кампутар. ## Стварыце галінку Перайдзіце ў каталог рэпазітара на вашым кампутары, калі вы яшчэ не там. ```bash cd first-contributions ``` Цяпер стварыце галінку, з дапамогай `каманды git checkout` ```bash git checkout -b ``` Напрыклад: ```bash git checkout -b add-alonzo-church ``` (Сінтаксічную не патрабуецца, каб назва галіны ўтрымлівала слова * add *, але гэта апраўдана, паколькі падкрэслівае прызначэнне гэтай галіны - дадаць ваша імя ў спісы.) ## Занясіце неабходныя змены і стварыце commit Цяпер адкрыйце файл `Contributors.md` ў вашым тэкставым рэдактары, запішыце ваша імя і захавайце файл. выканайце каманду git status Калі вы пяройдзеце ў дырэкторыю праекта і выканайце `git status`, вы ўбачыце змены. Дадайце гэтыя змены з дапамогай каманды `git add`. ```bash git add Contributors.md ``` Цяпер занясіце дадзеныя змены з дапамогай каманды `git commit`. ```bash git commit -m "Add to Contributors list" ``` Зменіце `` на ваша імя ## Занясіце дадзеныя змены на github Занясіце вашыя змены з дапамогай каманды `git push` ```bash git push origin ``` Зменіце `` на імя галіны, якую вы стварылі раней. ## Пацвердзіце змены для праверкі вашага кода Калі вы зойдзеце ў свой рэпазітар на GitHub, вы ўбачыце кнопку `Compare & pull request`. Націсніце на яе. стварыць запыт на злучэнне Цяпер пацвердзіце pull-request. адправіць запыт на зняцце Хутка я ўчыню аб'яднанне ўсіх вашых змяненняў з асноўнай галіной гэтага праекта. Вы атрымаеце паведамленне па электроннай пошце, калі змены будуць прынятыя (ўнесены ў галоўную галіну). Асноўная галіна вашага рэпазітара не будзе зменена. Для сінхранізацыі выканайце крокі, размешчаныя ніжэй. ## Сінхранізуецца ваша адгалінаванне з дадзеным рэпазітаром Перш за ўсё перайдзіце ў асноўную галіну: ```bash git checkout master ``` Затым дадайце url майго рэпазітара ў полі `upstream remote url`: ```bash git remote add upstream https://github.com/Roshanjossey/first-contributions ``` Такім чынам мы паведамім git, што існуе іншая версія дадзенага праекта па пэўнай спасылцы, і мы яе лічым майстрам. Як толькі змены смержены, падгрузіць новую версію майго рэпазітара. ```bash git fetch upstream ``` Такім чынам мы забралі ўсе змены ў маім адгалінаванні (upstream remote). Пасля, вам трэба зліць новую версію майго рэпазітара з вашай майстар-галіной. ```bash git rebase upstream/master ``` Так вы ўжываеце ўсе змены, якія вы падцягнулі да вашай майстар-галіны. Калі вы запушите зараз майстар-галіна, ваша адгалінаванне таксама будзе ўтрымліваць змены. ```bash git push origin master ``` Звярніце ўвагу, што вы робіце push ў выдаленай рэпазітар origin. На гэтым этапе я аб'яднаў вашу галіну `` са сваёй майстар-галіной, а вы аб'ядналі сваю майстар-галіна з маёй. Ваша галіна больш не патрэбна, вы можаце выдаліць яе: ```bash git branch -d ``` Таксама можаце выдаліць яе версію ў аддаленым рэпазітары: ```bash git push origin --delete ``` Гэта зусім не абавязкова, але назва гэтай галіны адлюстроўвае яе даволі спецыфічнае прызначэнне. І працягласць яе жыцця можа быць адпаведна кароткай. ## Выкарыстанне іншых інструментаў | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ## Што далей? Ніжэй некалькі папулярных рэпазітароў, дзе вы можаце знайсці заданні для пачаткоўцаў. Наперад, перайдзіце ў рэпазітары, каб даведацца больш. | [![exercism](https://avatars2.githubusercontent.com/u/5624255?v=3&s=100)](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22) | [![fun-retro](https://avatars3.githubusercontent.com/u/15913975?v=3&s=100)](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22) | [![habitat](https://avatars1.githubusercontent.com/u/18171698?v=3&s=100)](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [![scikit-learn](https://avatars0.githubusercontent.com/u/365630?v=3&s=100)](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie) | [](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22) | [![elasticsearch](https://avatars2.githubusercontent.com/u/6764390?v=3&s=100)](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22) | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [exercism](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22) | [Fun Retros](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [react](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22) | [habitat](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [scikit-learn](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [Leiningen](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie) | [numpy](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22) | [elasticsearch](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22) | | [![homebrew](https://avatars2.githubusercontent.com/u/1503512?v=3&s=100)](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) | [![rust](https://avatars1.githubusercontent.com/u/5430905?v=3&s=100)](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy) | [![vuejs](https://avatars1.githubusercontent.com/u/6128107?v=3&s=100)](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22) | [![Suave](https://avatars2.githubusercontent.com/u/5822862?v=3&s=100)](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy) | [![OpenRA](https://avatars3.githubusercontent.com/u/409046?v=3&s=100)](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [![PowerShell](https://avatars0.githubusercontent.com/u/11524380?v=3&s=100)](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs) | [![coala](https://avatars2.githubusercontent.com/u/10620750?v=3&s=100)](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer) | [![moment](https://avatars2.githubusercontent.com/u/4129662?v=3&s=100)](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs) | | [homebrew](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) | [Rust](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy) | [vuejs](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22) | [Suave](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy) | [OpenRA](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [PowerShell](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs) | [coala](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer) | [moment](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs) | | [![ava](https://avatars0.githubusercontent.com/u/8527916?v=3&s=100)](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22) | [![freeCodeCamp](https://avatars0.githubusercontent.com/u/9892522?v=3&s=100)](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [![webpack](https://avatars3.githubusercontent.com/u/2105791?v=3&s=100)](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22) | [![hoodie](https://avatars1.githubusercontent.com/u/1888826?v=3&s=100)](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [![pouchdb](https://avatars3.githubusercontent.com/u/3406112?v=3&s=100)](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) | [![neovim](https://avatars0.githubusercontent.com/u/6471485?v=3&s=100)](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level) | [![babel](https://avatars2.githubusercontent.com/u/9637642?v=3&s=100)](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [](https://github.com/adobe/brackets/labels/Starter%20bug) | | [ava](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22) | [freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [webpack](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22) | [hoodie](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [pouchdb](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) | [neovim](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level) | [babel](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [brackets](https://github.com/adobe/brackets/labels/Starter%20bug) | | [![Node.js](https://avatars1.githubusercontent.com/u/9950313?v=3&s=100)](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | [](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | | [Node.js](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | [Semantic-UI-React](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | ================================================ FILE: docs/translations/README.ca.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeres Contribucions És difícil. Sempre és difícil fer una cosa per primera vegada. Sobretot quan es col·labora amb altres, ja que equivocar-se no és gens agradable. Volem simplificar la manera d'aprendre a contribuir i col·laborar en projectes de codi obert per primera vegada. Llegir articles i mirar tutorials pot ser útil, però què millor que fer les coses en un entorn pràctic real? Aquest projecte és una guia per a principiants que vol simplificar la primera contribució a projectes de codi oberts. Si vols fer la teva primera contribució, segueix les instruccions que es mostren a continuació: #### *Si no et sents còmode/a amb la línia d'ordres (*Command Line*), [aquí trobaràs tutorials utilitzant eines que tenen Interfície Gràfica (GUI)](#Tutorials-amb-Altres-Eines)* fer fork d'aquest repositori Si no tens git al teu ordinador, l'hauràs d'[instal·lar]( https://help.github.com/articles/set-up-git/). ## Bifurca (*Fork*) aquest respositori Fes una *fork* d'aquest repositori clicant al botó "*Fork*" a la part superior dreta d'aquesta pàgina. Això crearà una còpia d'aquest repositori al teu compte de GitHub. ## Clona (*Clone*) el repositori clonar aquest repositori Clona aquest repositori al teu ordinador: ves al teu compte de GitHub, fes clic al botó clonar "*clone or download*" del repositori, i després clica a la icona de *copiar al porta-retalls*. Obre una terminal/línia d'ordre i executa el següent comandament de git: ```bash git clone "url que acabes de copiar" ``` on "url que acabeu de copiar" (sense cometes dobles) és la *url* per a aquest repositori (la vostra bifurcació o *fork* d'aquest projecte). Per obtenir la *url*, torna als passos anteriors. copiar URL al porta-retalls Per exemple: ```bash git clone https://github.com/aquest-soc-jo/first-contributions.git ``` on `aquest-soc-jo` és el teu nom d'usuari de GitHub. En aquest pas, estàs copiant el contingut del repositori *first-contributions* de GitHub al teu ordinador. ## Crea una branca (*branch*) Canvieu al directori del repositori del vostre ordinador (si no hi esteu allà ja): ```bash cd first-contributions ``` Crea una nova branca (*branch*) utilitzant el comandament `git checkout`: ```bash git checkout -b ``` Per exemple: ```bash git checkout -b add-nom-cognom ``` (No fa falta que el nom de la branca contingui la paraula *add* però és recomanable, ja que l'objectiu d'aquesta branca és afegir el teu nom a la llista.) ## Fes els canvis necessaris i confirma (*commit*) els canvis Obre l'arxiu `Contributors.md` en un editor de text i afegeix-hi el teu nom. No l'afegeixis ni al principi, ni al final de l'arxiu. Posa'l en qualsevol altre posició. Llavors desa l'arxiu. estat del git Ara, si vas al directori del projecte i executes el comandament `git status`, veuràs els canvis. Afegeix aquests canvis a la branca que acabes de crear utilitzant el comandament `git add`: ```bash git add Contributors.md ``` Confirma (*commit*) els canvis utilitzant el comandament `git init`: ```bash git commit -m "Add to Contributors list" ``` reemplaçant `` amb el teu nom. ## Empeny (*Push*) els canvis cap a GitHub Envia els canvis utilitzant el comandament `git push`: ```bash git push origin ``` reemplaçant `` amb el nom de la branca que has creat anteriorment. ## Envia (*Submit*) els canvis per tal que siguin revisats Si ara vas al teu repositori a GitHub, veuràs un botó `Compare & pull request` (Compara i fes una sol·licitud d'incorporació). Fes clic en aquest botó. crear una pull request Envia la sol·licitud d'incorporació (*pull request*). envia la pull request Quan un administrador vegi la solicitud, la revisarà i incorporarà els teus canvis a la branca principal (*main branch*) del projecte. Rebràs una notificació per correu electrònic quan els canvis s'hagin incorporat. ## I ara què? Enhorabona! Acabes de completar el procés de treball principal que et trobaràs com a col·laborador de projectes de codi obert: *_fork -> clone -> edit -> PR_*. Ara, celebra la teva contribució i comparteix-la amb els teus amics i seguidors anant a [la web](https://firstcontributions.github.io/#social-share). Si vols contribuir al projecte, pots començar amb aquesta [guia per contribuir al codi](https://github.com/roshanjossey/code-contributions). A continuació, et pots preparar per contribuir a altres projectes. Hem reunit una llista de projectes amb tasques (*issues*) pendents fàcils per tal de poder començar. Fes un cop d'ull a [la llista de projectes aquí](https://firstcontributions.github.io/#project-list). ### [Material extra](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutorials utilitzant altres eines | Aplicativo GitHub Desktop | Visual Studio 2017 | Programa GitKraken | Editor VS Code | Aplicativo Sourcetree | Programa IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](https://www.jetbrains.com/idea/download/#section=windows) | ================================================ FILE: docs/translations/README.col.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeras Contribuciones Uy, la cosa está complicada. La primera vez que uno le mete la ficha a algo nuevo es re difícil, ¿sí o qué? Más cuando toca camellar con otra gente, porque nadie quiere meter las patas y quedar como un guevón. Nosotros queremos es que los pipiolos que le quieren entrar al código abierto la tengan más suave para aprender y aportar su granito de arena. Bacano leer artículos y ver tutoriales y toda esa vaina, pero nada como aprender haciendo, ¿o no? Este proyecto es una guía re chévere para que los novatos le cojan el tiro a esto de contribuir por primera vez. Si quieres estrenar tus pinitos en esto, sigue estos pasos al pie de la letra: #### _Si no le has cogido el tiro a la consola,[acá tenés tutoriales con herramientas más amigables (GUI)](#Tutoriales-con-otras-herramientas)_ fork de este repositorio Si no tenés git en tu aparato, podés encontrar cómo instalarlo en[este link](https://docs.github.com/es/get-started/quickstart/set-up-git). ## Hacele un (_Fork_) a este repositorio Dale click al botón de "_Fork_" allá arriba a la derecha de esta página. Eso te va a crear una copia de este repositorio en tu cuenta, facilito. ## Clona (_Clone_) el repositorio Forkeado clonar este repositorio Ahora toca clonar este repositorio en tu compu. Andate a tu cuenta de GitHub, dale al botón de "_clone or download_" y después al iconito para _copiar al portapapeles_. Abre tu consola o terminal y ejecuta el siguiente comando de git: ```bash git clone "url que acabas de copiar" ``` Donde dice "url que acabas de copiar" (sin las comillas, ojo) es la _url_ de este repositorio (tu _fork_ del proyecto). Mira los pasos de antes para sacar la _url_. copiar URL al portapapeles Por ejemplo: ```bash git clone https://github.com/este-eres-tu/first-contributions.git ``` Cambiá `este-eres-tu` por tu usuario de GitHub. Acá estás copiando todo el contenido del repositorio _first-contributions_ de GitHub a tu compu. ## Crea una rama (_Branch_) Metete al directorio del repositorio en tu compu (si no estás ya ahí). ```bash cd first-contributions ``` Ahora crea una rama (_branch_) usando el comando `git checkout`: ```bash git checkout -b ``` Por ejemplo: ```bash git checkout -b add-alonzo-church ``` (No es obligatorio que el nombre de la rama tenga la palabra add, pero tiene sentido ponerla porque la idea de esta rama es agregar tu nombre a la lista.) ## Hacé los cambios necesarios y confirmalos (_Commit_) Abrí el archivo `Contributors.md` en un editor de texto y agregá tu nombre. No lo pongas ni al principio ni al final del archivo, metelo en cualquier otro lado. Guardá el archivo. gestado de git Si vas al directorio del proyecto y ejecutas el comando `git status`, verás que hay cambios. Agrega esos cambios a la rama (_branch_) que creaste anteriormente usando el comando `git add`: ```bash git add Contributors.md ``` Ahora hacele un _commit_ a esos cambios ejecutando el comando `git commit`: ```bash git commit -m "Add to Contributors list" ``` cambiando `` por tu nombre, obviamente. ## Subí (_Push_) tus cambios a GitHub Mandale un _push_ de tus cambios usando el comando `git push`: ```bash git push origin ``` Reemplaza `` con el nombre de la rama que creaste antes. ## Mandá (_Submit_) tus cambios para que los revisen Si vas a tu repositorio en GitHub, verás un botón `Compare & pull request`. Dale click sobre este botón. crea una pull request Ahora mandá la _pull request_. enviar la pull request Dentro de poco voy a estar fusionando tus cambios (haciendo merge) con la rama master de este proyecto. Te va a llegar un correo cuando los cambios estén fusionados. ## ¿Y ahora qué sigue? ¡Felicitaciones parcero! ¡Le diste la vuelta completa al proceso _fork -> clone -> edit -> PR_ que vas a usar un montón como contribuidor! Celebrá tu aporte y compartilo con tus amigos y seguidores en la.[web app](https://firstcontributions.github.io/#social-share). También te podés unir a nuestro equipo de Slack si necesitás una mano o tenés alguna pregunta.[Unite a nuestro Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). Ahora dale, empezá a contribuir a otros proyectos. Armamos una lista de proyectos con issues fáciles para que arranques. Dale una mirada a la[lista de proyectos en la aplicación web](https://firstcontributions.github.io/#project-list). ### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriales con otras herramientas | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.cs.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # První příspěvek Život je těžký. Obzvláště když něco děláte poprvé. V případě, že na něčem spolupracujete, není dělání chyb něco, co by vám dělalo radost. My bychom rádi zjednodušili cestu novým přispěvatelům do open-source při jejich učení se jak na to. Čtení článků nebo zhlédnutí video návodů jsou také cesty, ale co je lepší než si danou věc přímo osahat na vlastní kůži v reálném prostředí? Tento projekt je zaměřen na poskytnutí pomoci začátečníkům s jejich prvním přispěním do open-source. Pokud jste jím právě vy, následujte kroky popsané níže. #### *Pokud nemáte rádi příkazovou řádku, [zde najdete návody na použití nástrojů s GUI (grafické uživatelské rozhraní)](#Návod-za-použití-dalších-nástrojů)* forkněte tento repozitář Pokud namáte nainstalovaný git, [nainstalujte si jej]( https://help.github.com/articles/set-up-git/). ## Forkněte tento repozitář Forkněte (vytvoření kopie z originálu, z anglického *fork* – *vidlička*, jako vytvoření nové odnože) tento repozitář kliknutím na tlačítko **Fork** nahoře na této stránce. Tím vytvoříte kopii tohoto repozitáře na svém vlastním GitHub účtu. ## Naklonujte repozitář naklonujte tento repozitář Nyní naklonujte (anglicky *clone*) forknutý repozitář na váš počítač, naklonování není nic jiného než stáhnutí obrazu repozitáře k vám na počítač. Na vašem GitHub účtu si otevřete forknutý repozitář, klikněte na tlačítko **Clone or download** a následně v okýnku, které se objeví, klikněte na tlačítko s ikonkou **copy to clipboard** vedle URL adresy, čímž si ji zkopírujete do schránky. Teď otevřete terminál a spusťte následující příkaz: ```bash git clone "url které jste právě zkopírovali" ``` zkopírujte adresu do schránky Například: ```bash git clone https://github.com/vase-username/first-contributions.git ``` Tímto na svém počítači vytvoříte složku se soubory daného repozitáře. ## Vytvořte větev V příkazové řádce se přepněte do složky s repozitářem (pokud v ní už nejste) ```bash cd first-contributions ``` Nyní vytvořte novou větev (anglicky *branch*) za použití příkazu `git checkout`: ```bash git checkout -b ``` Například: ```bash git checkout -b pridani-meho-jmena ``` Jméno větve by mělo vypovídat o tom, co kód nebo cokoliv jiného do ní přidané bude dělat/vykonávat, případně proč se daná věc děje. ## Udělejte změny a zaznamenejte je Otevřete soubor `Contributors.md` v textovém editoru a přidejte do něj své jméno. Napiště jej někam doprostřed a soubor uložte. git status Pokud teď v příkazové řádce spustíte příkaz `git status`, uvidíte jaké změny byly v repozitáři provedeny. Tyto změny do dané větvě přidáte příkazem `git add`: ```bash git add Contributors.md ``` Zbývá už jen potvrdit (anglicky *commit*) změny příkazem `git commit`: ```bash git commit -m "Add to Contributors list" ``` Za přepínač `-m` se píše co dané změny představují, popis by měl být jednoduchý ale výstižný. ## Protlačte změny na GitHub Nyní změny provedené lokálně na počítači protlačíme (anglicky *push*) na GitHub příkazem `git push`: ```bash git push origin ``` ## Předložte své změny k posouzení Pokud se nyní podíváte do svého GitHub repozitáře, uvidíte tlačítko **Compare & pull request**. Klikněte na něj. vytvořte pull request Teď vytvořte žádost o přetažení vaší větve do originálního repozitáře (anglicky *pull request*). potvrďte pull request Brzy budou správci provádět zapracování vašich změn do hlavní (anglicky *master*) větve tohoto projektu. Až se do ní vaše změny dostanou, dostanete e-mailové upozornění. ## Kam dále? Blahopřejeme! Právě jste dokončili standardní _fork -> clone -> edit ->_ průběh práce (anglicky *workflow*), se kterým se jako přispěvatel do projektů setkáte dennodenně. Oslavte svůj první příspěvek se svými přáteli a následovníky přes [webovou aplikaci](https://firstcontributions.github.io/#social-share). Pokud byste chtěli více praxe, můžete zkusit [code contributions](https://github.com/roshanjossey/code-contributions). Nyní vám už nic nebrání v příspívání do ostatních projektů. Připravili jsme pro vás seznam projektů, které mají jednoduché záležitosti k vyřešení/naprogramování, se kterými můžete začít. Podívejte se [zde](https://firstcontributions.github.io/#project-list). ### [Další materiály](../additional-material/git_workflow_scenarios/additional-material.md) ## Návod za použití dalších nástrojů | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.da.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Første bidrag Det er svært. Det er altid svært når det er første gang. Specielt hvis man samarbejder er det ikke rart at begå fejl. Vi vil simplificere den store udfordring det er for nybegyndere at lære om open-source, og at lave deres første bidrag. At læse artikler og se video guides hjælper, men hvad er bedre end at bruge det i praksis? Dette projekt håber at kunne tilbyde vejledning og gøre det overkommeligt for alle at lave deres første open-source bidrag. #### _Hvis du ikke er komfortabel med command line, [her er vejledninger til GUI værktøjer](#Guides-med-andre-værktøjer)_ lav en fork af dette repository Har du ikke Git på din maskine kan du [installere det](https://help.github.com/articles/set-up-git/). ## Fork dette repository Fork dette repo ved at klikke på "fork" knappen øverst på siden. Dette vil lave en kopi af projektet i din Github konto. ## Clone dette repository clone dette repository Næste trin er at "clone" dit nye repository til din maskine. Naviger til din Github account og åbn dit nye repository, derefter find "clone" øverst oppe og tryk på knappen. Tryk _copy to clipboard_ ikonet. Åbn en terminal og kør den følgende git command: ```bash git clone "din url" ``` hvor "din url" skal erstattes med den URL du kopieret i forrige trin. kopier URL til udklipsholder Eksempel: ```bash git clone https://github.com/dit-brugernavn/first-contributions.git ``` Erstat 'dit-brugernavn' med dit GitHub brugernavn. Her kopierer vi indholdet af first-contributions repositoriet fra din Github konto, til din lokale PC. ## Opret en branch Åbn en konsol og cd til dit lokale repository (hvis ikke du allerede er der): ```bash cd first-contributions ``` Derefter opretter du en branch med kommandoen `git checkout`: ```bash git checkout -b ``` Eksempel: ```bash git checkout -b add-alonzo-church ``` (Navnet på din branch behøver ikke at indeholde ordet _add_, men det giver mening at inkludere det her da branchen er til for at tilføje dit navn til en liste med navne.) ## Lav dine ændringer og commit dem Åben filen `Contributors.md` i en text editor og tilføj dit navn til listen. Undgå at tilføje dit navn øverst eller nederst på listen, men helst et sted i mellem. Når dette er gjort så gem filen. git status Hvis du går til konsollen og kører kommandoen `git status`, vil du se dine ændringer. Tilføj disse ændringer til din branch med kommandoen `git add`: ```bash git add Contributors.md ``` Derefter commit ændringerne med kommandoen `git commit`: ```bash git commit -m "Add to Contributors list" ``` Erstat `` med dit Github brugernavn. ## Push ændringer til Github Push dine ændringer til Github med kommandoen `git push`: ```bash git push origin ``` Erstat `` med navnet på den branch du oprettede tidligere. ## Indgiv ændringer til inspektion Hvis du går ind på dit repository på Github, så vil du se en `compare & pull request` knap. Klik på den. opret en pull request Indgiv nu din pull request. indsend pull request Snart vil jeg merge dine ændringer ind i master branch'en af projektet. Du vil modtage en notifikation per email når dine ændringer er blevet merget. ## Hvor til nu? Tillykke! Du har nu gennemført den udbredte _fork -> clone -> edit -> PR_ workflow som du vil støde oftest på som contributor! Fejr dit bidrag og del det med dine venner og følgere ved at gå til [web app](https://firstcontributions.github.io/#social-share). Du kan også tilslutte dig vores code-contributions repo, hvis du er klar til at løse mere avancerede problemer. [Join code-contributions repo](https://github.com/firstcontributions/code-contributions). Tillad os også at hjælpe dig i gang med dine næste bidrag. Vi har kompileret en liste af projekter med letty, overkommelige problemer du kan starte ud med. Check den ud her: [the list of projects in web app](https://firstcontributions.github.io/#project-list). ### [ekstra materiale](../additional-material/git_workflow_scenarios/additional-material.md) ## Guides med andre værktøjer | GitHub Desktop-app | Visual Studio 2017 | GitKraken-program | VS Code-editor | Sourcetree-app | IntelliJ IDEA-program | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.de.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions Dieses Projekt zielt darauf ab, Anfängern den Einstieg zu erleichtern und sie bei ihrem ersten Beitrag zu unterstützen. Wenn du deinen ersten Beitrag leisten möchten, befolge die folgenden Schritte. _Wenn du nicht weißt wie man das Terminal/CMD bedient, [hier findest du Anleitungen für GUI Tools.](#Anleitungen-für-andere-Tools)_ Forke dieses Repository #### Wenn du Git nicht auf deinem System installiert hast, [installiere es](https://...github.com/en/get-started/quickstart/set-up-git). ## Forke dieses Repository Forke dieses Repository indem du auf den Fork Button oben auf dieser Seite klickst. Dies wird eine Kopie dieses Repository's in deinem Account erstellen. ## Klone das Repository Klone dieses Repository Klone jetzt das geforkte Repository auf deinen Computer. Gehe zu deinem Github Account, öffne das geforkte Repository, drücke auf den Code Button, dann auf den SSH Tab und dann drücke auf das _copy url to clipboard_ icon. Öffne ein Terminal Fenster und führe den folgenden Git Befehl aus: ```bash git clone "kopierte url" ``` wobei "kopierte url" (ohne die Anführungszeichen) die url zu diesem Repository ist (deine Fork von diesem Projekt). Im vorherigen Schritt siehst du wie du diese erhälst . URL in die Zwischenablage kopieren Zum Beispiel: ```bash git clone git@github.com:das-bist-du/erster-Beitrag.git ``` wobei `das-bist-du` dein Github Nutzername ist. Hier kopierst du den Inhalt des first-contributions Repository's auf Github auf deinen Computer. ## Erstelle einen Zweig Wechsle zum Repository Ordner (wenn du nicht bereits dort bist): ```bash cd first-contributions ``` Erstelle nun einen Zweig, indem du den `git switch` Befehl benutzst: ```bash git switch -c dein-neuer-zweig-name ``` Zum Beispiel: ```bash git switch -c add-alonzo-church ```
Wenn du auf irgendeinen Fehler bei der Nutzung von git switch stößt, drücke hier: Wenn die Fehlermeldung "Git: `switch` is not a git command. See `git –help`" erscheint, liegt dies wahrscheinlich daran das du eine veraltete Version von Git nutzt. In diesem Fall versuche stattdessen `git checkout` zu nutzen: ```bash git checkout -b dein-neuer-zweig-name ```
## Mache notwendige veränderungen und commit diese Öffne nun die Datei `Contributors.md` in einem Texteditor und füge deinen Namen hinzu. Füge ihn nicht ganz am Anfang oder am Ende hinzu, sondern irgendwo dazwischen, mittendrin. Speichere jetzt die Datei. git status Wenn du in den Projektordner gehst und den Befehl `git status`, ausführst werden dir die Änderungen angezeigt. Füge diese Änderungen nun zu dem Zweig hinzu den du gerade erstellt hast, indem du den Befehl `git add` ausführst. ```bash git add Contributors.md ``` Jetzt commite diese Änderungen mit dem `git commit` Befehl: ```bash git commit -m "Add your-name to Contributors list" ``` ersetze `your-name` mit deinem Namen. ## Änderungen auf Github pushen Übertrage deine Änderungen mit `git push`: ```bash git push -u origin dein-zweig-name ``` ersetze `dein-zweig-name` mit dem Namen des Zweiges den du vorhin erstellt hast.
Solltest du auf irgendwelche Fehler beim Pushen stoßen, drücke hier: - ### Authentifizierungs Fehler 
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//first-contributions.git/'
Gehe zu [GitHub's tutorial](https://...github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) wie du einen ssh Key zu deinem Account hinzufügst und konfigurierst. Außerdem, kannst du 'git remote -v' ausführen um deine Remote Addresse anzuzeigen. Wenn es so aussieht: 
origin	https://github.com/your-username/your_repo.git (fetch)
  origin	https://github.com/your-username/your_repo.git (push)
ändere es mit diesem Befehl: ```bash git remote set-url origin git@github.com:dein-nutzername/dein_repo.git ``` Ansonsten wirst du noch immer aufgefordert Passwort und Benutzername einzugeben und bekommst einen Authentifizierungs Fehler.
## Reiche deine Änderungen für ein Review ein Wenn du jetzt zu deinem Repository auf Github gehts, wirst du einen `Compare & pull request` Knopf sehen. Drücke diesen Knopf. erstelle eine Pull-Request Jetzt, reiche deine Pull-Request ein. Reiche deine Pull-Request ein Bald werde ich alle deine Änderungen in den Haupt-Zweig dieses Projektes mergen. Du wirst eine Benachrichtigungs Email bekommen sobald die Änderungen gemerged wurden. ## Was nun? Gratulation! Du hast gerade den Standard _Forken -> Klonen -> Bearbeiten -> Pull-Request_ Workflow durchgeführt, dem du als Beitragender oft begegnen wirst! Feier deinen Beitrag und teile in mit deinen Freunden und Followern indem du hier drückst [web app](https://firstcontributions.github.io/#social-share). Wenn du gerne mehr Übung hättest, schau dir [code contributions](https://github.com/roshanjossey/code-contributions) an. Jetzt los gehts, mit Beiträgen zu anderen Projekten. Wir haben eine Liste von Projekten mit leichten Fehlern für Einsteiger bereitgestellt. Schau dir [die Liste der Projekte in der Web-App an](https://firstcontributions.github.io/#project-list) an. ### [Zusätzliches Material](../additional-material) ## Anleitungen für andere Tools | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |

Dieses Projekt wird unterstützt von:

================================================ FILE: docs/translations/README.dz.md ================================================ [![Houb el tatbi9ate el hourra](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Awel mouchraka 🇩🇿 Dayemen kayen mochkile ki nebdaw hadja men el bidaya. El khawof ta3 edire khatae daymen machi melih, khousousan ki techarek fi el code. Bessah 3alem el tatbi9ate el hourine mawodjoud bache etcharek wo tekhdem fi madjemou3a. Tani, Rana habine nebesstou el ta3lime ta3 el moucharraka el djadidda fel tatbi9ate el hourra bi ta3lime kifache techarek lil merra el oulla. Te9rra ma9alate wa les tutos te9derre te3awonek, bessah wache howa afdel mine tehawolle tessiyi bela ma eddire akhtae ? Hadda el machrou3 medyoure bache yaa3ti nassaihe wo y ssahel tari9ate kifache li maya3rfouche bache eydirrou el moucharaka el oulla ta3houme. Etfekare : 9edma tekoune alaise, 9edma tet3alem bezaf. Wolla rak hab etcharek lel merra el oulla, teba3 el khtouwate el djaya. Wallah, rah tekoune moussaliya. embrancher ce repertoire Wolla ma3endekche git fel ordinateur ta3ek, [ tell3ou be rabet ]( https://help.github.com/articles/set-up-git/ ). ## Forker hadda el garage (ne3aytoulou tani Fork) Forker el garage ki teklicker 3ala zire Fork el fow9e ta3 el safeha. Hada rah yecrée nousskha tabe9 el assel ta3 el garage fi github ta3ek. ## Enssoukhe el garage 3andek fel PC clonez ce répertoire Dourka, enssoukhe hada el garage 3ala el PC diyalek. Clické 3ala el zire enssoukhe menba3ede eclicker 3ala l'icone *copié fi presse papier ta3ek*. Eftah la console ta3 les commandes (ida rak fi windows) wola el terminale (ida rak fi MacOS ou Linux) menba3de cheghale lé commandes git el taliya : ```bash git clone "l'url eli copietha dourk berk" ``` wine "l'url eli copietha dourk berk" (bela lé guillemets) hiya l'url ta3 el garage. chouf fi eli fate men 9abel bache tethassel 3ala l'url. copier l'URL dans le presse-papier Mithale : ```bash git clone https://github.com/issem-el-mousstakhdem-ta3ek/first-contributions.git ``` wine `issem-el-mousstakhdem-ta3ek` howa issem el mousstakhdem ta3 el compte ta3ek github, hena rak tecopier ga3 el mouhtawa ta3 el garage `first-contributions` mine Github lel PC diyalek. ## Ecréyé far3e Rouhe lel garage ta3 el projet eli créyitou djedide mousstenssakhe (edha marakeche déja fih) ```bash cd first-contributions ``` Dourka ecréyé far3e be la commande `git checkout` : ```bash git checkout -b ``` Mithale : ```bash git checkout -b add-koffi-sani ``` (Esseme el far3e mayahtajeche yekoune fih kelmete *add*, mé hadja meliha loukane yekoune fih hadef lel fare3 wo tezide esseme diyalek lel lista.) ## Dire el taghyirate el mouhima é kemle fiha Dourka, efteh el féchiyé `Contributors.md` fi un editeur de text, zid fih assmek, menba3de ahfedou, Idha fetehte le terminal ou derte la commande `git status`, rah etchouf beli kayen taghyérates. Zid hadouk al taghiyérates lel far3e eli créyeteho men 9bel be la commande `git add` : ```bash git add Contributors.md ``` Dourka, kemel commité hadouk étaghyérates be la commande `git commit`: ```bash git commit -m "Add to Contributors list" ``` Ghéyere `` bel assem diyalek. ## Eb3athe el tagheyérates fi github Ebe3athes el taghyérates diyalek be la commande `git push` : ```bash git push origin ``` Bedel `` be esseme el far3e eli créyeteho men 9abel. ## Présenté el taghyérates ta3ek lel fahsse Idha rahet lel garage diyalek 3ala github, rah etchouffe beli kayen zire `Compare & pull request`, éclické 3ala el zire hadek. dir talab dyal pull request Dourka présenter el talebe diyalek lel fahsse. qaddem pull request Fi zamen saghire rah ene fuzioné el taghyérates ta3ek me3a el fare3 main ta3 el projet hada, Yewosselek rissala ta3 el taghyérates ghire ki tendare la fusion kamel. El far3e main ta3ek marahe yessralou hata taghyiére lel ane. Bache main ta3ek yekoune moutwafek me3a ta3i, lazem tabe3 hadou lé el khoutouwates : ## Khelli el main ta3ek synchronisé me3a hada el garage Bache tebda, rouhe lel fare3 main ```bash git checkout main ``` Zide l'url ta3 el garage ta3ek ki `upstream remote url` : ```bash git remote add upstream https://github.com/Roshanjossey/first-contributions ``` Hada rah tekoune tarika bache te9oule lel git beli kayen version wahdoukhera texister bi had el 3ounwane wo nettb9ou a3lihe `upstream`. Ghire el tagheyérates tet fuzionna, hawosse 3ala la version djedidda ta3 el garrage ta3i : ```bash git fetch upstream ``` Henya rana nehawossou 3ala teghyérates fel main ta3i (upstream remote). Dourka, rahe tefusioner el taghyére el djadid ta3 el garage ta3i me3a el far3e ta3ek main : ```bash git rebase upstream/main ``` Henya rahe neteb9ou ga3 el taghyérates eli rak tehawosse a 3lihoume fel far3e main. Idha be3ate el far3e main dourka, el main ta3ek rahe yekoune howa tani fih taghéyérates : ```bash git push origin main ``` Tahedire: Hadi el khetra, rah tebe3aye el garage el be3ide eli assmou origin. Fi hade el marhala rani fusionite el far3e `` me3a el far3e main, wo enta fusionite el far3e main ta3i me3a el far3e main ta3ek. el far3e `` maraheche nahtajouhe, edane te9dere tessuprimihe : ```bash git branch -d ``` wa aydan te9dere tenihi la version ta3ou fel far3e el be3ide tani : ```bash git push origin --delete ``` Wache cheft henaya machi darouri, bessah assem el far3e yewori beli el hadef rahe moukhassasse. ## Tuto besste3male adawates wahdoukhra | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.ec.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeras Contribuciones Este proyecto tiene como objetivo simplificar y guiar la forma en que los principiantes hacen su primera contribución. Si está buscando hacer su primera contribución, siga los pasos a continuación. #### *Si no estás familiarizado con la línea de comandos, [aquí hay tutoriales usando herramientas con Interfaz Gráfica (GUI)](#tutoriales-usando-otras-herramientas)* hacer un fork de este repositorio En caso de no tener instalado Git en tu equipo, te dejo una [guia]( https://git-scm.com/book/es/v2/Inicio---Sobre-el-Control-de-Versiones-Instalaci%C3%B3n-de-Git) para instalarlo. ## Haz un "Fork" de este repositorio Presiona el boton "fork" de este repositorio en la parte superior derecha de la página. Al hacer esto, se crea una copia de este repositorio en tu cuenta de GitHub. ## Haz un "Clone" del repositorio copiado clonar este repositorio Ahora clona el repositorio al que le hiciste un fork previamente, el URL del repositorio deberia estar asi `https://github.com//first-contributions`. Entra en tu cuenta de Github, y has click en el botón `Code` y luego en la pestaña SSH y luego haz clic en el icono de _copiar al portapapeles_. Abre tu terminal y ejecuta el siguiente comando git: ``` git clone "la url del repositorio que copiaste" ``` Donde "la url del repositorio que copiaste" (sin las comillas dobles) es la *url* a este repositorio (tu *fork* a este proyecto), se veria algo asi `https://github.com//first-contributions.git` . copiar URL al portapapeles Por ejemplo: ``` git clone https://github.com//first-contributions.git ``` Donde `` es tu nombre de usuario de GitHub. Con este comando estas copiando los contenidos del repositorio *first-contributions* de GitHub a tu equipo. ## Crea una rama (*Branch*) Cambia al directorio del repositorio en tu equipo (si es que no estás ahí ya). ``` cd first-contributions ``` Ahora crea una rama (*branch*) usando el comando `git checkout` o `git switch`: ``` git checkout -b git switch -c ``` Por ejemplo: ``` git checkout -b add-julio-jaramillo git switch -c add-julio-jaramillo ```
Si obtienes algún error usando git switch, haz clic aquí: Si aparece el mensaje de error "Git: `switch` no es un comando git. Consulta `git –help`", es probable que estés usando una versión anterior de git. En este caso, intenta usar git checkout en su lugar.
## Haz los cambios necesarios y has un "Commit" de esos cambios Abre el archivo `Contributors.md` en un editor de texto y añade tu nombre. No lo añadas ni al principio ni al final del archivo, hazlo en cualquier otro sitio. Ahora guarda el archivo. introducir comando git status Si vas al directorio del proyecto y ejecutas el comando `git status`, podrás ver los cambios ya reflejados. Agrega esos cambios a la rama (*branch*) que creaste antes usando el comando `git add`: ``` git add Contributors.md ``` Ahora puedes hacer un *commit* sobre estos cambios ejecutando el comando `git commit`: ``` git commit -m "Add to Contributors list" ``` reemplazando `` con tu nombre. ## Haz un "Push" de tus cambios a GitHub Envía tus cambios usando el comando `git push`: ``` git push -u origin ``` Reemplaza `` con el nombre de la rama que creaste anteriormente.
Si obtienes algún error al enviar (Push), haz clic aquí: - ### Error de Autenticación 
remote: El soporte para la autenticación de contraseña se eliminó el 13 de agosto de 2021. Utiliza un token de acceso personal en su lugar.
  remote: Consulta https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ para obtener más información.
  fatal: Fallo en la autenticación para 'https://github.com//first-contributions.git/'
Ve al [tutorial de GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) sobre cómo generar y configurar una clave SSH en tu cuenta. Además, es posible que desees ejecutar `git remote -v` para verificar tu dirección remota. Si se ve algo como esto: 
origin https://github.com/tu-usuario/tu_repo.git (fetch)   
  origin  https://github.com/tu-usuario/tu_repo.git (push)
cámbialo usando este comando: ```bash git remote set-url origin git@github.com:tu-usuario/tu_repo.git ``` De lo contrario, aún se te pedirá un nombre de usuario y contraseña y obtendrás un error de autenticación.
## Envía (*Submit*) tus cambios para ser revisados Si vas a tu repositorio en GitHub, verás un botón `Compare & pull request`. Haz clic sobre este botón. crear una pull request Ahora envía el *pull request*. enviar la pull request Pronto estaré combinando tus cambios (haciendo *merge*) con la rama master de este proyecto. Recibirás una notificación por correo electrónico cuando los cambios hayan sido combinados. ## ¿Cuáles son los siguientes pasos? ¡Felicidades! ¡Has completado la línea de trabajo *_fork -> clone -> edit -> PR_* que encontrarás habitualmente como contribuidor! Festeja tu contribución y compártela con tus amigos y seguidores yendo a la [web app](https://firstcontributions.github.io/#social-share). Si deseas más práctica, consulta [code contributions](https://github.com/roshanjossey/code-contributions). Ahora empieza a contribuir a otros proyectos. Hemos reunido una lista de proyectos con *issues* sencillas para que puedas empezar. Échale un ojo a la [lista de proyectos en la web app](https://firstcontributions.github.io/#project-list). ### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriales usando otras herramientas |GitHub Desktop|Visual Studio 2017|GitKraken|VS Code|Sourcetree App|IntelliJ IDEA| |---|---|---|---|---|---| |[GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md)|[Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md)|[GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md)|[Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md)| [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md)|[IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md)| ================================================ FILE: docs/translations/README.eg.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) #
مساهمتك الأولى
الصعوبة متوقعة لما تبدأ أي مشروع جديد، خصوصاً لو كان المشروع بيتضمن ناس تانية، ودة بيخلي الوقوع في الخطأ مزعج ومتعب.
لكن المساهمة في مشاريع مفتوحة المصدر اسسها العمل الجماعي والعطاء.
في المشروع دة هدفنا هو تبسيط الطريق لأول مساهمة ليك.
ممكن تقرأ وتتفرج على فيديوهات على الإنترنت عشان تعرف تبدأ فى المساهمة للمشاريع مفتوحة المصدر، لكن هتستفيد أكتر لو عرفت تساهم في مشروع دلوقتي من غير خوف لحسن تعمل حاجة غلط. المشروع اللى انت فاتحه حاليا بيركز انه يوفرلك التوجيهات الأولية اللي هتحتجها عشان تبدأ أول مساهمة ليك. مش مشكلة تغلط المهم انك تتعلم من الغلط ودة الهدف هنا. تابع الخطوات واحدة واحدة ونوعدك انك هتستمتع.
لو ماكنش عندك git على جهازك حمله من هنا.
##
أفصل المشروع دة - Fork this Repository
اعمل فورك للمستودع ده
خد نسخة من المشروع دة (أو افصله) عن طريق انك تدوس على Fork في أعلى الصفحة. لو عملت كدة فأنت اخدت نسخة من الفولدر دة فى حسابك على github.
##
إنسخ المشروع دة - Clone the repository
انسخ المستودع على جهازك
انسخ المشروع دة لجهازك. دوس على Clone بعدين دوس على أيقونة Copy to clipboard
انسخ الرابط للحافظة
إفتح التريمنال وأكتب الأمر دة:
``` git clone "url you just copied" ```
بدل "url you just copied" حط الرابط اللي نسخته من الخطوة اللي فاتت، الرابط دة بتاع المشروع.
على سبيل المثال:
``` git clone https://github.com/this-is-you/first-contributions.git ```
في المثال دة لاحظ ان 'this-is-you' هيكون إسم حسابك في موقع github، الأمر دة هينسخ محتويات المشروع لجهازك الخاص عشان تقدر تعدل عليه بحرية في أي وقت.

##
إنشاء فرع - Create a branch
بما اننا عايزين نعمل تغيير فى الفايل اللى عملناله نسخة على الجهاز.. الأول ننتقل للفولدر اللي لسة نسخينه:
``` cd first-contributions ```
قبل مانعمل التغيير هنعمل "فرع" وهنديله اسم زي كدة:
``` git checkout -b "add-your-name" ```
هتحط اسمك بدل your-name
مثلا:
``` git checkout -b "add-alonzo-church" ```
##
غيّر التغيير اللي حابب تغيره:
التغيير اللي هتغيره فى الحالة دي انك تحط اسمك فى نهاية قايمة الأسماء فى فايل. افتح فايل اسمه "Contributors.md" بالـ text editor المفضل ليك وحط إسمك و إحفظ الفايل. بعد كدة ارجع للترمينال وأكتب الأمر دة git status الأمر دة بيظهر لك أي تغيرات حصلت في المشروع. عشان تضيف التغيرات دي للفرع بتاعك هتستخدم الأمر دا git add.
``` git add Contributors.md ```
حتى الأن انت عندك فرع فيه التغيير، عشان تبعت التغيير دة وتتمه هيتعمل على خطوتين: الأولى انك تعمل للتغيير دة اسم فهتستخدم الأمر git commit.
``` git commit -m "Add to Contributors list" ```
إستبدل <your-name> بإسمك.

##
بعدين ترفع التغييرات - Push changes to Github
هترفع التغييرات عن طريق الأمر git push
``` git push origin "add-your-name" ```
إستبدل <add-your-name> بإسم الفرع اللي انت لسة عامله .
لو عندك مشكلة وانت بتعمل push غالبا هتكون Authentication error - ### Authentication Error 
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/'

	أسهل طريقة لحل المشكلة انك تعمل ssh key وتحطه علي GitHub
	[GitHub's Tutorial - Create an ssh key](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)
   [GitHub's tutorial - adding ssh key to your account](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) 
    بكده هتكون authenticated و مش هيكون عندك مشكلة لما تعمل push 

    تقدر تتاكد انك بترفع علي الريبو الصح لما تكتب في ال 
	```bash
	git remote -v
	```
    لو ظهرلك كده:
  
origin	https://github.com/your-username/your_repo.git (fetch)
  origin	https://github.com/your-username/your_repo.git (push)

    يبقي معندكش مشكلة
	غير كده تقدر تغير ال remote address كده
  ```bash
  git remote set-url origin git@github.com:your-username/your_repo.git
  ```

سلم تغيراتك للمراجعة

في صفحة المشروع بتاعك على صفحتك الشخصية على github دوس على زرار Compare & pull request. هو ماكنش ظاهر قبل كدة.
اعمل Pull Request لدمج التغييرات
دلوقتي هتسلم طلبك لصاحب المشروع الأساسي عشان يراجع عليه، في الحالة دي الطلب بتاعك هيوصلي.
قدّم الـ Pull Request
بعد المراجعة هدمج تغيرراتك للفرع الرئيسي في المشروع. وهيتم تنبيهك عن طريق البريد الإلكتروني بدة.
لما يحصل وأقبل طلبك هتلاقي ان المشروع المنسوخ على حسابك مفيهوش التغيررات. فلازم تزامن المشروع الرئيسي باللي على حسابك بالخطوات دي:
##
طب اعمل ايه بعد كدة؟
احتفل بأول مساهمة ليك، أعمل شير مع صحابك ومتابعينك عن طريق زيارة الموقع دة.
إذا كنت ترغب في المزيد من التدريب مساهمات

يلا نخليك تبدأ تساهم في مشاريع بجد؟ عملنا قائمة بمشاريع بمشاكل بسيطة ممكن تبدأ بيها النهاردة.
## ##
لو هتستخدم ادوات تانية ممكن تتعلم من هنا
| تطبيق GitHub Desktop | فيجوال ستوديو 2017 | برنامج GitKraken | محرر VS Code | تطبيق Sourcetree | برنامج IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.en-pirate.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions 'tis hard. 'tis always hard th' first time ye do somethin'. Especially when ye be collaboratin', makin' mistakes ain't a comfortable thin'. We wanted t' simplify th' way new open-source contributors learn & contribute fer th' first time. Readin' tales & watchin' tutorials can help, but wha''s better than actually doin' th' stuff in a practice environment? This project aims at providin' guidance & simplifyin' th' way beginners make thar first contribution. If ye be lookin' t' make yer first contribution, follow th' steps below. #### *If ye're nah comfortable wit' command line, [here be tutorials usin' GUI tools.](#Tutorials-Usin'-Other-Tools)* plunder this code chest If ye don't 'ave git on yer machine, [install it](https://help.github.com/articles/set-up-git/). ## Fork this repository Fork this repo by skewerin' on th' fork button on th' top o' this page. This will create a copy o' this repository in yer account. ## Clone the repository make yer own copy o’ this treasure Now clone this repo t' yer machine. Go t' yer GitHub account, skewer on th' clone button 'n then skewer th' *copy to clipboard* icon. Open a terminal 'n run th' followin' git command: ```bash git clone "url ye jus' copied" ``` where "url ye jus' copied" (without th' quote marks) be th' url t' this repository (yer fork o' this project). See th' previous steps t' obtain th' url. snatch the map link to yer clipboard Fer example: ```bash git clone https://github.com/this-be-ye/first-contributions.git ``` where `this-be-ye` be yer GitHub username. Here ye're copyin' th' contents o' th' first-contributions repository in GitHub t' yer 'puter. ## Create a branch Change t' th' repository directory on yer 'puter (if ye be nah already thar): ```bash cd first-contributions ``` Now create a branch usin' th' `git checkout` command: ```bash git checkout -b ``` Fer example: ```bash git checkout -b add-luke-oliff ``` (Th' name o' th' branch does nah needs t' 'ave th' word *add* in it, but 'tis a reasonable thin' t' include 'cause th' purpose o' this branch be t' add yer name t' a list.) ## Make necessary changes 'n commit those changes Now open `Contributors.md` file in a text editor, add yer name t' it. Don't add it at th' beginnin' or end o' th' file. Put it anywhere in between. Now, save th' file. check the ship’s log If ye go t' th' project directory 'n execute th' command `git status`, ye'll see thar are changes. Add those changes t' th' branch ye jus' created usin' th' `git add` command: ```bash git add Contributors.md ``` Now commit those changes usin' th' `git commit` command: ```bash git commit -m "Add to Contributors list" ``` replacing `` with your name. ## Push changes t' GitHub Push yer changes usin' th' command `git push`: ```bash git push origin ``` replacin' `` wit' th' name o' th' branch ye created earlier. ## Submit yer changes fer review If ye go t' yer repository on GitHub, ye'll see a `Compare & pull request` button. Click on that button. raise a flag fer a pull request Now submit th' pull request. send yer pull request to the captain Soon I'll be mergin' all yer changes into th' master branch o' this project. Ye will get a notification email once th' changes 'ave been merged. ## Where t' go from here? Well done! Ye jus' completed th' standard _fork -> clone -> edit -> PR_ workflow that ye'll encounter often as a contributor! Celebrate yer contribution 'n share it wit' yer hearties 'n followers by goin' t' [web app](https://firstcontributions.github.io/#social-share). Now let's get ye started wit' contributin' t' other projects. We've compiled a list o' projects wit' easy issues ye can get started on. Check out [th' list o' projects in web app](https://firstcontributions.github.io/#project-list). ### [Additional material](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutorials Usin' Other Tools | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.eo.md ================================================ [![Amo al Malferma Kodo](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![Licenco: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Helpantoj de Malferma Kodo](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Unuaj Kontribuoj Estas malfacile. Iam estas malfacile la unua fojo kiam vi faras ion, speciale kiam vi kunlaboras kun aliaj, ĉar fari erarojn ne estas agrable. Nia celo estas simpligi la manieron en kiu novaj kontribuantoj de _malferma kodo_ lernas kaj kontribuas unue. Legi artikolojn kaj rigardi tutoriaojn povas helpi, sed kio estas pli bona ol fari aferojn en praktika medio? Ĉi tiu projekto celas esti gvidilo kaj simpligi la manieron en kiu komencantoj faras sian unuan kontribuon. Se vi volas fari vian unuan kontribuon, sekvu la paŝojn kiuj estas montritaj sube. #### *Se vi ne estas konata kun la komandlinio, [jen tutoriaj uzante ilojn kun Grafika Interfaco (GUI)](#Tutoriales-con-otras-herramientas)* forko de ĉi tiu deponejo Se vi ne havas git-on en via komputilo, vi povas trovi instrukciojn por instali ĝin [ĉi tie]( https://docs.github.com/es/get-started/quickstart/set-up-git ). ## Forku (*Fork*) ĉi tiun deponejon Forku ĉi tiun deponejon klakante la butonon "*Fork*" en la supraj dekstra flanko de ĉi tiu paĝo. Tio kreos kopion de ĉi tiu deponejo en via konto. ## Klono (*Clone*) la forkan deponejon kloni ĉi tiun deponejon Nun klono ĉi tiun deponejon al via komputilo. Iru al via GitHub-konto, klaku sur la butono "*clone or download*" kaj poste klaku sur la ikono por *kopii al la poŝtelefono*. Malfermu vian konsolon aŭ terminalon kaj rulu la jenan git-an komandon: ```bash git clone "url you just copied" ``` Kie estas "la URL kiun vi ĵus kopis" (sen la duobla cita signo) estas la *URL* de ĉi tiu deponejo (via fork de ĉi tiu projekto). Rigardu la antaŭajn paŝojn por akiri la *URL*-on. kopii la URL-on al la poŝtelefono Ekzemple: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` La parto kun `este-eres-tu` estos anstataŭigita per via GitHub-uzantonomo. Ĉi tie vi kopias la enhavon de la deponejo *first-contributions* de GitHub al via komputilo. ## Krei branĉon (*Branch*) Shanĝu al la dosierujo de la deponejo sur via komputilo (se vi ne jam estas tie): ```bash cd first-contributions ``` Nun kredu branĉon (*branch*) uzante la komandon `git checkout`: ```bash git switch -c your-new-branch-name ``` Ekzemple: ```bash git switch -c add-alonzo-church ``` (La nomo de la branĉo ne devas enhavi la vorton *add*, sed estas racionebla ĉar la celo de tiu ĉi branĉo estas aldoni vian nomon al la listo.) ## Faru la necesajn ŝanĝojn kaj konfirmu (*Commit*) tiujn ŝanĝojn Malfermu la dosieron `Contributors.md` en teksta redaktilo kaj aldonu vian nomon. Ne aldonu ĝin aŭ en la komenco aŭ en la fino de la dosiero, sed faru tion ie interne. Konservu la dosieron. git statuso Se vi iras al la projekta dosierujo kaj ekzekutas la komandon `git status`, vi vidos ke estas ŝanĝoj. Aldonu tiujn ŝanĝojn al la branĉo kiun vi kreis antaŭe uzante la komandon `git add`: ```bash git add Contributors.md ``` Nun konfirmu tiujn ŝanĝojn uzante la komandon `git commit`: ```bash git commit -m "Aldonu al la listo de Kontribuantoj" ``` anstataŭigu `` per via nomo. ## Puŝu (*Push*) viajn ŝanĝojn al GitHub Puŝu viajn ŝanĝojn uzante la komandon `git push`: ```bash git push -u origin your-branch-name ``` Anstataŭigu `` per la nomo de la branĉo kiun vi kreis antaŭe. ## Submetu (*Submit*) viajn ŝanĝojn por revizio Se vi iras al via deponejo en GitHub, vi vidos butonon `Compare & pull request`. Klaku sur tiu butono. krei pull request Nun sendu la *pull request*. sendi pull request Baldaŭ mi unuos viajn ŝanĝojn (faros *merge*) kun la ĉefa branĉo de tiu ĉi projekto. Vi ricevos retmesaĝon kiam la ŝanĝoj estos unuitaj. ## Kie iri de ĉi tie? Gratulojn! Vi ĵus finis la regulan _fork -> clone -> redaktu -> pull request_ fluon kiun vi ofte renkontos kiel kontribuanto! Festu vian kontribuon kaj dividiĝu kun viaj amikoj kaj sekvantoj irante al [rete apikaĵo](https://firstcontributions.github.io/#social-share). Se vi deziras pli da praktikado, rigardu [kodajn kontribuojn](https://github.com/roshanjossey/code-contributions). Nun komencu kontribui al aliaj projektoj. Ni kolektis liston de projektoj kun facilaj problemoj, por ke vi povu ekhavi. Rigardu [la liston de projektoj en la rete apikaĵo](https://firstcontributions.github.io/#project-list). ### [Plia materialo](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriaj uzante aliajn ilojn | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.es.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeras Contribuciones Es complicado. Resulta difícil la primera vez que haces algo, especialmente cuando colaboras con otros, pues cometer errores no es nada agradable. Nuestro objetivo es simplificar la forma en la que nuevos contribuidores de _código abierto_ aprenden y contribuyen por primera vez. Leer artículos y ver tutoriales puede ayudar, pero, ¿Qué mejor manera de practicar que hacer las cosas en un entorno de prácticas? Este proyecto se enfoca en guiar a principiantes durante su primera contribución. Si quieres lograr tu primera contribución, sigue los pasos que se muestran a continuación. #### *Si no estás familiarizado con la consola o terminal, [aquí hay tutoriales usando herramientas con Interfaz Gráfica (GUI)](#Tutoriales-con-otras-herramientas)* hacer un fork de este repositorio Si no tienes git en tu equipo, puedes encontrar instrucciones para instalarlo en [este enlace]( https://docs.github.com/es/get-started/quickstart/set-up-git ). ## Bifurca (*Fork*) este repositorio Haz un *fork* de este repositorio haciendo click en el botón "*Fork*" en la parte superior derecha en esta página. Esto creará una copia de este repositorio en tu cuenta. ## Clona (*Clone*) el repositorio bifurcado clonar este repositorio Ahora clona este repositorio en tu equipo. Dirígete a tu cuenta de GitHub, haz click en el botón "*clone or download*" y luego haz click en el icono para *copiar al portapapeles*. Abre tu consola o terminal y ejecuta el siguiente comando de git: ```bash git clone "url que acabas de copiar" ``` Donde pone "url que acabas de copiar" (sin las comillas dobles) es la *url* a este repositorio (tu *fork* a este proyecto). Mira los pasos previos para obtener la *url*. copiar la URL al portapapeles Por ejemplo: ```bash git clone https://github.com/este-eres-tu/first-contributions.git ``` La parte de `este-eres-tu` la reemplazarás con tu usuario de GitHub. Aquí estás copiando los contenidos del repositorio *first-contributions* de GitHub a tu equipo. ## Crea una rama (*Branch*) Cambia al directorio del repositorio en tu equipo (si es que no estás ahí ya). ```bash cd first-contributions ``` Ahora crea una rama (*branch*) usando el comando `git checkout` o `git switch`: ```bash git checkout -b git switch -c ``` Por ejemplo: ```bash git checkout -b add-alonzo-church git switch -c add-alonzo-church ``` (El nombre de la rama no tiene por qué contener la palabra *add*, pero es razonable que lo tenga porque el objetivo de esta rama es añadir tu nombre a la lista.) ## Haz los cambios necesarios y confirma (*Commit*) esos cambios Abre el archivo `Contributors.md` en un editor de texto y añade tu nombre. No lo añadas ni al principio ni al final del archivo, hazlo en cualquier otro sitio. Guarda el archivo. estado de Git Si vas al directorio del proyecto y ejecutas el comando `git status`, verás que hay cambios. Agrega esos cambios a la rama (*branch*) que creaste anteriormente usando el comando `git add`: ```bash git add Contributors.md ``` Ahora haz un *commit* sobre estos cambios ejecutando el comando `git commit`: ```bash git commit -m "Add to Contributors list" ``` Cambiando `` por tu nombre. ## Sube (*Push*) tus cambios a GitHub Haz *push* de tus cambios usando el comando `git push`: ```bash git push -u origin ``` Reemplaza `` con el nombre de la rama que creaste anteriormente. ## Envía (*Submit*) tus cambios para ser revisados Si vas a tu repositorio en GitHub, verás un botón `Compare & pull request`. Haz click sobre el botón. crear una pull request Ahora envía la *pull request*. enviar la pull request Pronto estaré fusionando tus cambios (haciendo *merge*) con la rama master de este proyecto. Recibirás una notificación por correo electrónico cuando los cambios hayan sido fusionados. ## ¿Cuáles son los siguientes pasos? ¡Enhorabuena! ¡Has completado el flujo de trabajo *_fork -> clone -> edit -> PR_* que encontrarás habitualmente como contribuidor! Celebra tu contribución y compártela con tus amigos y seguidores yendo a [web app](https://firstcontributions.github.io/#social-share). Si quieres más práctica, echa un vistazo a [contribuciones de código](https://github.com/roshanjossey/code-contributions). Ahora empieza a contribuir en otros proyectos. Hemos reunido una lista de proyectos con *issues* sencillas para que puedas empezar. Échale un ojo a la [lista de proyectos en la aplicación web](https://firstcontributions.github.io/#project-list). ### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriales con otras herramientas | Aplicación GitHub Desktop | Visual Studio 2017 | Programa GitKraken | Editor VS Code | Aplicación Sourcetree | Programa IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.ewe.md ================================================ [![kɔmpiutaɖoɖo femaxee ƒe Lɔlɔ̃](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Kpekpeɖeŋu Gbãtɔ Esesẽna ɣesiaɣi ne èwɔ nane zi gbãtɔ.Vɔvɔ̃ be yeawɔ vodadawo meɖea dzi ɖi kura o, vevietɔ ne èle nu wɔm aduadu.Gake kɔmpiutadziɖoɖo siwo wozãna faa ƒe xexeame ku ɖe nuwɔwɔ aduadu kple dɔwɔwɔ le ƒuƒoƒo me ŋu.Azɔ hã, míedi be míana wòanɔ bɔbɔe na kɔmpiutadziɖoɖo yeye siwo tsɔa nu faa femaxee la be woasrɔ̃ nu to alesi nàdzɔ nu zi gbãtɔ la fiafia wò me. Nyatiwo kple nufiamewo xexlẽ ate ŋu akpe ɖe ŋuwò, gake nukae nyo wu be nàdze agbagba eye màte ŋu awɔ vodada o? Dɔ sia ƒe taɖodzinue nye be wòana mɔfiame eye wòana alesi dɔsrɔ̃viwo wɔa woƒe nudzɔdzɔ gbãtɔ nanɔ bɔbɔe.Ðo ŋku edzi be: zi alesi nèfa tu la, zi nenemae nèsrɔ̃a nu nyuie wu.Ne èdi vevie be yeadzɔ nu gbãtɔ la, ɖeko nàwɔ ɖe afɔɖeɖe siawo dzi.Medo ŋugbe be anye modzakaɖeɖe. Wɔ nudzraɖoƒe sia ƒe kɔpi Ne git mele wò kɔmpiuta dzi o, [ tsɔe de wò kɔmpiuta dzi ]( https://help.github.com/articles/set-up-git/ ). ## Miɖe asi le agbalẽdzraɖoƒe sia (si woyɔna hã be Fork) . Ne èdi be yeaʋu agbalẽvi sia la, zi dzi le aɖaka si nye "Fork" si le axa la ƒe tame. Esia ana be woaŋlɔ nyatakaka siwo le nyatakakadzraɖoƒea ɖe wò asitelefon dzi. ## Wɔ numekugbalẽvi sia ƒe kɔpi Kɔpi nudzraɖoƒe sia Azɔ wɔ agbalẽdzraɖoƒe sia ƒe nɔnɔmetata ɖe wò kɔmpiuta dzi. Zi clone ƒe dzesi dzi emegbe nàzi dzesi la dzi *kɔpi ɖe agbalẽƒomɔ̃ me*. Ʋu kpovitɔ eye nàzã git se siwo gbɔna : ```bash git clone "url si nèwɔ kɔpi na fifia" ``` afisi "url si nèwɔ kɔpi teti koe nye ema" (si me nyayɔyɔawo mele o) nye url si le agbalẽdzraɖoƒea. Kpɔ akpa si do ŋgɔ be nàxɔ url la. Kɔpi URL la ɖe clipboard me Le kpɔɖeŋu me : ```bash git clone https://github.com/wò-ŋkɔ-si-nèzãna/first-contributions.git ``` afisi `Wò ŋkɔ si nèzãna` nye wò GitHub zãla ƒe ŋkɔ. Afisiae nèle nusiwo le agbalẽdzraɖoƒea ƒe kɔpi wɔm le `first-contributions` tso GitHub dzi le wò kɔmpiuta dzi. ## Wɔ alɔdzedɔwɔƒe aɖe Ʋu yi dɔwɔwɔ ƒe nɔnɔmetata yeye si wowɔ ƒe nɔnɔmetata me (ne mèle afima haɖe o): ```bash cd first-contributions ``` Azɔ wɔ alɔdze aɖe kple sededea `git checkout` : ```bash git checkout -b ``` Le kpɔɖeŋu me : ```bash git checkout -b add-abdou-raouf-atarmla ``` (Mehiã be nya *add* nanɔ alɔdzedɔwɔƒea ƒe ŋkɔ me o, gake esɔ be nàde eme elabena taɖodzinu si le alɔdze sia ŋue nye be wòatsɔ wò ŋkɔ akpe ɖe xexlẽdzesi aɖe ŋu.) ## Wɔ tɔtrɔ siwo hiã eye nàtsɔ wo ana Azɔ ʋu nuŋlɔɖia `Contributors.md` de wò ŋkɔ ɖe etame eye nàŋlɔe ɖi. Git ƒe nɔnɔme Ne èʋu sedede ƒe nyatakakadzraɖoƒea eye nèwɔ sededea `git status`, àkpɔe be tɔtrɔwo li. Tsɔ tɔtrɔ siawo kpe ɖe alɔdze si nèwɔ fifia kple sededea ŋu `git add` : ```bash git add Contributors.md ``` Azɔ wɔ tɔtrɔ siawo kple sededea `git commit`: ```bash git commit -m "Tsɔ kpe ɖe Nudzɔlawo ƒe xexlẽdzesi ŋu" ``` tsɔ wò ŋkɔ ɖɔli ``. ## Tu tɔtrɔwo ɖe GitHub dzi Tu wò tɔtrɔwo kple sededea `git push` : ```bash git push origin ``` tsɔ alɔdze si wowɔ va yi ƒe ŋkɔ ɖɔli ``. ## Miɖo miaƒe tɔtrɔwo ɖa be woalé ŋku ɖe wo ŋu Ne èyi wò nudzraɖoƒe le Github la, àkpɔ `Compare & pull request` ƒe dzesi. Zi dzesi sia dzi. Wɔ Pull Request aɖe Azɔ tsɔ hehe ƒe biabiaa ɖo ɖa. Ɖo Pull Request la ɖa Eteƒe madidi o, maƒo miaƒe tɔtrɔwo katã nu ƒu ɖe dɔ sia ƒe alɔdze vevitɔ me. Àxɔ nyatakaka to e-mail dzi ne wonya wu ƒoƒo ɖekae nu ko. Womatrɔ asi le miaƒe alɔdzedɔwɔƒea ƒe alɔdzedɔwɔƒe gãtɔ ŋu le ɣeyiɣi sia me o. Be wò spur nawɔ ɖeka kple tɔnye la, wɔ ɖe afɔɖeɖe siawo dzi. ## Na wò alɔdzedɔwɔƒea nawɔ ɖeka kple nyatakakadzraɖoƒe sia Gbã la, trɔ ɖe alɔdzedɔwɔƒe gã la ŋu (main) ```bash git checkout main ``` Eye nàtsɔ nye nyatakakadzraɖoƒe ƒe ka akpee be `upstream remote url` : ```bash git remote add upstream https://github.com/Roshanjossey/first-contributions ``` Esia nye mɔ si dzi míetona gblɔna be nu bubu aɖe hã li si le míaƒe nyatakakadzraɖoƒea si míeyɔna be `upstream`. Ne tɔtrɔawo va wɔ ɖeka ko la, di nye numekuku ƒe akpa yeyea: ```bash git fetch upstream ``` Afisiae míele tɔtrɔwo katã dim le nye alɔdzedɔwɔƒe (upstream remote) me. Fifia ele be nàƒo tɔtrɔ yeye si tso nye agbalẽdzraɖoƒea nu ƒu ɖe wò alɔdze gã la me: ```bash git rebase upstream/main ``` Le afisia la, míewɔa tɔtrɔ siwo katã dim nènɔ la ŋudɔ le alɔdzedɔwɔƒe gã la me. Ne ètu alɔdze gã la fifia la, tɔtrɔ siawo hã anɔ wò fɔkpaa ŋu: ```bash git push origin main ``` Nuxlɔ̃ame: Fifia ya èle tutum ayi adzɔge ʋĩ ƒe nyatakakadzraɖoƒe si woyɔna be origin. Le afisia la, metsɔ wò `` alɔdzedɔwɔƒea ƒo ƒu kple nye alɔdze gãtɔ, eye nètsɔ nye alɔdze gã la ƒo ƒu kple wò alɔdze gãtɔ. Wò `` alɔdze megahiã o, eyata àteŋu atutue: ```bash git branch -d ``` eye àte ŋu atutu eƒe tɔtrɔ le adzɔge ʋĩ ƒe nyatakakadzraɖoƒe hã: ```bash git push origin --delete ``` Esia mehiã o, gake alɔdzedɔwɔƒea ƒe ŋkɔ ɖee fia be eƒe taɖodzinua nye nu si le vevie. Eƒe agbenɔɣi ate ŋu anɔ kpuie. ## Nufiame siwo zãa dɔwɔnu bubuwo | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ## Afikae míayi emegbe? Àte ŋu awɔ ɖeka kple míaƒe ƒuƒoƒoa hã le Slack nenye be èhiã kpekpeɖeŋu alo nyabiase aɖewo le asiwò. [Wɔ ɖeka kple ƒuƒoƒoa le Slack dzi](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) ================================================ FILE: docs/translations/README.fa.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions)

# اولین مشارکت این پروژه قصد دارد تا مسیر مشارکت در پروژه‌های متن‌باز را برای تازه‌کارها آسان نماید. اگر شما نیز به دنبال راهی برای ثبت اولین مشارکت خود هستید، این اقدامات را دنبال کنید. _اگر با محیط کامندی (CLI) احساس راحتی نمی‌کنید، [راهنمای استفاده از ابزارهای گرافیکی (GUI) را مشاهده کنید](#آموزش-انجام-مشارکت-در-دیگر-ابزارها)._ فورک کردن این مخزن #### اگر نرم‌افزار git را آماده ندارید، [از اینجا نصب کنید](https://help.github.com/articles/set-up-git/). ## مخزن را فورک کنید با کلیک کردن بر روی دکمه Fork، از مخزن مورد نظر یک انشعاب بگیرید. این عملیات یک نسخه کپی از مخزن را بر روی حساب کاربری شما ایجاد می‌کند. ## مخزن را کلون (شبیه) کنید کلون کردن این مخزن حال، از مخزن فورک شده، یک کلون روی سیستم کاربری خود ایجاد کنید. وارد حساب کاربری خود شده و مخزن فورک شده را باز کنید. دکمه Code را فشرده و نماد copy to clipboard را انتخاب کنید. سپس یک ترمینال باز کنید و دستور گیت زیر را اجرا نمایید: ```bash git clone "url you just copied" ``` بطوری که در قسمت "url you just copied"، آدرس مخزن فورک شده بدون علامت‌های کوتیشن (نقل قول) قرار گیرد. کپی URL در کلیپ‌بورد بعنوان مثال: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` به طوری که عبارت `this-is-you` برابر با نام حساب کاربری گیت‌هاب شما باشد. با این اقدام، تمام محتوای مورد نیاز جهت مشارکت را بر روی سیستم خود آماده می‌سازید. ### یک شاخه ایجاد کنید اگر در مسیر مخزن کلون شده قرار ندارید، با دستور زیر وارد مسیر مخزن شوید: ```bash cd first-contributions ``` با استفاده از دستور `git checkout` یک شاخه جدید ایجاد کنید: ```bash git checkout -b your-new-branch-name ``` بعنوان مثال: ```bash git checkout -b add-alonzo-church ``` (هیچ لزومی نیست که در نام شاخه از کلمه `add` استفاده کنید. چنانچه قرار است بعنوان مشارکت، نام خود را به یک لیست اضافه کنیم، استفاده از این کلمه بعنوان نام شاخه، امری عاقلانه می‌باشد.) ### تغییرات اساسی ایجاد کرده و کامیت کنید در این قدم، ابتدا فایل `Contributors.md` را در یک محیط ویرایش متن باز کنید. نام خود را به این فایل اضافه کنید. توجه کنید که نام نه در ابتدا و نه در انتها قرار گیرد. نام را بین اسامی قرار دهید. فایل را ذخیره کنید. وضعیت گیت چنانچه وارد مسیر مخزن شوید و دستور `git status` را اجرا نمایید، مشاهده خواهید کرد که تغییراتی بر روی مخزن اعمال شده. با استفاده از دستور `git add`، تغییرات را به برنچ از پیش ساخته‌شده اضافه کنید: ```bash git add Contributors.md ``` حال، تغییرات را با دستور `git commit` کامیت و ثبت نمایید: ```bash git commit -m "Add to Contributors list" ``` توجه داشته باشید که نام خود را با عبارت `` جایگزین کنید. ## تغییرات را ارسال (پوش) کنید با استفاده از دستور `git push` تغییرات ثبت شده را ارسال کنید: ```bash git push origin ``` نام برنچی که در مراحل قبل ایجاد کردید را با عبارت `` جایگزین کنید. ## تغییرات خود را برای بررسی، ثبت کنید چنانچه وارد مخزن فورک شده در حساب کاربری خود شوید، گزینه‌ای تحت عنوان `Compare & pull request` مشاهده خواهید کرد. آن گزینه را انتخاب کنید. ایجاد یک درخواست کشش در این مرحله، درخواست (Pull request) خود را ثبت کنید. ثبت درخواست کشش نهایتا، من تغییرات شما را به برنچ master پروژه اضافه (merge) خواهم کرد. بلافاصله پس از مرج شدن درخواست شما، یک ایمیل مبنی بر همین موضوع برای شما ارسال خواهد شد. ## اقدامات بعدی تبریک! شما مراحل فورک کردن، کلون کردن، ایجاد تغییرات و پول رکوئست را به خوبی پشت سر گذاشتید. مشارکت خود روی این پروژه را [از اینجا](https://firstcontributions.github.io/#social-share) با دیگر دوستان و دنبال‌کنندگان خود جشن بگیرید. حال، شما می‌توانید مشارکت خود را روی دیگر پروژه‌ها آغاز نمایید. ما یک لیست از پروژه‌ها با مشکلات ساده ایجاد کردیم که گزینه خوبی برای شروع می‌باشد. لیست پروژه‌ها را [از این اینجا](https://firstcontributions.github.io/#project-list) دنبال کنید. ### [اطلاعات بیشتر](additional-material/git_workflow_scenarios/additional-material.md) ## آموزش انجام مشارکت در دیگر ابزارها | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |

================================================ FILE: docs/translations/README.fi.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Ensimmäiset kontribuutiot Se on vaikeaa. Ensimmäiset kerrat ovat aina vaikeita. Etenkin tehdessä yhteistyötä, virheiden teko ei ole ollenkaan mukavaa. Me halusimme yksinkertaistaa tavan jolla avoimen lähdekoodin kontribuoijat oppivat sekä kontribuoivat ensimmäistä kertaa. Artikkeleiden lukeminen sekä tutoriaalien katsominen voi auttaa, mutta mikä onkaan parempaa kuin käytännön harjoite harjoitusympäristössä? Tämä projekti tähtää avun tarjoamiseen sekä aloittelijoiden ensimmäisen kontribuution yksinkertaistamiseen. Jos olet aikeissa kontribuoida ensimmäistä kertaa, seuraa alla olevia ohjeita. #### *Jos et osaa käyttää komentoriviä sulavasti, [täältä löytyy tutoriaaleja GUI-työkalujen käyttöön.](#Muiden-työkalujen-tutoriaaleja)* forkkaa tämä repositorio Jos sinulla ei ole git asennettuna koneellesi, [asenna se](https://help.github.com/articles/set-up-git/). ## Forkkaa tämä repositorio Forkkaa tämä repositorio klikkaamalla yläkulmassa näkyvää painiketta "Fork". Tämä luo kopion tästä repositoriosta käyttäjällesi. ## Kloonaa repositorio kloonaa tämä repositorio Seuraavaksi kloonaa juuri forkkaamasi repositorio koneellesi. Mene GitHub käyttäjäsivuillesi, avaa forkkaamasi repositorio sekä klikkaa "Clone or download"-painiketta jonka jälkeen kopioi osoite painamalla "Copy to clipboard"-ikonia. Avaa komentorivi ja syötä seuraava git-komento: ```bash git clone "Juuri kopioimasi URL" ``` "Juuri kopioimasi URL"-tekstin sijasta (ilman lainausmerkkejä) pastea repositorion URL äskeisestä vaiheesta. kopioi URL leikepöydälle Esimerkiksi: ```bash git clone https://github.com/nimesi/first-contributions.git ``` Kirjoita GitHub-käyttäjänimesi 'nimesi' teksin sijaan. Tämä komento kopioi sisällön GitHubisi first contributions-repositorion koneellesi. ## Luo branch Mene repositoriosi kansioon koneellasi (ellet jo ole siellä). ```bash cd first-contributions ``` Seuraavaksi luo branch komennolla `git checkout`: ```bash git checkout -b ``` Esimerkiksi: ```bash git checkout -b add-matti-meikalainen ``` (Branchin nimeen ei välttämättä tarvitse sisällyttää sanaa *add*, mutta tässä se käy järkeen sillä tämän branchin tarkoitus on lisätä nimesi listaan.) ## Tee tarvittavat muutokset sekä committoi ne Seuraavaksi avaa `Contributors.md` tiedosto tekstieditorissa ja lisää nimesi tiedostoon. Älä lisää sitä tiedoston alkuun taikka loppuun vaan keskelle. Seuraaksi tallenna tiedosto. git status -komento Jos menet projektin kansioon ja syötät komennon `git status`, näet muutokset. Lisää nuo muutokset branchiin `git add` komennolla: ```bash git add Contributors.md ``` Seuraavaksi committoi muutokset `git commit` komennolla: ```bash git commit -m "Add to Contributors list" ``` Korvaamalla `` nimelläsi. ## Muutosten pushaaminen GitHubiin Pushaa muutoksesi komennolla `git push`: ```bash git push origin ``` Korvaamalla `` nimellä jonka annoit branchillesi aikaisemmin. ## Jätä muutoksesi arvosteltavaksi Jos menet repositorioosi GitHubissa, näet `Compare & pull request` painikkeen. Paina tuota painiketta. luo pull request Seuraavaksi suorita pull request. lähetä pull request Seuraavaksi mergeän muutoksesi tämän projektin master-branchiin. Tulet saamaan ilmoituksen sähköpostiisi kun muutokset ovat mergetty. ## Mihin seuraavaksi? Onneksi olkoon! Olet juuri suorittanut tavanomaisen *Fork -> Clone -> Edit -> Pull Request* -työnkulun joka tulee vastaasi usein kontribuoijana! Juhlista kontribuutiotasi ja jaa se ystävillesi ja followereillesi menemällä [Web Appiin](https://firstcontributions.github.io/#social-share). Jos haluaisit kontribuoida muihin projekteihin, me olemme koonneet listan yksinkertaisista ensimmäisistä issueista työskenneltäväksesi. [Lista löytyy Web-Appistamme](https://firstcontributions.github.io/#project-list). ### [Lisämateriaaleja](../additional-material/git_workflow_scenarios/additional-material.md) ## Muiden työkalujen tutoriaaleja | GitHub Desktop -sovellus | Visual Studio 2017 | GitKraken-ohjelma | VS Code -editori | Sourcetree-sovellus | IntelliJ IDEA -ohjelma | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.fil.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Mga Unang Kontribusyon Makakatulong ang proyektong ito na gawing mas simple at magsilbing gabay sa paggawa ng mga gustong magbigay ng kanilang unang kontribusyon. Kung gusto magkaroon ng unang kontribusyon, sundin ang mga hakbang sa ibaba. _Kung hindi ka komportable sa paggamit ng command line, [narito ang mga tutorial gamit ang GUI tool.](#tutorials-using-other-tools)_ i-fork ang repository na ito #### Kung wala kang Git sa iyong computer, [i-install ito](https://docs.github.com/en/get-started/quickstart/set-up-git). ## I-fork ang repository ito I-fork ang repository na ito sa pamamagitan ng pag-click sa _fork button_ sa kanang itaas ng page na ito. Gagawa ito ng kopya ng _repository_ sa iyong _account_. ## I-clone ang _repository_ i-clone ang repository na ito Ngayon, i-clone ang _forked repository_ sa iyong _computer_. Pumunta sa iyong _GitHub account_, buksan ang _forked repository_, i-click ang _code button_ at pagkatapos ay i-click ang _copy to clipboard_ icon. Magbukas ng terminal at patakbuhin ang sumusunod na git command: ```bash git clone "url na kakakopya mo lang" ``` ang "url na kakakopya mo lang" (tanggalin ang "") ay ang url ng iyong _forked repository_.Tingnan ang mga nakaraang hakbang para makuha ang url. kopyahin ang URL sa clipboard Halimbawa: ```bash git clone https://github.com/username/first-contributions.git ``` ang `username` ay ang iyong GitHub username. Dito mo napunta ang mga laman ng kinopya mong _repository_ ng mga unang kontribusyon sa GitHub sa iyong _computer_. ## Gumawa ng _branch_ Pumunta sa _directory_ ng _repository_ sa iyong _computer_ (kung wala ka pa roon, i-type ito sa _terminal_): ```bash cd first-contributions ``` Ngayon, gumawa ng isang _branch_ gamit ang _command_ na `git switch`: ```bash git switch -c pangalan-ng-branch ``` Halimbawa: ```bash git switch -c add-juan-delacruz ``` ## Ilagay ang mga gusto mong baguhin sa _repository_ Ngayon, buksan ang `Contributors.md` _file_ sa isang _text editor_ at idagdag ang iyong pangalan (maaari mong gayahin na lang ang gawa ng iba). Iwasang ilagay ito sa pinaka-simula o dulo ng _file_. Ilagay ito kahit saan sa gitna ng _file_. I-save ang _file_ kapag nailagay na. git status Kung pupunta ka sa _directory_ ng proyekto at i-type ang _command_ na `git status`, makikita mo yung mga nabago mo sa `Contributors.md`. Idagdag ang mga _file_ na nabago mo sa _branch_ na ginawa mo kanina gamit ang _command_ na `git add`: ```bash git add Contributors.md ``` I-commit ang mga _files_ na iyon gamit ang _command_ na `git commit`: ```bash git commit -m "Add iyong-pangalan to Contributors list" ``` ## I-push ang mga _files_ na _nabago_ sa GitHub I-push ang mga nabago mong _files_ gamit ang command na `git push`: ```bash git push -u origin pangalan-ng-branch ``` Ang `pangalan-ng-branch` ay pangalan ng branch na ginawa mo kanina.
Kung nagkaroon ng error habang nag-pupush, i-click ito: - ### Error sa Pagpapatunay 
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//first-contributions.git/'
Pumunta sa [tutorial ng GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) sa paggawa at pag-configure ng SSH key sa iyong account.
## I-submit ang mga binago mo para mareview Kung pupunta ka sa iyong _forked repository_ sa GitHub, makikita mo yung button na `Compare & pull request`. I-click mo iyon. gumawa ng pull request Ngayon, baguhin ang ilang _checkboxes_ sa _description textarea_, at i-submit ang _pull request_. ipasa ang pull request Ime-merge ko ang lahat ng mga nabago mo sa _main branch_ ng proyektong ito. Makakatanggap ka ng _email notification_ kapag na-merge ko na ito. ## Saan na pagkatapos? Congrats! Nakumpleto mo lang ang karaniwang _fork -> clone -> edit -> pull request_ workflow na madalas mong gagamitin bilang isang _contributor_! Ipakita ang iyong kontribusyon sa iyong mga kaibigan at tagasubaybay at magpunta sa [web app](https://firstcontributions.github.io/#social-share). Kung gusto mo pang magsanay, tingnan ang [code contributions](https://github.com/roshanjossey/code-contributions). Ngayon, pwede ka nang gumawa ng kontribusyon sa iba pang mga proyekto! Gumawa kami ng isang listahan ng mga proyekto na may mga madadaling gawing _issues_ na pwede mong gawin. Tingnan ang [listahan ng mga proyekto sa web app](https://firstcontributions.github.io/#project-list). ### [Karagdagang materyal](additional-material/git_workflow_scenarios/additional-material.md) ## Mga Tutorial Gamit ang Iba Pang Mga Tool | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.fr.md ================================================ [![L'amour du logiciel libre](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Premières Contributions C'est toujours compliqué la première fois que l'on fait quelque chose. La peur de faire des fautes n'est pas du tout confortable, spécialement quand vous collaborez. Mais le monde du logiciel libre est le fait de collaborer et de travailler en groupe. Aussi, nous voulons simplifier l'apprentissage des nouveaux contributeurs au logiciel libre en vous enseignant à contribuer pour la première fois. Lire des articles et des tutoriels peut aider, mais qu'y a-t-il de mieux que d'essayer sans pouvoir faire d'erreurs ? Ce projet a pour ambition de fournir des conseils et simplifier la manière dont les apprentis font leur première contribution. Souvenez-vous : plus vous êtes serein, mieux vous apprenez. Si vous aspirez à faire votre première contribution, suivez tout simplement les étapes suivantes. Promis, ce sera amusant. Dupliquez ce dépôt sur votre compte GitHub Si vous n'avez pas encore Git installé sur votre machine, [ installez-le ](https://help.github.com/articles/set-up-git/). ## Faire un fork de ce dépôt Forkez ce dépôt en cliquant sur le bouton _fork_ en haut de cette page. Cela créera une copie de ce dépôt dans votre propre compte GitHub ## Clonez ce répertoire Clonez ce dépôt sur votre ordinateur Maintenant, clonez ce répertoire sur votre ordinateur. Allez sur votre compte GitHub, ouvrez le dépôt forké, cliquez sur le bouton _Code_, puis sur l’onglet _SSH_ et enfin sur l’icône _copier dans le presse-papiers_. Ouvrez une invite de commande (si vous êtes sous Windows) ou un terminal (si vous êtes sous MacOS ou Linux) et exécutez la commande git suivante : ```bash git clone "l'url que vous venez de copier" ``` où "l'url que vous venez de copier" (sans les guillemets) est l'url du dépôt forké. Revoir les étapes précédentes pour obtenir l’URL exacte. Copiez l'URL dans le presse-papiers Par exemple : ```bash git clone https://github.com/votre-nom-d-utilisateur/first-contributions.git ``` où `votre-nom-d-utilisateur` est votre nom d'utilisateur GitHub. Ici vous êtes en train de copier le contenu du dépôt `first-contributions` depuis GitHub sur votre ordinateur. ## Créez une branche Déplacez-vous dans le répertoire du projet nouvellement cloné (si vous n'y êtes pas encore) : ```bash cd first-contributions ``` Maintenant créez une branche avec la commande `git checkout` : ```bash git checkout -b ``` Par exemple : ```bash git checkout -b add-koffi-sani ``` (Le nom de la branche n'a pas besoin de contenir le terme _add_, mais il est mieux de l'inclure car l'objectif de cette branche est d'ajouter votre nom à une liste.)
Si vous rencontrez une erreur avec git switch, cliquez ici : Si le message "Git: switch is not a git command. See git –help" s’affiche, c’est probablement parce que vous utilisez une ancienne version de Git. Dans ce cas, essayez plutôt : ```bash git checkout -b nom-de-ta-nouvelle-branche ```
## Effectuez les modifications nécessaires et enregistrez-les Ouvrez le fichier `Contributors.md` dans un éditeur de texte, ajoutez-y votre nom, et enregistrez-le. Ne l’ajoutez pas au début ou à la fin du fichier, mais quelque part au milieu. Sortie de la commande git status Si vous ouvrez l'invite de commande et que vous exécutez la commande `git status`, vous verrez qu'il y a des modifications. Ajoutez ces modifications à la branche que vous venez de créer avec la commande `git add` : ```bash git add Contributors.md ``` Maintenant faites un commit de ces modifications avec la commande `git commit`: ```bash git commit -m "Add to Contributors list" ``` en remplaçant `` par votre nom. ## Envoyez les modifications vers GitHub Poussez vos modifications avec la commande `git push` : ```bash git push -u origin ``` en remplaçant `` avec le nom de la branche précédemment créée.
Si tu obtiens une erreur au moment de pousser, clique ici : - ### Erreur d’authentification 
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//first-contributions.git/'
Suivez le tutoriel GitHub pour générer et configurer une clé SSH sur votre compte. Vous pouvez également exécuter git remote -v pour vérifier votre adresse distante. Si elle ressemble à ceci : 
origin https://github.com/ton-nom-utilisateur/ton_repo.git (fetch) origin https://github.com/ton-nom-utilisateur/ton_repo.git (push)
Modifiez-la avec cette commande : ```bash git remote set-url origin git@github.com:ton-nom-utilisateur/ton_repo.git ``` Sinon, vous continuerez de devoir entrer votre mot de passe et vous obtiendrez une erreur d’authentification.
## Soumettez votre contribution pour révision Si vous vous rendez sur votre répertoire sur Github, vous verrez un bouton `Compare & pull request`. Cliquez dessus. Créer une pull request Soumettez ensuite la _pull request_. Soumettre une pull request Je fusionnerai bientôt vos modifications dans la branche principale du projet. Vous recevrez un e-mail de confirmation une fois que ce sera fait. La branche main de votre dépôt forké ne subira pas de modification. Pour que votre dépôt soit synchronisé avec le mien, suivez les étapes suivantes. ## Gardez votre embranchement synchronisé avec ce répertoire D'abord, basculez sur la branche main ```bash git checkout main ``` Et ajouter l'url de mon répertoire comme `upstream remote url` : ```bash git remote add upstream https://github.com/Roshanjossey/first-contributions ``` Ceci est une manière de dire à git qu'une autre version de ce répertoire existe à l'adresse spécifiée et que nous l'appelons `upstream`. Une fois les modifications fusionnées, cherchez la nouvelle version de mon répertoire : ```bash git fetch upstream ``` Ici nous cherchons toutes les modifications dans mon embranchement (upstream remote). Maintenant, vous devez fusionner la nouvelle révision de mon répertoire avec votre branche main : ```bash git rebase upstream/main ``` Ici nous appliquons toutes les modifications que vous avez récupéré à la branche main. Si vous poussez la branche main maintenant, votre embranchement aussi aura les modifications : ```bash git push origin main ``` Avertissement: Cette fois, vous poussez les modifications au répertoire distant appelé origin. A cet instant j'ai fusionné votre branche `` avec ma branche main, et vous avez fusionné ma branche main avec votre branche main. Votre branche `` n'est plus utile, donc vous pouvez la supprimer : ```bash git branch -d ``` et vous pouvez supprimer sa version dans le répertoire distant aussi : ```bash git push origin --delete ``` Ceci n'est pas nécessaire, mais le nom de la branche montre que son objectif est assez spécifique. Sa durée de vie peut être courte. ## Tutoriels en utilisant d'autres outils | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ## Où aller ensuite ? Si vous souhaitez contribuer au code, consultez notre [dépôt GitHub de contributions au code](https://github.com/roshanjossey/code-contributions). ================================================ FILE: docs/translations/README.ga.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Tosaíonn Céad Cuireadh Is é aidhm an tionscadail seo a bheith simplí agus treoraithe don tslí a ndéanann túsóirí a gcéad chuimsithe. Más mian leat do chéad chuimsiú a dhéanamh, lean na céimeanna thíos. _Más rud é nach bhfuil tú compordach leis an líne smachta, [tá tutóirialanna anseo ag baint úsáide as uirlisí GUI](#tutorials-using-other-tools)_ foirceann an stór seo #### Mura bhfuil git ar do mhaisín agat, [suiteáil é](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Foirgneamh an repositry a shábháil Foirgneamh an repositry seo trí ghrúpaigh air a dhéanamh. Cliceáil ar an gcnaipe foirgneamh atá ar bharr an leathanaigh seo. Cruthóidh sé cóip d'an repositry seo in do chuntas féin. ## Clónaigh an repositry clónaigh an stór seo Anois, clónaigh an repositry ghrúpaithe chuig do mhaisín. Téigh go dtí do chuntas GitHub, oscail an repositry ghrúpaithe, cliceáil ar an gcnaipe cód agus ansin _cliceáil ar an íomhá ghlactha_ chuig an ghluais cóipchlibeaird. Oscail tearma agus rith an t-ordú git seo a leanas: ```bash git clone "url a ghlac tú amach" ``` Mar sin "url a ghlac tú amach" (gan na tréimhseanna quoitimh) is ea url chuig an repositry seo (do ghruapa den tionscadal seo). Féach ar na céimeanna roimhe sin chun an url a fháil. cóipeáil an URL go dtí an ghearrthaisce Mar shampla: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` Ait a bhfuil `this-is-you` is t-ainm úsáideora GitHub. Anseo atá tú ag cóipeáil ábhar repositry first-contributions ar GitHub chuig do ríomhaire. ## Cruthaigh snáth Athraigh go dtí comhad repositry ar do ríomhaire (mura bhfuil tú ansin cheana): ```bash cd first-contributions ``` nois cruthaigh snáth ag baint úsáide as an comhad `git switch`: ```bash git switch -c your-new-branch-name ``` Mar shampla: ```bash git switch -c add-alonzo-church ``` ## Déan na hathruithe riachtanacha agus déan comhaireamh orthu Anois, oscail `Contributors.md` i eagarthóir téacs, cuir do ainm leis. Ná cuir é ag tús ná ag deireadh an chomhad. Cuir é in aon áit ina lár. Ansin, sábháil an comhad. stádas git Más téann tú go dtí comhaid tionscadail agus déanann tú an t-ordú `git status`, feicfidh tú go bhfuil athruithe ann. Cuir na hathruithe sin leis an snáth a chruthaigh tú leis an gcnaipe `git add`: ```bash git add Contributors.md ``` Ansin déan comhaireamh orthu leis an gcnaipe `git commit`: ```bash git commit -m "Add your-name to Contributors list" ``` agus cuir in áit do ainm in ionad `your-name`. ## Seol athruithe chuig GitHub Seol do chuid athruithe ag baint úsáide as an gcnaipe `git push`: ```bash git push -u origin your-branch-name ``` agus cuir `your-branch-name` do snátha a chruthaigh tú roimhe seo.
Má fhaigheann tú botúin ar bith le linn an athsheoladh, cliceáil anseo: - ### Authentication Error 
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//first-contributions.git/'
Go to [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account.
## Cuimhnigh ort do chuid athruithe a chur chun athbhreithnithe Má téann tú go dtí do repositry ar GitHub, feicfidh tú cnaipe `Compare & pull request`. Cliceáil ar an gcnaipe sin. cruthaigh iarratas tarraingthe Ansin cuir isteach an iarratas athbhreithnithe. cuir isteach iarratas tarraingthe Go luath beidh mé ag méascadh na hathruithe uile atá déanta agat isteach i mbranca príomh an tionscadail seo. Beidh ríomhphost fógra agat nuair a bheidh na hathruithe comhoiriúnaithe. ## Cá háit a leantú as seo amach? Comhghairdeas! Chríochnaigh tú an tslí ríthábhachtach _fork -> clone -> edit -> pull request_ iarratas ar athbhreithniú a bhíonn ag tionscalóirí go minic! Ceiliúraigh do chionta agus roinne é le do chairde agus le do leanúnaigh trí dul go dtí an aip ghréasáin. [web app](https://firstcontributions.github.io/#social-share). Más mian leat níos mó cleachtas, seiceáil. [code contributions](https://github.com/roshanjossey/code-contributions). Anois, lig dúinn tú a thosú ag tacú le tionscadail eile. Tá liosta againn de thionscadail le faidhéideanna éasca a d'fhéadfá tosú orthu. Féach ar liosta na dtionscadal san aip ghréasáin. Anois, lig dúinn tú a thosú ag tacú le tionscadail eile. Tá liosta againn de thionscadail le faidhéideanna éasca a d'fhéadfá tosú orthu. Féach ar [liosta na dtionscadal san aip ghréasáin](https://firstcontributions.github.io/#project-list). ### [Ábhar Breise](additional-material/git_workflow_scenarios/additional-material.md) ## Tutóirialanna Ag Úsáid Uirlisí Eile | Clár Deisce GitHub | Visual Studio 2017 | Clár GitKraken | Eagarthóir VS Code | Feidhmchlár Sourcetree | Clár IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Clár Deisce GitHub](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [Clár GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Eagarthóir VS Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Feidhmchlár Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [Clár IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) |

Tugann tacaíocht don tionscadal seo::

================================================ FILE: docs/translations/README.ge.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # პირველი კონტრიბუცია ახალი რამის პირველად, დამოუკიდებლად, გაკეთება შეიძლება საკმაოდ რთული აღმოჩნდეს. მითუმეტეს, თუ უცხოებთან თანამშრომლობ და შეცდომების დაშვება არცთუ ისე კარგი გრძნობაა. ჩვენ გვინდოდა დამწყები ოფენ სორს კონტრიბუტორებისთვის გაგვემარტივებინა საქმე და გვესწავლებინა თუ როგორ უნდა შეიტანონ წვლილი სხვა პროექტებში. ეს პროექტი ეხმარება დამწყებ "დეველოპერებს" რათა გაუადვილდეთ პირველი კონტრიბუცია Github_ზე. თუ გინდა რომ პირველი შენი დაწერილი კოდი Github_ზე ათვირთო მაშინ მიყევი ქვემოთ მოცემულ ინსტრუქციას. კი, სტატიების წაკითხვა და ვიდეოების ყურება კარგია, მაგრამ, პრაქტიკას არც ერთი შეედრება. ეს პროექტიც ზუსტად იმისთვისაა, რომ გაგიმარტივოს გზა პირველ კონტრიბუციამდე, რომელსაც ქვემოთ ჩამოთვლილი რამდენიმე ნაბიჯი გაშორებს.\ #### *თუ ტერმინალთან დიდად არ მეგობრობ, [აქ ნახავ რამდენიმე პროგრამას, რომელიც ტერმინალის გამოყენებას აგარიდებს თავიდან]( #ტუტორიალები-სხვა-პროგრამების-გამოყენებით )* დააფორკეთ ეს რეპოზიტორი თუ კომპიუტერში გითი არ გაქვს ჩაწერილი, [მიჰყევი ლინკს]( https://help.github.com/articles/set-up-git/). ## დაფორკე ეს რეპოზიტორია რეპოზიტორიის დაფორკვისთვის, ამ გვერდის მარჯვენა ზედა კუთხეში დააჭირე "Fork" ღილაკს, რომელიც მის ასლს შეგიქმნის. ## რეპოზიტორიის დაკლონვა კლონირება ამ რეპოზიტორიის ახლა, დაფორკილი რეპოზიტორია შენს კომპიუტერზე უნდა გადმოიტანო. ამისთვის შედი შენს გითჰაბის პროფილზე, გახსენი რეპოზიტორია და დააჭირე "Clone or download"-ს, შემდეგ კი *"copy to clipboard"*-ის სურათს. ახლა გახსენი ტერმინალი და გაუშვი შემდეგი ბრძანება: ```bash git clone "url you just copied" ``` სადაც "url you just copied" (ბრჭყალების გარეშე) არის შენ მიერ დაკოპირებული რეპოზიტორიის ლინკი. (თუ ეს ლინკი არ გაქვს, წინა ნაბიჯი თავიდან გაიარე). URL-ის კოპირება ბუფერში მაგალითად: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` სადაც `this-is-you` ნაწილი, შენი გითჰაბის სახელია. ამითი რეპოზიტორიის ყველა ფაილი შენს კომპიუტერში გადმოვა. ## შექმენი ბრენჩი შენი კომპიუტერით შედი რეპოზიტორიის ფოლდერში (თუ უკვე იქ არ ხარ): ```bash cd first-contributions ``` ახლა შექმენი ახალი ბრენჩი `git checkout` ბრძანების გამოყენებით: ```bash git checkout -b ``` მაგალითად: ```bash git checkout -b add-alonzo-church ``` (ბრენჩის სახელის დასაწყისში *add*-ის მიწერა სავალდებულო არაა, თუმცა მიზანშეწონილია, რადგანაც მისი მთავარი მიზანია თქვენი სახელი დაამატოს კონტრიბუტორთა სიაში.) ## საჭირო ფაილების შეცვლა და ატვირთვა ახლა რომელიმე პროგრამით (სასურველია ტექსტ ედიტორით) გახსენი ფაილი, სახელად `Contributors.md` და დაამატე შენი სახელი. ოღონდ გაითვალისწინე, რომ ის სხვების სახელებს შორის უნდა ჩაწერო და არა ფაილის დასაწყისში, ან ბოლოში. შეინახე ცვლილებები. git status ბრძანება თუ პროექტის ფოლდერში გადახვალ და გაუშვებ ბრძანება: `git status`. ტერმინალი გაჩვენებს რა ფაილებში მოხდა ცვლილებები. `git add`-ით დაამატე ცვლილებები შენ მიერ შექმნილ ახალ ბრენჩს: ```bash git add Contributors.md ``` ახლა შეინახე ისინი `git commit`-ის გამოყენებით: ```bash git commit -m "Add to Contributors list" ``` აქაც, `` უნდა შეცვალო შენი პროფილის სახელით. ## ცვლილებების ატვირთვა გითჰაბზე ატვირთე შენი ნამუშევარი `git push`-ის მეშვეობით: ```bash git push origin ``` `` აქ შენ მიერ შექმნილი ბრენჩის სახელით უნდა ჩაანაცვლო. ## განხილვის მოთხოვნა გითჰაბზე, შენს რეპოზიტორიაში როცა გადახვალ, დაინახავ `Compare & pull request` ღილაკს. დააჭირე. Pull Request-ის შექმნა ახლა შენ მოითხოვ ცვლილებების განხილვას. Pull Request-ის გაგზავნა და სულ მალე, შენი ნამუშევარი ამ პროექტის მთავარ ბრენჩზე გამოჩნდება. ამის შესახებ მეილსაც მიიღებ. ## აქედან საით? გილოცავ! შენ შეასრულე სტანდარტული კონტრიბუციის პროცედურა, რომელსაც მომავალში ხშირად გამოიყენებ, როგორც კონტრიბუტორი! აღნიშნე და გაუზიარე მეგობრებს შენი წარმატება [ამ ლინკზე გადასვლით] (https://firstcontributions.github.io/#social-share) თუ კონტრიბუციების სხვაგან შეტანაც გინდა, გადახედე კოდის [კონტრიბუციები] (https://github.com/roshanjossey/code-contributions) თუ კონტრიბუციების სხვაგან შეტანაც გინდა, ჩვენ შენთვის შედარებით მარტივად გასაგები პროექტები შევარჩიეთ, [რომლებსაც აქ ნახავ](https://firstcontributions.github.io/#project-list). ### [დამატებითი მასალა](../additional-material/git_workflow_scenarios/additional-material.md) ## ტუტორიალები სხვა პროგრამების გამოყენებით | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | | [GitHub Desktop](../github-desktop-tutorial.md) | [Visual Studio 2017](../github-windows-vs2017-tutorial.md) | [GitKraken](../gitkraken-tutorial.md) | [Visual Studio Code](../github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.gh.md ================================================ [![Love for Open Source](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Ntoboa a Edi Kan Bere a edi kan a wobɛyɛ biribi no yɛ nea ɛyɛ den bere nyinaa. Suro a wusuro sɛ wubedi mfomso no nyɛ nea ahotɔ wom koraa, titiriw bere a woreyɛ biako no. Nanso wiase a ɛwɔ open source no fa adwumayɛkuw ne adwuma a wɔbɛyɛ sɛ kuw ho. Enti, yɛpɛ sɛ yɛma ɔkwan a wɔfa so ma wɔn a wɔde mmoa foforo kɔ open source no yɛ mmerɛw denam sɛnea wobɛkyerɛkyerɛ wo sɛnea wode wo ntoboa a edi kan bɛma no so. Nsɛm ne nkyerɛkyerɛ akenkan betumi aboa, nanso dɛn na eye sen sɛ wobɛbɔ mmɔden a wunsuro sɛ wubedi mfomso? Saa dwumadie yi botaeɛ ne sɛ ɛbɛma akwankyerɛ na ama sɛdeɛ wɔn a wɔrefi aseɛ no de wɔn ntoboa a ɛdi kan de ma no ayɛ mmerɛ. Kae:dodow a wo ho adwo wo no, dodow no ara na wusua ade yiye.Sɛ wopɛ sɛ wode wo ntoboa a edi kan ma a, di anammɔn a ɛwɔ ase ha no akyi kɛkɛ. yɛ fork saa repo yi Sɛ wo nni Git wɔ wo kɔmputa so a, . [fa hyɛ wo kɔmputa so](https://help.github.com/articles/set-up-git/). ## Fork Saa Adekorabea Yi Fork saa adekorabea yi denam fork button a ɛwɔ kratafa no atifi a wobɛma so. Wei bɛma woanya akoraeɛ no bi wɔ wo akonta so. ## Clone Saa Adekorabea yɛ clone repo yi Afei clone saa akoraeɛ yi kɔ wo kɔmputa so. Klik clone button no so na afei klik *kɔpi kɔ clipboard so* icon no so. Bue ahyɛdeɛ kwan (sɛ wowɔ Windows so) anaa terminal (sɛ wowɔ MacOS anaa Linux so) na yɛ git ahyɛdeɛ a ɛdidi soɔ yi: ```bash git clone "URL a woayɛ ho kɔpi nkyɛe no" ``` baabi a "URL a woayɛ ho kɔpi seesei ara" (a nsɛm a wɔafa aka no nka ho) yɛ akoraeɛ URL. fa URL no kɔ clipboard Nhwɛsoɔ: ```bash git clone https://github.com/your-username/first-contributions.git ``` baabi a `wo-ɔdefoɔ din` yɛ wo GitHub dwumadie din. Ɛha na worekɔpi `ntoboa ahorow a edi kan` akoraeɛ no mu nsɛm afiri GitHub so akɔ wo kɔmputa so. ## Yɛ Baa Dwumadibea Kɔ adwuma no ho kyerɛwtohɔ a wɔayɛ no foforo no so (sɛ woankɔ hɔ dedaw a): ```bash cd first-contributions ``` Afei fa `git checkout` ahyɛdeɛ no yɛ baa dwumadibea: ```bash git checkout -b ``` Nhwɛsoɔ: ```bash git checkout -b add-quarjo-wusu ``` (Ɛnsɛ sɛ baa dwumadibea din no kura asɛmfua *add*, nanso ntease wom sɛ wode bɛka ho efisɛ baa dwumadibea yi atirimpɔw ne sɛ wode wo din bɛka list bi ho.) ## Yɛ Nsakrae a Ɛho Hia na Fa Hyɛ Afei, bue `Contributors.md` fael no wɔ text editor mu, fa wo din ka ho, na sie fael no. Sɛ wobue ahyɛdeɛ no na wo tu `git status` ahyɛdeɛ no a, wobɛhunu sɛ nsakraeɛ bi wɔ hɔ. Fa nsakrae yi ka baa dwumadibea a woayɛ nkyɛe no ho denam `git add` ahyɛde no so: ```bash git add Contributors.md ``` Afei fa `git commit` ahyɛdeɛ no yɛ nsakraeɛ yi: ```bash git commit -m "Add kɔ Contributors list no so" ``` fa wo din si `` ananmu. ## Pia Nsakraeɛ kɔ GitHub Fa `git push` ahyɛdeɛ no pia wo nsakraeɛ no: ```bash git push origin ``` fa baa dwumadibea a woadi kan abɔ no din si `` ananmu. ## Fa Wo Nsakrae no Mena ma Wɔnhwɛ Mu Sɛ wokɔ wo akoraeɛ wɔ GitHub so a, wobɛhunu `Fa toto ho. bɔ pull request Afei fa twetwe adesrɛ no kɔma. tua pull request no Mebɛka mo nsakraeɛ nyinaa abom ayɛ adwuma yi baa dwumadibea titiriw no nnansa yi ara. Wo nsa bɛka amanneɛbɔ email bere a wɔawie nkabom no. Wɔrensakra wo fork no nkorabata titiriw no wɔ saa bere yi mu. Sɛnea ɛbɛyɛ a wo fork no ne me de no bɛkɔ so ayɛ pɛ a, di anammɔn yi akyi. ## Ma Wo Fork no ne Saa Adekorabea Yi Nhyia Nea edi kan no, dan kɔ baa dwumadibea titiriw no so: ```bash git checkout main ``` Na fa me akoraeɛ URL no ka ho sɛ `upstream akyirikyiri url`: ```bash git remote add upstream https://github.com/Roshanjossey/first-contributions ``` Wei yɛ ɔkwan a yɛbɛfa so aka akyerɛ Git sɛ saa akoraeɛ yi nkyerɛaseɛ foforɔ wɔ hɔ wɔ address a wɔakyerɛ no so, na yɛfrɛ no `upstream`. Sɛ wɔka nsakraeɛ no bom wie a, hwehwɛ me akoraeɛ no foforɔ no: ```bash git fetch upstream ``` Ɛha na yɛrefa nsakraeɛ a ɛwɔ me baa dwumadibea a ɛwɔ soro no nyinaa aba.Afei ɛsɛ sɛ wode me akorae no mu nsakrae foforo no bom ne wo baa dwumadibea titiriw no: ```bash git rebase upstream/main ``` Ɛha na yɛde nsakraeɛ a wode baa wo baa dwumadibea kɛseɛ no nyinaa redi dwuma.Sɛ wopia baa dwumadibea kɛse no mprempren a, wo kyɛnsee no nso benya nsakrae ahorow no: ```bash git push origin main ``` Kɔkɔbɔ: Saa bere yi de, worepia akɔ akyirikyiri adekorabea a wɔfrɛ no origin no so. Saa bere yi, mede wo `` baa dwumadibea no kaa me baa dwumadibea kɛse no ho, na wo nso wode me baa dwumadibea kɛse no kaa wo baa dwumadibea titiriw no ho. Wo `` baa dwumadibea no ho nhia bio, enti wubetumi apopa: ```bash git branch -d ``` na wubetumi nso apopa ne akyirikyiri nkyerɛase no: ```bash git push origin --delete ``` Eyi ho nhia, nanso baa dwumadibea no din kyerɛ sɛ n’atirimpɔw yɛ pɔtee koraa. Ne nkwa nna betumi ayɛ tiaa. ## Nkyerɛkyerɛ a Wɔde Nnwinnade Afoforo Di Dwuma | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.gl.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribucións É difícil. Sempre é difícil a primeira vez que fas algo. Especialmente cando estás colaborando, equivocarse non é algo agradable. Pero no *open source* (o código aberto) todo trata de colaboración e de traballar xuntos. Quixemos simplificar a forma na que novos contribuidores *open-source* aprenden e contribúen por primeira vez. Ler artículos e ver titoriais pode axudar, pero ¿que haberá mellor que facer as cousas nunha contorna pensada para practicar? Iste proxecto enfócase en prover unha guía e en simplificar o xeito no que os novatos fan a súa primeira contribución. Lembra que mentres máis relaxado esteas, mellor aprenderás. Se queres facer a túa primeira contribución só tés que seguir os sinxelos pasos que se amosan a continuación. E prometémosche que será entretido. fork de éste repositorio Se aínda non tés git na túa máquina, [ instálao ]( https://help.github.com/articles/set-up-git/ ) ## Bifurca(*Fork*) este repositorio Fai un *fork* (bifurcación) deste repo facendo click no botón "Fork" que está na cima desta páxina. Isto creará unha copia deste repositorio na túa conta. ## Clona(*Clone*) o repositorio clonar este repositorio A continuación clona este repo no teu equipo. Fai click no botón "*Clone*" e despois na icona para copiar ó portapapeis (clipboard) Abre a túa consola ou terminal e executa o seguinte comando de git: ``` git clone "url que copiache" ``` Onde "url que copiache" (sen as comiñas) é a url deste repositorio. Mira os pasos previos para obter a url. copiar URL a clipboard Por exemplo: ```bash git clone https://github.com/o-teu-nome/first-contributions.git ``` Onde "o-teu-nome" é o teu usuario de GitHub. Aquí estarás copiando os contidos do repositorio first-contributions en GitHub para o teu computador. ## Crear unha póla(*Branch*) Cambia ó directorio do repositorio no teu computador (se é que non estás xa nel). ```bash cd first-contributions ``` Agora crea unha branch (póla) usando o comando `git checkout` ```bash git checkout -b ``` Por exemplo ```bash git checkout -b engade-María-Soliña ``` (O nome da branch non ten que incluir necesariamente a palabra 'engade', pero resulta razoable se consideramos que o propósito desta póla é engadir o teu nome a unha lista). ## Fai os cambios necesarios e efectúa(*Commit*) deses cambios Agora abre o arquivo `Contributors.md` nun editor de texto, engade o teu nome e despois garda o arquivo. Se vas ó directorio do proxecto e executas `git status`, verás que hai modificacións. git status Agrega eses cambios ou modificacións usando o comando `git add` tal como se amosa: ```bash git add Contributors.md ``` Agora podes facer commit sobre os cambios co comando `git commit` ```bash git commit -m "Add to Contributors list" ``` cambiando `` polo teu nome. ## Envía (*Push*) os teus cambios a GitHub Fai un *push* dos teus cambios usando o comando `git push` ```bash git push origin ``` cambiando `` polo nome da branch que creaches antes. ## Envía os teus cambios para seren revisados Se vas ó teu repositorio en GitHub, verás un botón `Compare & pull request`. Fai click nese botón: crea unha pull request Agora crea e envía a pull request: sube a pull request Axiña mesturarei os teus cambios (facendo *merge*) na master branch deste proxecto. Recibirás unha notificación por correo cando os cambios xa estean mesturados. ### [ Material adicional ](../additional-material/git_workflow_scenarios/additional-material.md) ## Titoriais con outras ferramentas | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ## Onde ir dende aquí? Se queres practicar máis e contribuír a código aberto, mira [Code Contributions](https://github.com/roshanjossey/code-contributions). ================================================ FILE: docs/translations/README.gr.md ================================================  [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Πρώτες Συνεισφορές Αυτό το έργο έχει σκοπό να απλοποιήσει και να καθοδηγήσει τον τρόπο με τον οποίο οι αρχάριοι κάνουν την πρώτη τους συνεισφορά. Αν σκοπεύετε να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε τα παρακάτω βήματα. Αν δεν είστε εξοικειωμένοι με τη γραμμή εντολών, [εδώ υπάρχουν σεμινάρια που χρησιμοποιούν γραφικά εργαλεία](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) κάντε fork σε αυτό το αποθετήριο Εάν δεν έχετε εγκατεστημένο το git στον υπολογιστή σας, [εγκαταστήστε το](https://help.github.com/articles/set-up-git/) ## Αντιγράψτε το αποθετήριο (fork) Αντιγράψτε το αποθετήριο πατώντας το κουμπί με τίτλο `Fork` στην κορυφή αυτής της σελίδας. Με αυτό τον τρόπο ένα ακριβές αντίγραφο του αποθετηρίου θα δημιουργηθεί στο λογαριασμό σας. ## Αποθηκεύστε τοπικά το αποθετήριο (clone) κλωνοποιήστε αυτό το αποθετήριο Τώρα αντιγράψτε το αποθετήριο στον υπολογιστή σας. Κάντε κλικ στο κουμπί `Clone or download` και μετά στο εικονίδιο δεξιά από το σύνδεσμο για αντιγραφή στο πρόχειρο. Ανοίξτε ένα παράθυρο τερματικού και τρέξτε την ακόλουθη git εντολή: ```bash git clone "σύνδεσμος που μόλις αντιγράψατε" ``` Όπου "σύνδεσμος αποθετηρίου" (χωρίς τα εισαγωγικά) είναι ο σύνδεσμος για αυτό το αποθετήριο. Ανατρέξτε στα προηγούμενα βήματα για να βρείτε αυτόν τον σύνδεσμο. αντιγράψτε τον σύνδεσμο στο πρόχειρο Για παράδειγμα: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` Όπου 'this-is-you' είναι το όνομα χρήστη που έχετε στο github. Από εδώ αντιγράφετε τα περιεχόμενα του αποθετηρίου `first-contributions` απο το github στον υπολογιστή σας. ## Δημιουργήστε ένα νέο παρακλάδι (branch) Πηγαίνετε στο φάκελο του αποθετηρίου στον υπολογιστή σας εάν δεν είστε ήδη εκεί. ```bash cd first-contributions ``` Τώρα δημιουργήστε ένα νέο παρακλάδι χρησιμοποιώντας την εντολή `git switch` : ```bash git switch -c your-new-branch-name ``` Για παράδειγμα: ```bash git switch -c add-alonzo-church ``` (Το όνομα του παρακλαδιού δεν χρειάζεται να περιέχει την λέξη _add_ αλλά είναι λογικό να την συμπεριλάβουμε μιας και ο σκοπός του παρακλαδιού είναι να προσθέσουμε το όνομα μας σε μια λίστα.) ## Πραγματοποιήστε τις αλλαγές και αποθηκεύστε τες (add & commit) Τώρα ανοίξτε το αρχείο `Contributors.md` με έναν επεξεργαστή κειμένου. Χρειάζεται να είστε εξοικειωμένοι με την Markdown, μια ελαφριά γλώσσα σήμανσης. Δείτε στο [cheat sheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) για το πως να χρησιμοποιήσετε την Markdown. Σε αυτήν την περίπτωση προσθέστε την παρακάτω σειρά στο τέλος του αρχείου `Contributors.md:` ```bash - [Το-όνομα-σας](https://github.com/Your-username) ``` Για παράδειγμα: ```bash - [John Doe](https://github.com/johndoe) ``` Σιγουρευτείτε ότι δεν υπάρχει κενό ανάμεσα στα `](` . Αποθηκεύστε το αρχείο και κλείστε το. κατάσταση git Εάν πάτε στο φάκελο του αποθετηρίου και γράψετε την εντολή `git status`, θα δείτε ότι υπάρχουν κάποιες αλλαγές. Προσθέστε αυτές τις αλλαγές χρησιμοποιώντας την εντολή `git add`. ```bash git add Contributors.md ``` Τώρα σώστε αυτές τις αλλαγές χρησιμοποιώντας την παρακάτω `git commit` εντολή. ```bash git commit -m "Add to Contributors list" ``` όπου `` αντικαταστήστε με το όνομα σας ## Αποθηκεύστε τις αλλαγές σας στο github (push) Αποθηκεύστε τις αλλαγές σας χρησιμοποιώντας την εντολή `git push` ```bash git push origin ``` όπου `` αντικαταστήστε με το όνομα του παρακλαδιού(branch) που δημιουργήσατε προηγουμένως ## Υποβάλετε τις αλλαγές σας για έλεγχο Εάν πάτε στο αποθετήριο (repository) στο github θα δείτε ένα κουμπί με τίτλο `Compare & pull request`. Κάντε κλικ σε αυτό το κουμπί. δημιουργήστε ένα αίτημα έλξης Τώρα υποβάλετε το pull request. υποβάλετε το αίτημα έλξης Σύντομα θα ενσωματώσω όλες τις αλλαγές σας στο master branch του προγράμματος. Θα ειδοποιηθείτε με email όταν οι αλλαγές που κάνατε ενσωματωθούν. ## Τι να κάνετε τώρα; Συγχαρητήρια! Μόλις ολοκληρώσατε την τυπική ροή εργασιών _fork -> clone -> edit -> pull request_ που θα συναντήσετε συχνά ως συνεργάτης! Για περισσότερες συνεισφορές, επισκεφθείτε το [αποθετήριο συνεισφορών κώδικα](https://github.com/firstcontributions/first-contributions). Γιορτάστε και μοιραστείτε την συνεισφορά σας με τους φίλους και τους ακόλουθους σας πηγαίνοντας στο [web app](https://firstcontributions.github.io/#social-share). Τώρα μπορείτε να ξεκινήσετε να συνεισφέρετε και σε άλλα project. Έχουμε φτιάξει μια λίστα από project με εύκολα προβλήματα για να ξεκινήσετε. Δείτε εδώ [τη λίστα με τα project](https://firstcontributions.github.io/#project-list). Μπορείτε να βρείτε περισσότερους τρόπους να συνεισφέρετε [εδώ](https://github.com/firstcontributions/first-contributions#code-contributions). ### [Επιπρόσθετο υλικό](../additional-material/git_workflow_scenarios/additional-material.md) ## Εκπαιδευτικό Υλικό Χρήσης Άλλων Εργαλείων | Εφαρμογή GitHub Desktop | Visual Studio 2017 | Πρόγραμμα GitKraken | Επεξεργαστής VS Code | Εφαρμογή Sourcetree | Πρόγραμμα IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.guj.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # પ્રથમ યોગદાન પ્રથમ વખત કંઈક કરવું થોડું મુશ્કેલ છે. ખાસ કરીને જ્યારે તમે જુથ સાથે મળીને કામ કરી રહ્યા હોવ, ત્યારે ભૂલો કરવી એ સારી વાત નથી. પરંતુ એકબીજા સાથે મળીને એક જ લક્ષ્ય માટે કામ કરવું — એ જ તો ઓપન સોર્સ છે. અમે તમારું પ્રથમ ઓપન સોર્સ કોન્ટ્રિબ્યુશન / યોગદાન સરળ બનાવાનો પ્રયત્ન કરીશુ. ઓનલાઇન આર્ટિકલ્સ વાંચન અને ઓનલાઇન ટ્યુટોરિયલ્સ મદદ કરી શકે છે, પરંતુ પોતે જ તે કામ કરવાથી સારું શું હોઇ શકે? આ પ્રોજેક્ટ તમને તમારી પ્રથમ કોન્ટ્રિબ્યુશન માટે દિશા નિર્દેશ આપશે. જો તમે તમારું પ્રથમ કોન્ટ્રીબ્યુશન કરવા માંગો છો તો આગળ આપેલા પગલાઓ અનુસરો. જો તમે કમાન્ડ લાઇન સાથે આરામદાયક ન હોવ, તો અહીં [ GUI ટૂલ્સનો ઉપયોગ કરવાના ટ્યુટોરિયલ્સ ](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) આપેલ છે. આ રિપોઝીટરીને ફોર્ક કરો જો તમારા કમ્પ્યુટર પર Git ઇન્સ્ટોલ નથી, [ તો Git ઈન્સ્ટોલ કરો](https://help.github.com/articles/set-up-git/) ## રિપોઝીટરીને ફોર્ક કરો ફોર્ક(કાંટા) બટન પર ક્લિક કરવાથી આ રિપોઝીટરી ફોર્ક થાય છે, આ તમારા GitHub એકાઉન્ટમાં આ રિપોઝીટરીની એક નકલ (કોપી) બનાવશે. ## રિપોઝીટરી ક્લોન કરો આ રિપોઝીટરીને ક્લોન કરો હવે તમે આ રેપો તમારા કમ્પ્યુટરમાં ક્લોન કરો (અર્થાત ડાઉનલોડ કરો). તમારા GitHub એકાઉન્ટ પર જાવ, કોડ બટન પર ક્લિક કરો અને પછી `copy to clipboard` આઇકોન પર ક્લિક કરો. આનાથી એ રેપોજીટરીનો યુઆરએલ કોપી થશે. તમારા કમ્પ્યુટર પર એક ટર્મિનલ / કમાંડ પ્રોમ્પ્ટ ખોલો અને નીચે દર્શાવ્યા મુજબ git આદેશ ચલાવો: ```bash git clone "યુઆરએલ જે તમે હમણાં જ નકલ(ક્લોન) કરી" ``` જ્યાં "યુઆરએલ જે તમે હમણાં જ કોપી કર્યું છે" (અવતરણ ચિહ્નો સિવાય) એ આ રિપોઝીટરી(આ પ્રોજેક્ટનો તમારો ફૉર્ક) ની URL ના સંગ્રહ માટે છે. તેની URL ને મેળવવા માટે પાછલા પગલાં જુઓ. તેમને કોપી કરેલ યુઆરએલ સાથે બદલી કાઢો. ઉદાહરણ તરીકે: ```bash git clone https://github.com/આ-તમે-છો/first-contributions.git ``` URL ને ક્લિપબોર્ડમાં કોપી કરો 'આ-તમે-છો' તમારા GitHub એકાઉન્ટનું `username` છે. અહીં તમે તમારા કમ્પ્યુટરમાં GitHub થી first-contributions રિપોને કોપી કરી રહ્યા છો અથવા તેના એક સ્થાનિક / લોકલ કોપી બનાવી રહ્યા છે. ## એક બ્રાંચ બનાવો તમારા કમ્પ્યુટર પર બનાવેલ રિપોઝીટરીની કોપીનાં ફોલ્ડર / ડિરેક્ટરીમાં જાવ (જો હજુ સુધી તમે ત્યાં ન હોવ તો નીચે આપેલ Command(આદેશ) ચલાવો) ```bash cd first-contributions ``` હવે 'git checkout' command(આદેશ) નો ઉપયોગ કરીને એક નવી શાખા(Branch) બનાવો. નવી શાખા(Branch) બનાવવા માટે -b વિકલ્પનો ઉપયોગ થાય છે. ```bash git checkout -b <તમારી-શાખા-નામ-ઉમેરો> ``` ઉદાહરણ તરીકે: ```bash git checkout -b add-alonzo-church ``` (શાખા(Branch)ના નામમાં 'add' ઉમેરવાની જરૂર નથી, પરંતુ તેમાં શામેલ કરવું યોગ્ય છે કારણ કે શાખા(Branch)નો હેતુ એક નામ છે, જે નામ ઉમેરવાનું છે.) ## આવશ્યક ફેરફારો કરો અને તે ફેરફારોને કમીટ કરો- હવે `Contributors.md` ફાઇલને એક ટેક્સ્ટ એડિટરમાં ખોલો અને તેમાં તમારુ નામ લખો. ફાઇલની શરૂઆત અથવા અંતે ઉમેરવાને બદલે, તેને મધ્યમાં ગમે ત્યાં રાખો. હવે, ફાઇલને સેવ કરો. git સ્થિતિ જો તમે પ્રોજેક્ટની ડાઈરેક્ટરીમા જશો અને કમાન્ડ પ્રોમ્પ્ટમાં `git status` નિર્દેશ ચલાવશો, તો તમે કરેલા પરિવર્તન જોઈ શક્શો. તે પરિવર્તન બનાવવામાં આવેલ શાખા(Branch)માં ઉમેરવા માટે 'git add` કમાન્ડ વાપરો. ```bash git add Contributors.md ``` હવે તમારા પોતાના ફેરફારોને 'git commit' આદેશનો ઉપયોગ કરી કમીટ કરો. ```bash git commit -m "Add <તમારુ-નામ> to Contributors list" ``` <તમારુ નામ> ની જગ્યાએ તમારું નામ દાખલ કરો ## તમારા ફેરફારો ને GitHub માં પુશ કરો (ધકેલો). `git push` ઉપયોગ કરીને તમારા પરિવર્તન ને પુશ કરો ```bash git push origin <તમારી-શાખા-નામ-ઉમેરો> ``` `<તમારી-શાખા-નામ-ઉમેરો>` ની જગ્યાએ તમારી શાખા(Branch)નુ નામ ઉમેરો. ## તમારા ફેરફારોના રીવ્યુ માટે સબમિટ કરો જો તમે તમારા github એકાઉન્ટ પર તમારી રિપો માં જાવ તો Compare & pull request નો ઓપ્શન હશે. તેને દબાવો. પુલ રિક્વેસ્ટ બનાવો હવે તમારી pull request સબમિટ કરો. પુલ રિક્વેસ્ટ સબમિટ કરો ટૂંક સમયમાં હું તમારા ફેરફારો માટે આ પ્રોજેક્ટની માસ્ટર શાખામાં મર્જ ક્રી દઇશ. તમને એક મેલ આવશે જ્યારે તમારા ફેરફારો મર્જ થશે. ## હવે, અહીંથી આગળ શું? અભિનંદન!:tada: તમે હમણાં જ સ્ટાન્ડર્ડ `fork -> clone -> edit -> pull request` વર્કફ્લો પૂર્ણ કર્યો છે. જેનો તમે વારંવાર સહયોગકર્તા (contributor) તરીકે સામનો કરશો! તમારા પ્રથમ યોગદાનની ઉજવણી કરો અને [વેબ એપ્લિકેશન](https://firstcontributions.github.io/#social-share) પર જઈને તમારા મિત્રો અને ફોલોઅર્સ સાથે શેર કરો. જો તમને વધુ પ્રેક્ટિસ જોઈતી હોય, તો [કોડ યોગદાન ચેકઆઉટ](https://github.com/roshanjossey/code-contributions) કરો. ચાલો, હવે તમને અન્ય પ્રોજેક્ટ્સમાં કૉન્ટ્રિબ્યુટ કરવામા મદદ કરુ. અમે તમારા માટે એક યાદી બનાવી છે જેમા ખૂબ સરળ issues(મુદ્દાઓ) છે. [વેબ એપમા પ્રોજેક્ટ્સ ની સૂચિ જુઓ.](https://firstcontributions.github.io/#project-list) ## અન્ય સાધનોનો ઉપયોગ કરીને ટ્યુટોરીયલ્સ | GitHub ડેસ્કટોપ | વિઝ્યુઅલ સ્ટુડિયો 2017 | GitKraken પ્રોગ્રામ | VS કોડ એડિટર | સોર્સટ્રી એપ્લિકેશન | IntelliJ IDEA પ્રોગ્રામ | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.hau.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Kyauta ta Farko Yana da wahala. Yana da wahala lokacin da kuka fara yin wani abu. Musamman lokacin da kuke mu'amala, yin kuskure ba abu ne mai kyau ba. Muna son ƙirƙirar buɗaɗɗen hanya don sababbin mutane don koyo kuma su shiga a karon farko. Karatun labarai da koyawa kan layi na iya taimaka muku, amma menene ya fi yin ainihin abin? Manufar wannan aikin shine don ba da jagora & ba da damar mutane su fara ba da gudummawa. Idan kuna neman ba da gudummawarku ta farko, bi matakan da ke ƙasa. #### *Idan ba kwa son alamomin doka, [Anan akwai koyawa ta amfani da kayan aikin GUI.](#Koyo-don-amfani-wasu)* Yi fork na wannan ma’ajiyar lamba Idan ba ku da inji a kan injin ku, [shigar da shi]( https://help.github.com/articles/set-up-git/). ## Cire wannan babban fayil ɗin Cire wannan repo ta danna maɓallin thumbnail a saman wannan shafin. Wannan zai haifar da ajiyar tsaro guda ɗaya a cikin asusunku. ## Yana rufe wurin ajiya Yi clone na wannan ma’ajiyar Yanzu maye gurbin repo akan injin ku. Je zuwa asusun GitHub ɗin ku, buɗe repo don dannawa, danna maɓallin clone sannan danna gunkin alamar. Bude tasha kuma gudanar da umarni mai zuwa: ```bash git clone "url you just copied" ``` inda "url ɗin da kuka kwafi" (ba tare da alamar magana ba) shine url don ajiya anan (ƙarshen wannan aikin). Duba matakan da suka gabata don samun url. Kwafi URL zuwa clipboard Misali: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` inda `this-is-you` shine sunan mai amfani na GitHub. Anan, kuna kwafin abun ciki na ainihin gudummawar GitHub akan kwamfutarka. ## Ƙirƙiri reshe Canja zuwa tsarin shugabanci akan kwamfutarka (idan ba ku da shi a can): ```bash cd na farko-gudunmawar ``` Yanzu, ƙirƙiri reshe ta amfani da umarnin 'git checkout': ```bash git checkout -b <ƙara-sabon-reshe-name> ``` Misali: ```bash git checkout -b add-alonzo-church ``` (Sunan reshen ba lallai ba ne a saka kalmar a cikinsa, amma yana da mahimmanci ku haɗa shi saboda manufar wannan reshen shine ƙara sunan ku a cikin jerin sunayen). ## Yi canje-canjen da suka dace kuma ku canza waɗannan canje-canje Yanzu buɗe fayil ɗin `Contributors.md` a editan rubutu, ƙara sunan ku gare shi. Ana haɗe shi zuwa farkon ko ƙarshen fayil ɗin. Saka shi wani wuri a tsakanin. Yanzu ajiye fayil ɗin. Matsayin git Idan ka je kundin kundin kamfani kuma ka aiwatar da umurnin 'git status', za ka ga cewa akwai canje-canje. Ƙara waɗannan canje-canje zuwa reshen da kuka ƙirƙira ta amfani da umarnin 'git add': ```bash git ƙara Masu ba da gudummawa.md ``` Yanzu aiwatar da canje-canje ta amfani da umarnin 'git Committee': ```bash git commit -m "Ƙara zuwa lissafin Masu ba da gudummawa" ``` Sauya `' da sunan ku. ## Tura duk waɗannan canje-canje zuwa GitHub Yi canje-canjen ku ta amfani da umarnin 'git push': ```bash git tura asalin <ƙara-sunan-reshen ku> ``` Sauya `` da sunan reshe da kuka ƙirƙira a baya. ## Ƙaddamar da canje-canjenku don dubawa Idan kun je wurin ajiyar ku akan GitHub, zaku ga maɓallin 'Compare & ja buƙatar'. Danna maɓallin. ƙirƙiri buƙatar ja Yanzu, yi buƙatar. aika buƙatar ja Nan ba da jimawa ba zan magance duk canje-canjenku a wannan reshe. Za ku karɓi saƙon sanarwa a duk lokacin da aka yi canji. ## Ina zan je daga nan? Taya murna! Ka kawai karanta uwar garken -> kwafin fitarwa -> gyara -> Zazzage sabis na PR wanda koyaushe za ku hadu a matsayin mai ba da ku! Duba gudunmawar ku kuma ku raba ta tare da abokanku da mabiyanku ta ziyartar [app app](https://firstcontributions.github.io/#social-share). Kuna iya shiga cikin ma'aikatan mu na abokantaka idan kuna buƙatar kowane taimako ko kuna da tambayoyi. [Haɗa ƙungiyar slack](https://join.slack.com/t/firstcontr🏴ibutors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWYZm Yanzu, bari mu fara da ba da gudummawa don wasu ayyuka. Mun tattara jerin ayyuka masu sauƙi da tattaunawa da za ku iya farawa. Duba [jerin ayyuka da aikace-aikacen yanar gizo](https://firstcontributions.github.io/#project-list). ### [Ƙarin Material](../additional-material/git_workflow_scenarios/additional-material.md) ## Ilimi da amfani da sauran kayan | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.hb.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) #### _קרא [בשפות אחרות](Translations.md)._ [Shqip](README.al.md) [Armenian](README.arm.md) [Uzbek language](README.uz.md) [Azərbaycan dili](README.aze.md) [বাংলা](README.bn.md) [Bulgarian](README.bg.md) [Português (Brasil)](README.pt_br.md) [Català](README.ca.md) [中文 (Simplified)](README.zh-cn.md) [Czech](README.cs.md) [Deutsch](README.de.md) [Dansk](README.da.md) [العربية](README.eg.md) [Dezéiriya](README.dz.md) [Española](README.es.md) [Française](README.fr.md) [Gaeilge](README.ga.md) [Galego](README.gl.md) [Ελληνικά](README.gr.md) [ქართული](README.ge.md) [Magyar](README.hu.md) [Bahasa Indonesia](README.id.md) [हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்](Translations.md) [தமிழ்](README.ta.md) [فارسی](README.fa.md) [پښتو](README.pus.md) [Italiano](README.it.md) [日本語](README.ja.md) [සිංහල](README.si.md) [Kiswahili (Kenya)](README.kws.md) [한국어](README.ko.md) [Lietuvių kalba](README.lt.md) [Limba Română Limba Română](README.ro.md) [မြန်မာ](README.mm_unicode.md) [Македонски](README.mk.md) [Español de México](README.mx.md) [Bahasa Melayu / بهاس ملايو‎ / Malay](README.my.md) [Dutch](README.nl.md) [Norsk](README.no.md) [नेपाली](README.np.md) [Wikang Filipino](README.fil.md) [English (Pirate)](README.en-pirate.md) [اردو](README.ur.md) [Twi (Ghana)](README.gh.md) [Polski](README.pl.md) [Português (Portugal)](README.pt-pt.md) [Русский язык](README.ru.md) [عربى](README.ar.md) [Svenska](README.se.md) [Slovenčina](README.slk.md) [Slovenščina](README.sl.md) [ภาษาไทย](README.th.md) [Türkçe](README.tr.md) [中文(Traditional)](README.zh-tw.md) [Українська](README.ua.md) [Tiếng Việt](README.vn.md) [Swahili language](README.sw.md) [Zulu (South Africa)](README.zul.md) [Afrikaans (South Africa)](README.afk.md) [Igbo (Nigeria)](README.igb.md) [Bambara (Mali)](README.mli.md) [Hausa (Nigeria)](README.hau.md) [Yoruba (Nigeria)](README.yor.md) [Latvia](README.lv.md) [Suomeksi](README.fi.md) [Беларуская мова](README.by.md) [Српски](README.sr-Cyrl.md) [Srpski](README.sr-Latn.md) [Қазақша](README.kz.md) [Bosanski](README.bih.md) [Bosanski](README.bih.md) [Hrvatski](README.hr.md) [پښتو](README.ps.md) [Somalia](README.so.md) [Ecuador](README.ec.md) [Luganda (Uganda)](README.lug.md) [Turkmen language](README.tm.md) [Ewe (TOGO)](README.ewe.md) [አማርኛ](README.et.md) [Kurdî](README.kr.md) [Malagasy](README.mg.md) [ភាសាខ្មែរ](README.kh.md) [Moroccan Darija](README.ma.md) # תרומות ראשונות מטרת פרויקט זה היא לפשט ולהדריך מתחילים בדרכם אל תרומתם הראשונה לקוד פתוח. אם אתם מחפשים דרך לבצע תרומה ראשונית, עקבו אחר ההוראות הבאות. _אם אינכם חשים בנוח להשתמש בשורת פקודה, [כאן תוכלו למצוא מדריכים לשימוש בכלים גרפיים](#הדרכות-בשימוש-כלים-אחרים)._ ביצוע Fork למאגר #### אם עוד לא התקנתם GIT, [התקינו כעת](https://help.github.com/articles/set-up-git). ## בצעו Fork למאגר זה כדי לבצע Fork למאגר זה, ניתן ללחוץ על כפתור ה – Fork בתחילת העמוד. פעולה זו תיצור עותק של מאגר זה בחשבון שלכם. ## שכפול המאגר שכפול המאגר כעת, שכפלו את המאגר הזה למחשב שלכם. לכו לדף ה-GitHub שלכם, לחצו על כפתור השכפול ואז לחצו על הצלמית `copy to clipboard`. פתחו טרמינל והריצו את הפקודה הבאה: ```bash git clone "url you just copied" ``` כאשר הביטוי `"url you just copied"` (ללא סימני הגרשיים) הוא הקישור למאגר זה שביצעתם עליו Fork קודם לכן. ראו את הצעדים הקודמים כדי להשיג את הקישור. העתק כתובת URL ללוח לדוגמא: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` כאשר `this-is-you` הוא שם המשתמש שלכם ב-GitHub. לכאן אתם מעתיקים את התוכן של מאגר first-contributions ב-GitHub לתוך המחשב שלכם. ## יצירת ענף החליפו לתיקיית המאגר בתוך המחשב שלכם (באם טרם נכנסתם לתיקייה זו): ```bash cd first-contributions ``` כעת, צרו ענף (branch) בשימוש הפעולה `git switch`: ```bash git switch -c your-new-branch-name ``` לדוגמא: ```bash git switch -c add-alonzo-church ```
אם אתה מקבל שגיאות בעת השימוש ב-git switch, לחץ כאן:

אם מופיעה הודעת השגיאה "Git: switch is not a git command. See git –help", זה כנראה בגלל שאתה משתמש בגרסה ישנה של Git.

במקרה כזה, נסה להשתמש במקום זאת בפקודה git checkout:

```bash git checkout -b your-new-branch-name ```
## ערכו שינויים הכרחיים ובצעו להם commit כעת פתחו את הקובץ `Contributors.md` בתוכנת עריכת טקסט והוסיפו את השם שלכם אליו. אל תוסיפו את השם בתחילת הקובץ או בסופו. הוסיפו אותו באמצע. לאחר שסיימתם, שמרו את הקובץ. גיט סטטוס אם תנווטו לתיקיית הפרויקט ותבצעו את הפעולה `git status`, תוכלו לראות את השינויים שביצעתם שם. הוסיפו את השינויים האלו לענף שיצרתם תוך שימוש בפקודה `git add`: ```bash git add Contributors.md ``` עכשיו, בצעו commit לשינויים הללו תוך שימוש בפקודת `git commit`: ```bash git commit -m "Add your-name to Contributors list" ``` החליפו את הביטוי `your-name` עם השם שלכם. ## לדחוף את השינויים ל-GitHub דחפו את השינויים תוך שימוש בפקודה `git push`: ```bash git push -u origin your-branch-name ``` החליפו את `your-branch-name` עם השם של הענף שיצרתם מוקדם יותר.
במידה ומתקבלות שגיאות במהלך הדחיפה, לחץ כאן

  • שגיאת אימות

```bash 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//first-contributions.git/' ``` עברו אל [המדריך של GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) על יצירה והגדרה של מפתח SSH לחשבון שלך. כמו כן, ייתכן שתרצה להריץ את הפקודה 'git remote -v' כדי לבדוק את הכתובת המרוחקת שלך. אם זה דומה לזה: ```bash origin https://github.com/your-username/your_repo.git (fetch) origin https://github.com/your-username/your_repo.git (push) ``` תחליף את זה בעזרת הפקודה: ```bash git remote set-url origin git@github.com:your-username/your_repo.git ``` אחרת, עדיין תתבקש לספק שם משתמש וסיסמה ותקבל שגיאת אימות.
## הגישו את השינויים שלכם לסקירה אם תלכו למאגר שלכם ב-GitHub, תוכלו לראות כפתור עם הכיתוב `Compare & pull request`. לחצו על כפתור זה. צור בקשת משיכה כעת, הגישו את בקשת הדחיפה (pull request): שלח בקשת משיכה בקרוב, אצרף את כל השינויים לתוך הענף הראשי של פרויקט זה. אתם תקבלו עדכון במייל ברגע שהשינויים ימוזגו. ## מה לעשות מכאן? כל הכבוד! כרגע סיימתם את מעגל הזרימה הסטנדרטי של _fork -> clone -> edit -> pull request_ שאתם תפגשו באופן שכיח כתורמים! תחגגו את התרומתכם ושתפו אותה עם החברים והעוקבים שלכם בכך שתלכו ל-[web app](https://firstcontributions.github.io/#social-share). אם אתם רוצים עוד תרגול, בדקו את [תרומות הקוד](https://github.com/roshanjossey/code-contributions). עכשיו אפשר להתחיל לתרום לפרוייקטים אחרים. הכנו רשימה של פרוייקטים על נושאים קלים שאתם יכולים להתחיל לעבוד עליהם. [רשימה של פרוייקטים ב- web app](https://firstcontributions.github.io/#project-list). ### [חומר נוסף](../additional-material/git_workflow_scenarios/additional-material.md) ## הדרכות בשימוש כלים אחרים | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |

פרוייקט זה נתמך על ידי:

================================================ FILE: docs/translations/README.hi.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # प्रथम योगदान इस परियोजना का उद्देश्य शुरुआती लोगों द्वारा अपना पहला योगदान करने की प्रक्रिया को सरल और मार्गदर्शित करना है। यदि आप योगदान देना चाहते हैं, तो नीचे दिए गए चरणों का पालन करें। आर्टिकल्स पढ़ना और ऑनलाइन ट्यूटोरियल्स देखना मददगार साबित हो सकते हैं, लेकिन बिना कुछ गलती करके खुद काम करने से अच्छा हो सकता है। इस प्रोजेक्ट आपको अपने पहले योगदान के लिए दिशा निर्देशित करेगा। याद रखें - जितने तनाव मुक्त होकर आप सीखेंगे, उतना ही बेहतर सीख पाएंगे। नीचे दिए गए निर्देशों का पालन करें। इस रिपॉज़िटरी को फ़ोर्क करें यदि आपके कंप्यूटर पर Git नहीं है तो, [इसे स्थापित करें](https://help.github.com/articles/set-up-git/) । _यदि आप कमांड लाइन के साथ सहज नहीं हैं, [तो यहाँ ग्राफिकल इंटरफेस (GUI) टूल्स का उपयोग करने वाले ट्यूटोरियल हैं] (#अन्य-टूल-का-उपयोग-करके-ट्यूटोरियल) ।_ ## रिपॉज़िटरी को फोर्क करना काँटा (फोर्क) बटन पर क्लिक करके इस रिपॉज़िटरी को फोर्क कर सकते हैं। यह आपके GitHub खाते (अकाउंट) में इस रिपॉज़िटरी की एक प्रति (कॉपी) बना देगा जो केवल आपके लिए उपलब्ध होगी। ## रिपॉज़िटरी को क्लोन करना इस रिपॉज़िटरी को क्लोन करें अब इस रिपॉज़िटरी को अपने कंप्यूटर पर क्लोन (यानी डाउनलोड) करें। अपने GitHub अकाउंट पर जाएँ, फोर्क की गई रिपॉज़िटरी खोलें, 'Code/कोड' बटन पर क्लिक करें, और फिर 'Copy to Clipboard' आइकॉन पर क्लिक करें। अपने कंप्यूटर पर एक टर्मिनल/कमांड प्रांप्ट खोलें और निम्न git आदेश (कमांड) चलाएँ: ```bash git clone "यूआरएल जिसे आपने अभी कॉपी किया" ``` जहाँ "यूआरएल जिसे आपने अभी कॉपी किया" (उद्धरण चिह्नों के बिना) इस रिपॉज़िटरी के लिए यूआरएल है (इस परियोजना का आपका फोर्क) । यूआरएल प्राप्त करने के लिए पिछले निर्देश देखें । उदाहरण के लिए: ```bash git clone https://github.com/यह-आप-हैं/first-contributions.git ``` URL को क्लिपबोर्ड में कॉपी करें `यह-आप-हैं` आपके GitHub अकाउंट का नाम है। यहाँ आप अपने कंप्यूटर में GitHub से first-contributions रिपॉज़िटरी को कॉपी कर रहे हैं अथवा उसकी एक लोकल/स्थानीय कॉपी बना रहे हैं । ## एक शाखा (ब्राँच) बनाएँ अपने कंप्यूटर पर बनाई गई रिपॉज़िटरी की कॉपी के फोल्डर/डायरेक्टरी में जाएँ (यदि अभी तक नहीं की है तो निम्न आदेश चलाएँ) ```bash cd first-contributions ``` अब एक नई शाखा बनाएँ `git switch` कमांड का उपयोग करके । नई शाखा बनाने के लिए -c ऑप्शन का उपयोग होता है । ```bash git switch -c <अपनी-शाखा-का-नाम-जोड़ें> ``` उदाहरण के लिए: ```bash git switch -c add-alonzo-church ``` ( शाखा के नाम में `add` जोड़ने की आवश्यकता नहीं है, लेकिन इसमें शामिल होना जरूरी है क्योंकि इस शाखा का उद्देश्य एक सूची में अपना नाम जोड़ना है। ) ## आवश्यक परिवर्तन करें और उन परिवर्तनों को कमिट करें- अब `Contributors.md` फ़ाइल को एक टेक्स्ट एडिटर में खोलकर इसमें अपना नाम जोड़ दें। फ़ाइल की शुरुआत या अंत में इसे न जोड़ें। इसे बीच में कहीं भी रखें । गिट स्थिति देखें आप यदि `git status` कमांड चलाएंगे , तो आपको अपने द्वारा किये गए परिवर्तन देखेंगे। उन परिवर्तनों को बनाई गई शाखा में जोड़ने के लिए `git add` कमांड का उपयोग करें । ```bash git add Contributors.md ``` अब अपने किये गए बदलावों को `git commit` कमांड का उपयोग करके कमिट करें । ```bash git commit -m "Add <आपका-नाम> to Contributors list" ``` <आपका-नाम> की जगह अपना नाम लिखें । ## अपने बदलावों को Github में पुश करें । `git push` का उपयोग कर अपने परिवर्तन को पुश करें । ```bash git push origin <अपनी-शाखा-का-नाम-जोड़ें> ``` `<अपनी-शाखा-का-नाम-जोड़ें>` की जगह अपनी शाखा का नाम लिखें । ## अपने बदलावों को रिव्यु के लिए सबमिट करें । यदि आप अपने GitHub प्रोफ़ाइल पर अपनी रिपॉज़िटरी खोलते हैं, तो आपको 'Compare & pull request' का विकल्प दिखाई देगा। उस पर क्लिक करें। पुल रिक्वेस्ट बनाएं अब अपनी pull request सबमिट करें । पुल रिक्वेस्ट सबमिट करें जल्द ही मैं आपके बदलावों को इस प्रोजेक्ट की मुख्य शाखा में सम्मिलित कर दूंगा। आपको एक ईमेल आएगी जब आपके बदलाव सम्मिलित होंगे । ## यहाँ से कहाँ जाएं? बधाई! आपने _fork -> clone -> edit -> PR_ वर्कफ्लो की पूर्ति कर ली है, जिसका आप अक्सर एक योगदानकर्ता के रूप में सामना करेंगे! अपने पहले योगदान की खुशी में जश्न मनाएं तथा इसे [वेब एप्प](https://firstcontributions.github.io/#social-share) के जरिये अपने मित्रों के साथ शेयर करें। यदि आप अधिक अभ्यास करना चाहते हैं, तो हमारे । [कोड योगदान](https://github.com/roshanjossey/code-contributions) अब आप अन्य प्रोजेक्ट्स पर योगदान कर सकते हैं, तो चलिए शुरू करते हैं! हमने आपके लिए एक प्रोजेक्ट्स की सूचि तैयार की है जहाँ सरल इश्यूज हैं । आप चाहें तो वहाँ से आरम्भ कर सकते हैं । [प्रोजेक्ट्स कि लिस्ट](https://firstcontributions.github.io/#project-list) ## शिक्षण अन्य साधनो का उपयोग करने के लिए |गिटहब डेस्कटॉप | विज़ुअल स्टूडियो 2017 | गिटक्रैकेन | वीएस कोड | सॉर्सट्री ऐप | | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | ================================================ FILE: docs/translations/README.hne.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [स्लैक टीम ल ज्वाइन करऽ](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # प्रथम योगदान पहली बार कुछू करे बर कठिन होथे| ख़ास तौर पर जब आपमन मिलकर काम करथव तब गलतियां करना बने बात नहीं आय | मगर आपस म मिलना अउ एक जुट होकर काम करे ल ही त ओपन सोर्स कइथे| हमन आप मन के पहला ओपन सोर्स कॉन्ट्रिब्यूशन/योगदान आसान बनाए बर आपमन की मदद करबो | आर्टिकल्स पढ़े अउ ऑनलाइन ट्यूटोरियल देखके मदद मिल सकत हे मगर बिना कुछू गलत करे अउ खुद वो काम करे ले बने अउ का हो सकत हे ? यह प्रोजेक्ट आपमन के पहले कॉन्ट्रिब्यूशन बर दिशा निर्देशन करे बर बने मदद करहि | याद रखौ - जतका तनाव मुक्त होकर आप मन सिखहु ततका आपमन बने सीख पाबौ | अगर आप मन अपन पहली कॉन्ट्रिब्यूशन करना चाहत हो त आगे दिए तरीका ल बने फॉलो करौ | ई रिपॉजिटरी के फोर्क करऽ आपमन के कंप्यूटर म Git नहीं हे त, [एला स्थापित करौ](https://help.github.com/articles/set-up-git/) ## रिपॉज़िटरी ल फॉर्क करे बर कांटा (फॉर्क) बटन म क्लिक करके ए रिपॉज़िटरी ल फॉर्क कर सकत हो| ए ह आपमन के GitHub खाते म इही रिपॉज़िटरी के एकठन प्रति (कॉपी) बना दिहि। ## रिपोजिटरी क्लोन ई रिपॉजिटरी के क्लोन करऽ अब आपमन ए रेपो ल अपन कंप्यूटर म क्लोन (डाउनलोड) करव| अपन GitHub खाते म जाकर क्लोन बटन म क्लिक करव अउ फिर कॉपी टू क्लिपबोर्ड आइकॉन म क्लिक करव | अपन कंप्यूटर म एक ठन टर्मिनल/कमांड प्रांप्ट खोलव अउ निम्न git आदेश चलावव: ```bash git clone "यूआरएल जैला आपमन कॉपी करे हावव " ``` जेती "यूआरएल जैला आपमन कॉपी करे हावव" (उद्धरण चिह्नों के बिना) ए भंडार बर यूआरएल हे । यूआरएल प्राप्त करे बर पिछला चरण देखव । उदाहरण बर: ```bash git clone https://github.com/यह-तै-हावस/first-contributions.git ``` URL के क्लिपबोर्ड में कॉपी करऽ यह-तै-हावस आपमन के GitHub अकाउंट के नाम हावै। एती आपमन अपन कंप्यूटर न GitHub ले फर्स्ट-कंट्रिब्यूशंज़ रेपो ल कॉपी करथव अउ ओखर एक लोकल/स्थानीय कॉपी बनावथस| ## एक ब्राँच बनाए बर अपन कंप्यूटर म बनाये गए रिपॉजिटरी के कॉपी के फोल्डर/डायरेक्टरी म जावव (अगर अब तक नहीं करे हावस त निम्न आदेश चलावव) ```bash cd first-contributions ``` अब एक ठी नवा शाखा बनवाव `git checkout` कमांड के उपयोग करके | नवा शाखा बनाए बर -b ऑप्शन के उपयोग होथे। ```bash git checkout -b <अपन-शाखा-के-नाम-जोड़ें> ``` उदाहरण बर: ```bash git checkout -b add-alonzo-church ``` ( शाखा के नाम म `add` जोड़ने के आवश्यकता नहीं हावए, लेकिन एमा जोड़ना चल जाहि काबर की ए शाखा के उद्देश्य एक सूची म अपन नाम ल जोड़े बर हे। ) ## आवश्यक परिवर्तन करे बर अउ उन परिवर्तनों ल कमिट करे बर- अब `Contributors.md` फ़ाइल ल एक टेक्स्ट एडिटर म खोलकर एमा अपन नाम लिखव। फ़ाइल के शुरुआत या अंत म एला झन जोड़बे। एला बीच म कही तिरिया देहु आपमन | git status आपमन अगर `git status` निर्देश चलाहु , त आपमन ल किये गए परिवर्तन दिखहि। उन परिवर्तनों ल बनाए गए शाखा म जोड़े बर `git add` कमान्ड के उपयोग करव | ```bash git add Contributors.md ``` अब अपन करे गए बदलाव ल कमिट करे बर `git commit` आदेश के उपयोग करव | ```bash git commit -m "Add <अपन-नाम> to Contributors list" ``` <अपन-नाम> के जगह अपन नाम डालव| ## अपन करे बदलाव ल Github म पुश करव| `git push` के उपयोग कर अपन परिवर्तन ल पुश करव| ```bash git push origin <अपन-शाखा-के-नाम-जोड़व> ``` `<अपन-शाखा-के-नाम-जोड़व>` के जगह अपन शाखा के नाम डालव| ## अपन बदलाव ल रिव्यु करे बर सबमिट करव| आपमन अपन github प्रोफाइल म अपन रेपो म जाबा अउ Compare & pull request ल दबवाव| पुल रिक्वेस्ट खोलऽ आप मन के pull request सबमिट करव| पुल रिक्वेस्ट भेजऽ मैं आपमन के बदलाव ल ए प्रोजेक्ट के मास्टर शाखा म तुरते मर्ज कर दुहु| आप मन ल एक ठन मेल आ जहि जब बदलाव मर्ज होही| ## इहा ले कती जाबो? बधाई हो मितान! आपमन ने_fork -> clone -> edit -> PR_ वर्कफ़्लो ल पूरा कर डरे हव! अपन पहली योगदान के ख़ुशी म अपन संगी मन करा शेयर करव [वेब एप्प](https://firstcontributions.github.io/#social-share) पे जाके | आपमन हमर स्लैक टीम ल ज्वाइन कर सकत हव अगर आपमन ल कोनो सहायता के जरुरत होही त | [म ज्वाइन करव](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) अब आपमन अउ प्रोजेक्ट्स म कंट्रीब्यूट करे बर शुरू कर सकत हव | हमन एक लिस्ट बनाए हन जेन म अड़बड़ सरल मुद्दे हवएं| [प्रोजेक्ट्स के लिस्ट](https://firstcontributions.github.io/#project-list) ## अन्य टूल के उपयोग करके ट्यूटोरियल | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.hr.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Prvi doprinosi Cilj ovog projekta je da pruži jednostavne korake za početnike da naprave svoje prve doprinose. Ukoliko želite napraviti prvi doprinos pratite sljedeće korake ispod. #### _Ukoliko niste baš sigurni u svoj rad s komandnom linijom/terminalom, [ovdje možete pronaći tutorijale za GUI alate.](#Upute-za-druge-alate)_ Napravite fork repozitorijuma Ukoliko nemate git instaliran na Vašem računalu, [instalirajte ga ovdje](https://help.github.com/articles/set-up-git/). ## Napravite fork repozitorija Forkajte ovaj repozitorij tako da kliknete na dugme _fork_ na vrhu stranice. Ovako pravite kopiju repozitorija na vašoj github stranici. ## Klonirajte repozitorij klonirajte ovaj repozitorij Sada klonirajte repozitorij koji ste prethodno forkali. Posjetite svoj GitHub profil, otvorite repozitorij koji ste forkali, kliknite na _clone_ (kloniraj) dugme i kliknite na ikonicu _copy to clipboard_. Otvorite terminal i upišite slijedeće git naredbe: ```bash git clone "url koji ste upravo kopirali" ``` gdje je "url koji ste sada kopirali" (bez navodnika) url na ovaj repozitorij (vaš fork ovog projekta). Pogledajte prethodne korake kako dohvatiti url. kopirajte URL u međuspremnik Na primjer: ```bash git clone https://github.com/ovo-ste-Vi/first-contributions.git ``` Gdje je umjesto `ovo-ste-Vi` upisano vaše _github_ korisničko ime. Ovime kopirate sadržaj repozitorija _first-contributions_ na vaše računalo. ## Stvaranje grane _branch_ Prebacite se u radni direktorij na Vašem računalu (ukoliko već niste tamo): ```bash cd first-contributions ``` Pa zatim napravite novu granu _branch_ koristeći `git switch` comandu: ```bash git switch -c dodaj-svoje-ime ``` Na primjer: ```bash git switch -c add-alonzo-church ``` ## Napravite potrebne izmjene i potvrdite promjene Otvorite `Contributors.md` datoteku u tekst editoru i dodajte Vaše ime. Nemojte dodavati ime na sam početak ili kraj. Stavite ga negdje u sredinu. Potom spremite datoteku. git status naredba Ukoliko odete u radni direktorij i izvršite naredbu `git status`, primijetit ćete da postoje promjene. Dodajte ove promjene u granu koju ste gore napravili koristeći `git add` naredbu: ```bash git add Contributors.md ``` Sada potvrdite ove promjene koristeći `git commit` naredbu: ```bash git commit -m "Add svoje-ime to Contributors list" ``` Gdje umjesto `svoje-ime` upisujete svoje ime. ## Pushajte promjene na GitHub Pošaljite promjene u repozitorij na GitHub-u koristeći naredbu `git push`: ```bash git push origin -u ime-Vaše-grane ``` gdje umjesto `ime-Vaše-grane` stavljate ime vaše grane koje ste prethodno napravili. ## Pošaljite izmjene na pregled Ukoliko odete na repozitorij na Vašem GitHub profilu primijetit ćete `Compare & pull request` Dugme. Kliknite na njega. izradite pull request a zatim pošaljite zahtjev klikom na dugme _Create pull request_. pošaljite pull request Nakon toga, vlasnik će spojiti promjene koje ste napravili sa master granom projekta. Dobit ćete mail potvrde kada se grane spoje. ## Što dalje? Čestitamo! Završili ste standardni _fork -> clone -> edit -> PR_ tok koji će vas pratiti kroz Vaš čitav programerski život! Proslavite tako što ćete podjeliti svoj doprinos sa prijateljima i pratiocima otvaranjem [stranice](https://firstcontributions.github.io/#social-share). Sada možemo početi sa doprinosima drugim projektima. Napravili smo popis projekata sa jednostavnim problemima na kojima možete početi raditi. Posjetite [listu projekata na naštoj stranici](https://firstcontributions.github.io/#project-list). ### [Dodatni materijali](../additional-material/git_workflow_scenarios/additional-material.md) ## Upute za druge alate | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.hu.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Első közreműködés nyílt forráskódú projektben Minden kezdet nehéz, ezért szeretnénk segíteni számodra az első lépésekben ahhoz, hogy bátran kódolj kooperatívan nyílt forráskódú projekteket. Senki sem szeret hibázni, de szerencsére itt most nyugodtan megteheted. A lényeg, hogy gyakorolj! A projekt célja, hogy útmutatást nyújtson, egyszerűsítse és segítse a kezdők első lépéseit nyílt forráskódú szoftverek közös programozásában. Ha te is most készülsz először ilyet csinálni, segítünk neked, kövesd az alábbi lépéseket. #### *Ha a parancssor kényelmetlen, [itt egy tutorial a GUI felület használatához.](#Oktatóanyagok-más-eszközök-használatával)* ágaztasd el ezt a tárolót Ha nincs a gépeden git, [telepítsd fel]( https://help.github.com/articles/set-up-git/). ## Ágaztasd ezt a repót (fork) A Fork gomb kattintásával ágaztasd el ezt a repót. Ezzel készítettél egy másolatot erről a reporól a te saját git fiókodba. ## Klónozd a repót (clone) klónozd ezt a repót Most klónozd az elágaztatott repót a gépedre. Menj a GitHub fiókodra, nyisd meg a forkolt repositoryt, kattints a clone gombra, majd kattints a *copy to clipboard* ikonra. Nyiss egy terminált és futtasd a következő parancsot: ```bash git clone "url-amit-most-masoltal-le" ``` A "url-amit-most-masoltal-le" kifejezést, cseréld ki (idézőjelek nélkül) a vágólapra helyezett repository url címére (ami ebből a projektől ágazik). Az ágaztatás folyamatát lásd az előző lépésben. másold az URL címet a vágólapra Például: ```bash git clone https://github.com/a-te-git-neved/first-contributions.git ``` A `a-te-git-neved` lesz a GitHub felhasználóneved. Ezzel letöltöd a first-contributions repositoryt GitHub-ról a saját számítógépedre. ## Készíts egy ágat (branch) Navigálj a repository könytárába (ha nem ott vagy jelenleg): ```bash cd first-contributions ``` Most készítsünk egy ágat `git checkout` parancs használatával: ```bash git switch -c ``` Például: ```bash git switch -c add-gabor-takacs ``` (A branch nevében nem kötelező, hogy benne legyen az *add* szó, de észszerű belefoglalni, mert ennek az ágnak az a célja, hogy hozzáadja a nevünket egy listához.) ## Végezd el a szükséges változtatásokat és rögzítsd azokat (commit) Nyisd meg a `Contributors.md` fájlt egy szövegszerkesztőben, majd add hozzá a neved. Ne a fájl elejére vagy végére helyezd, hanem a kettő közé. A kettő között bárhová teheted. Mentsd el a fájlt. git állapota Ha a project könyvtárába navigálsz és futtatod a `git status` parancsot, akkor a következő módosításokat fogod látni: Ezeket a módosításokat add hozzá a branchez a `git add` paranccsal: ```bash git add Contributors.md ``` Commitoljuk a módosításokat a `git commit` paranccsal: ```bash git commit -m "Add to Contributors list" ``` Helyettesítsd `` kifejezést a saját neveddel. ## Töltsd fel az elkészült változtatásokat a GitHub-ra (push) Töltsd fel a változtatásokat a `git push` paranccsal: ```bash git push origin ``` Helyettesítsd az `` kifejezést annak a branchnek a nevével, amit korábban létrehoztál. ## Küldd be a módosításaidat ellenőrzésre (pull request) Ha a saját repódba navigálsz GitHub-on, látnod kell a `Compare & pull request` gombot. Kattints rá! hozz létre egy pull request-et Sikeresen elküldted a pull requested. küldd be a pull request-et Kis idő elteltével összevonja a változásokat a project fő ágában. Értesítést fogsz kapni emailben, ha a változások összefűzésre kerültek. ## Hogyan tovább? Gratulálunk! Sikeresen teljesítetted az alapvető _fork -> clone -> edit -> PR_ folyamatot, melyet gyakran kell majd csinálnod közreműködőként! Ünnepeld meg az első kooperációdat és oszd meg barátaiddal és követőiddel ennek a [web app](https://firstcontributions.github.io/#social-share)-nak a segítségével. Bármilyen kérdésed van vagy segítségre lenne szükséged, csatlakozz slack csapatunkhoz. [Csatlakozz a slack csapathoz.](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). Itt az idő egy másik projektben is közreműködni. Összeállítottunk egy listát azokról a projektekről, melyek könnyebb feladatokat tartalmaznak az induláshoz. Nézd meg a [projektek listáját](https://firstcontributions.github.io/#project-list) a webalkalmazásban. ### [Kiegészítő anyag](../additional-material/git_workflow_scenarios/additional-material.md) ## Oktatóanyagok más eszközök használatával | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.hy.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Առաջին ներդրումները(contributions) Այս նախագիծը նպատակ ունի պարզեցնել և առաջնորդել սկսնակներին իրենց առաջին ներդրման ճանապարհին: Եթե ցանկանում եք կատարել ձեր առաջին ներդրումը, հետևեք ստորև նշված քայլերին: _Եթե հրամանի պատուհանը (command line) ձեզ հարմար չէ, [ահա ուղեցույցներ գրաֆիկական ինտերֆեյսի (GUI) կիրառմամբ.](#Ուղեցույցներ-այլ-գործիքների-կիրառմամբ)_ ճյուղավորել այս պահեստը #### Եթե դուք չունեք git ձեր մեքենայի վրա, [տեղադրեք այն](https://help.github.com/articles/set-up-git/) ## Ճյուղավորեք (fork) այս պահոցը (repository) Ստեղծեք ձեր սեփական պատճենը՝ սեղմելով այս էջի վերևում գտնվող `fork` կոճակը: Դա կստեղծի այս պահոցի պատճենը ձեր պրոֆիլում: ## Կլոնավորեք պահոցը կրկնօրինակել այս պահեստը Հիմա կլոնավորեք պահոցը ձեր համակարգչում: Հղումը պատճենելու համար սեղմեք `clone` կոճակը, այնուհետև `copy to clipboard` կոճակը: Բացեք տերմինալը և գործարկեք հետևյալ git հրամանը. ```bash git clone "url you just copied" ``` Որտեղ "url you just copied"-ը (առանց չակերտների) ձեր պահոցի հղումն է (այս նախագծի ձեր ճյուղավորումը). Հետևեք քայլերին, որպեսզի ստանաք հղումը. cպատճենել URL-ը սեղմատախտակին Օրինակ՝ ```bash git clone https://github.com/this-is-you/first-contributions.git ``` Որտեղ `this-is-you`-ն github-ի ձեր մուտքանունն է. Այսպիսով դուք պատճենում եք first-contributions պահոցը՝ GitHub-ից, ձեր համակարգչի վրա: ## Ստեղծեք ճյուղ Մուտք գործեք ձեր համակարգչում գտնվող պահոցը, եթե արդեն այնտեղ չեք։ ```bash cd first-contributions ``` Հիմա ստեղծեք նոր ճյուղ՝ օգտագործելով `git checkout` հրամանը․ ```bash git checkout -b ``` Օրինակ՝ ```bash git checkout -b add-alonzo-church ``` ## Կատարեք անհրաժեշտ փոփոխությունները և կատարեք ձեր ներդրումը (commit) Հիմա բացեք `Contributors.md` ֆայլը ձեր տեքստային խմբագրիչում, գրեք ձեր անունը և պահպանեք ֆայլը։ Մի ավելացրեք այն ֆայլի սկզբում կամ վերջում: Տեղադրեք այն որևէ տեղ մեջտեղում: Այժմ պահպանեք ֆայլը: git status Եթե գնաք նախագծի պանակ և կատարեք `git status` հրամանը, կտեսնեք, որ փոփոխություններ կան: Ավելացրեք այդ փոփոխությունները այն ճյուղին, որը հենց նոր ստեղծեցիք՝ օգտագործելով `git add` հրամանը. ```bash git add Contributors.md ``` Այժմ գործադրեք այս փոփոխությունները `git commit` հրամանով. ```bash git commit -m "Add to Contributors list" ``` Փոփոքեք ``-ը ձեր անունով ## Push արեք փոփոխությունները github Push արեք ձեր փոփոխությունները `git push` հրամանով․ ```bash git push origin ``` Փոփոխոք ``-ը ավելի վաղ ստեղծած ճյուղի անունով:
Եթե push անելիս առաջանում են սխալներ, սեղմեք այստեղ՝ - ### Authentication Error 
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//first-contributions.git/'
Go to [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account.
## Հաստատեք փոփոխությունները վերանայման համար Եթե այցելեք ձեր GitHub պահոցը, կտեսնեք `Compare & pull request` կոճակը։ Սեղմեք այդ կոճակը։ ստեղծել pull request Ապա հաստատեք pull հարցումը: Ներկայացնել pull request Շուտով ես կմիավորեմ ձեր բոլոր փոփոխությունները այս նախագծի գլխավոր մասնաճյուղի մեջ: Փոփոխությունները միաձուլվելուց հետո դուք կստանաք ծանուցող նամակ: ## Ու՞ր գնալ այստեղից Շնորհավորանքնե՛րս, դուք հենց նոր ավարտեցիք ստանդարտ _fork -> clone -> edit -> pull request_ աշխատակարգը, որը հաճախ կհանդիպեք որպես ներդրող: Նշեք ձեր ներդրումը և կիսվեք այն ձեր ընկերների և հետևորդների հետ՝ այցելելով [web app](https://firstcontributions.github.io/#social-share). Եթե ցանկանում եք ավելի շատ փորձ, դիտեք [code contributions](https://github.com/roshanjossey/code-contributions). Հիմա կարող եք ձեր ներդրումն ունենալ այլ նախագծերում։ Մենք կազմել ենք հեշտ խնդիրներ ունեցող նախագծերի ցանկ, որոնցից կարող եք սկսել: Համեցեք [վեբ հավելվածի նախագծերի ցանկը](https://firstcontributions.github.io/#project-list). ### [Լրացուցիչ նյութեր](additional-material/git_workflow_scenarios/additional-material.md) ## Ուղեցույցներ այլ գործիքների կիրառմամբ | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.id.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Kontribusi Pertama Proyek ini bertujuan untuk menyederhanakan dan membimbing perjalanan seorang pemula berkontribusi di Github untuk pertama kali. Perhatikan langkah-langkah berikut untuk memulai: #### _Jika Anda tidak terbiasa dengan baris perintah(command line), [di sini ada tutorial untuk menggunakan GUI(antarmuka bergrafis).](#Tutorial-Menggunakan-Alat-Lain)_ fork repositori ini Apabila Anda belum menginstall git di komputer Anda, [install segera](https://help.github.com/articles/set-up-git/). ## _Fork_ Repositori Ini Fork repositori ini dengan cara klik tombol _Fork_ yang ada di bagian atas kanan pada halaman ini. Hal Ini akan membuat sebuah salinan repositori di akun Anda. ## _Clone_ (Kloning) Repositori klon repositori ini Sekarang kloning repositori yang sudah Anda _fork_ ke komputer Anda. Pergi ke akun GitHub Anda, buka repositori yang sudah Anda _fork_, klik tombol _Code_ dan kemudian klik ikon salin ke papan klip. Buka sebuah terminal dan jalankan perintah git berikut: ``` git clone "url yang telah Anda disalin" ``` bagian "url yang telah Anda disalin" (tanpa tanda petik) adalah url ke repositori ini (proyek yang telah Anda _fork_ ini). Lihat langkah sebelumnya untuk mendapatkan url. salin URL ke papan klip Contohnya: ``` git clone git@github.com:ini-adalah-anda/first-contributions.git ``` bagian `ini-adalah-anda` adalah nama pengguna GitHub Anda. Di sini Anda menyalin konten dari repositori first-contributions di GitHub ke komputer Anda. ## Membuat Sebuah _Branch_ (Cabang) Pindah ke direktori repositori yang terdapat pada komputer Anda (jika Anda belum berada di sana): ``` cd first-contributions ``` Sekarang buatlah sebuah _branch_ menggunakan perintah `git checkout`: ``` git checkout -b ``` Contohnya: ``` git checkout -b add-alonzo-church ```
Jika kamu mendapatkan beberapa kesalahan menggunakan git switch, klik disini: Jika pesan error: "Git: `switch` is not a git command. See `git –help`" muncul, kemungkinan besar Anda menggunakan versi git yang lama. Dalam kasus ini, coba gunakan `git checkout` sebagai gantinya: ```bash git checkout -b your-new-branch-name ```
## Buat Perubahan Yang Diperlukan Lalu _Commit_ (Simpan) Perubahan Tersebut Sekarang buka berkas `Contributors.md` menggunakan teks editor, tambahkan nama Anda ke dalamnya. Jangan menambahkan pada awal atau akhir dari berkas. Simpan dimana saja di antaranya. Sekarang simpan berkasnya. status git Jika Anda pergi ke direktori proyek dan mengeksekusi perintah `git status`, Anda akan melihat ada sebuah perubahan. Tambahkan perubahan tersebut ke _branch_ yang baru saja Anda buat menggunakan perintah `git add`: ``` git add Contributors.md ``` Sekarang simpan perubahan tersebut menggunakan perintah `git commit`: ``` git commit -m "Add to Contributors list" ``` Ubah bagian `` dengan nama Anda. ## Dorong (Push) Perubahan Ke GitHub _Push_ perubahan menggunakan perintah `git push`: ``` git push origin ``` ganti bagian `` dengan nama cabang yang sebelumnya Anda buat.
Jika Anda mendapatkan kesalahan saat melakukan push, klik disini: - ### Kesalahan Autentikasi 
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//first-contributions.git/'
Buka [tutorial GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) untuk menghasilkan dan mengkonfigurasi sebuah kunci SSH ke akun Anda. Jika kelihatannya seperti ini: 
origin	https://github.com/your-username/your_repo.git (fetch)
    origin	https://github.com/your-username/your_repo.git (push)
Buat perubahan dengan perintah: 
git remote set-url origin git@github.com:your-username/your_repo.git
Jika tidak, Anda akan tetap dimintai nama pengguna dan kata sandi serta mendapatkan kesalahan autentikasi.
## Kirim Perubahan Untuk Diperiksa Jika Anda membuka repositori Anda di GitHub, Anda akan melihat sebuah tombol `Compare & pull request`. Tekan tombol tersebut. buat pull request Sekarang kirimkan _Pull Request_ kirim pull request Saya (pengelola) akan segera menggabungkan semua perubahan Anda ke cabang utama (_main branch_) dari proyek ini. Anda akan mendapatkan email pemberitahuan setelah perubahan digabungkan. ## Ke Mana Lagi Setelah Dari Sini? Selamat! Anda baru saja menyelesaikan standar _fork_ -> _clone_ -> _edit_ -> _pull request_ sebuah alur kerja yang akan sering Anda temui sebagai seorang kontributor! Rayakan kontribusi Anda dan bagikan dengan teman-teman dan pengikut Anda dengan membuka [web app](https://firstcontributions.github.io/#social-share). Jika Anda ingin lebih banyak latihan, lihat [kontribusi kode](https://github.com/roshanjossey/code-contributions). Sekarang mari kita mulai dengan berkontribusi di proyek lain. Kami sudah menyusun daftar proyek dengan isu yang mudah dikerjakan sehingga Anda dapat segera memulai. Cek di [daftar proyek web app](https://firstcontributions.github.io/#project-list). ## [Materi tambahan](../additional-material/translations/additional-material.id.md) ## Tutorial Menggunakan Alat (tools) Lain | Aplikasi GitHub Desktop | Visual Studio 2017 | Program GitKraken | Editor VS Code | Aplikasi Sourcetree | Program IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |

Proyek ini didukung oleh:

================================================ FILE: docs/translations/README.igb.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Onyinye Mbụ O siri ike. Ọ na-esiri gị ike mgbe mbụ i mere ihe. Karịsịa mgbe ị na-emekọ ihe, imehie ihe abụghị ihe dị mma. Anyị chọrọ ime ka ụzọ ndị ọhụrụ na-emeghe emeghe na-amụta ma tinye aka maka oge mbụ. Ịgụ isiokwu & nkuzi ntanetị nwere ike inyere gị aka, ma gịnị dị mma karịa ime ihe ahụ na-eme ihe omume? Ihe oru a bu iji nye nduzi & mee ka ndi mmadu bidoro ibu onyinye mbu. Ọ bụrụ na ị na-achọ ime onyinye mbụ gị, gbasoo nzọụkwụ dị n'okpuru. #### _Ọ bụrụ na ị naghị enwe mmasị na akara iwu, [ebe a bụ nkuzi na-eji ngwaọrụ GUI.](#Nkuzi-na-iji-ihe-ndi-ozo)_ Fork depo a Ọ bụrụ na ịnweghị igwe na igwe gị, [wụnye ya](https://help.github.com/articles/set-up-git/). ## Wepu ebe nchekwa a Wepu a repo site na ịpị bọtịnụ mkpịsị aka n'elu nke ibe a. Nke a ga-emepụta otu ntinye nchekwa a na akaụntụ gị. ## Na-ekpuchi ebe nchekwa Kopịa depo a Ugbu a, dochie ya repo na igwe gị. Gaa na akaụntụ GitHub gị, meghee repo ahụ maka pịa, pịa bọtịnụ clone ma pịazie ya na akara ngosi akara ngosi. Mepee ọnụ ma jikwa iwu na-esonụ: ``` git clone "url you just copied" ``` ebe "url na ị depụtaghachiri" (na-enweghị ntinye ọnụ) bụ url maka nchekwa ebe a (mgbịrịgwụ nke ọrụ a). Hụ nzọụkwụ ndị gara aga iji nweta url. Kopịa URL gaa na klipbọọdụ Ọmụmaatụ: ``` git clone https://github.com/this-is-you/first-contributions.git ``` ebe `this-is-you` ka aha njirimara GitHub gị. Lee, ị na-edegharị ọdịnaya nke onyinye ntinye mbụ na GitHub na kọmputa gị. ## Mepụta alaka Gbanwee na nhazi ndekọ na kọmputa gị (ọ bụrụ na ịnweghị ebe ahụ): ``` cd first-contributions ``` Ugbu a, mepụta alaka ụlọ ọrụ site na iji `git checkout` iwu: ``` git checkout -b ``` Ọmụmaatụ: ``` git checkout -b add-alonzo-church ``` (Aha alaka ahụ adịghị mkpa iji tinye okwu ahụ n'ime ya, ma ọ bụ ihe dị mkpa ị gụnyere n'ihi na ebumnuche nke alaka a bụ ịgbakwunye aha gị na ndepụta.) ## Mee mgbanwe ndị dị mkpa ma mee mgbanwe ndị ahụ Ugbu a mepee `Contributors.md` faịlụ na nchịkọta ederede, tinye aha gị na ya. Adakwunye ya na mmalite ma ọ bụ njedebe nke faịlụ ahụ. Tinye ya n'ebe ọ bụla n'etiti. Ugbu a, chekwaa faịlụ ahụ. git status Ọ bụrụ na ịga na ndekọ ụlọ ọrụ ma mebie iwu ahụ `git status`, ị ga-ahụ na e nwere mgbanwe. Tinye mgbanwe ndị a n'alaka ụlọ ọrụ ị mepụtara site na iji `git add` iwu ahụ: ``` git add Contributors.md ``` Ugbu a mee mgbanwe ndị ahụ site na iji `git commit` iwu ahụ: ``` git commit -m "Add to Contributors list" ``` jiri aha gị dochie ``. ## Kwanye mgbanwe nile a n'ime GitHub Mee mgbanwe gị site na iji iwu `git push`: ``` git push origin ``` dochie `` aha alaka ụlọ ọrụ ị mepụtara n'oge gara aga. ## Nyefee mgbanwe gị maka nyocha Ọ bụrụ na ị gaa ebe nchekwa gị na GitHub, ị ga-ahụ `Compare & pull request` bọtịnụ. Pịa bọtịnụ ahụ. Mepụta arịrịọ pull Ugbu a, rịọ arịrịọ ahụ. Zipu arịrịọ pull N'oge na-adịghị anya, m ga-emeri mgbanwe gị niile n'ime ngalaba alaka ụlọ ọrụ a. Ị ga-enweta ozi ngosi mgbe ọ bụla emetụtara mgbanwe. ## Ebee ka esi aga ebe a? Ekele! Naanị ị gụchara ihe nkesa -> mmepụta oyiri -> dezie -> Bọpụ ọrụ PR nke ị ga-ezute mgbe niile dị ka onye na-enye gị! Nalee onyinye gị ma soro ndị enyi gị na ụmụazụ gị kerịta ya site na ịga na [ngwa weebụ](https://firstcontributions.github.io/#social-share). Ugbu a, ka anyị malite site na inye onyinye maka ọrụ ndị ọzọ. Anyị ejikọtawo ndepụta nke oru na okwu dị mfe ị nwere ike ịmalite. Lelee [ndepụta nke oru na ngwa weebụ ](https://firstcontributions.github.io/#project-list). ### [Ihe ndi ozo](../additional-material/git_workflow_scenarios/additional-material.md) ## Nkuzi na iji ihe ndi ozo | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.is.md ================================================ # First-Contributions [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Fyrstu framlög Þetta verkefni miðar að því að einfalda og leiðbeina byrjendum í gegnum fyrsta framlag þeirra. Ef þú vilt gera þitt fyrsta framlag, fylgdu þá skrefunum hér að neðan. _Ef þú ert ekki þægileg(ur) með skipanalínu, [hér eru leiðbeiningar með því að nota GUI verkfæri.](#Leiðbeiningar-með-öðrum-verkfærum)_ fork this repository #### Ef þú ert ekki með Git uppsett á tölvunni þinni, [settu það upp](https://help.github.com/articles/set-up-git/). ## Forkaðu þetta geymsla Forkaðu þessa geymslu með því að smella á "Fork" hnappinn efst á þessari síðu. Þetta mun búa til afrit af geymslunni á þínum GitHub reikningi. ## Klónaðu geymsluna clone this repository Núna klónaðu forkaða geymsluna á þína tölvu. Farðu á GitHub reikninginn þinn, opnaðu forkaða geymsluna, smelltu á "Code" hnappinn og smelltu síðan á "copy to clipboard" táknið. Opnaðu terminal og keyrðu eftirfarandi git skipun: ``` git clone "url sem þú afritaðir" ``` þar sem "url sem þú afritaðir" (án gæsalappa) er slóðin á geymsluna (þitt fork af þessu verkefni). Sjá fyrri skref til að fá slóðina. copy URL to clipboard Til dæmis: ``` git clone https://github.com/þitt-notandanafn/first-contributions.git ``` þar sem `þitt-notandanafn` er þitt GitHub notandanafn. Hér ertu að afrita innihald first-contributions geymslunnar á GitHub yfir á þína tölvu. ## Búðu til grein Farðu í geymsluskrána á tölvunni þinni (ef þú ert ekki þegar þar): ``` cd first-contributions ``` Nú búðu til grein með því að nota `git checkout` skipunina: ``` git checkout -b ``` Til dæmis: ``` git checkout -b add-jon-jonsson ``` (Nafn greinarinnar þarf ekki að innihalda orðið *add* en það er skynsamlegt að hafa það með þar sem tilgangur þessarar greinar er að bæta nafninu þínu við lista yfir framlagsmenn.) ## Gerðu nauðsynlegar breytingar og commit-aðu þær Nú opnaðu `Contributors.md` skrána í textaritli og bættu nafninu þínu við. Ekki bæta því við í upphafi eða enda skrárinnar. Settu það hvar sem passar miðað við stafrófsröð. Vistaðu síðan skrána. git status Ef þú ferð í verkefnismöppuna og framkvæmir skipunina `git status`, þá muntu sjá að það eru breytingar. Bættu þessum breytingum við greinina sem þú bjóst til með `git add` skipuninni: ``` git add Contributors.md ``` Nú commit-aðu þessar breytingar með `git commit` skipuninni: ``` git commit -m "Add <þitt-nafn> to Contributors list" ``` og settu þitt nafn í staðinn fyrir `<þitt-nafn>`. ## Ýttu breytingunum á GitHub Ýttu breytingunum þínum með `git push` skipuninni: ``` git push origin ``` og settu nafnið á greininni sem þú bjóst til áður í staðinn fyrir ``. ## Sendu inn breytingarnar þínar til yfirferðar Ef þú ferð í geymsluna þína á GitHub, þá muntu sjá `Compare & pull request` hnapp. Smelltu á þann hnapp. create a pull request Nú sendu inn pull request. submit pull request Fljótlega mun ég sameina allar breytingarnar þínar við aðalgrein þessa verkefnis. Þú færð tilkynningu í tölvupósti þegar breytingarnar hafa verið sameinaðar. ## Hvað næst? Til hamingju! Þú hefur nú lokið við hefðbundið _fork -> clone -> edit -> pull request_ verkflæði sem þú munt oft rekast á sem framlagsmaður! Fagnaðu framlagi þínu og deiltu því með vinum þínum og fylgjendum með því að fara á [vefappið](https://firstcontributions.github.io/#social-share). ### [Viðbótarefni](additional-material/git_workflow_scenarios/additional-material.md) ## Leiðbeiningar með öðrum verkfærum | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.it.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Il primo contributo È dura. È sempre difficile fare qualcosa per la prima volta. Specialmente quando si sta collaborando, sbagliare ci mette a disagio. Ma l'open source si basa sulla collaborazione e sul lavorare insieme. Pertanto volevamo semplificare il modo in cui i nuovi collaboratori imparano e contribuiscono per la prima volta a progetti open-source. Leggere articoli e guardare tutorial può essere utile, ma cosa c'è di meglio che provare a fare effettivamente le cose sul campo? Questo progetto punta ad essere una guida per i meno esperti. Ricorda: più sei rilassato, meglio imparerai. Se vuoi contribuire per la prima volta, segui i semplici passi elencati qui sotto. Ti promettiamo che sarà divertente. fai il fork di questa repository Se non hai git sul tuo computer, [installalo]( https://help.github.com/articles/set-up-git/). ## Fai il fork di questa repository Fai il *fork* di questa *repo* (abbreviazione di *repository*, ossia un archivio) cliccando sul bottone ***fork*** in cima alla pagina. Questo creerà una copia di questa repository nel tuo account. ## Scarica la repository clona questa repository Ora scarica (*clone*) questa repo nel tuo computer. Clicca sul pulsante per scaricare e poi copia l'url. Apri il terminale e lancia il seguente comando: ```bash git clone "url appena copiato" ``` dove "url appena copiato" (senza le virgolette) è l'url di questa repository. Leggi i passaggi precedenti per ottenere l'url. copia l'URL negli appunti Per esempio: ```bash git clone https://github.com/questo-sei-tu/first-contributions.git ``` dove `questo-sei-tu` è il tuo username GitHub. Qui stai copiando il contenuto della repository da GitHub al tuo computer. ## Crea un ramo (*Branch*) Entra nella directory della repository (se non lo hai già fatto): ```bash cd first-contributions ``` Ora crea un ramo (*branch*) usando il comando `git checkout -b`: ```bash git checkout -b ``` Ad esempio: ```bash git checkout -b aggiungi-alonzo-church ``` (Non è necessario inserire la parola *aggiungi* nel nome del branch, ma in questo caso è ragionevole includerlo poiché lo scopo di questo branch è aggiungere il tuo nome alla lista. Lo scopo di nominare un branch è descrivere le modifiche che andremo ad effettuare, il nome deve essere quindi descrittivo e non generale per facilitare il team con cui si collabora.) ## Fai le modifiche necessarie e crea un commit Ora apri il file `Contributors.md` in un editor, inserisci il tuo nome. Non aggiungerlo all'inizio o alla fine del file ma in un qualsiasi punto nel mezzo. Ora salva il file. Se vai nella directory del progetto ed esegui il comando `git status`, vedrai quali sono i cambiamenti. Aggiungi le modifiche al branch appena creato usando il comando `git add`: ```bash git add Contributors.md ``` Crea ora una commit che includa le modifiche da te fatte, usando `git commit`: ```bash git commit -m "Add to Contributors list" ``` cambiando `` con il tuo nome. ## Invia (*Push*) le modifiche a GitHub Invia (*push*) le tue modifiche con il comando `git push`: ```bash git push origin ``` sostituendo `` con il nome del branch creato prima. ## Invia i tuoi cambiamenti per una revisione Se vai nella tua repository su GitHub, vedrai il pusante `Compare & pull request`. Cliccalo. crea una pull request Ora invia la pull request. invia la pull request Presto saranno incorporati (*merge*) tutti i tuoi cambiamenti nel master branch di questo progetto. Riceverai una mail di notifica una volta che le modifiche saranno state accettate. ### [ Prossimi passi ](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutorial usando altri tool | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ## E ora? Unisciti alla nostra squadra su slack in caso tu abbia bisogno di aiuto o abbia qualche domanda. Proveremo ad aiutarti! [Unisciti alla squadra Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). Qui sotto puoi trovare delle repo popolari dove cercare problemi semplici da cui partire. Continua nelle repo per imparare di più |[![exercism](https://avatars2.githubusercontent.com/u/5624255?v=3&s=100)](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[![fun-retro](https://avatars3.githubusercontent.com/u/15913975?v=3&s=100)](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[![habitat](https://avatars1.githubusercontent.com/u/18171698?v=3&s=100)](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[![scikit-learn](https://avatars0.githubusercontent.com/u/365630?v=3&s=100)](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[![elasticsearch](https://avatars2.githubusercontent.com/u/6764390?v=3&s=100)](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| |---|---|---|---|---|---|---|---| |[exercism](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[Fun Retros](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[react](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[habitat](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[scikit-learn](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[Leiningen](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[numpy](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[elasticsearch](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| |[![homebrew](https://avatars2.githubusercontent.com/u/1503512?v=3&s=100)](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[![rust](https://avatars1.githubusercontent.com/u/5430905?v=3&s=100)](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[![vuejs](https://avatars1.githubusercontent.com/u/6128107?v=3&s=100)](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[![Suave](https://avatars2.githubusercontent.com/u/5822862?v=3&s=100)](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[![OpenRA](https://avatars3.githubusercontent.com/u/409046?v=3&s=100)](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[![PowerShell](https://avatars0.githubusercontent.com/u/11524380?v=3&s=100)](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[![coala](https://avatars2.githubusercontent.com/u/10620750?v=3&s=100)](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[![moment](https://avatars2.githubusercontent.com/u/4129662?v=3&s=100)](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)| |[homebrew](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[Rust](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[vuejs](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[Suave](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[OpenRA](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[PowerShell](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[coala](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[moment](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)| |[![ava](https://avatars0.githubusercontent.com/u/8527916?v=3&s=100)](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[![freeCodeCamp](https://avatars0.githubusercontent.com/u/9892522?v=3&s=100)](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[![webpack](https://avatars3.githubusercontent.com/u/2105791?v=3&s=100)](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[![hoodie](https://avatars1.githubusercontent.com/u/1888826?v=3&s=100)](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[![pouchdb](https://avatars3.githubusercontent.com/u/3406112?v=3&s=100)](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[![neovim](https://avatars0.githubusercontent.com/u/6471485?v=3&s=100)](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level)|[![babel](https://avatars2.githubusercontent.com/u/9637642?v=3&s=100)](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) |[](https://github.com/adobe/brackets/labels/Starter%20bug)| |[ava](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[webpack](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[hoodie](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[pouchdb](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[neovim](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level)|[babel](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) |[brackets](https://github.com/adobe/brackets/labels/Starter%20bug)| | [![Node.js](https://avatars1.githubusercontent.com/u/9950313?v=3&s=100)](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22)|[](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22)| | [Node.js](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |[Semantic-UI-React](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | ================================================ FILE: docs/translations/README.ja.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions 初めてのことは何でも大変なものです。特に他人と協力する時に、間違うのは気持ちの良いことではありません。しかし、オープンソースにおける活動では協力することが全てです。私たちは初めてオープンソースに貢献する人たちが、簡単に貢献できる方法を学べるようにしたいと考えています。 記事を読んだりチュートリアルをやってみることはためになりますが、実際にやってみる方が良いでしょう。このプロジェクトはそのガイダンスを行い、初心者が最初のオープンソースへの貢献を簡単に行えるようにするためのものです。
初めてのオープンソースへの貢献を行いたい場合、以下の簡単なステップに従ってください。 #### *コマンドラインでの操作に慣れていない場合、[グラフィカルなツールでもチュートリアルを行えます。]( #その他のツールを使用したチュートリアル )* このリポジトリをフォーク まだGitをインストールしていない場合は、[ここ](https://help.github.com/articles/set-up-git/)からインストールしてください ## リポジトリをフォーク Forkボタンをクリックしてこのリポジトリをフォークしてください。 この作業であなたのアカウントにはこのリポジトリのコピーが作られます。 ## リポジトリをクローン このリポジトリをクローン 次にフォークしたリポジトリをクローンします。あなたのリポジトリに移動してフォークしたリポジトリを開き*Code*ボタンをクリックした後に*Copy to clipboard*アイコンをクリックしてください。 ターミナルを開いて以下のgitコマンドを実行してください： ```bash git clone "コピーしたURL" ``` "コピーしたURL" (ダブルクオーテーションは除いてください) は先ほどコピーしたリポジトリのURLと置き換えてください。 クリップボードにURLをコピー 例： ```bash git clone https://github.com/＜あなたのユーザー名＞/first-contributions.git ``` `あなたのユーザー名` はご自身のGitHubユーザー名に置き換えてください。この作業でGitHub のリポジトリの内容はあなたのコンピュータに保存されました。 ## ブランチを作成 もしリポジトリのディレクトリにいなければそこまで移動してください。 ```bash cd first-contributions ``` `git switch` コマンドを使用してブランチを作成します： ```bash git switch -c ``` 例: ```bash git switch -c add-alonzo-church ``` (ブランチの名前には必ずしも*add*が含まれていなければならないわけではありませんが、このブランチの目的があなたの名前をリストに加えることであることを考慮すれば含むのが適切です。) ## コードを変更してその変更をコミット テキストエディタで`Contributors.md`ファイルを開いてあなたの名前を追加してください。ただし、ファイルの先頭または最後に追加しないようにしましょう。名前リストの間のどこか好きな場所に、あなたの名前を追加するようにしてください。あなたの名前をファイルに加えたら、ファイルを保存します。 Gitステータス プロジェクトディレクトリに移動して`git status`を実行すると、変更がなされたことが確認できると思います。`git add`コマンドを使ってそれらの変更を適用してください。 ```bash git add Contributors.md ``` 次に`git commit`コマンドを使ってこれらの変更をコミットします。 ```bash git commit -m "Add <あなたの名前> to Contributors list" ``` `<あなたの名前>`をご自身の名前に置き換えてください。 ## GitHubに変更をpushする `git push`コマンドを使って変更をpushしてください。 ```bash git push origin <ブランチ名> ``` `<ブランチ名>`には先ほど作成したブランチ名を入れてください。 ## レビューのためにプルリクエストを送る GitHub上であなたのリポジトリに行くと、`Compare & pull request`ボタンが表示されます。そのボタンをクリックしてください。 プルリクエストを作成 プルリクエストを作ってください。 プルリクエストを提出 すぐに変更がこのプロジェクトのmainブランチにマージされます。マージが終了した際にはその旨のメールが送られます。 ## 次に何をするべきか おめでとうございます！ コントリビューターとして重要な _フォーク -> クローン -> 編集 -> プルリクエスト_　の基本的なワークフローが完了しました。 初めてのオープンソースへの貢献を祝って友達やフォロワーに[このウェブアプリ](https://firstcontributions.github.io/#social-share)を使ってシェアしましょう。 さらに練習したい場合は、[コードの貢献](https://github.com/roshanjossey/code-contributions)を確認してください。 他のプロジェクトへの貢献を始めましょう。簡単なイシューが立てられているプロジェクトのリストを作りました。ウェブアプリで[プロジェクトリスト](https://firstcontributions.github.io/#project-list)を確認してみてください。 ### [追加リソース](../additional-material/git_workflow_scenarios/additional-material.md) ## その他のツールを使用したチュートリアル | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.jv.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Kontribusi pisanan Proyek iki nduweni tujuan kanggo nyederhanakake lan nuntun cara para pamula nggawe kontribusi pisanan. Yen sampeyan pengin nggawe kontribusi pisanan, tindakake langkah ing ngisor iki. _Yen sampeyan ora kepenak karo baris perintah, [iki tutorial nggunakake alat GUI.](#tutorials-using-other-tools)_ garpu repositori iki #### Yen sampeyan ora duwe git ing mesin sampeyan, [instal](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Garpu gudang iki Garpu gudang iki kanthi ngeklik tombol garpu ing sisih ndhuwur kaca iki. Iki bakal nggawe salinan repositori iki ing akun sampeyan. ## Kloning repositori ckloning repositori iki Saiki tiron repositori garpu menyang mesin sampeyan. Pindhah menyang akun GitHub sampeyan, bukak gudang bercabang, klik tombol kode, banjur ing tab SSH banjur klik _copy url to clipboard_ icon. Bukak terminal lan jalanake perintah git ing ngisor iki: ```bash git clone "url you just copied" ``` ngendi "url sampeyan mung disalin" (tanpa tandha petik) punika url kanggo gudang iki (garpu proyek iki). Deleng langkah sadurunge kanggo njupuk url. salin URL menyang clipboard Contone: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` ngendi `this-is-you` jeneng panganggo GitHub sampeyan. Ing kene sampeyan lagi nyalin isi repositori kontribusi pisanan ing GitHub menyang komputer. ## Nggawe cabang Ganti menyang direktori repositori ing komputer (yen sampeyan durung ana): ```bash cd first-contributions ``` Saiki gawe cabang nggunakake printah `git switch`: ```bash git switch -c your-new-branch-name ``` Contone: ```bash git switch -c your-new-branch-name ``` Yen sampeyan nemu kesalahan nggunakake git switch, klik kene: Yen pesen kesalahan "Git: `switch` dudu perintah git. Waca `git –help`" katon, kemungkinan amarga sampeyan nggunakake versi git sing lawas. Ing kasus iki, coba gunakake `git checkout` tinimbang: ```bash git checkout -b jeneng-cabang-anyar sampeyan ``` ## Gawe owah-owahan sing perlu lan tindakake owah-owahan kasebut Saiki bukak file `Contributors.md` ing editor teks, tambahake jeneng sampeyan. Aja ditambahake ing wiwitan utawa pungkasan file. Sijine ing ngendi wae ing antarane. Saiki, simpen file kasebut. status git Yen sampeyan pindhah menyang direktori proyek lan nglakokake perintah `git status`, sampeyan bakal weruh ana owah-owahan. Tambahake owah-owahan kasebut menyang cabang sing lagi wae digawe nggunakake perintah `git add`: ```bash git add Contributors.md ``` Saiki gawe owah-owahan kasebut nggunakake perintah `git commit`: ```bash git commit -m "Add your-name to Contributors list" ``` ngganti `your-name` karo jeneng sampeyan. ## Push owah-owahan menyang GitHub Push owahan sampeyan nggunakake printah `git push`: ```bash git push -u origin your-branch-name ``` ngganti `your-branch-name` karo jeneng cabang sing digawe sadurunge. Yen ana kesalahan nalika meksa, klik kene: - ### Kasalahan Authentication 
remote: Dhukungan kanggo otentikasi tembung sandhi wis dibusak tanggal 13 Agustus 2021. Mangga gunakake token akses pribadhi.
  remot: Mangga deleng https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ kanggo informasi luwih lengkap.
  fatal: Otentikasi gagal kanggo 'https://github.com//first-contributions.git/'
Bukak [Github's Tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) kanggo nggawe lan ngatur kunci SSH menyang akun sampeyan. Uga, sampeyan bisa uga pengin mbukak 'git remote -v' kanggo mriksa alamat remot. Yen katon kaya iki: 
asal https://github.com/your-username/your_repo.git (fetch)
  origin https://github.com/your-username/your_repo.git (push)
ngganti nggunakake printah iki: ```bash git remote set-url asal git@github.com:your-username/your_repo.git ``` Yen ora, sampeyan isih bakal dijaluk jeneng pangguna lan sandhi lan entuk kesalahan otentikasi. ## Kirim owahan kanggo ditinjau Yen sampeyan pindhah menyang repositori ing GitHub, sampeyan bakal weruh tombol `Compare & pull request`. Klik tombol kasebut. gawe pull request Saiki kirim panjalukan tarik. kirim pull request Sakcepete aku bakal nggabungake kabeh owah-owahan sampeyan menyang cabang utama proyek iki. Sampeyan bakal entuk email kabar yen owah-owahan wis digabung. ## Saka ngendi arep lunga? Sugeng! Sampeyan mung ngrampungake standar _fork -> clone -> edit -> pull request_ workflow sing bakal kerep ditemoni minangka kontributor! Rayakan kontribusi sampeyan lan enggo bareng karo kanca lan pandherekipun kanthi pindhah menyang [web app](https://firstcontributions.github.io/#social-share). Yen sampeyan pengin latihan liyane, priksa [code contribution](https://github.com/roshanjossey/code-contributions). Saiki ayo miwiti kontribusi kanggo proyek liyane. Kita wis nyusun dhaptar proyek kanthi masalah sing gampang sampeyan bisa miwiti. Priksa [the list of projects in the web app](https://firstcontributions.github.io/#project-list). ### [Additional material](docs/additional-material/git_workflow_scenarios/additional-material.md) ## Tutorial Nggunakake Piranti Liyane | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](docs/gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](docs/gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](docs/gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](docs/gui-tool-tutorials/github-windows-intellij-tutorial.md) |

Proyek iki didhukung dening:

================================================ FILE: docs/translations/README.ka.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # ಮೊದಲ ಕೊಡುಗೆಗಳು ಈ ಯೋಜನೆಯು ಆರಂಭಿಕರು ತಮ್ಮ ಮೊದಲ ಕೊಡುಗೆಯನ್ನು ನೀಡುವ ವಿಧಾನವನ್ನು ಸರಳಗೊಳಿಸುವ ಮತ್ತು ಮಾರ್ಗದರ್ಶನ ಮಾಡುವ ಗುರಿಯನ್ನು ಹೊಂದಿದೆ. ನಿಮ್ಮ ಮೊದಲ ಕೊಡುಗೆಯನ್ನು ನೀಡಲು ನೀವು ಬಯಸಿದರೆ, ಕೆಳಗಿನ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ. ನೀವು ಆಜ್ಞಾ ಸಾಲಿನೊಂದಿಗೆ ಆರಾಮದಾಯಕವಲ್ಲದಿದ್ದರೆ,[GUI ಉಪಕರಣಗಳನ್ನು ಬಳಸುವ ಟ್ಯುಟೋರಿಯಲ್‌ಗಳು ಇಲ್ಲಿವೆ.](#tutorials-using-other-tools)_ ಈ ಭಂಡಾರವನ್ನು ಫೋರ್ಕ್ ಮಾಡಿ ನಿಮ್ಮ ಯಂತ್ರದಲ್ಲಿ ನೀವು ಗಿಟ್ ಹೊಂದಿಲ್ಲದಿದ್ದರೆ,[ಅದನ್ನು ಸ್ಥಾಪಿಸಿ](https://help.github.com/articles/set-up-git/) ## ಈ ರಿಪಾಸಿಟರಿ ಫೋರ್ಕ್ ಮಾಡಿ ಈ ಪುಟದ ಮೇಲ್ಭಾಗದಲ್ಲಿರುವ ಫೋರ್ಕ್ ಬಟನ್ ಅನ್ನು ಕ್ಲಿಕ್ ಮಾಡುವ ಮೂಲಕ ಈ ರಿಪಾಸಿಟರಿಯನ್ನು ಫೋರ್ಕ್ ಮಾಡಿ. ಇದು ನಿಮ್ಮ ಖಾತೆಯಲ್ಲಿ ಈ ರಿಪಾಸಿಟರಿಯ ನಕಲನ್ನು ರಚಿಸುತ್ತದೆ. ## ರಿಪಾಸಿಟರಿ ಕ್ಲೋನ್ ಈ ಭಂಡಾರವನ್ನು ಕ್ಲೋನ್ ಮಾಡಿ ಈಗ ನಿಮ್ಮ ಯಂತ್ರಕ್ಕೆ ಫೋರ್ಕ್ಡ್ ರಿಪಾಸಿಟರಿಯನ್ನು ಕ್ಲೋನ್ ಮಾಡಿ. ನಿಮ್ಮ ಗಿಟ್-ಹಬ್ ಖಾತೆಗೆ ಹೋಗಿ, ಫೋರ್ಕ್ ಮಾಡಿದ ರಿಪಾಸಿಟರಿಯನ್ನು ತೆರೆಯಿರಿ, "Code" ಬಟನ್ ಅನ್ನು ಕ್ಲಿಕ್ ಮಾಡಿ ಮತ್ತು ನಂತರ "copy to clipboard" ಐಕಾನ್ ಅನ್ನು ಕ್ಲಿಕ್ ಮಾಡಿ - ಇದು URL(ವೆಬ್‌ ವಿಳಾಸ) ಅನ್ನು ನಕಲಿಸುತ್ತದೆ[ಕಾಪಿ ಮಾಡುತ್ತದೆ]. ಟರ್ಮಿನಲ್ ತೆಗೆದು ಈ ಕೆಳಗಿನ ಗಿಟ್ ಆಜ್ಞೆಯನ್ನು ಚಲಾಯಿಸಿ: ```bash git clone "copied URL" ``` ಇಲ್ಲಿ "copied URL" - ನೀವು ಈಗಷ್ಟೇ ನಕಲಿಸಿದ URL(ನೀವು ಫೋಕ೯ ಮಾಡಿದ ಪ್ರಾಜೆಕ್ಟ ಲಿಂಕ್) ಅನ್ನು ಉದ್ಧರಣ[""] ಚಿಹ್ನೆಗಳಿಲ್ಲದೆ ಈ ಸ್ಥಳಕ್ಕೆ ಸೇರಿಸಿ. ಕ್ಲಿಪ್‌ಬೋರ್ಡ್‌ಗೆ URL ಅನ್ನು ನಕಲಿಸಿ ಉದಾಹರಣೆಗೆ: ```bash git clone https://github.com/ಇದು ನೀನು/first-contributions.git ``` `ಇದು ನೀನು' ಅಂದ್ರೆ ನಿಮ್ಮ ಗಿಟ್‌ಹಬ್ ಖಾತೆಯ ಹೆಸರು. ಇಲ್ಲಿ ನೀವು ನಿಮ್ಮ ಕಂಪ್ಯೂಟರ್‌ಗೆ ಗಿಟ್‌ಹಬ್‌ನಲ್ಲಿನ first-contributions ಯೋಜನೆಯನ್ನು ನಕಲಿಸುತ್ತಿದ್ದೀರಿ. ## ಒಂದು ಶಾಖೆಯನ್ನು ರಚಿಸಿ ನಿಮ್ಮ ಕಂಪ್ಯೂಟರ್‌ನಲ್ಲಿ first-contributions ರಿಪಾಸಿಟರಿ ಕಡತಕ್ಕೆ ಬದಲಾಯಿಸಿ (ನೀವು ಈಗಾಗಲೇ ಇಲ್ಲದಿದ್ದರೆ): ```bash cd first-contributions ``` ಈಗ `git checkout` ಆಜ್ಞೆಯನ್ನು ಬಳಸಿಕೊಂಡು ಒಂದು ಶಾಖೆಯನ್ನು ರಚಿಸಿ: ```bash git checkout -b <ನಿಮ್ಮ ಹೊಸ-ಶಾಖೆ-ಹೆಸರನ್ನು ಸೇರಿಸಿ> ``` ಉದಾಹರಣೆಗೆ: ```bash git checkout -b add-alonzo-church ``` (ಶಾಖೆಯ ಹೆಸರಿನಲ್ಲಿ `add` ಎಂಬ ಪದವನ್ನು ಹೊಂದುವ ಅಗತ್ಯವಿಲ್ಲ, ಆದರೆ ಇದನ್ನು ಸೇರಿಸುವುದು ಸಮಂಜಸವಾದ ವಿಷಯ ಏಕೆಂದರೆ ಈ ಶಾಖೆಯ ಉದ್ದೇಶವು ನಿಮ್ಮ ಹೆಸರನ್ನು ಪಟ್ಟಿಗೆ ಸೇರಿಸುವುದು.) ## ಅಗತ್ಯ ಬದಲಾವಣೆಗಳನ್ನು ಮಾಡಿ -‌ ಕಮಿಟ್ ಮಾಡಿ ಈಗ ಪಠ್ಯ ಸಂಪಾದಕದಲ್ಲಿ `Contributor.md` ಫೈಲ್ ಅನ್ನು ತೆರೆಯಿರಿ, ಅದಕ್ಕೆ ನಿಮ್ಮ ಹೆಸರನ್ನು ಸೇರಿಸಿ. ಅದನ್ನು ಫೈಲ್‌ನ ಪ್ರಾರಂಭ ಅಥವಾ ಕೊನೆಯಲ್ಲಿ ಸೇರಿಸಬೇಡಿ. ನಡುವೆ ಎಲ್ಲಿಯಾದರೂ ಸೇರಿಸಿ. ಈಗ, ಫೈಲ್ ಅನ್ನು ಸೇವ್‌ ಮಾಡಿ. git ಸ್ಥಿತಿ ನೀವು ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗೆ ಹೋಗಿ `git status` ಆಜ್ಞೆಯನ್ನು ಕಾರ್ಯಗತಗೊಳಿಸಿದರೆ, ನೀವು ಮಾಡಿದ ಬದಲಾವಣೆ ಕಾಣಿಸುತ್ತವೆ. `git add` ಆಜ್ಞೆಯನ್ನು ಬಳಸಿ, ಬದಲಾಯಿಸಿದ ಫೈಲ್‌ನ್ನು ಸ್ಟೇಜ ಮಾಡಿ. ```bash git add Contributors.md ``` ಈಗ `git commit` ಆಜ್ಞೆಯನ್ನು ಬಳಸಿಕೊಂಡು ಆ ಬದಲಾವಣೆಗಳನ್ನು ಕಮಿಟ್ ಮಾಡಿ: ```bash git commit -m "add name to contributors" ``` "add name to contributors" ಇದು ಕಮಿಟ್‌ ಸಂದೇಶ. ನೀವು ಮಾಡಿದ ಬದಲಾವಣೆಗೆ ತಕ್ಕಂತೆ ಸಂದೇಶವು ಅಥ೯ಪೂಣ೯ವಾಗಿರಬೇಕು ## ಬದಲಾವಣೆಗಳನ್ನು ಗಿಟ್‌ಹಬ್‌ಗೆ ಪುಶ್ ಮಾಡಿ `Git push` ಆಜ್ಞೆಯನ್ನು ಬಳಸಿಕೊಂಡು ನಿಮ್ಮ ಬದಲಾವಣೆಗಳನ್ನು ಗಿಟ್‌ಹಬ್‌ಗೆ ಕಳುಹಿಸಿರಿ: ```bash git push origin ``` `` ಈ ಸ್ಥಳದಲ್ಲಿ ನೀವು ರಚಿಸಿದ ಬ್ರ್ಯಾಂಚ್‌ ಹೆಸರನ್ನು ಬರೆಯಿರಿ. ## ನಿಮ್ಮ ಬದಲಾವಣೆಗಳನ್ನು ವಿಮರ್ಶೆಗಾಗಿ ಸಲ್ಲಿಸಿ ನೀವು ಗಿಟ್‌ಹಬ್‌ನಲ್ಲಿರುವ ನಿಮ್ಮ ಕಡತಕ್ಕೆ ಹೋದರೆ, ನೀವು `Compare & pull request` ಬಟನ್ ನೋಡುತ್ತೀರಿ. ಆ ಬಟನ್ನ್ನು ಕ್ಲಿಕ್ ಮಾಡಿ. ಎಲೆಯುವ ವಿನಂತಿಯನ್ನು ರಚಿಸಿ ಈಗ ಗಿಟ್‌ಹಬ್‌ ಪುಲ್ ವಿನಂತಿಯನ್ನು ಸಲ್ಲಿಸಿ. ಸಲ್ಲಿಸಲು ವಿನಂತಿಯನ್ನು ರಚಿಸಿ ಶೀಘ್ರದಲ್ಲೇ ನಾನು ನಿಮ್ಮ ಎಲ್ಲಾ ಬದಲಾವಣೆಗಳನ್ನು ಈ ಯೋಜನೆಯ ಮಾಸ್ಟರ್ ಶಾಖೆಯಲ್ಲಿ ವಿಲೀನಗೊಳಿಸುತ್ತೇನೆ. ಬದಲಾವಣೆಗಳನ್ನು ವಿಲೀನಗೊಳಿಸಿದ ನಂತರ ನೀವು ಅಧಿಸೂಚನೆ ಇಮೇಲ್ ಅನ್ನು ಪಡೆಯುತ್ತೀರಿ. ## ಇಂದಿನಿಂದ ಏನು? ಅಭಿನಂದನೆಗಳು! ನೀವು ಕೊಡುಗೆದಾರರಾಗಿ ಆಗಾಗ್ಗೆ ಎದುರಾಗುವ ಪ್ರಮಾಣಿತ _fork -> clone -> edit -> PR_ ವರ್ಕ್‌ಫ್ಲೋ ಅನ್ನು ನೀವು ಇದೀಗ ಪೂರ್ಣಗೊಳಿಸಿದ್ದೀರಿ! ನಿಮ್ಮ ಕೊಡುಗೆಯನ್ನು ಸಂಭ್ರಮಿಸಿ ಮತ್ತು ಅದನ್ನು ನಿಮ್ಮ ಸ್ನೇಹಿತರು ಹಾಗು ಅನುಯಾಯಿಗಳೊಂದಿಗೆ ಹಂಚಿಕೊಳ್ಳಿ [ವೆಬ್ ಅಪ್ಲಿಕೇಶನ್](https://firstcontributions.github.io/#social-share). ನೀವು ಹೆಚ್ಚಿನ ಅಭ್ಯಾಸವನ್ನು ಬಯಸಿದರೆ, ಪರಿಶೀಲಿಸಿ [ಕೋಡ್ ಕೊಡುಗೆಗಳು](https://github.com/roshanjossey/code-contributions). ಈಗ ನೀವು ಹೆಚ್ಚಿನ ಯೋಜನೆಗಳಿಗೆ ಕೊಡುಗೆ ನೀಡಲು ಪ್ರಾರಂಭಿಸಬಹುದು. ನಾವು ನಿಮಗಾಗಿ ಒಂದು ಪಟ್ಟಿಯನ್ನು ತಯಾರಿಸಿದ್ದೇವೆ ಅದು ಬಹಳ ಸುಲಭವಾದ ಸಮಸ್ಯೆಗಳು. [ಯೋಜನೆಗಳ ಪಟ್ಟಿ](https://firstcontributions.github.io/#project-list) ## ಇತರ ಪರಿಕರಗಳನ್ನು ಬಳಸುವ ಟ್ಯುಟೋರಿಯಲ್ | GitHub ಡೆಸ್ಕ್‌ಟಾಪ್ ಆಪ್ | ವಿಜುವಲ್ ಸ್ಟುಡಿಯೋ 2017 | GitKraken ಪ್ರೋಗ್ರಾಂ | VS ಕೋಡ್ ಎಡಿಟರ್ | Sourcetree ಆಪ್ | IntelliJ IDEA ಪ್ರೋಗ್ರಾಂ | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.kh.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) #### _អានឯកសារនេះជា [ភាសាផ្សេង](translations/Translations.md)._ [Shqip](translations/README.al.md) [Armenian](translations/README.arm.md) [Uzbek language](translations/README.uz.md) [Azərbaycan dili](translations/README.aze.md) [বাংলা](translations/README.bn.md) [Bulgarian](translations/README.bg.md) [Português (Brasil)](translations/README.pt_br.md) [Català](translations/README.ca.md) [中文 (Simplified)](translations/README.zh-cn.md) [Czech](translations/README.cs.md) [Deutsch](translations/README.de.md) [Dansk](translations/README.da.md) [العربية](translations/README.eg.md) [Dezéiriya](translations/README.dz.md) [Española](translations/README.es.md) [Française](translations/README.fr.md) [Gaeilge](translations/README.ga.md) [Galego](translations/README.gl.md) [Ελληνικά](translations/README.gr.md) [ქართული](translations/README.ge.md) [Magyar](translations/README.hu.md) [Bahasa Indonesia](translations/README.id.md) [עִברִית](translations/README.hb.md) [हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்](translations/Translations.md) [தமிழ்](translations/README.ta.md) [فارسی](translations/README.fa.md) [پښتو](translations/README.pus.md) [Italiano](translations/README.it.md) [日本語](translations/README.ja.md) [සිංහල](translations/README.si.md) [Kiswahili (Kenya)](translations/README.kws.md) [한국어](translations/README.ko.md) [Lietuvių kalba](translations/README.lt.md) [Limba Română Limba Română](translations/README.ro.md) [မြန်မာ](translations/README.mm_unicode.md) [Македонски](translations/README.mk.md) [Español de México](translations/README.mx.md) [Bahasa Melayu / بهاس ملايو‎ / Malay](translations/README.my.md) [Dutch](translations/README.nl.md) [Norsk](translations/README.no.md) [नेपाली](translations/README.np.md) [Wikang Filipino](translations/README.tl.md) [English (Pirate)](translations/README.en-pirate.md) [اردو](translations/README.ur.md) [Polski](translations/README.pl.md) [Português (Portugal)](translations/README.pt-pt.md) [Русский язык](translations/README.ru.md) [عربى](translations/README.ar.md) [Svenska](translations/README.se.md) [Slovenčina](translations/README.slk.md) [Slovenščina](translations/README.sl.md) [ภาษาไทย](translations/README.th.md) [Türkçe](translations/README.tr.md) [中文(Traditional)](translations/README.zh-tw.md) [Українська](translations/README.ua.md) [Tiếng Việt](translations/README.vn.md) [Swahili language](translations/README.sw.md) [Zulu (South Africa)](translations/README.zul.md) [Afrikaans (South Africa)](translations/README.afk.md) [Igbo (Nigeria)](translations/README.igb.md) [Yoruba (Nigeria)](translations/README.yor.md) [Hausa (Nigeria)](translations/README.hau.md) [Latvia](translations/README.lv.md) [Suomeksi](translations/README.fi.md) [Беларуская мова](translations/README.by.md) [Српски](translations/README.sr-Cyrl.md) [Srpski](translations/README.sr-Latn.md) [Қазақша](translations/README.kz.md) [Bosanski](translations/README.bih.md) [Bosanski](translations/README.bih.md) [Hrvatski](translations/README.hr.md) [پښتو](translations/README.ps.md) [Somalia](translations/README.so.md) [Ecuador](translations/README.ec.md) [Turkmen language](translations/README.tm.md) [Ewe (TOGO)](translations/README.ewe.md) [አማርኛ](translations/README.et.md) [ភាសាខ្មែរ](translations/README.kh.md) # ការរួមចំណែកជាលើកដំបូង គម្រោងនេះមានគោលបំណងធ្វើឱ្យសាមញ្ញ និងណែនាំពីរបៀបដែលអ្នកចាប់ផ្តើមធ្វើការរួមចំណែកដំបូងរបស់ពួកគេ។ ប្រសិនបើអ្នកកំពុងស្វែងរកការរួមចំណែកដំបូងរបស់អ្នក សូមអនុវត្តតាមជំហានខាងក្រោម។ _ប្រសិនបើអ្នកមិនសូវស្រួលជាមួយបន្ទាត់ពាក្យបញ្ជាទេ [នេះគឺជាការបង្រៀនដោយប្រើឧបករណ៍ GUI ។](#tutorials-using-other-tools)_ បែកចេញពីរុំពោលនេះ #### ប្រសិនបើអ្នកមិនមាន git នៅលើម៉ាស៊ីនរបស់អ្នក [សូមដំឡើង](https://docs.github.com/en/get-started/quickstart/set-up-git). ## ស៊ាំសាខានេះ (Fork this repository) សូមស៊ាំសាខានេះដោយចុចលើប៊ូតុង Fork ដែលនៅផ្នែកខាងលើនៃទំព័រនេះ។ វានឹងបង្កើតច្បាប់ចម្លងនៃសាខានេះក្នុងគណនីរបស់អ្នក។ ## ចម្លងសាខានេះ (Clone the repository) ចម្លងរុំពោលនេះ ឥឡូវនេះ ចម្លងសាខាដែលអ្នកបានស៊ាំទៅកាន់កុំព្យូទ័ររបស់អ្នក។ ចូលទៅគណនី GitHub របស់អ្នក បើកសាខាដែលបានស៊ាំ ចុចលើប៊ូតុង Code ហើយចុចលើរូបតំណាង​​ _copy to clipboard_។ បើក terminal ហើយដំណើរការពាក្យបញ្ជា git ខាងក្រោម៖ ```bash git clone "url you just copied" ``` កន្លែងដែល "url ដែលអ្នកទើបតែចម្លង" (ដោយគ្មានសញ្ញាសម្រង់) គឺជា url ទៅកាន់ឃ្លាំងនេះ (ចំនុចប្រសព្វរបស់អ្នកនៃគម្រោងនេះ)។ សូមមើលជំហានមុនដើម្បីទទួលបាន url ។ ចម្លង URL ទៅក្តារតម្បៀតខ្ទាស់ ឧទាហរណ៍៖ ```bash git clone git@github.com:this-is-you/first-contributions.git ``` កន្លែងដែល `this-is-you` គឺជាឈ្មោះអ្នកប្រើប្រាស់ GitHub របស់អ្នក។ នៅទីនេះអ្នកកំពុងចម្លងមាតិកានៃឃ្លាំងការរួមចំណែកដំបូងនៅលើ GitHub ទៅកាន់កុំព្យូទ័ររបស់អ្នក។ ## បង្កើតសាខាថ្មី (Create a branch) ផ្លាស់ប្តូរទៅថតឃ្លាំងនៅលើកុំព្យូទ័ររបស់អ្នក (ប្រសិនបើអ្នកមិនទាន់នៅទីនោះ)៖ ```bash cd first-contributions ``` ឥឡូវបង្កើតសាខាមួយដោយប្រើពាក្យបញ្ជា 'git switch'៖ ```bash git switch -c your-new-branch-name ``` ឧទាហរណ៍៖ ```bash git switch -c add-alonzo-church ``` ## កែប្រែលើកែលម្អដែលចាំបាច់ និងធ្វើការប្តិត (commit) ប្រែប្រួលទាំងនោះ ឥឡូវនេះបើកឯកសារ 'Contributors.md' នៅក្នុងកម្មវិធីនិពន្ធអត្ថបទ បន្ថែមឈ្មោះរបស់អ្នកទៅវា។ កុំបន្ថែមវានៅដើម ឬចុងបញ្ចប់នៃឯកសារ។ ដាក់វានៅកន្លែងណាមួយនៅចន្លោះ។ ឥឡូវនេះរក្សាទុកឯកសារ។ ស្ថានភាព git ប្រសិនបើអ្នកចូលទៅកាន់ថតគម្រោង ហើយប្រតិបត្តិពាក្យបញ្ជា 'git status' អ្នកនឹងឃើញមានការផ្លាស់ប្តូរ។ បន្ថែមការផ្លាស់ប្តូរទាំងនោះទៅសាខាដែលអ្នកទើបតែបង្កើតដោយប្រើពាក្យបញ្ជា `git add`៖ ```bash git add Contributors.md ``` ឥឡូវនេះធ្វើការផ្លាស់ប្តូរទាំងនោះដោយប្រើពាក្យបញ្ជា 'git commit'៖ ```bash git commit -m "Add your-name to Contributors list" ``` ជំនួស 'ឈ្មោះរបស់អ្នក' ជាមួយឈ្មោះរបស់អ្នក។ ## ផ្តួលប្រែប្រួលទៅ GitHub (Push changes to GitHub) រុញការផ្លាស់ប្តូររបស់អ្នកដោយប្រើពាក្យបញ្ជា 'git push': ```bash git push -u origin your-branch-name ``` ជំនួស `your-branch-name` ជាមួយនឹងឈ្មោះសាខាដែលអ្នកបានបង្កើតមុន។
ប្រសិនបើអ្នកទទួលបានកំហុសណាមួយនៅពេលរុញ សូមចុចទីនេះ៖ - ### កំហុសនៅក្នុងការ Authentication (Authentication Error) 
remote: ការគាំទ្រសម្រាប់ការបញ្ចូលពាក្យសម្ងាត់ត្រូវបានដកហូតនៅថ្ងៃទី 13 ខែសីហា ឆ្នាំ 2021។ សូមប្រើ **Personal Access Token** ជំនួស។
  remote: សូមមើល https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ សម្រាប់ព័ត៌មានបន្ថែម។
  fatal: ការ Authenticate បរាជ័យសម្រាប់ 'https://github.com//first-contributions.git/'
សូមចូលទៅកាន់ [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ដើម្បីបង្កើត និងកំណត់រចនាសម្ព័ន្ធ SSH Key ទៅក្នុងគណនី GitHub របស់អ្នក។
## ដាក់បញ្ជូនការផ្លាស់ប្តូររបស់អ្នកសម្រាប់ការពិនិត្យ ប្រសិនបើអ្នកចូលទៅកាន់ឃ្លាំងរបស់អ្នកនៅលើ GitHub អ្នកនឹងឃើញប៊ូតុង 'Compare & pull request' ។ ចុចលើប៊ូតុងនោះ។ បង្កើតសំណើទាញ ឥឡូវនេះដាក់សំណើទាញ។ ដាក់សំណើទាញ ឆាប់ៗនេះ ខ្ញុំនឹងបញ្ចូលការផ្លាស់ប្តូររបស់អ្នកទាំងអស់ទៅក្នុងសាខាចម្បងនៃគម្រោងនេះ។ អ្នកនឹងទទួលបានអ៊ីមែលជូនដំណឹង នៅពេលដែលការផ្លាស់ប្តូរត្រូវបានបញ្ចូលគ្នា។ ## តើត្រូវទៅណាពីទីនេះ? អបអរសាទរ! អ្នកទើបតែបានបញ្ចប់ស្តង់ដារ _fork -> clone -> edit -> pull request_ workflow ដែលអ្នកនឹងជួបប្រទះជាញឹកញាប់ក្នុងនាមជាអ្នករួមចំណែក! អបអរសាទរការរួមចំណែករបស់អ្នក ហើយចែករំលែកវាជាមួយមិត្តភក្តិ និងអ្នកដើរតាមរបស់អ្នកដោយចូលទៅកាន់ [កម្មវិធីគេហទំព័រ](https://firstcontributions.github.io/#social-share). អ្នកអាចចូលរួមជាមួយក្រុម slack របស់យើង ប្រសិនបើអ្នកត្រូវការជំនួយ ឬមានសំណួរណាមួយ។ [ចូលរួមក្រុម slack](https://firstcontributors.slack.com/join/shared_invite/zt-29qhyr9lt-Bi7WLbgGIFqV7aCEG_grvg#/shared-invite/email). ឥឡូវនេះ ចូរអ្នកចាប់ផ្តើមជាមួយនឹងការរួមចំណែកដល់គម្រោងផ្សេងទៀត។ យើងបានចងក្រងបញ្ជីគម្រោងដែលមានបញ្ហាងាយស្រួលដែលអ្នកអាចចាប់ផ្តើមបាន។ ពិនិត្យមើល [បញ្ជីគម្រោងក្នុងកម្មវិធីបណ្ដាញ](https://firstcontributions.github.io/#project-list). ### [សម្ភារៈបន្ថែម](additional-material/git_workflow_scenarios/additional-material.md) ## ការបង្រៀនដោយប្រើឧបករណ៍ផ្សេងទៀត | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) |

គម្រោងនេះត្រូវបានគាំទ្រដោយ៖

================================================ FILE: docs/translations/README.ko.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # 첫 기여 이 프로젝트는 초보자가 처음으로 오픈소스에 기여할 수 있도록 쉽게 안내하는 것을 목표로 합니다. 첫 번째 기여를 하고 싶다면, 아래의 설명을 따라주세요. _만약 명령어 인터페이스에 익숙하지 않다면, [여기에서 GUI 도구 튜토리얼을 참고하세요.](#다른-도구들을-사용한-튜토리얼)._ 이 저장소 포크하기 #### 만약, git이 설치되어 있지 않다면 [설치하세요](https://docs.github.com/en/get-started/quickstart/set-up-git). ## 저장소 포크하기 이 저장소 페이지의 상단에 있는 Fork 버튼을 클릭해서 저장소를 포크하세요. 그러면 본인의 깃허브 계정에 이 저장소의 복사본이 생성됩니다. ## 저장소 클론하기 이 저장소 복제하기 이제 fork한 저장소를 자신의 기기에 클론하세요. 깃허브 계정의 fork한 저장소에 들어가서, Code 버튼을 클릭하고, _클립보드로 url 복사_ 아이콘을 클릭합니다. 터미널을 열고 다음 git 명령을 실행합니다: ```bash git clone "방금 복사한 URL" ``` 위에 (따옴표를 제외한) "방금 복사한 URL"은 이 저장소의 URL입니다. URL은 이전 단계에서 찾을 수 있습니다. URL을 클립보드로 복사 예시: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` `this-is-you`에 해당하는 부분을 본인의 깃허브 계정명으로 바꾸어주세요. 이 명령어는 깃허브의 first-contributions 저장소를 자신의 컴퓨터로 복사합니다. ## 브랜치 생성하기 (아직 저장소 디렉토리가 아니라면) 아래의 명령어를 입력해서 조금 전에 컴퓨터에 복사한 저장소 디렉토리로 이동합니다. ```bash cd first-contributions ``` 그리고 `git switch` 명령어를 입력해서 브랜치를 생성합니다. ```bash git switch -c your-new-branch-name ``` 예시: ```bash git switch -c add-alonzo-church ``` ## 필요한 부분을 변경하고 변경 사항을 커밋하기 이제 텍스트 편집기에서 `Contributors.md` 파일을 열고 본인의 이름을 아래와 같이 추가해주세요. 파일의 시작 부분이나 마지막 부분에 추가해서는 안됩니다. 중간 부분의 마음에 드는 곳에 추가하면 됩니다. 그리고 파일을 저장하세요. 깃의 현재 상태 확인하기 프로젝트 디렉토리로 이동해서 `git status` 명령어를 실행하면 변경 사항이 존재하는 것을 볼 수 있습니다. 변경 사항을 `git add` 명령어를 사용해서 조금 전에 생성한 브랜치에 추가합니다. ```bash git add Contributors.md ``` 이제 `git commit` 명령어를 사용해서 변경 사항을 커밋합니다. ```bash git commit -m "Add your-name to Contributors list" ``` `your-name`을 본인 이름으로 변경하세요. ## 변경 사항을 깃허브에 푸시하기 `git push` 명령어로 변경 사항을 푸시합니다. ```bash git push -u origin your-branch-name ``` `your-branch-name` 부분을 조금 전에 생성한 브랜치 이름으로 변경하세요.
푸시하는 중에 에러가 발생했다면, 여기를 클릭하세요: - ### Authentication Error 
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//first-contributions.git/'
[깃허브 튜토리얼](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)로 이동해서 본인의 계정에 SSH key 생성 및 설정에 대한 정보를 얻을 수 있습니다.
## 검토를 위해 변경 사항을 제출하기 이제 본인의 깃허브 저장소로 이동하면 `Compare & pull request` 버튼을 볼 수 있습니다. 버튼을 클릭하세요. 풀 요청 생성하기 이제 풀 요청(Pull Request)을 제출합니다. 풀 요청 제출하기 이제 여러분의 변경 사항을 담당자가 확인한 후에 main 브랜치에 병합 하게 되면 알림 메일을 받을 수 있습니다. ## 첫 기여, 그리고 그 후 축하합니다! 앞으로 기여자로서 자주 사용하게 될 기본 워크플로우인 _포크(fork) -> 클론(clone) -> 수정(edit) -> 풀 요청(pull request)_, 를 완료했습니다! 첫 기여에 대한 소식을 친구들 및 팔로워에게 [웹 앱](https://firstcontributions.github.io/#social-share)을 통해 공유해보세요. 이제 다른 프로젝트에도 기여해보세요! 지금 바로 시작할 수 있는 난이도가 낮은 이슈들로 가득 찬 목록이 있습니다. [웹 앱의 프로젝트 목록](https://firstcontributions.github.io/#project-list)에서 확인해보세요. ### [추가 자료](../additional-material/translations/Korean/additional-material.ko.md) ## 다른 도구들을 사용한 튜토리얼 | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |

This project is supported by:

================================================ FILE: docs/translations/README.kr.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) #### _Read this in [other languages](translations/Translations.md)._ [Shqip](translations/README.al.md) [Armenian](translations/README.arm.md) [Uzbek language](translations/README.uz.md) [Azərbaycan dili](translations/README.aze.md) [বাংলা](translations/README.bn.md) [Bulgarian](translations/README.bg.md) [Português (Brasil)](translations/README.pt_br.md) [Català](translations/README.ca.md) [中文 (Simplified)](translations/README.zh-cn.md) [Czech](translations/README.cs.md) [Deutsch](translations/README.de.md) [Dansk](translations/README.da.md) [العربية](translations/README.eg.md) [Dezéiriya](translations/README.dz.md) [Española](translations/README.es.md) [Française](translations/README.fr.md) [Gaeilge](translations/README.ga.md) [Galego](translations/README.gl.md) [Ελληνικά](translations/README.gr.md) [ქართული](translations/README.ge.md) [Magyar](translations/README.hu.md) [Bahasa Indonesia](translations/README.id.md) [עִברִית](translations/README.hb.md) [हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்](translations/Translations.md) [தமிழ்](translations/README.ta.md) [فارسی](translations/README.fa.md) [پښتو](translations/README.pus.md) [Italiano](translations/README.it.md) [日本語](translations/README.ja.md) [සිංහල](translations/README.si.md) [Kiswahili (Kenya)](translations/README.kws.md) [한국어](translations/README.ko.md) [Lietuvių kalba](translations/README.lt.md) [Limba Română Limba Română](translations/README.ro.md) [မြန်မာ](translations/README.mm_unicode.md) [Македонски](translations/README.mk.md) [Español de México](translations/README.mx.md) [Bahasa Melayu / بهاس ملايو‎ / Malay](translations/README.my.md) [Dutch](translations/README.nl.md) [Norsk](translations/README.no.md) [नेपाली](translations/README.np.md) [Wikang Filipino](translations/README.tl.md) [English (Pirate)](translations/README.en-pirate.md) [اردو](translations/README.ur.md) [Polski](translations/README.pl.md) [Português (Portugal)](translations/README.pt-pt.md) [Русский язык](translations/README.ru.md) [عربى](translations/README.ar.md) [Svenska](translations/README.se.md) [Slovenčina](translations/README.slk.md) [Slovenščina](translations/README.sl.md) [ภาษาไทย](translations/README.th.md) [Türkçe](translations/README.tr.md) [中文(Traditional)](translations/README.zh-tw.md) [Українська](translations/README.ua.md) [Tiếng Việt](translations/README.vn.md) [Swahili language](translations/README.sw.md) [Zulu (South Africa)](translations/README.zul.md) [Afrikaans (South Africa)](translations/README.afk.md) [Igbo (Nigeria)](translations/README.igb.md) [Yoruba (Nigeria)](translations/README.yor.md) [Hausa (Nigeria)](translations/README.hau.md) [Latvia](translations/README.lv.md) [Suomeksi](translations/README.fi.md) [Беларуская мова](translations/README.by.md) [Српски](translations/README.sr-Cyrl.md) [Srpski](translations/README.sr-Latn.md) [Қазақша](translations/README.kz.md) [Bosanski](translations/README.bih.md) [Bosanski](translations/README.bih.md) [Hrvatski](translations/README.hr.md) [پښتو](translations/README.ps.md) [Somalia](translations/README.so.md) [Ecuador](translations/README.ec.md) [Turkmen language](translations/README.tm.md) [Ewe (TOGO)](translations/README.ewe.md) [አማርኛ](translations/README.et.md) Kurdî # Beşdariyên Yekem Ev proje armanc dike ku rêya destpêkkeran ji bo beşdariya wan a yekem hêsan û rêber bike. Heke hûn li beşdariya xwe ya yekem digerin, van gavan bişopînin. _Heke hûn bi xeta fermanê ne rehet in, [li vir perwerdeyên ku amûrên GUI bikar tînin hene.](#perwerdeyên-ku-amûrên-din-bikar-tînin)_ vê depoyê fork bikin #### Heke git li ser makîneya we tune, [wê saz bikin](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Vê depoyê fork bikin Vê depoyê bi tikandina bişkoka fork li jora vê rûpelê fork bikin. Ev ê kopiyeke vê depoyê di hesabê we de çêke. ## Depoyê clone bikin vê depoyê clone bikin Niha depoya forkkirî li makîneya xwe clone bikin. Herin hesabê xwe yê GitHub, depoya forkkirî vekin, li ser bişkoka code bitikînin û paşê li ser îkona _copy to clipboard_ bitikînin. Termînalek vekin û ev fermana git bimeşînin: ```bash git clone "url'a ku we naha kopî kir" ``` li cihê ku "url'a ku we naha kopî kir" (bêyî nîşanên jêgirtinê) url'a vê depoyê ye (forka we ya vê projeyê). Ji bo bidestxistina url'ê li gavên berê binêrin. URL'ê kopî bikin Bo nimûne: ```bash git clone git@github.com:ev-hûn-in/first-contributions.git ``` li ku derê `ev-hûn-in` navê we yê bikarhêneriya GitHub e. Li vir hûn naveroka depoya first-contributions li ser GitHub'ê li kompûtera xwe kopî dikin. ## Şaxekê çêbikin Derbasi pelrêça depoyê li ser komputera xwe bibin (heke hûn ne li wir in): ```bash cd first-contributions ``` Niha bi bikaranîna fermana `git switch` şaxekê çêbikin: ```bash git switch -c navê-şaxa-we-ya-nû ``` Bo nimûne: ```bash git switch -c add-alonzo-church ``` ## Guherandinên pêwist çêbikin û wan guherandinan commit bikin Niha pelê `Contributors.md` di edîtorekî nivîsê de vekin, navê xwe lê zêde bikin. Wê li destpêk an dawiya pelê zêde nekin. Li cihekî navbera wan de deynin. Niha, pelê tomarbikin. rewşa git Heke hûn herin pelrêça projeyê û fermana `git status` bimeşînin, hûn ê bibînin ku guherandin hene. Van guhertinan li şaxa ku we nû çêkiriye bi bikaranîna fermana `git add` zêde bikin: ```bash git add Contributors.md ``` Niha van guhertinan bi bikaranîna fermana `git commit` commit bikin: ```bash git commit -m "Add navê-we to Contributors list" ``` `navê-we` bi navê xwe re biguherin. ## Guhertinan bişînin GitHub Guherandinên xwe bi fermana `git push` bişînin: ```bash git push -u origin navê-şaxa-we ``` `navê-şaxa-we` bi navê şaxa ku we berê çêkiribû re biguherin.
Heke hûn di dema push kirinê de bi xeletiyekê re rû bi rû bimînin, li vir bitikînin: - ### Xeletiya Rastkirinê 
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//first-contributions.git/'
Herin [perwerdehiya GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) li ser çêkirin û veavakirina mifteya SSH ji bo hesabê xwe.
## Guherandinên xwe ji bo nirxandinê pêşkêş bikin Heke hûn herin depoya xwe li ser GitHub, hûn ê bişkokek `Compare & pull request` bibînin. Li ser wê bişkokê bitikînin. daxwaza kişandinê çêbikin Niha daxwaza kişandinê pêşkêş bikin. daxwaza kişandinê pêşkêş bikin Di demek nêzîk de, ez ê hemû guherandinên we di şaxa sereke ya vê projeyê de tevlihev bikim. Dema ku guherandin hatin tevlihevkirin, hûn ê e-nameyek agahdariyê bistînin. ## Ji vir ve ku derê? Pîroz be! We çerxa _fork -> clone -> edit -> pull request_ a standard ku hûn ê gelek caran wek beşdarvan pêrgî wê werin temam kir! Beşdariya xwe pîroz bikin û bi hevalên xwe û şopînerên xwe re parve bikin bi çûyîna [sepana webê](https://firstcontributions.github.io/#social-share). Niha em dest bi beşdariya we di projeyên din de bikin. Me lîsteyek ji projeyan bi mijarên hêsan amade kiriye ku hûn dikarin pê dest pê bikin. [Lîsteya projeyan di sepana webê de kontrol bikin](https://firstcontributions.github.io/#project-list). ### [Materyalên zêde](additional-material/git_workflow_scenarios/additional-material.md) ## Perwerdeyên Ku Amûrên Din Bikar Tînin | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md)

This project is supported by:

| ================================================ FILE: docs/translations/README.kws.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Mchango wa Kwanza Ni vigumu. Ni vigumu daima mara ya kwanza unafanya kitu. Hasa wakati unashirikiana, kufanya makosa sio jambo la kushangaza. Tulitaka kurahisisha njia mpya ya wafadhili wa kujifunza na kuchangia kwa mara ya kwanza. Kusoma makala na mafunzo ya kutazama yanaweza kusaidia, lakini ni nini bora zaidi kuliko kufanya mambo halisi katika mazingira ya mazoezi? Mradi huu unalenga kutoa mwongozo na kurahisisha wasanidi wa njia kufanya mchango wao wa kwanza. Ikiwa unatafuta kufanya mchango wako wa kwanza, fuata hatua zifuatazo. #### *Ikiwa huna urahisi na mstari wa amri, [hapa ni mafunzo kwa kutumia zana za GUI.](#Mafundisho-Kutumia-Zana-Zingine)* uma hazina hii ## Vuta hifadhi hii Vuta repo hii kwa kubonyeza kifungo cha fakia juu ya ukurasa huu. Hii itaunda nakala ya hifadhi hii katika akaunti yako. ## Weka chumba nakili hazina hii Sasa nakala repo iliyovutwa kwa mashine yako. Nenda kwenye akaunti yako ya GitHub, fungua repo iliyovutwa, bonyeza kitufe cha kamba na kisha bofya nakala kwenye clipboard. Fungua terminal na uendesha amri yafuatayo: ``` git clone "url you just copied" ``` ambapo "url ulikosa tu" (bila alama za kupiga kura) ni url kwenye hifadhi hii (fomu yako ya mradi huu). Angalia hatua za awali ili kupata url. nakili URL kwenye ubao wa kunakili Kwa mfano: ``` git clone https://github.com/this-is-you/first-contributions.git ``` hapo `this-is-you`tumia jina lako la mtumiaji GitHub. Hapa unakili nakala ya maudhui ya kwanza ya michango kwenye GitHub kwenye kompyuta yako. ## Unda tawi Badilisha kwenye saraka ya uhifadhi kwenye kompyuta yako (ikiwa huko tayari): ``` cd first-contributions ``` Sasa unda tawi kwa kutumia git `checkout` amri: ``` git checkout -b ``` Kwa mfano: ``` git checkout -b add-alonzo-church ``` (Jina la tawi haina haja ya kuwa neno liongeze ndani yake, lakini ni jambo la kuzingatia kwa sababu lengo la tawi hili ni kuongeza jina lako kwenye orodha.) ## Fanya mabadiliko muhimu na ufanyie mabadiliko hayo Sasa fungua `Contributors.md` faili katika mhariri wa maandishi, uongeze jina lako. Usiongeze kwenye mwanzo au mwisho wa faili. Weka mahali popote katikati. Sasa, sahau faili. hali ya git Ikiwa unakwenda kwenye saraka ya mradi na kutekeleza amri `git status`, utaona kuna mabadiliko. Ongeza mabadiliko hayo kwenye tawi ulilojenga kwa kutumia `git add` amri: ``` git add Contributors.md ``` Sasa fanya mabadiliko hayo kwa kutumia amri `git commit`: ``` git push origin ``` kubadilisha `` jina lako. ## Skuma mabadiliko kwenye GitHub Skuma mabadiliko yako kwa kutumia amri `git push`: ``` git push origin ``` kubadilisha `` na jina la tawi uliloumba hapo awali. ## Tuma mabadiliko yako kwa ukaguzi Ikiwa unaenda kwenye hifadhi yako kwenye GitHub, utaona `Compare & pull request` kifungo. Bofya kwenye kifungo hicho. unda ombi la kuvuta Sasa weka ombi la kuvuta. wasilisha ombi la kuvuta Hivi karibuni nitaunganisha mabadiliko yako yote kwenye tawi la mradi huu. Utapata barua pepe ya arifa mara mabadiliko yameunganishwa. ## Wapi kutoka hapa? Hongera! Wewe umekamilisha fomu ya kawaida *fork -> clone -> hariri -> pull request* ambayo unakutana mara nyingi kama mchangiaji! Sherehekea mchango wako na marafiki na wafuasi wako kwa kuenda kwenye [programu ya wavuti](https://firstcontributions.github.io/#social-share). Unaweza kujiunga na timu yetu ya slack ikiwa unahitaji msaada wowote au una maswali yoyote. [Jiunge na timu ya slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). Sasa hebu tuanze uanze na kuchangia kwenye miradi mingine. Tumeandika orodha ya miradi na masuala rahisi unaweza kuanza. Angalia [orodha ya miradi katika programu ya wavuti](https://firstcontributions.github.io/#project-list). ### [Nyenzo za ziada](../additional-material/git_workflow_scenarios/additional-material.md) ## Mafundisho Kutumia Zana Zingine | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.ky.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Алгачкы салымдар (first contributions) Бул долбоор жаңы баштагандарга алгачкы салымын кошуу жолун жеңилдетип, багыт берүүнү максат кылат. Эгер сиз алгачкы салымыңызды кошууну кааласаңыз, төмөнкү кадамдарды аткарыңыз. Эгер сиз командалык сап (command line) менен иштөөдө ыңгайсыз болсоңуз, бул жерде GUI куралдарын колдонгон окуу материалдары бар. fork this repository Эгер компьютериңизде git жок болсо, [аны орнотуңуз](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Репозиторийди "fork" кылыңыз Бул баракчанын жогору жагындагы fork баскычын басып, бул репозиторийди fork кылыңыз. Бул сиздин аккаунтуңузда бул репозиторийдин көчүрмөсүн түзөт. ## Репозиторийди клондоңуз (clone) clone this repository Эми fork кылынган репозиторийди компьютериңизге клондоңуз. GitHub аккаунтуңузга кирип, fork кылынган репозиторийди ачыңыз, андан кийин code баскычын, анан SSH кошумча барагын (tab) басып, url-ди алмашуу буферине көчүрүү (copy url to clipboard) сөлөкөтүн басыңыз. Терминалды ачып, төмөнкү git командасын аткарыңыз: ``` git clone "сиз жаңы эле көчүргөн url" ``` мында "сиз жаңы эле көчүргөн url" (тырмакчасыз) бул репозиторийдин url-и болуп саналат (бул долбоордун сиздин fork'уңуз). Url-ди алуу үчүн мурунку кадамдарды караңыз. copy URL to clipboard Мисалы: ``` git clone git@github.com:this-is-you/first-contributions.git ``` мында `this-is-you` сиздин GitHub колдонуучу атыңыз. Бул жерде сиз GitHub-дагы first-contributions репозиторийинин мазмунун компьютериңизге көчүрүп жатасыз. ## Тармак (branch) түзүңүз Компьютериңиздеги репозиторий каталогуна өтүңүз (эгер ал жерде болбосоңуз): ``` cd first-contributions ``` Эми `git switch` командасын колдонуп, тармак (branch) түзүңүз: ``` git switch -c your-new-branch-name ``` Мисалы: ``` git switch -c add-tigilchi-balanchaev ```
Эгер git switch командасын колдонууда кандайдыр бир каталар кетсе, бул жерди басыңыз: Эгер "Git: switch is not a git command. See git –help" деген ката билдирүүсү чыкса, анда сиз git-тин эски версиясын колдонуп жаткан болушуңуз мүмкүн. Бул учурда, анын ордуна git checkout колдонуп көрүңүз: ``` git checkout -b add-tigilchi-balanchaev ```
## Керектүү өзгөртүүлөрдү киригизип, аларды "commit" кылыңыз Эми `Contributors.md` файлын текст редакторунан ачып, ага өз атыңызды кошуңуз. Аны файлдын башына же аягына кошпоңуз. Ортосуна бир жерге коюңуз. Эми, файлды сактаңыз. git status Эгер сиз долбоор каталогуна барып, `git status` командасын аткарсаңыз, өзгөртүүлөр бар экенин көрөсүз. Жаңы эле түзгөн тармакка (branch) ал өзгөртүүлөрдү `git add` командасын колдонуп кошуңуз: ``` git add Contributors.md ``` Эми ал өзгөртүүлөрдү `git commit` командасын колдонуп, commit кылыңыз: ``` git commit -m "Add your-name to Contributors list" ``` мында `your-name` дегенди өз атыңыз менен алмаштырыңыз. ## Өзгөртүүлөрдү github-га "push" кылыңыз Өзгөртүүлөрүңүздү `git push` командасын колдонуп push кылыңыз: ``` git push -u origin your-branch-name ``` мында `your-branch-name` дегенди мурда түзгөн тармагыңыздын аты менен алмаштырыңыз.
Эгер push кылууда кандайдыр бир каталар кетсе, бул жерди басыңыз: - ### Аутентификация катасы (authentication error) 
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//first-contributions.git/'
[GitHub'дын окуу материалына](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) өтүп, аккаунтуңузга SSH ачкычын түзүү жана конфигурациялоо боюнча окуңуз. Ошондой эле, алыскы дарегиңизди текшерүү үчүн 'git remote -v' командасын аткаргыңыз келиши мүмкүн. Эгер ал ушундай көрүнсө: 
origin https://github.com/your-username/your_repo.git (fetch)   origin https://github.com/your-username/your_repo.git (push)
Аны төмөнкү команда менен өзгөртүңүз: ```bash git remote set-url origin git@github.com:your-username/your_repo.git ``` Антпесе, сизге дагы деле колдонуучу аты жана сырсөз суралып, аутентификация катасы келе берет.
## Өзгөртүүлөрүңүздү карап чыгуу үчүн жөнөтүңүз Эгер GitHub'дагы репозиторийиңизге барсаңыз, `Compare & pull request` баскычын көрөсүз. Ошол баскычты басыңыз. create a pull request Эми pull request жөнөтүңүз. submit the pull request Жакында мен сиздин бардык өзгөртүүлөрүңүздү бул долбоордун негизги тармагына бириктирем (merge). Өзгөртүүлөр бириктирилгенде сизге электрондук почта аркылуу билдирүү келет. ## Эми каякка баруу керек? Куттуктайбыз! Сиз салым кошуучу катары көп кездешүүчү стандарттуу _fork -> clone -> edit -> pull request_ иш процессин аяктадыңыз! Салымыңызды белгилеп, [веб-тиркемеге](https://firstcontributions.github.io/#social-share) кирип, досторуңуз жана жолдоочуларыңыз менен бөлүшүңүз. Эгер көбүрөөк тажрыйба алгыңыз келсе, [биздин Slack командасына кошулуңуз](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) карап көрүңүз. Эми башка долбоорлорго салым кошууну баштайлы. Биз сиз баштасаңыз боло турган жеңил маселелери бар долбоорлордун тизмесин түздүк. [веб-тиркемедеги долбоорлордун тизмесин](https://firstcontributions.github.io/#project-list) карап чыгыңыз. --- ## Башка куралдарды колдонгон окуу материалдары | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](docs/gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](docs/gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](docs/gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](docs/gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.kz.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Жобаға алғаш рет үлес қосу Оңай іс емес, жалпы кез-келген істе алғашқы қадам қиын келеді. Қателіктер жасау өте жағымсыз, әсіресе топтық жұмыс істесеңіз. Барлық open source проекттер ынтымақтастық пен бірегей жұмыстан тұрады. Біз бастаушы әзірлеушілер үшін үлес қосу және бірлесіп жұмыс істеудегі алғашқы қадамдарды жеңілдеткіміз келеді. Егер сіз өзіңіздің алғашқы үлесіңізді жасау мүмкіндігін іздесеңіз, төмендегі қарапайым қадамдарды орындаңыз. Бұл репозиторийді форк жасаңыз Егерде сіздің компьютеріңізде git қосылмаған болса, [ оны қосыңыз ](https://help.github.com/articles/set-up-git/) ## Тармақты (fork) жасаңыз Өзіңіздің тармағыңызды жасау үшін, беттің үстіңгі жағындағы `fork` түймесін басыңыз. Осылай сіз осы репозиторийдің өзіңіздің аккаутыңызда копиясын жасайсыз. ## Репозиторийді клондаңыз Бұл репозиторийді клондаңыз Енді бұл репозиторийді өз дербес компьютеріңізге клодаңыз. Сілтемені көшіру үшін `clone` батырмасын басыңыз, содан кейін `copy to clipboard` белгішесіне басыңыз. Терминалды ашып, келесі git пәрмендіні іске қосыңыз: ``` git clone "url you just copied" ``` Бұл жерде "url you just copied" (тырнақшасыз) сіздің репозиторийңізге сілтеме. Бұл сілтемені алу үшін алдыңғы қадамдарды қараңыз. URL мекенжайын алмасу буферіне көшіріңіз Мысалы: ``` git clone https://github.com/this-is-you/first-contributions.git ``` Бұл жерде `this-is-you` сіздің github-тағы логин. Осылайша GitHub-тан сіздің компьютеріңізге 'first-contributions' репозиторийін көшіресіз. ## Тармақ жасаңыз Терминалда репозиторий папкасына кіріңіз (егер әлі кірмеген болсаңыз): ``` cd first-contributions ``` Енді `git switch` команданың көмегімен тармақты құрыңыз. ``` git switch -c your-new-branch-name ``` Мысалы: ``` git checkout -b add-alonzo-church ``` > Тармақтың аты шешіп жатқан мәселе немесе енгізетін өзгерістеріңізге сәйкес болғаны дұрысырақ, бірақ міндетті емес. ## Керек өзгерістерді еңгізіп, коммит жасаңыз Енді мәтіндік редакторда `Contributors.md` файлын ашыңыз, атыңызды енгізіңіз және файлды сақтаңыз. Егер сіз жобалық каталогқа барып, `git абалын көрсөтүү` орындасаңыз, өзгертулерді көресіз. Бұл өзгертулерді `git add` командасымен қосыңыз. ``` git add Contributors.md ``` Енді бұл өзгерістерды `git commit` командасымен коммиттаңыз. ``` git commit -m "Add to Contributors list" ``` `` өзіңіздің атыңызға ауыстырыңыз ## Өзгерістерді Github'қа жіберіңіз Өзгерістерді `git push` командасымен жіберіңіз ``` git push origin your-new-branch-name ``` `your-new-branch-name` дегенді алдында құрған тармақ атына өзгертіңіз. ## Өзгерістерді ревью үшін растаңыз Егер сіз GitHub-тағы репозиторийге кірсеңіз, `Compare & pull request` батырмасын көресіз. Оны басыңыз. Pull request жасаңыз Енді пулл-реквестті растаңыз. Pull request жіберіңіз Көп ұзамай мен осы жобаның негізгі бөлімімен барлық өзгерістерді біріктіремін. Өзгерістер қабылданған кезде (мердж жасалғанда) электрондық хат аласыз. ## Ары қарай не? Төменде сіз жаңадан келген тапсырмаларды таба алатын бірнеше танымал репозиторийлер бар. Қосымша ақпарат алу үшін репозиторийге барыңыз. | [![exercism](https://avatars2.githubusercontent.com/u/5624255?v=3&s=100)](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22) | [![fun-retro](https://avatars3.githubusercontent.com/u/15913975?v=3&s=100)](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22) | [![habitat](https://avatars1.githubusercontent.com/u/18171698?v=3&s=100)](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [![scikit-learn](https://avatars0.githubusercontent.com/u/365630?v=3&s=100)](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie) | [](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22) | [![elasticsearch](https://avatars2.githubusercontent.com/u/6764390?v=3&s=100)](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22) | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [exercism](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22) | [Fun Retros](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [react](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22) | [habitat](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [scikit-learn](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [Leiningen](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie) | [numpy](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22) | [elasticsearch](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22) | | [![homebrew](https://avatars2.githubusercontent.com/u/1503512?v=3&s=100)](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) | [![rust](https://avatars1.githubusercontent.com/u/5430905?v=3&s=100)](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy) | [![vuejs](https://avatars1.githubusercontent.com/u/6128107?v=3&s=100)](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22) | [![Suave](https://avatars2.githubusercontent.com/u/5822862?v=3&s=100)](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy) | [![OpenRA](https://avatars3.githubusercontent.com/u/409046?v=3&s=100)](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [![PowerShell](https://avatars0.githubusercontent.com/u/11524380?v=3&s=100)](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs) | [![coala](https://avatars2.githubusercontent.com/u/10620750?v=3&s=100)](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer) | [![moment](https://avatars2.githubusercontent.com/u/4129662?v=3&s=100)](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs) | | [homebrew](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) | [Rust](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy) | [vuejs](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22) | [Suave](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy) | [OpenRA](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy) | [PowerShell](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs) | [coala](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer) | [moment](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs) | | [![ava](https://avatars0.githubusercontent.com/u/8527916?v=3&s=100)](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22) | [![freeCodeCamp](https://avatars0.githubusercontent.com/u/9892522?v=3&s=100)](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [![webpack](https://avatars3.githubusercontent.com/u/2105791?v=3&s=100)](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22) | [![hoodie](https://avatars1.githubusercontent.com/u/1888826?v=3&s=100)](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [![pouchdb](https://avatars3.githubusercontent.com/u/3406112?v=3&s=100)](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) | [![neovim](https://avatars0.githubusercontent.com/u/6471485?v=3&s=100)](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level) | [![babel](https://avatars2.githubusercontent.com/u/9637642?v=3&s=100)](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [](https://github.com/adobe/brackets/labels/Starter%20bug) | | [ava](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22) | [freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [webpack](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22) | [hoodie](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) | [pouchdb](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22) | [neovim](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level) | [babel](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) | [brackets](https://github.com/adobe/brackets/labels/Starter%20bug) | | [![Node.js](https://avatars1.githubusercontent.com/u/9950313?v=3&s=100)](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | [](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | | [Node.js](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | [Semantic-UI-React](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | ================================================ FILE: docs/translations/README.la.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # "Contribute" ຜົນງານໃນ GitHub ຮ່ວມກັບຄົນອື່ນເປັນຄັ້ງທຳອິດແມ່ນບໍ່? ມັນເປັນເລື່ອງທີ່ຂ້ອງຂ້າງຍາກໜ້ອຍໜຶ່ງ, ແຕ່ກ້າວທຳອິດໃນການເລີ່ມຕົ້ນເຮັດຫຍັງບາງຢ່າງມັນກໍ່ຈະຍາກແບບນີ້ສະເໝີ ໂດຍສະເພາະເວລາທີ່ຕ້ອງຮ່ວມງານກັບຄົນອື່ນ ເພາະເມື່ອເຮົາໄດ້ເຮັດຫຍັງຜິດພາດມັນກໍ່ມັກຈະເຮັດໃຫ້ເຮົາບໍ່ສະບາຍໃຈ, ແຕ່ວ່າໃນໂລກຂອງໂອເພັນຊອສ (open source) ຄືໂລກທີ່ເຮົາຕ້ອງໄດ້ເຮັດວຽກຮ່ວມກັນ! ເຮົາຈຶ່ງຢາກໃຫ້ຜູ້ທີ່ເຂົ້າມາໃໝ່ໄດ້ຮຽນຮູ້ວິທີການ "ຄອນທຣິບິ້ວ" ຜົນງານຮ່ວມກັບຄົນອື່ນໃນ GitHub ແບບງ່າຍໆ. ການອ່ານບົດຄວາມ ແລະ ການທີ່ໄດ້ທົດລອງເຮັດຕົວຢ່າງຕ່າງໆກໍ່ອາດຈະຊ່ວຍໄດ້, ແຕ່ເຖິງຢ່າງໃດກໍ່ຕາມ ຄົງຈະບໍ່ມີສິ່ງໃດເໜືອໄປກວ່າການທີ່ເຮົາໄດ້ລົງມືເຮັດດ້ວຍຕົນເອງ!. ໃນໂປຣເຈັກນີ້ຈະສອນໃຫ້ມືໃໝ່ຮູ້ຈັກການສົ່ງ "contribution" ທຳອິດໄດ້ຢ່າງງ່າຍໆ. ໃຫ້ຈື່ໄວ້ວ່າ: ຄວາມພະຍາຍາມຢູ່ທີ່ໃດ ຄວາມພະຍາຍາມກໍ່ຢູ່ທີ່ນັ້ນເຊັ່ນກັນ! ຖ້າພ້ອມແລ້ວເຮົາມາລອງສົ່ງ contibution ທຳອິດກັນໄດ້ພຽງບໍ່ເທົ່າໃດຂັ້ນຕອນດ້ານລຸ່ມໄປພ້ອມໆກັນເລີຍ, ບອກເລີຍວ່າງ່າຍກວ່າປອກກ້ວຍ. Crea exemplar huius repositoris ຫາກໃຜຍັງບໍ່ໄດ້ຕິດຕັ້ງ git ລົງໃນເຄື່ອງ, ທ່ານສາມາດກົດລິ້ງ[ຕິດຕັ້ງໄດ້ທີ່ນີ້]( https://help.github.com/articles/set-up-git/ ) ## ກົດ "Fork" ໂປຣເຈັກນີ້ ໂປຣເຈັກຫຼັກນີ້ມັກຈະເອີ້ນວ່າ ໂປຣເຈັກຕົ້ນນ້ຳ, ທ່ານສາມາດ fork ໂປຣເຈັກຕົ້ນນ້ຳນີ້ໄປຍັງ repo ຂອງ account ຂອງທ່ານເອງໄດ້ໂດຍການກົດປຸ່ມ "Fork" ທີ່ດ້ານເທິງຂອງໜ້ານີ້. ແລ້ວໂປຣເຈັກນີ້ກໍ່ຈະຖືກຄັດລອກໄປທີ່ account ຂອງທ່ານ. ## ກົດປຸ່ມ "Clone" ໂປຣເຈັກນີ້ Replica hoc repositorium ມາຮອດຂັ້ນຕອນນີ້ເຮົາກໍ່ Clone ໂປຣເຈັກລົງມາທີ່ຄອມພິວເຕີຂອງເຮົາໂດຍການກົດທີ່ປຸ່ມ "Clone" ແລ້ວເລືອກ *Copy to clipboard* (ຄຳສັ່ງຄັດລອກ) ເປີດ terminal ຂຶ້ນມາ (ຕົວຢ່າງ Terminal ໃນ MacOS ຫຼື cmd ໃນ Windows) ແລ້ວພິມຄຳສັ່ງ git ຕໍ່ໄປນີ້: ``` git clone "url ທີ່ຄັດລອກໄວ້" ``` "url ທີ່ຄັດລອກໄວ້" (ບໍ່ຕ້ອງໃສ່ " ") ຄື url ຂອງໂປຣເຈັກຂອງທ່ານ ທ່ານສາມາດກັບໄປເບິ່ງວິທີການຄັດລອກ url ໄດ້ຈາກຫົວຂໍ້ກ່ອນໜ້ານີ້ URL in tabulam memoriae copia ຕົວຢ່າງ: ``` git clone https://github.com/this-is-you/first-contributions.git ``` `this-is-you` ຄືຊື່ username ຂອງທ່ານຢູ່ເທິງ GitHub, ມາຮອດບ່ອນນີ້ທ່ານໄດ້ "Clone" ໂປຣເຈັກ first-contributions ໄປໄວ້ທີ່ຄອມພິວເຕີຂອງທ່ານແລ້ວ. ## ສ້າງ branch ໃນ terminal ປ່ຽນ directory ໄປບ່ອນທີ່ທ່ານ Clone ໂປຣເຈັກໄວ້: ``` cd first-contributions ``` ບ່ອນນີ້ໃຫ້ສ້າງ branch (ແຕກສາຂາອອກມາໃໝ່) ດ້ວຍຄຳສັ່ງ `git checkout`: ``` git checkout -b <ຊື່ branch> ``` ຕົວຢ່າງ: ``` git checkout -b add-phongphat-khamphiew ``` (ປົກກະຕິຊື່ຂອງ branch ບໍ່ຈຳເປັນຕ້ອງມີຄຳວ່າ *add* ແຕ່ໃນໂປຣເຈັກນີ້ຢາກໃຫ້ໃຊ້ add-ຊື່-ຂອງ-ທ່ານ ເພາະຊື່ຂອງທ່ານຈະໄປສະແດງຢູ່ທີ່ລາຍການ Contributors (ຜູ້ເຂົ້າຮ່ວມ) ຂອງໂປຣເຈັກນີ້ ## ເພີ່ມຫຼືແກ້ໄຂ code ໄດ້ເລີຍ, ແຕ່ຢ່າລືມ "Commit" ບອກວ່າທ່ານໄດ້ເຮັດຫຍັງລົງໄປແລ້ວແນ່ ຕອນນີ້ໃຫ້ເປີດໄຟລ໌ `Contributors.md` ໃນໂປຣແກຣມ text editor ເພີ່ມຊື່ຂອງທ່ານລົງໄປ ຈາກນັ້ນບັນທຶກໄຟລ໌ Statum Git ໃນ terminal ຖ້າທ່ານຢູ່ທີ່ directory ຂອງໂປຣເຈັກ ໃຫ້ລອງພິມຄຳສັ່ງ `git status` ຈະເຫັນວ່າທ່ານໄດ້ປ່ຽນແປງໄຟລ໌ໃດແນ່ແລ້ວ. ເພີ່ມການປ່ຽນແປງນັ້ນໆເຂົ້າໄປ branch ທີ່ຫາກໍ່ສ້າງດ້ວຍຄຳສັ່ງ `git add`: ``` git add Contributors.md ``` ຕອນນີ້ "Commit" ການປ່ຽນແປງດັ່ງກ່າວດ້ວຍຄຳສັ່ງ `git commit`: ``` git commit -m "Add <ຊື່ຂອງທ່ານ> to Contributors list" ``` ແທນບ່ອນ `<ຊື່ຂອງທ່ານ>` ດ້ວຍຊື່ແທ້ຂອງທ່ານ. ## "Push" code ທີ່ປ່ຽນແປງຂຶ້ນ GitHub "Push" ຜົນງານທີ່ທ່ານໄດ້ເຮັດໃນຂັ້ນຕອນກ່ອນໜ້ານີ້ຂຶ້ນ GitHub ດ້ວຍຄຳສັ່ງ `git push`: ``` git push origin <ຊື່ branch ຂອງທ່ານ> ``` ແທນບ່ອນ `<ຊື່ branch ຂອງທ່ານ>` ດ້ວຍຊື່ຂອງ branch ທີ່ທ່ານໄດ້ສ້າງໄວ້ໃນຫົວຂໍ້ກ່ອນໜ້ານີ້ (add-ຊື່-ຂອງ-ທ່ານ) ## ສົ່ງຜົນງານ ແລະ ລໍຖ້າຣີວິວຈາກເຈົ້າຂອງໂປຣເຈັກ ໄປທີ່ repository ຂອງທ່ານເທິງ GitHub ກົດທີ່ `Compare & pull request` Crea petitionem trahendi ຕອນນີ້ກໍ່ສົ່ງ Pull Request ໄປທີ່ໂປຣເຈັກຫຼັກ ຫຼື ໂປຣເຈັກຕົ້ນນ້ຳໄດ້ເລີຍ Mitte petitionem trahendi ເຮົາຈະທຳການ "Merge" ຫຼື ລວມຜົນງານທີ່ທ່ານໄດ້ປ່ຽນແປງ code ມາທີ່ master branch ຂອງໂປຣເຈັກນີ້, ທ່ານຈະໄດ້ຮັບອີເມວເມື່ອເຮົາໄດ້ທຳການ Merge ຜົນງານຂອງທ່ານສຳເລັດແລ້ວ. ## ຈະເຮັດຫຍັງຕໍ່ຫຼັງຈາກນີ້? ຍິນດີນຳ, ທ່ານໄດ້ປະຕິບັດຂັ້ນຕອນຂອງການເຮັດ contribute ຄື fork -> clone -> edit -> pull request ເຊິ່ງຂັ້ນຕອນຕ່າງໆເຫຼົ່ານີ້ເປັນສິ່ງທີ່ທ່ານຕອງໄດ້ພົບເມື່ອທ່ານເປັນ contributor ສະເຫຼີມສະຫຼອງໃຫ້ແກ່ການມີສ່ວນຮ່ວມຂອງທ່ານ, ຢ່າລືມແບ່ງປະສົບການທີ່ທ່ານໄດ້ຮັບໃຫ້ແກ່ໝູ່ເພື່ອນຂອງທ່ານ ໂດຍໄປທີ່ [ເວັບໄຊນີ້](https://firstcontributions.github.io/#social-share) ຈາກນີ້ທ່ານສາມາດ contribute ໃຫ້ໂປຣເຈັກອື່ນໆໄດ້, ໂດຍທາງເຮົາໄດ້ເຮັດລາຍການໂປຣເຈັກທີ່ງ່າຍຕໍ່ການເລີ່ມຕົ້ນບາງສ່ວນໄວ້ໃຫ້ [ລາຍຊື່ໂປຣເຈັກທີ່ໜ້າສົນໃຈ](https://firstcontributions.github.io/#project-list) ### [ຂໍ້ມູນອື່ນໆເພີ່ມເຕີມ](../additional-material/git_workflow_scenarios/additional-material.md) ## ເຝິກການ contribute ໂດຍໃຊ້ເຄື່ອງມືອື່ນໆ |GitHub Desktop|Visual Studio 2017|GitKraken| |---|---|---| |[GitHub Desktop](../github-desktop-tutorial.md)|[Visual Studio 2017](../github-windows-vs2017-tutorial.md)|[GitKraken](../gitkraken-tutorial.md)| ================================================ FILE: docs/translations/README.ln.md ================================================ [![Bolingo ya Logiciel Libre](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Makabo nto contribution ya Liboso Ezalaka ntango nyonso mpasi mpo na moto kosala eloko moko mpo na mbala ya liboso. Kobanga kosala mabunga nto erreurs ezalaka malamu te, mingimingi ntango ozali kosala mosala elongo na bato mosusu. Kasi mokili ya logiciel libre ezali likambo ya kosala mosala elongo mpe kosala na kati ya etuluku nto groupe. Yango wana, tolingi kopesa nzela ya pete mpo na baye bazali kobanda kopesa makabo nto mpe contribution na logiciel libre na koteya bino ndenge ya kosala contribution mpo na mbala ya liboso. Kotánga ba articles mpe ba tutoriels ekoki kosalisa, kasi nini eleki malamu koleka komeka na kozanga kobanga kosala mabunga nto mpe erreur? Projet oyo ezali na mokano ya kopesa toli mpe kopesa nzela ya pete mpo na ndenge bayekoli bakoki kopesa contribution na bango ya liboso. Kobosana te: soki ozali na kimya mingi, okoyekola malamu. Soki olingi kopesa makabo nto mpe contribution na yo ya liboso, landa kaka ba étapes oyo ezali awa na nse. Nalaki yo, ekozala esengo. Kopela dépôt oyo na compte na yo ya GitHub Soki ozali naino na Git te na machine na yo, [ installe-yango ](https://help.github.com/articles/set-up-git/). ## Kosala fork ya dépôt oyo Sala fork ya dépôt oyo na kokliké na bouton _fork_ neti elakisami na bilili oyo likoló. Yango ekosala copie ya dépôt oyo na compte na yo moko ya GitHub. ## Kosala clone ya répertoire oyo Sala clone ya dépôt oyo na ordinateur na yo Sikoyo, sala clone ya répertoire oyo na ordinateur na yo. Kende na compte na yo ya GitHub, fungola dépôt oyo osali fork, kliké na bouton _Code_, na nsima na onglet _SSH_ mpe na nsuka na icône _copier dans le presse-papier_. Fungola invite de commande (soki ozali na Windows) to terminal (soki ozali na MacOS to Linux) mpe sala commande git oyo elandi: [Okoki mpe koinstallé Git bash na Windows nayo soki](https://gitforwindows.org/) ```bash git clone "lien ya repertoire oyo okopié" ``` esika "lien ya repertoire oyo okopié" (longola ba guillemets) ezali url ya dépôt oyo osali fork. Talá lisusu ba étapes ya liboso mpo na kozwa URL ya solo. Kopa URL na presse-papiers Na ndakisa: ```bash git clone https://github.com/kombo-na-yo-ya-utilisateur/first-contributions.git ``` esika `kombo-na-yo-ya-utilisateur` ezali kombo na yo ya utilisateur ya GitHub. Awa ozali kokopié ba contenus ya dépôt `first-contributions` uta na GitHub na ordinateur na yo. ## Kosala branche moko Kende na répertoire ya projet oyo osili kosala clone (soki ozali naino na kati te): ```bash cd first-contributions ``` Sikoyo sala branche moko na commande `git checkout`: ```bash git checkout -b ``` Na ndakisa: ```bash git checkout -b add-emmanuel-binen ``` (Kombo ya branche kozala na kozala na liloba _add_ ezali ya mutuya te, kasi ezali malamu koyekola yango mpo tina ya branche oyo ezali mpo na kobakisa kombo na yo na liste.)
Soki okutani na libunga na git switch, kliká awa: Soki message "Git: switch is not a git command. See git –help" ebimi, ezali mpo ozali kosalela version ya kala ya Git. Na likambo yango, meká nde: ```bash git checkout -b kombo-ya-branche-na-yo-ya-sika ```
## Sala ba modifications oyo esengeli mpe enregistrer yango Fungola fichier `Contributors.md` na éditeur ya texte, bakisá kombo na yo kuna, mpe enregistrer yango. Kobakisa yango te na ebandeli to na nsuka ya fichier, kasi esika moko na katikati. Résultat ya commande git status Soki ofungoli terminal de commande mpe osali commande `git status`, okomona ete ezali na ba modifications. Bakisá ba modifications yango na branche oyo osili kosala na commande `git add`: ```bash git add Contributors.md ``` Sikoyo sala commit ya ba modifications yango na commande `git commit`: ```bash git commit -m "Add to Contributors list" ``` longola `` mpe bakisa kombo na yo moko. ## Tinda ba modifications na GitHub Pusa ba modifications na yo na commande `git push`: ```bash git push -u origin ``` longola makomi oyo `` mpe tia kombo ya branche oyo osili kosala.
Soki ozwi ba erreurs ntango ya kopusa ba modifications, kliké awa: - ### Erreur ya authentification 
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//first-contributions.git/'
Landa tutoriel ya GitHub mpo na kosala mpe ko configurer clé SSH na compte na yo. Okoki mpe kosala `git remote -v` mpo na kotala adresse na yo ya mosika. Soki ezali lokola oyo: 
origin https://github.com/kombo-na-yo-ya-utilisateur/ton_repo.git (fetch) origin https://github.com/kombo-na-yo-ya-utilisateur/ton_repo.git (push)
Bongisa yango na commande oyo: ```bash git remote set-url origin git@github.com:kombo-na-yo-ya-utilisateur/ton_repo.git ``` Soki te, okokoba komona kokɔtisa mot de passe na yo mpe na suka okozua erreur ya authentification.
## Tinda contribution na yo mpo na kotala Soki okeyi na répertoire na yo na Github, okomona bouton `Compare & pull request`. Kliké na yango. Kosala pull request Na nsima, tinda _pull request_. Kotinda pull request Nakotia ba modifications na yo na branche principale ya projet kala mingi te. Sima okozwa e-mail ya confirmation soki yango esalemi. Branche main ya dépôt na yo oyo osali fork ekobongwana te. Mpo ete dépôt na yo ezala synchronisé na ya ngai, landa ba étapes oyo elandi. ## Tiká fork na yo ezala synchronisé na répertoire oyo Ya liboso, kende na branche main ```bash git checkout main ``` Mpe bakisá url ya répertoire na ngai lokola `upstream remote url`: ```bash git remote add upstream https://github.com/Emmanuelbinen/first-contributions ``` Oyo ezali lolenge moko ya koyebisa git ete version mosusu ya répertoire oyo ezali na adresse oyo epesami mpe tobengi yango `upstream`. Soki ba modifications esili kosangisama, luká version ya sika ya répertoire na ngai: ```bash git fetch upstream ``` Awa tozali koluka ba modifications nyonso na fork na ngai (upstream remote). Sikoyo, osengeli kosangisa version ya sika ya répertoire na ngai na branche main na yo: ```bash git rebase upstream/main ``` Awa tozali kosalela ba modifications nyonso oyo ozwi na branche main. Soki opusi branche main sikoyo, fork na yo mpe ekozala na ba modifications: ```bash git push origin main ``` Keba: Mbala oyo, ozali kopusa ba modifications na répertoire ya mosika oyo babengi origin. Na ntango oyo nasangisi branche na yo `` na branche na ngai main, mpe osangisi branche na ngai main na branche na yo main. Branche na yo `` ezali lisusu na ntina te, yango wana okoki kolongola yango: ```bash git branch -d ``` mpe okoki kolongola version na naye uta répertoire ya mosika mpe: ```bash git push origin --delete ``` Oyo ezali ya ntina te, kasi kombo ya branche emonisi ete mokano nto objectif na yango ezali ya sikisiki nto polelepolele. Bomoi na yango ekoki kozala mokuse. ## Ba tutoriels mpo nakosalelá bisaleli nto baoutils mosusu | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ## Wapi kokende na nsima? Soki olingi kopesa makabo na code, talá [dépôt na biso ya GitHub ya makabo nto contribution na code](https://github.com/roshanjossey/code-contributions). ================================================ FILE: docs/translations/README.lt.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Pirmieji įnašai Sunku. Visada sunku ką nors padaryti pirmą kartą. Ypač bendradarbiaujant, klaidų darymas nėra malonus dalykas. Tačiau atviras kodas - tai bendravimas ir bendradarbiavimas. Mes norime paprasčiau paaiškinti naujiesiems atvirojo kodo kūrėjams, kaip jie gali prisidėti pirmą kartą. Galite pradėti skaityti straipsnius ir žiūrėti vadovus, bet kas gali būti geriau nei mokymasis darant be klaidų pirmą kartą? Šio projekto tikslas - suteikti patarimus ir supaprastinti tai, kaip naujokai atlieka savo pirmąjį indėlį. Prisiminkite: kuo labiau atsipalaidavę esate, tuo geriau mokotės. Jei norite atlikti pirmąjį indėlį, atlikite toliau pateiktus paprastus veiksmus. Mes pažadame, tai bus smagu. _Jei nesate pratę dirbti su komandine eilute, [čia rasite vadovą, naudojantį GUI įrankius.](#tutorials-using-other-tools)_ sukurkite šaką iš šio saugyklos #### Jei neturite instaliuoto git, [instaliuokite čia](https://help.github.com/articles/set-up-git/). ## Kopijuokite (fork) šią saugyklą Kopijuokite saugyklą paspausdami šaknies simbolio mygtuką šio puslapio viršuje. Tai sukurs šios saugyklos kopiją jūsų GitHub paskyroje. ## Klonuokite saugyklą nukopijuokite šią saugyklą Dabar klonuokite šią saugyklą į savo kompiuterį. Spustelėkite klonavimo mygtuką ir tada spustelėkite *copy to clipboard* piktogramą. Atidarykite terminalą ir paleiskite šią git komandą: ``` git clone "kątik nukopijuota nuoroda" ``` kur "kątik nukopijuota nuoroda" (be citatos ženklų) yra url nuoroda jūsų saugyklai (jūsų projekto kopijai). Peržiūrėkite ankstesnius veiksmus, kad gautumėte url nuorodą. nukopijuokite URL į iškarpinę Pavyzdžiui: ``` git clone https://github.com/tai-jus/first-contributions.git ``` kur `tai-jus` yra jūsų GitHub paskyros vartotojo vardas. Čia jūs kopijuojate first-contributions saugyklos turinį į "GitHub" aplanką savo kompiuteryje. ## Sukurkite šaką (branch) Pakeiskite kompiuterio saugyklos katalogą (jei dar to nepadarėte anksčiau): ``` cd first-contributions ``` Dabar sukurkite šaką naudodami komandą `git branch`: ``` git branch -c ``` Pavyzdžiui: ``` git branch -c add-vardenis-pavardenis ``` (Saugyklos pavadinime neprivalo būti žodžio *add*, bet mes jį naudojame, kadangi šios šakos (branch) paskirtis yra įtraukti savo vardą į sąrašą.)
Jei gavote klaidos pranešimą naudodami git switch, spauskite čia: Jei klaidos pranešimas yra "Git: `switch` is not a git command. See `git –help`", tikėtinai naudojate seną git versiją. Tokiu atveju bandykite `git checkout`: ```bash git checkout -b add-vardenis-pavardenis ```
## Atlikite reikiamus pakeitimus ir pridėkite (commit) šiuos pakeitimus Dabar atidarykite failą `Contributors.md` teksto redaktoriuje ir pridėkite prie jo savo vardą. Nedėkite jo į failo pradžią ar pabaigą - įrašykite jį bet kur kitur faile. Galiausiai, išsaugokite failą. Jei eisite į projekto katalogą ir paleisite komandą `git status`, pamatysite, kad yra pakeitimų. Pridėkite šiuos pakeitimus į ką tik sukurtą šaką (branch) komandos `git add` pagalba: ``` git add Contributors.md ``` Dabar atlikite šiuos pakeitimus naudodami komandą `git commit`: ``` git commit -m "Add to Contributors list" ``` pakeisdami `` savo vardu. ## Išsiųskite pakeitimus į GitHub Išsiųskite pakeitimus komanda `git push`: ``` git push origin ``` pakeisdami `` anskčiau sukurtos šakos (branch) vardu.
Jei gaunate klaidos pranešimą išsaugodami pakeitimus, spauskite čia: - ### Autentifikacijos klaida 
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//first-contributions.git/'
[GitHub vadovas](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) padės jums sugeneruoti ir sukonfiguruoti SSH raktą savo paskyroje. Taip pat, galbūt norėsite pabandyti 'git remote -v', skirtą patikrintite savo nuotolinį adresą (remote address). Jei jis atrodo taip ar panašiai: 
origin	https://github.com/your-username/your_repo.git (fetch)
  origin	https://github.com/your-username/your_repo.git (push)
pakeiskite jį, naudodami komandą: ```bash git remote set-url origin git@github.com:your-username/your_repo.git ``` Kitu atveju jūsų vis tiek sulauksite klausimo apie savo vartotojo vardą ir slaptažodį ir sulauksite autentifikacijos klaidos.
## Pateikite pakeitimus peržiūrai Eikite į savo saugyklą GitHub. Pamatysite mygtuką `Compare & pull request` (palyginti ir įtraukti užklausą). Spustelėkite šį mygtuką. sukurkite traukimo užklausą Dabar pateikite įtraukimo į pradinę saugyklą (pull) užklausą. pateikite traukimo užklausą Netrukus projekto autorius sujungs visus jūsų šakos pakeitimus su šio projekto pagrindine šaka. Kai pakeitimai bus sujungti, gausite tai patvirtinantį el. laišką. ## Kas toliau? Džiaukitės ir atkreipkite dėmesį į savo įnašą pasidalindami šia žinia su draugais [interneto aplikacijoje](https://firstcontributions.github.io/#social-share). Pradėkite tobulinti kitus projektus. Mes sukūrėme projektų sąrašą, kuriuose yra lengvai išsprendžiamų problemų. Peržiūrėkite [projektų sąrašą interneto aplikacijoje](https://firstcontributions.github.io/#project-list). ### [ Papildoma medžiaga ](../additional-material/git_workflow_scenarios/additional-material.md) ## Pamokos naudojant kitus įrankius | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.lug.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Okwongezaako Eby'okusooka Ekigendererwa ky'enteekateeka eno kwe kusobozesa n'okuyamba abayizi mu kuteekawo ebyabwe eby'okubiri. Bw'oba oyagala okukola eky'osooka okuyongeraako, goberera emboozi ez'ekiddako wansi. _Bw'oba tokkiriziganya na command line, [wano waliyo ebiranga ebikozesa ebikozesebwa ebiwa GUI.](#tutorials-using-other-tools)_ Forka ekitabo kya repository #### Bw'oba tolina git ku kompyuta yo, [teeka git](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Gabaako repo eno Gabaako repo eno nga okozesa ekirungo ekiri waggulu ku lupapula luno. Kino kijja kutonda kopi ya repo eno mu akaawunti yo. ## Koppa repo Koppa ekitabo kya repository Kati koppa repo eyogabiddwa ku kompyuta yo. Genda ku akaawunti yo ku GitHub, fungula repo eyogabiddwa, koona ku kaakano akaliko code n'oluvannyuma koona ku kirungo _copy to clipboard_. Fungula terminal n'okozesa ekiragiro ekiddako ku git: ```bash git clone "url you just copied" ``` "URL gy'okoze koppa" (nga tekirina obubonero obuli mu kkiwandiiko) kye URL eri ku repo eno (okugaba kwo ku kawefube ono). Laba ku bigambo ebyo ebiri waggulu okugenda ku URL. Koppa URL ogiteeke mu clipboard Ekikokyo: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` awa `this-is-you` ye erinya lyo ku GitHub. Wano okopeera ebiri mu repo ey'okusooka okuyongeraako ku GitHub ku kompyuta yo. ## Tonda branch Kyusa mu nnannyini repo ku kompyuta yo (bw'oba toliyo dda): ```bash cd first-contributions ``` Kati tonda branch ng'oyita mu kiragiro kya `git switch`: ```bash git switch -c your-new-branch-name ``` Ekikokyo: ```bash git switch -c add-alonzo-church ``` ## Kola enkyukakyuka eziyetaagisa n'okikakasa ezo enkyukakyuka Kati gulawo fayiro ya `Contributors.md` mu kikozesebwa ky'okuwandiika, yongeramu erinnya lyo mu fayiro eno. Togyongeramu ku ntandikwa oba ku nkomerero ya fayiro. Tta gy'ali wakati wa fayiro. Kati, giyita fayiro eno. Embeera ya git Bw'ogenda mu kisenge ky'enteekateeka n'okola ekiragiro `git status`, ojja kulaba nga waliyo enkyukakyuka. Yongeza ezo enkyukakyuka ku branch gye watondawo nga okozesa ekiragiro kya `git add`: ```bash git add Contributors.md ``` Kati okakasa ezo enkyukakyuka nga okozesa ekiragiro kya `git commit`: ```bash git commit -m "Add your-name to Contributors list" ``` oweerereza erinnya lyo ku `your-name`. ## Sindikiza enkyukakyuka ku GitHub Sindikiza enkyukakyuka nga okozesa ekiragiro kya `git push`: ```bash git push -u origin your-branch-name ``` oweerereza erinnya lyo ku `your-branch-name`. ## Weereza enkyukakyuka zo okuzuulibwa Bw'ogenda ku repo yo ku GitHub, ojja kulaba akapipati ka `Compare & pull request`. Koona ku kapipati ako. Tondawo Pull Request Kati weereza pull request. Weereza Pull Request Olwatuuka kunsonga y'okukakasa enkyukakyuka zo, ojja kufuna email ya kunnyonnyola enkyukakyuka zomaze okukakasa. Oluvannyuma lw'okwo Ki ekirungi! Onoowuziza ku ttendekero lya _fork -> clone -> edit -> pull request_ workflow gwe oyinza okufuna ng'omukozi! Jaguza ekyo ky'oyongeddeko era ogikwase mikwano gyo n'abagoberera nga oyita ku [web app](https://firstcontributions.github.io/#social-share). Kati ka tutandikire okukola ku kintu ekirala. Tundese olukalala lwa project ezirina ebizibu ebitalina y'oyinza okutandika n'okukola. Kebera [olukalala lwa project mu web app](https://firstcontributions.github.io/#project-list). ### [Ebirala ebisobola okukuyamba](additional-material/git_workflow_scenarios/additional-material.md) ## Ebitendekebwa Ebikozesa Ebikozesebwa Ebirala | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.lv.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Pirmais devums Kaut ko paveikt pirmo reizi vienmēr ir grūti. Turklāt pieļaut kļūdas, jo īpaši līdzdarbojoties ar citiem, nav patīkami. Mēs vēlamies vienkāršot veidu, kā jauni atvērtā koda līdzautori mācās un pievieno savu devumu pirmo reizi. Rakstu lasīšana un pamācību skatīšanās var palīdzēt, tomēr nekas nav labāks par īstu darbību mācību vidē. Šī projekta mērķis ir sniegt norādījumus un vienkāršot veidu, kā iesācēji pievieno savu pirmo devumu. Ja tu vēlies līdzdarboties, seko turpmāk norādītajiem soļiem. #### *Ja tu nejūties ērti ar komandrindu, [izmanto GUI rīku pamācības.]( #pamācības-citiem-rīkiem )* sadaliet šo repozitoriju Ja tavā datorā nav git, [uzinstalē to]( https://help.github.com/articles/set-up-git/). ## Izveido repozitorija atzarojumu Izveido savu repozitorija atzarojumu, nospiežot *fork* pogu šīs lapas augšpusē. Tādējādi tavā profilā tiks izveidota šī repozitorija kopija. ## Klonē repozitoriju klonējiet šo repozitoriju Tagad klonē nokopēto repozitoriju savā datorā. Ej uz savu GitHub profilu, atver nokopēto repozitoriju, nospied *clone* pogu un tad nospied uz *copy to clipboard* ikonas. Atver termināli un palaid šo git komandu: ```bash git clone "tikko nokopētā saite" ``` kur "tikko nokopētā saite" (bez pēdiņām) ir url uz šo repozitoriju (tavs projekta atzarojums). Apskaties iepriekšējos soļos, kā dabūt url. kopējiet URL starpliktuvē Piemēram: ```bash git clone https://github.com/tavs-vārds/first-contributions.git ``` kur `tavs-vārds` ir tavs GitHub lietotājvārds. Šādi tu kopē GitHub repozitorija *first-contributions* saturu savā datorā. ## Izveido zaru Savā datorā nomaini repozitorija direktoriju (ja tu vēl neatrodies tajā): ```bash cd first-contributions ``` Tagad izveido zaru ar `git checkout` komandu: ```bash git checkout -b ``` Piemēram: ```bash git checkout -b add-alonzo-church ``` (Zara nosaukumā nav obligāti jābūt vārdam *add*, bet būtu lietderīgi to iekļaut, jo šī zara mērķis ir tava vārda pievienošana sarakstam.) ## Veic nepieciešamās izmaiņas un iesūti tās Tagad atver `Contributors.md` failu teksta redaktorā un pievieno tam savu vārdu. Nepievieno to faila sākumā vai beigās, bet ievieto to kaut kur pa vidu. Pēc tam saglabā failu. git status Ja tu dosies uz projekta direktoriju un izpildīsi komandu `git status`, tu redzēsi, ka tajā ir izmaiņas. Pievieno šīs izmaiņas zaram, kuru tu tikko izveidoji, ar `git add` komandu: ```bash git add Contributors.md ``` Tagad iesūti šīs izmaiņas ar `git commit` komandu: ```bash git commit -m "Add to Contributors list" ``` aizvietojot `` ar savu vārdu. ## Pievieno izmaiņas GitHub Pievieno savas izmaiņas ar komandu `git push`: ```bash git push origin ``` aizvietojot `` ar zara, kuru tu iepriekš izveidoji, nosaukumu. ## Iesniedz izmaiņas pārskatīšanai Ja tu dosies uz savu GitHub repozitoriju, tu redzēsi `Compare & pull request` pogu. Nospied to. izveidojiet pull request Tagad iesniedz pievienotās izmaiņas. iesniedziet pull request Jau pavisam drīz es pievienošu visas tavas izmaiņas šī projekta galvenajam (master) zaram. Tu saņemsi paziņojumu e-pastā, tiklīdz izmaiņas būs pievienotas. ## Un ko tagad? Apsveicam! Tu tikko pabeidzi standarta _fork -> clone -> edit -> PR_ darbplūsmu, ar kuru turpmāk bieži nāksies sastapties kā līdzautoram. Pastāsti par savu devumu saviem draugiem un sekotājiem, izmantojot [mūsu vietni](https://firstcontributions.github.io/#social-share). Tagad tu vari līdzdarboties arī citos projektos. Mēs esam sastādījuši sarakstu ar projektiem, kuros ir vienkāršas problēmas, ar kurām tu varētu sākt. Izpēti [projektu sarakstu mūsu vietnē](https://firstcontributions.github.io/#project-list). ### [Papildu materiāli](../additional-material/git_workflow_scenarios/additional-material.md) ## Pamācības citiem rīkiem | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.ma.md ================================================ [![KAY3BEK T3AWN OPEN SOURCE](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Awel Moucharaka Fo9ma katbghi tbda chi 7aja jdida katkoun m39da flewl. Dik lkhouf anak tghlet ki3ssbek,5ossosan fach katkoun 5dam m3a nass o5rin. Walakin lblan dl open source w anak t5dm m3a nass f fra9i . Bghina , nsshlou 3likoum bach t3lmou tcharkou fchi projet open source b7al hada l awel mra . Rah blan tb9a t9ra kifach dir wla tchouf des tutoriels , walakin wach machi 7ssen nwriwk ki der bla matghlet ? Had lprojet l hadaf dyalou howa y3tek nassa2i7 w 5lik 3a9l : koulma knti mheden , ghat3lem 7ssen. Ila knti 3wal der awel i3ana , tbe3 had l5otowat w ra atsde9lk . Kanwa3dk , ghay3jbek l7al. connecter had repo Ila makanch 3ndk git f pc dyalk, [ Telechargeh ]( https://help.github.com/articles/set-up-git/ )mn had site. ## Jbed had repo l3endek (kismiwha hna Fork) Brek 3la dik FORK kima kaybanlk f tswira bach twli 3ndek b7al version dyal repo f compte dyalk . ## Telecharger 3ndk repo (Kismiwha clone ) Clone d repo Daba ,cloner repo dyalk l pc 3ndk. Brek 3la bottona d Clone w copier dik lien (HTTPS houwa sahel) ra kayna bottona 7da lien katcopiehlk nichan . 7el daba cmd (ila knti f windows) wla terminal (ila kan 3ndk mac wla 5dam b linux) w copier had les commandes li ghanwrik : ```bash git clone "dik lien li 3ad copieti" ``` 3andak t5liha hakak hhh "dik lien li 3ad copieti" (bla douk "") kteb tma lien li copieti fhemni . copier l'URL dans le presse-papier Atkoun b7al had chkel : ```bash git clone https://github.com/smytk_dyal_github/first-contributions.git ``` rah `smytk_dyal_github` hia smya li nta dayr. Daba nta fhad l5twa ghatelecharger ga3 had repo 3ndk f pc bach tbda tbeddel fiha. ## Swb branche jdida dyalk Daba f cmd nit wla terminal , d5l l dik lmilf li 3ad telechargeti (kteb had l3iba la ma3rftich d5l manuellement ) : ```bash cd first-contributions ``` Daba ha kifach ghatswb branch dyalk `git checkout` : ```bash git checkout -b "smya_dlbranch" ``` Par exemple : ```bash git checkout -b add-brahim ``` (Machi darori tder f smya add , walakin gha bach nfhmo 3lach zdtiha) ## Bdl fl file d Contributors Daba d5el l fichier dyal `Contributors.md` fchi editeur , zid smytk w chi lien ila bghiti (3andak der chi7aja 5ayba). Ila ktbti daba f dik cmd/terminal `git status`, aybanulk l3ibat li bdlti. Daba zidhoum l branch dyalk add-brahim bhad l3iba dyal `git add` : ```bash git add Contributors.md ``` Sauvegardeha b `git commit`: ```bash git commit -m "Add to Contributors list" ``` der fblasst `` smytk dbss7 (brahim matalan). ## PUSHIIII Daba ghatpushi had lmodofication li derti l github b `git push` : ```bash git push origin ``` ana knt mssmiha add-brahim , nta bdlha bachma knti dayr . ## 7et les modifications bach ytchafo Ila rj3ti l github atl9a dik l3iba dyal `Compare & pull request` brek 3liha a5ay. create a pull request Sf brek 3liha bach tle3 lnass li mss2oulin 3la hadchi. submit pull request Chwia mbe3d matjm3 dik lmodifications li derti . Aywslk mail ki9ololk fih ra safi dkchi dyalk nadi. branche main dyalk maghaytbdel fiha walou daba . Ila bghiti ta main dyalk ykoun msynchroniser tbe3 had les étapes. ## 5li main dyalk synchronisé m3a contributors B3da rje3 lmain matb9ach fdik add-brahim ```bash git checkout main ``` zid lien d repo as `upstream remote url` : ```bash git remote add upstream https://github.com/smytk_d_github/first-contributions ``` Ghi dik changes ydaro , 5ssk moraha tjbd version jdida dyal repo dyalk: ```bash git fetch upstream ``` Hna kan9lbo 3la ga3 tghyirat li kaynin f lfork dyalk nta (upstream remote). Daba 3ad 5ssk tjm3 had jdida m3a repo dyalk (main) : ```bash git rebase upstream/main ``` Daba ga3 tghyirat kaynin fl main. ila pushiti modifications aydaro ta f fork dyalk : ```bash git push origin main ``` Daba ra jm3na branch dyal `` m3a l main dyalna , w jm3na lmain dyalna m3a main dyalhom (yarbi tkoun fhmtini hh).Daba dik li drti flwl dyal `` mab9atch 3ndha fa2ida , ila bghiti t7ydha : ```bash git branch -d ``` w ymklk t7yda ta mn repo li b3ida : ```bash git push origin --delete ``` Machi darori t7yd lbranch walakin raha salat 5smtha ma3ndha lach tb9a tma . ## Tutoriels bchi twichyat o5rin | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ## Fin nmchi daba ? Ymklkoum tjiw l slack fin kayna lfr9a d hadchi kaml , n9do n3awnokom w njawbo 3la chi ass2ila [Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) ================================================ FILE: docs/translations/README.me.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Prvi doprinos Ovaj projekat ima za cilj da pojednostavi i vodi početnike do njihovog prvog doprinosa. Ako želite da napravite vaš prvi doprinos, pratite korake ispod. _Ako nijeste navikli da koristite komandnu liniju, [evo tutorijala koji koristi GUI alatke.](#Tutorijali-koji-koriste-druge-alatke)_ napravite kopiju repozitorijuma #### Ako nemate git na svojoj mašini, [instalirajte ga ovdje](https://help.github.com/articles/set-up-git/). ## Napravite kopiju repozitorijuma Napravite kopiju _(fork)_ ovog repozitorijuma tako što ćete kliknuti na dugme **fork** na vrhu stranice. Ovo će kreirati kopiju ovog repozitorijuma na vašem nalogu. ## Klonirajte repozitorijum Klonirajte repozitorijum Sada klonirajte repozitorijum na vašu mašinu. Idite na vaš GitHub profil, otvorite kopiju repozitorijuma, kliknite na dugme **code** i kliknite ikonicu *copy to clipboard*. Otvorite terminal i unesite sledeću git komandu: ``` git clone "url koji ste upravo kopirali" ``` Umjesto "url koji ste upravo kopirali" (bez znaka navoda) unesite url repozitorijuma koji ste kopirali u prethodnom koraku. Kopirajte URL Na primjer: ``` git clone https://github.com/korisnicko-ime/first-contributions.git ``` Umjesto `korisnicko-ime` napišite korisničko ime za vaš GitHub nalog. Na ovaj način kopirate sadržaj repozitorijuma na vašu mašinu. ## Kreiranje grane _(branch)_ Prebacite se u radni direktorijum na vašem računaru (ukoliko već nijeste tu): ``` cd first-contributions ``` Sada kreirajte granu koristeći komandu `git checkout`: ``` git checkout -b ime-vase-grane ``` Na primjer: ``` git checkout -b add-nikola-popovic ``` (Ime grane ne mora sadržati riječ _add_, ali je to preporučljivo jer je poenta ove grane da se doda vaše ime na listu kontributora.) ## Napravite potrebne promjene i potvrdite ih Sada otvorite fajl `Contributors.md` u tekst editoru i dodajte vaše ime. Nemojte dodati svoje ime na početku ili na kraju fajla. Stavite ga bilo gdje između. Sada, sačuvajte fajl. git status Ako se vratite na radni direktorijum i izvršite komandu `git status`, vidjećete da su prisutne promjene. Dodajte te promjene u granu koju ste kreirali u prethodnim koracima koristeći komandu `git add`: ``` git add Contributors.md ``` Sada potvrdite te izmjene koristeći komandu `git commit` : ``` git commit -m "Add to Contributors list" ``` Umjesto `` napišite vaše ime. ## Pošaljite izmjene u repozitorijum Pošaljite izmjene koje ste napravili u repozitorijum na GitHub-u koristeći komandu `git push`: ``` git push origin ``` Umjesto `` napišite ime grane koju ste kreirali ranije. ## Pošaljite vaše izmjene na provjeru Ako odete na repozitorijum na GitHub-u, vidjećete dugme **Compare / Pull Request**. Kliknite to dugme. Kreirajte pull request Sada pošaljite vaš pull request. Pošaljite pull request Uskoro, ja ću spojiti promjene koje ste napravili sa master granom repozitorijuma. Dobićete mejl potvrde kada se grane spoje. ## Šta dalje? Čestitamo! Upravo ste izvršili standradni _fork -> clone -> edit -> pull request_ proces koji ćete često gledati dok doprinosite kodu. Proslavite vaš doprinos i podijelite ga sa prijateljima i pratiocima kroz [stranicu](https://firstcontributions.github.io/#social-share). Sada možete početi da doprinosite i drugim projektima. Sastavili smo listu projekata sa jednostavim problemima na kojima možete početi da radite. Pogledajte [listu projekata na stranici](https://firstcontributions.github.io/#project-list). ### [Dodatni materijali](additional-material/git_workflow_scenarios/additional-material.md) ## Tutorijali koji koriste druge alatke | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.mg.md ================================================ [![L'amour du logiciel libre](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Fandraisana anjara voalohany Manahirana antsika foana indraindray ny manomboka zavatra amin'ny voalohany. Tsy mampahazo aina ny manao diso, indrindra moa fa rehefa mifampizara asa sy rehefa miara-miasa aman'olona. Ny tontolo eo amin'ny rindrakajy malalaka anefa dia miompana tanteraka eo amin'ny fiaraha-miasa miaraka amin'ireo olona efa mati-hanina. Izany indrindra ny antom-pisian'ito loharano misokatra ito mba hanamora ny fianaran'ireo vaovao izay handray anjara voalohany eo amin'ny fifampizarana eo amin'ny tontolon'ny rindrakajy malalaka. Tadidio fa tsy hahay mihitsy ianao raha tsy manandrana ary ny fahadisoana azo no hahazoanao traikefa. Raha te hahay ny fomba fandraisana anjara amin'ny fifampizarana ary dia araho ireto dingana manaraka ireto: Mampifandraiso ity takelaka ity Raha mbola tsy misy git ny solosainao, [ ampidiro izy ]( https://help.github.com/articles/set-up-git/ ). ## Hampifandraiso ity takelaka ity (izay antsoina koa hoe "Fork") Raha te hampifandray an'ity takelaka ity amin'ny kaontinao ianao dia tsindrio ilay bokotra "fork" etsy ambony. Lasa misy dika mitovy amin'ity takelaka ity ao amin'ny kaontinao avy eo. ## Dikao mitovy ity takelaka ity ao amin'ny solosainao Dikao mitovy ity takelaka ity Raha te hanao dika mitovy an'ity takelaka ity ianao, dia mankanesa ao amin'ny kaontinao "Github" ary sokafy ilay takelaka nampifandraisinao. Tsindrio ilay bokotra misy soratra hoe "Code" etsy ambony, tsindrio ilay sary fahamantarana manao kopia. Sokafy avy eo fandefasana kaomandy, ary alefaso ity kaomandy ity: ``` git clone "Rohy izay natao kopia" ``` Ilay "Rohy izay natao kopia" (tsy misy faingo) dia ny rohy misy ilay takelaka ao amin'ny kaontinao. Jereo eo ambony ny fomba hahazoana ilay rohy. Ataovy kopia ny rohy Ohatra: ``` git clone https://github.com/ny-anaranao/first-contributions.git ``` Ilay `ny-anaranao` dia ny anaran'ny kaontinao "Github". Eto dia manao dika mitovy ny takelaka avy lavitra ho ao amin'ny solosainao. ## Mamorona sampana Midira ao amin'ny toerana misy ilay tetikasa izay nataonao kopia (raha mbola tsy ao): ``` cd first-contributions ``` Mamorona sampana vaovao ka alefaso ny kaomandy `git checkout` : ``` git checkout -b ``` Ohatra: ``` git checkout -b add-crystel-ratsimbazafy ``` ## Ataovy ny fanovana ilaina rehetra Sokafy ny rakitra `Contributors.md` ao amin'ny fanoratanao ny soratra, dia hampidiro ao ny anaranao, dia tehirizo.Raha sokafanao ny fandefasana kaomandy ka alefanao ny `git status`, dia ho hitanao fa misy ny zavatra niova. Hampidiro anaty lisitra mba ho afaka hiditra ao amin'ny sampana zay noforoninao ny fanovana amin'ny alalan'ny kaomandy `git add`: ``` git add Contributors.md ``` Hampidiro ao amin'ny sampana amin'izay ny fanovana nataonao amin'ny alalan'ny `git commit`: ``` git commit -m "Add to Contributors list" ``` Soloy ny anaranao ilay ``. ## Alefaso any amin'ilay takelaka ao amin'ny Github ny fanovanao Raha te hanao an'izay dia alefaso ny kaomandy `git push` : ``` git push origin ``` Soloy ilay sampana izay noforoninao ilay hoe ``. ## Alefaso ny fangatahano mba hojerena Raha mitsidika ny takelakao ao amin'ny Github ianao dia mahita bokotra `Compare & pull request`. Tsindrio io bokotra io. Mamorona fangatahana Alefaso ny fangatahana avy eo. Mandefa ny fangatahana Ho hakambako ao amin'ny sampana fiaingan'ny tetikasa ny zavatra nataonao avy eo. Mahazo mailaka ianao avy eo mba hahafantaranao fa vita ny fanakambanana. Ny sampana fiaingan'ny tetikasa anao dia tsy maharay ilay fanovanao fa mila raisinao manokana izay fanovana farany ao amin'ny sampana fiaingan'ny tetikasa. Araho ireto dingana manaraka ireto. ## Tazomy tsy ho lany andro ny takelaka nampifandraisinao tamin'ny tena izy. Mankanesa ao amin'ny sampana fiaingana. ``` git checkout main ``` Dia hampidiro ny rohy misy ny takelak'ilay tetik'asa naotaonao fampifandraisana `upstream remote url`: ``` git remote add upstream https://github.com/Roshanjossey/first-contributions ``` Fomba iray atao mba hahahafantaran'i git fa misy zavatra vaovao ao amin'io takelaka io izay antsoina hoe `upstream`. Rehefa vita izay dia alaivo ny fanovana vaovao rehetra ao amin'ilay takelaka nampifandraisina: ``` git fetch upstream ``` Alefaso ao amin'ny sampana fiaingana misy ny takelakao anaty solosainao ny zavatra vaovao rehetra: ``` git rebase upstream/main ``` Alefaso any amin'ny takelaka ao amin'ny github anao ny fanovana azonao rehetra: ``` git push origin main ``` Afaka fafana amin'izay ny sampana izay noforoninao rehefa vita izay: ``` git branch -d ``` Afaka fafana ihany koa ny sampana avy lavitra: ``` git push origin --delete ``` ## Fanoroana hafa izay mampiasa fitaovana hafa | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ## Ny atao manaraka ? Afaka miditra ho mpikambana ao amin'ny ekipanay ao amin'ny Slack ianao raha mila fanontaniana na fanampiana. [Hiditra ho mpikambana ao amin'ny Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) ================================================ FILE: docs/translations/README.mk.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Први чекори Тешко е. Секогаш е тешко кога нешто се прави за прв пат. Кога соработуваме со други луѓе, правењето грешки е непријатно. Затоа сакавме да го поедноставиме начинот на кој новите соработници на отворен код учат и допринесуваат за прв пат. Читањето на статии и гледањето на видеа помага до некаде, но нема подобар начин за учење од вежбањето. Целта на овој проект е да се обезбеди вежба и да се поедностави начинот по кој почетниците допринесуваат отворен код. Ако сакате да го направите својот прв придонес, тогаш следете ги долунаведените чекори. #### *Ако не сакате да користите command line (терминал), [овде имате упатства за GUI](#Вежби-за-користење-на-други-програми)* форкнете го овој репозиториум Ако немате git на вашиот компјутер, [инсталирајте го]( https://help.github.com/articles/set-up-git/). ## Направете Разгранување (Fork) на ова складиште (repository) Направете разгранување на складиштето со притискање на копчето "Fork" кое се наоѓа на горниот дел на оваа страница. Вака ќе направите копија на складиштето во вашиот GitHub профил. ## Клонирајте го овоа складиште клонирајте го овој репозиториум Сега треба да го клонирате складиштето во вашиот компјутер. Отидете во вашиот GitHub профил, отворете го разгранетото складиште, кликнете на копчето "Clone" и копирајте го линкот. Исто така може да притиснете на иконата за копирање (Copy to clipboard) Отворете го терминалот и воведете ја следната команда: ```bash git clone "линкот кој го копиравте" ``` На местото на "линкот кој го копиравте" (без наводници) поставете го линкот на складиштето (Вашето Разгранување на овој проект). Погледнете ги претходните чекори за да видете како да го добиете линкот. копирајте ја URL адресата во таблата со исечоци На пример: ```bash git clone https://github.com/vashiot-username/first-contributions.git ``` со преименување на `vashiot-username` во вашето корисничко име. Во овој чекор правите копија на складиштето first-contributions од GitHub кон вашиот компјутер. ## Создавање на гранка (branch) Променете ја локацијата на складиштето во вашиот компјутер (Ако сеуште не сте ја промениле): ```bash cd first-contributions ``` Сега создајте гранка со помош на командата `git checkout`: ```bash git checkout -b ``` На пример: ```bash git checkout -b add-alonzo-church ``` (Името на гранката не мора да го содржи зборот *add*, но се препорачува, затоа што целта на оваа гранка е да го додадете вашето име во списокот.) ## Направете ги потребните промени и извршете (commit) ги Сега отворете го фајлот `Contributors.md` во уредник за текст и додадете го вашето име. Не додавајте го на почетокот или крајот на фајлот. Поставете го некаде на средината. Зачувајте ги промените. git статус Ако ја извршете командата `git status` во директоријата на складиштето, ќе забележите дека има промени. Зачувајте ги промените на создадената гранката со помош на командата `git add`: ```bash git add Contributors.md ``` Сега извршете ги промените со командата `git commit`: ```bash git commit -m "Add to Contributors list" ``` со промена на `` со вашето име. ## Поставете (Push) ги промените во GitHub Поставете ги вашите промени со командата `git push`: ```bash git push origin ``` со промена на `` во името на вашата гранка, која ја создадовте претходно. ## Поднесете ги вашите промени за преглед. Ако отидете во вашето складиште во GitHub, ќе го забележите копчето `Compare & pull request`. Притиснете го. создадете pull request Сега поднесете ги вашите промени за преглед. поднесете pull request Наскоро ќе ги спојам (merge) сите ваши промени во главната гранка (мастер branch) на овој проект. Ќе бидете известени по пат на електронска пошта за спојот на вашите промени. ## Што е следно? Честитки! Само што ги завршивте _fork -> clone -> edit -> PR_ операции, со кои ќе се соочувате често како соработник! Прославете ги вашите придонеси и споделете ги со пријатели и следители со посета на [веб-апликацијата](https://firstcontributions.github.io/#social-share). Доколку сакате да вежбате повеќе и да придонесувате во проекти со отворен код, погледнете го [Code Contributions](https://github.com/roshanjossey/code-contributions). Сега е време да започнете да допринесувате кон други проекти. Ние имаме создадено список со лесни проекти за да започнете. [Види ја листата](https://firstcontributions.github.io/#project-list). ### [Дополнителен материал](../additional-material/git_workflow_scenarios/additional-material.md) ## Вежби за користење на други програми | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.ml.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # ആദ്യ സംഭാവനകൾ (First Contributions) ആദ്യമായി ഒരു കാര്യം ചെയ്യുക എന്നുള്ളത് വളരെ ബുദ്ധിമുട്ടാണ്. പ്രത്യേകിച്ച്, മറ്റു പലരുടെയും ഒപ്പം ജോലി ചെയ്യുമ്പോൾ തെറ്റ് വരുന്നത് അത്ര സുഖകരമായ കാര്യം അല്ല. സ്വതന്ത്ര സോഫ്റ്റ്‌വെയറിലേക്ക് ആദ്യമായി സംഭാവന ചെയ്യുന്നവർക്ക് അതിനെ പറ്റി പഠിക്കാനും പങ്കാളി ആകുവാനും വേണ്ടി കുറച്ച്‌ കൂടെ എളുപ്പമായ എന്തെങ്കിലും ഉണ്ടാക്കണമെന്നായിരുന്നു ഞങ്ങളുടെ ആഗ്രഹം. ലേഖനങ്ങൾ വായിക്കുന്നതും വീഡിയോ കാണുന്നതും ഒക്കെ സഹായകരമാണ്. പക്ഷേ ചെയ്ത് തന്നെ പഠിക്കുന്നതാണ് ഏറ്റവും നല്ലത്. ഈ പ്രൊജക്റ്റ് ഇതിനെ പറ്റി പരിചയം ഇല്ലാത്ത ഒരാൾക്ക് ആദ്യത്തെ സംഭാവന നല്കാൻ ഉള്ള ഒരു വഴികാട്ടി ആണ്. നിങ്ങളും നിങ്ങളുടെ ആദ്യ സംഭാവന നൽകാൻ ആഗ്രഹിക്കുന്നു എങ്കിൽ താഴെ പറയുന്നത് പോലെ ചെയ്യുക. #### *താങ്കൾക്ക് കമാൻഡ് ലൈൻ ഉപയോഗിച്ച്‌ പരിചയം ഇല്ലെങ്കിൽ, [GUI ഉപയോഗിച്ച് ചെയ്യാൻ ഉള്ള നിർദേശങ്ങൾ ഇവിടെ ലഭ്യമാണ്](#മറ്റു-ഉപകരണങ്ങൾ-ഉപയോഗിച്ച്-ചെയ്യുന്നതിനെ-പറ്റിയുള്ള-ലേഖനങ്ങൾ)*. ഈ ശേഖരം ഫോർക്ക് ചെയ്യുക താങ്കളുടെ കമ്പ്യൂട്ടറിൽ ഗിറ്റ് (git) ഇല്ലെങ്കിൽ, [ഇൻസ്റ്റാൾ ചെയ്യുക](https://help.github.com/articles/set-up-git/). ## ഈ റെപ്പോസിറ്ററി ഫോർക്ക് (fork) ചെയ്യുക ഈ പേജിന്റെ ഏറ്റവും മുകളിൽ ഉള്ള ഫോർക്ക് ബട്ടൺ ഉപയോഗിച്ച് ഈ റെപ്പോസിറ്ററി ഫോർക്ക് ചെയ്യുക. ഇങ്ങനെ ചെയ്യുമ്പോൾ നിങ്ങളുടെ അക്കൗണ്ടിൽ ഈ റെപ്പോസിറ്ററിയുടെ ഒരു പകർപ്പ് സൃഷ്ടിക്കപ്പെടുന്നു. ## ഈ റെപ്പോസിറ്ററി ക്ലോൺ (clone) ചെയ്യുക ഈ ശേഖരം ക്ലോൺ ചെയ്യുക ഇനി ഫോർക്ക് ചെയ്ത റെപ്പോസിറ്ററി നിങ്ങളുടെ കമ്പ്യൂട്ടറിലേക്ക് ക്ലോൺ ചെയ്യുക. നിങ്ങളുടെ ഗിറ്റ്ഹബ് (GitHub) അക്കൗണ്ട് എടുത്ത് അതിൽ ഫോർക്ക് ചെയ്ത റെപ്പോസിറ്ററി തുറക്കുക. എന്നിട്ട് മുകളിൽ ക്ലോൺ ബട്ടണിലെ *കോപ്പി ടു ക്ലിപ്പ് ബോർഡ് (Copy to clipboard)* എന്ന ഐക്കൺ ക്ലിക്ക് ചെയ്യുക. എന്നിട്ട് ഒരു ടെർമിനൽ എടുത്ത് താഴെ പറയുന്ന ഗിറ്റ് കമാൻഡ് റൺ ചെയ്യുക: ```bash git clone <നിങ്ങളുടെ-ലിങ്ക്> ``` ഇതിൽ `<നിങ്ങളുടെ-ലിങ്ക്>` എന്ന് പറയുന്നത് താങ്കളുടെ (ഫോർക്ക് ചെയ്ത) റെപ്പോസിറ്ററി ലിങ്ക് ആണ്. ലിങ്ക് എങ്ങനെ കോപ്പി ചെയ്യാം എന്നറിയാൻ ഇതിനു മുൻപ് ഉള്ള നിർദേശം നോക്കുക. ക്ലിപ്പ്ബോർഡിലേക്ക് URL പകർത്തുക ഉദാഹരണം: ```bash git clone https://github.com/<താങ്കൾ>/first-contributions.git ``` ഇതിൽ `<താങ്കൾ>` എന്നതിന് പകരം നിങ്ങളുടെ ഗിറ്റ്ഹബ് യൂസർനെയിം കൊടുക്കുക. ഇപ്പോൾ നിങ്ങൾ ചെയ്യുന്നത് നിങ്ങളുടെ ഗിറ്റ്ഹബിലെ ഫസ്റ്റ്-കോണ്ട്രിബൂഷൻസ് (first-contributions) റെപ്പോസിറ്ററിയിൽ ഉള്ളവ നിങ്ങളുടെ കമ്പ്യൂട്ടറിലേക്ക് കോപ്പി ചെയ്യുകയാണ്. ## ഒരു ശാഖ (ബ്രാഞ്ച്, Branch) ഉണ്ടാക്കുക നിങ്ങളുടെ റെപ്പോസിറ്ററിയിലേക്ക് കടക്കുക: ```bash cd first-contributions ``` എന്നിട്ട് `git checkout` എന്ന കമാൻഡ് ഉപയോഗിച്ച് ഒരു ബ്രാഞ്ച് ഉണ്ടാക്കുക: ```bash git switch -c <നിങ്ങളുടെ-പുതിയ-ബ്രാഞ്ചിന്റെ-പേര്> ``` ഉദാഹരണം: ```bash git switch -c add-alonzo-church ``` (ബ്രാഞ്ചിന്റെ പേരിൽ add എന്ന് ഉണ്ടാകണം എന്ന് നിർബന്ധം ഇല്ല. പക്ഷെ നിങ്ങളുടെ ഉദ്ദേശം നിങ്ങളുടെ പേര് ഇതിൽ ഉൾപ്പെടുത്തണം എന്നത് ആണെന്നതിനാൽ അത് കൊടുക്കുന്നതാണ് നല്ലത്.) ## ആവശ്യത്തിനുള്ള വ്യത്യാസങ്ങൾ വരുത്തി അവ കമ്മിറ്റ് (commit) ചെയ്യുക ഇനി `Contributors.md` എന്ന ഫയൽ ഒരു എഡിറ്റർ ഉപയോഗിച്ച് തുറന്നതിനു ശേഷം താങ്കളുടെ പേര് അതിൽ ഉൾപ്പെടുത്തുക. അങ്ങനെ ചെയ്യുമ്പോൾ തുടക്കത്തിലോ അവസാനത്തിലോ അല്ലാതെ ഇടയിൽ എവിടെയെങ്കിലും ഉൾപെടുത്തുക. എന്നിട്ട് ആ ഫയൽ സേവ് ചെയ്യുക. git സ്റ്റാറ്റസ് താങ്കളുടെ പ്രൊജക്റ്റ് ഡയറക്ടറിയിൽ ചെന്ന് `git status` എന്ന കമാൻഡ് അടിച്ചു നോക്കിയാൽ താങ്കൾ വരുത്തിയ വ്യത്യാസങ്ങൾ കാണാൻ സാധിക്കും. ഈ വ്യത്യാസങ്ങൾ `git add` കമാൻഡ് ഉപയോഗിച്ച്‌ നിങ്ങളുടെ ബ്രാഞ്ചിലേക്ക് ചേർക്കുക: ```bash git add Contributors.md ``` ഇനി നിങ്ങൾ ഉണ്ടാക്കിയ വ്യത്യാസങ്ങൾ `git commit` കമാൻഡ് ഉപയോഗിച്ച് കമ്മിറ്റ് ചെയ്യുക: ```bash git commit -m "Add <താങ്കളുടെ-പേര്> to Contributors list" ``` ഇതിൽ `<താങ്കളുടെ-പേര്>` എന്ന സ്ഥാനത്ത് താങ്കളുടെ ശരിയായ പേര് കൊടുക്കുക. ## വ്യത്യാസങ്ങൾ ഗിറ്റ്ഹബിലേക്ക് ചേർക്കുക (push) `git push` കമാൻഡ് ഉപയോഗിച്ച് വ്യത്യാസങ്ങൾ ഗിറ്റ്ഹബിലേക്ക് പുഷ് ചെയ്യുക: ```bash git push origin <താങ്കളുടെ-ബ്രാഞ്ചിന്റെ-പേര്> ``` ഇതിൽ <താങ്കളുടെ-ബ്രാഞ്ചിന്റെ-പേര്> എന്നതിന് പകരം താങ്കൾ നേരത്തെ ഉണ്ടാക്കിയ ബ്രാഞ്ചിന്റെ പേര് കൊടുക്കുക. ## നിങ്ങളുടെ വ്യത്യാസങ്ങൾ പരിശോധനക്കായി (review) സമർപ്പിക്കുക നിങ്ങൾ ഇപ്പോൾ നിങ്ങളുടെ ഗിറ്റ്ഹബ് റെപ്പോസിറ്ററിയിൽ പോയി നോക്കിയാൽ അവിടെ `Compare & pull request` എന്ന ഒരു ബട്ടൺ കാണാം. അതിൽ അമർത്തുക. ഒരു പുൾ അഭ്യർത്ഥന സൃഷ്ടിക്കുക ഇനി പുൾ റിക്വസ്റ്റ് (pull request) കൊടുക്കുക. പുൾ അഭ്യർത്ഥന സമർപ്പിക്കുക വൈകാതെ തന്നെ ഞാൻ താങ്കളുടെ വ്യത്യാസങ്ങൾ പ്രധാന ബ്രാഞ്ചിലേക്ക് ചേർക്കുന്നതായിരിക്കും. അപ്പോൾ താങ്കൾക്ക് ഒരു ഇമെയിൽ അറിയിപ്പ് ലഭിക്കും. ## ഇവിടെ നിന്ന് ഇനി എങ്ങോട്ട്? അഭിനന്ദനങ്ങൾ! താങ്കൾ താങ്കളുടെ ആദ്യത്തെ _fork -> clone -> edit -> PR_ പടികൾ വിജയകരമായി പൂർത്തിയാക്കിയിരുന്നു. ഒരു സംഭാവകൻ/സംഭാവിക എന്ന നിലക്ക് ഇത് താങ്കൾക്ക് ഇടയ്ക്കിടെ ചെയ്യേണ്ടി വരുന്ന ഒരു കാര്യം ആണ്! താങ്കളുടെ സംഭാവന സുഹൃത്തുക്കളും പിൻഗാമികളുമായി (followers) പങ്കിട്ട് ആഘോഷിക്കുവാനായി ഈ [വെബ് ആപ്പ് ഉപയോഗിക്കുക](https://firstcontributions.github.io/#social-share). കൂടുതൽ പരിശീലനം ആവശ്യമുണ്ടെങ്കിൽ, [കോഡ് സംഭാവനകൾ](https://github.com/roshanjossey/code-contributions) പരിശോധിക്കുക. ഇനി താങ്കൾക്ക് മറ്റുള്ള പ്രൊജെക്ടുകളിൽ സംഭാവന ചെയ്യുവാൻ സാധിക്കും. താങ്കൾക്ക് വേഗം തുടങ്ങുവാൻ വേണ്ടി ഞങ്ങൾ എളുപ്പത്തിൽ തീർക്കാവുന്ന പ്രശ്നങ്ങൾ (issues) ഉള്ള പ്രോജക്ടുകളുടെ ഒരു ലിസ്റ്റ് ഉണ്ടാക്കിയിട്ടുണ്ട്. അത് ഈ [പ്രോജക്ടുകളുടെ ലിസ്റ്റിൽ](https://firstcontributions.github.io/#project-list) ഉൾപ്പെടുത്തിയിട്ടുണ്ട്. ### [കൂടുതൽ വായിക്കുക](../additional-material/git_workflow_scenarios/additional-material.md) ## മറ്റു ഉപകരണങ്ങൾ ഉപയോഗിച്ച് ചെയ്യുന്നതിനെ പറ്റിയുള്ള ലേഖനങ്ങൾ | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.mli.md ================================================ [![Porozɛ fuw kanu](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Bolomafara(contributions) fɔlɔw A ka gɛlɛn tuma bɛɛ ni i ye fɛn dɔ kɛ siɲɛ fɔlɔ min na. Siranya min bɛ mɔgɔ la ka filiw kɛ, o tɛ mɔgɔ lafiya fewu, kɛrɛnkɛrɛnnenya la n’aw bɛ jɛ ka baara kɛ ɲɔgɔn fɛ. Nka porogaramu hɔrɔnma diɲɛ ye jɛkafɔ ni baara kɛli ye kuluw kɔnɔ. Ani fana, an b’a fɛ ka dɛmɛ donbaga kuraw bolo minnu bɛ porogaramu fuw la, olu ka se ka kalan nɔgɔya, an kɛtɔ k’aw kalan bolomafara kɛcogo la siɲɛ fɔlɔ. Barokunw ni kalansenw kalanni bɛ se ka dɛmɛ don, nka mun ka fisa ni k’a ɲini k’a sɔrɔ i ma se ka filiw kɛ? Nin porozɛ in kun ye ka bilasirali kɛ ani ka kalandenw ka dɛmɛ fɔlɔ kɛcogo nɔgɔya. Aw ye aw hakili to a la: ni aw hakili sigilen don, aw bɛ kalan kɛ ka ɲɛ. N’i ​​b’a fɛ k’i ka bolomafara fɔlɔ kɛ, i ka nin fɛɛrɛ ninnu labato dɔrɔn. N bɛ layidu ta ko a bɛna kɛ ɲɛnajɛ ye. embrancher ce repertoire Ni git t i ka ɔridinatɛri kan, [ a sigi sen kan]( https://help.github.com/articles/set-up-git/ ). ## Aw ye nin ɲɛbilasɛbɛn in bolofara (a bɛ fɔ fana ko Fork) . Forok kɛ nin ɲɛbilasɛbɛn in na ni fork butɔni digilen ye ɲɛ sanfɛ. O bɛna kɛ sababu ye ka kunnafonisɛbɛn kopi dɔ dilan i ka jatebɔsɛbɛn kan. ## aw ka kan ka nin ɲɛbilasɛbɛn in Clone clonez ce répertoire Sisan, i ka nin ɲɛbilasɛbɛn in clone i ka ɔridinatɛri kɔnɔ. Clone button digi o kɔfɛ *copier dans le presse-papier* taamasiyɛn digi. Cikan yɔrɔ dɔ da wuli (n’i bɛ Windows kan) walima terminal (n’i bɛ MacOS walima Linux kan) ka nin git cikan ninnu kɛ: ``` git clone "URL min kopi kɛra sisan" ``` wali "URL min kopi kɛra sisan" (ni gillemants tɛ) ye url ye min bɛ kɛ ni ɲɛbilasɛbɛn ye. Aw ye tilayɔrɔ tɛmɛnen lajɛ walasa ka URL sɔrɔ. copier l'URL dans le presse-papier misale : ``` git clone https://github.com/i-ka-github-tɔgɔ/first-contributions.git ``` yɔrɔ min na `i-ka-github-tɔgɔ` ye i ka GitHub baarakɛla tɔgɔ ye. Yan i bɛ `first-contributions` ɲɛbilasɛbɛn kɔnɔkow kopi ka bɔ GitHub la ka taa i ka ɔridinatɛri kɔnɔ. ## Bolo(contributions) dɔ dabɔ Aw bɛ taa poroze ɲɛbilasɛbɛn kura clone (n’aw tɛ yen fɔlɔ): ``` cd first-contributions ``` Sisan, bolofara(branch) dɔ dabɔ ni cikan ye `git checkout` : ``` git checkout -b ``` misale : ``` git checkout -b add-koffi-sani ``` (Bolofara tɔgɔ man kan ka kɛ ni *add* daɲɛ ye, nka a bɛnnen don k’a don a kɔnɔ bawo nin bolofara in kun ye k’i tɔgɔ fara lisi kan.) ## Yɛlɛma wajibiyalenw kɛ ani k’u bila Sisan, `Contributors.md` file da wuli sɛbɛnnikɛlan dɔ kɔnɔ, k'i tɔgɔ fara a kan, k'a mara. N'i ye cikan-sɛbɛn da wuli ka `git status` cikan baara, i b'a ye ko fɛn dɔw b'a la. Aw ye nin bεnkanw Fàra bolofara kan aw ye min Dabɔ sisan ni `git add` cikan ye: ``` git add Contributors.md ``` Sisan, aw bɛ o fɛn caman Changements (Yɛlɛma) kɛ ni cikan(commade) ye `git commit`: ``` git commit -m "Add to Contributors list" ``` ni `` bilali ye i tɔgɔ nɔ na ## Yɛlɛma caman bɛ GitHub (GitHub) la Aw bɛ aw ka fɛn caman Changements (Yɛlɛma) Gɛn ni cikan ye `git push` : ``` git push origin ``` ni `` bilali ye bolofara min dabɔra ka kɔrɔ, o tɔgɔ bila a nɔ na. ##Aw ye aw ka fɛn caman ci walasa ka segin u kan N’i ​​taara i ka marayɔrɔ la Github kan, i bɛna `Compare & pull request` butɔni ye. Butɔn digi. create a pull request Sisan, aw ka sama ɲinini sɛbɛn di submit pull request Sɔɔni n bɛna aw ka fɛn caman Changements bɛɛ fara ɲɔgɔn kan ka kɛ nin porozɛ in bolofara belebele ye. I bɛna kunnafoni imɛri sɔrɔ ni farali banna dɔrɔn. I ka tɔnbolofara belebeleba tɛna yɛlɛma nin waati in na. Walasa k’aw ka bolofara ni ne ta ka bɛn, aw bɛ nin fɛɛrɛ ninnu tigɛ. ## Aw k’aw ka tɔnbolofara to ɲɔgɔn fɛ ni nin ɲɛbilasɛbɛn in ye Fɔlɔ, i ka wuli ka taa bolofara belebeleba(main) la ``` git checkout main ``` Ani ka n ka ɲɛbilasɛbɛn url fara a kan i n’a fɔ `upstream remote url`: ``` git yɔrɔjan fara sanfɛ https://github.com/i-ka-github-tɔgɔ/first-contributions ``` Nin ye fɛɛrɛ ye k’a fɔ git ye ​​ko nin ɲɛbilasɛbɛn in bɔko wɛrɛ bɛ yen ladɛrɛsi kofɔlen na wa an b’a wele ko `upstream`. Ni fɛn caman Changements (Yɛlɛma) farala ɲɔgɔn kan, i ka version kura ɲini n ka ɲɛbilasɛbɛn kɔnɔ: ``` git fetch upstream ``` Yan an bɛ fɛn caman sɛmɛntiya n ka bolofara kɔnɔ (upstream remote). Sisan i ka kan ka n ka ɲɛbilasɛbɛn lajɛlen kura fara ɲɔgɔn kan i ka bolofara belebele kɔnɔ: ``` git rebase upstream/main ``` Yan, i ye fɛn minnu ɲini, an bɛ olu bɛɛ waleya bolofara belebeleba la. N’i ​​ye bolofara belebele gɛlɛya sisan, i ka bolofara fana bɛna fɛn caman Changements: ``` git push origin main ``` Kɔlɔsili: Nin sen in na, i bɛ ka gɛlɛya ka taa yɔrɔjan ɲɛbilasɛbɛn na min bɛ wele ko origin. Nin hakɛ in na n y'i ka bolofara `` fara n ka bolofara belebele kan, wa i ye n bolofara belebele fara ɲɔgɔn kan n'i ka bolofara belebele ye. I ka bolofara `` nafa tɛ yen tugun, o la i bɛ se k'a bɔ yen: ``` git branch -d ``` ani i bɛ se k’a bɔko bɔ yɔrɔjan ɲɛbilasɛbɛn kɔnɔ fana: ``` git push origin --delete ``` O tɛ wajibi ye, nka bolofara tɔgɔ b’a jira ko a sinsinnen bɛ fɛn kɛrɛnkɛrɛnnen kan kosɛbɛ. A si bɛ se ka kɛ waati surun ye. ## Kalan minnu bɛ kɛ ni baarakɛminɛn wɛrɛw ye | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ## An bɛ taa min kɔfɛ? Aw bɛ se fana ka fara an ka jɛkulu kan Slack kan ni aw mago bɛ dɛmɛ na walima ni ɲininkali dɔw bɛ aw fɛ. [Rejoindre l'équipe sur Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) ================================================ FILE: docs/translations/README.mm_unicode.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # ပထမအကြိမ် ကူညီထောက်ပံ့ခြင်း ဘယ်အရာမဆို ပထမဦးဆုံးလုပ်ဆောင်အခါ အခက်အခဲတွေ့ကြုံရပါတယ်။ အထူးသဖြင့် လူအများနဲ့ ပေါင်းသင်းလုပ်ကိုင်ကြတဲ့ အခါ မထင်မှတ်ထားတဲ့ အမှားများတွေ့ရတတ်ပြီး အဆင်မပြေတာတွေဖြစ်တတ်ပါတယ်။ Open source software များကတော့ လူအများနဲ့ ပေါင်းသင်းဆက်ဆံလုပ်ကိုင် ကြရတာပါ။ ဒါကြောင့်မို့ ပထမဦးဆုံးအကြိမ် open-source project များကို ပါဝင် ကူညီထောက်ပံ့သူများကို ပထမဆုံးအကြိမ် ကူညီထောက်ပံ့နိုင်ဖို့နဲ့ လွယ်ကူ ရိုးရှင်းတဲ့ လေ့လာနည်းဖြစ်ဖို့ ရည်ရွယ်ပါတယ်။ လေ့ကျင်ခန်း စာစောင်တွေနဲ့ ဗီဒီယိုတွေက အကူအညီရနိုင်သော်လဲ တကယ်လက်တွေ့လုပ်ဆောင်တာထက် ပိုကောင်းတာမရှိပါဘူး။ ဒီ project က ပထမဆုံးအကြိမ် ကူညီထောက်ပံ့ပေးမဲ့ သူတွေအတွက် လွယ်ကူ ရှိးရှင်းပြီး အကူအညီအထောက်ပံ့ဖြစ်စေဖို့ ရည်ရွယ်ပါတယ်။ **မှတ်ထားပါ** : သင်ကသက်တောင်သက်သာရှိလေလေ သင်ကပိုကောင်းကောင်းသင်ယူနိုင်လေ ဖြစ်ပါတယ်။ သင်သာ အောက်မှာရှိတဲ့ အဆင့်တိုင်းလုပ်သွားလျှင် သင့်ရဲ့ ပထမဆုံး ကူညီထောက်ပံခြင်းမှာ အဆင်ပြေစွာ ပြီးမြောက်သွားမှာဆိုတာ အာမခံပါတယ်။ _command line (သို့) terminal အသုံးပြုရတာ အဆင်မပြေပါက [GUI tools အသုံးပြုပုံများကို ဒီမှာကြည့်ရန်](#အခြား-Tools-များ-အသုံးပြုသည့်-tutorial)_ ဒီ repository ကို fork လုပ်ပါ #### သင့်ကွန်ပျူတာထဲမှာ Git မသွင်းရသေးလျှင် [ဒီမှာ သွင်းနည်းကြည့်ရန်](https://help.github.com/articles/set-up-git/). ## ဒီ repository ကို fork လုပ်ပါ Fork လုပ်ဖို့အတွက် စာမျက်နှာအပေါ်နားမှရှိတဲ့ fork ခလုတ် ကိုနှိပ်ပါ။ ဒီ repository က သင့် အကောင့်ကို ပုံစံတူပွားအနေနဲ့ ရောက်လာပါမယ်။ ## ဒီ repository ကို clone လုပ်ပါ ဒီ repository ကို clone လုပ်ပါ ခုနက fork လုပ်ထားတဲ့ repository ကို သင့်ကွန်ပျူတာထဲ clone လုပ်ပါမယ်။ သင့် Github အကောင့်ကိုသွားပြီး fork လုပ်ထားတဲ့ repository ကို ဖွင့်ပါ။ Code ဆိုတဲ့ ခလုတ်လေးကို နှိပ်ပြီး _copy to clipboard_ icon လေးကို နှိပ်ပါ။ command line (သို့) terminal ကိုဖွင့်ပြီး အောက်က Git command ကို run ပါ။ ``` git clone "ခုနက copy ထားတဲ့ လင့်ခ်" ``` "ခုနက copy ထားတဲ့ လင့်ခ်" (quotation marks မထည့်ရပါ) ဆိုတာဟာ ဒီ repository (ဒီပရောဂျက်ရဲ့ သင့် fork) ရဲ့ လင့်ခ်ပဲ ဖြစ်ပါတယ်။ ဒီနေရာမှာ အဆင်မပြေဖြစ်ခဲ့ရင် အပေါ်က အဆင့်များကို ပြန်လုပ်ပါ။ URL ကို clipboard ထဲကို ကူးပါ ဥပမာ: ``` git clone https://github.com/this-is-you/first-contributions.git ``` `this-is-you` ဆိုတာ သင့်ရဲ့ Github username ပဲ ဖြစ်ပါတယ်။ ဒီအဆင့်တွေက Github မှာရှိတဲ့ first-contributions repository ကို သင့်ကွန်ပျူတာထဲသို့ ကူးထည့်တာပဲ ဖြစ်ပါတယ်။ ## Branch အသစ်လုပ်ခြင်း သင် copy လုပ်ထားတဲ့ repository directory ကို မရောက်သေးရင် အောက်က command ကို run ပြီး ရောက်အောင်သွားပါ။ ``` cd first-contributions ``` Branch အသစ်ကို `git checkout` command ကို run ပြီးလုပ်ပါ။ ``` git checkout -b your-new-branch-name ``` ဥပမာ: ``` git checkout -b add-alonzo-church ``` (Branch နာမည်ဘာဖြစ်ဖြစ်ရပါတယ် သို့သော်လဲ ဒီ project ကသင့် နာမည်ကိုထပ်ထည့်မှာဖြစ်လို့ _add_ သင့်နာမည်ကို အားလုံးနဲ့ အဆင်ပြေအောင်ထည့်ပေးပါ။) ## ပြောင်းစရာရှိတာများ ပြောင်းပြီး ထိုပြောင်းလဲမှုများကို commit လုပ်ခြင်း သင့် text editor မှာ `Contributors.md` ကိုဖွင့်ပါ။ ထိပ်ဆုံးနှင့်နောက်ဆုံးမှလွဲ၍ သင့်ရဲ့ နာမည်ကို အဆင်ပြေတဲ့ နေရာမှာထည့်ပြီး save ပါ။ git status command နဲ့ ထွက်တဲ့အခြေအနေကို ပြတဲ့ပုံ ပြီးရင် ဒီ folder ရှိတဲ့နေရာကိုသွားပြီး `git status` command ကို run ပါ။ သင်ဘာတွေပြောင်းထားလဲဆိုတာ မြင်ရပါလိမ့်မယ်။ ဒီပြောင်းလဲမှုတွေကို သင့်ရဲ့ branch ကိုထည့်ဖို့အတွက် `git add` command ကို run ပါ။ ``` git add Contributors.md ``` အခု commit လုပ်ဖို့ `git commit` command ကို run ပေးပါ။ ``` git commit -m "Add to Contributors list" ``` `` နေရာမှာ သင့်နာမည်ကို အစားထိုးပါ။ ## သင့်ရဲ့ ပြောင်းလဲ ပြုပြင်မှုကိုများကို Github သို့တင်ပါ။ ပြောင်းလဲမှုများကို Github သို့တင်ဖို့အတွက် `git push` ကို run ပါ။ ``` git push origin ``` `` နေရာမှာ သင်အသစ်လုပ်ထားတဲ့ branch နာမည်ကိုထည့်ပါ။ ## သင်ပြောင်းထားတာ တွေကို review လုပ်ဖို့ submit လုပ်ပါ။ သင့် GitHub က သင့် repository မှာ `Compare & pull request` ဆိုတဲ့ ခလုတ်မြင်နေရမှာပါ။ အဲ့ဒီ ခလုတ်ကို နှိပ်လိုက်ပါ။ pull request အသစ်တစ်ခု ဖန်တီးပါ အခု pull request ကို submit လုပ်လိုက်ပါ။ pull request ကို တင်သွင်းပါ သင့်ရဲ့ပြောင်းလဲမှုတွေကို ဒီ project ရဲ့ master branch မှာ ထည့်သွင်းပေးမှာဖြစ်ပါတယ်။ ဒါကြောင့် ဒီ project ရဲ့ master branch မှာ ထည့်သွင်းပြီးရင် သင့်မှာ notification email ရောက်လာပါလိမ့်မယ်။ ## ဒါပြီးရင် ဘာတွေဆက် လေ့လာမလဲ Congratulation! Open Source Project တွေမှာ အမြဲလုပ်ရလေ့ရှိတဲ့ _fork -> clone -> edit -> pull request_ လုပ်ငန်းစဥ်ကို သင် အောင်မြင်စွာ လုပ်နိုင်ခဲ့ပါပြီ။ အခု သင်ကူညီထောက်ပံ့ခဲ့တာကို သင့်သူငယ်ချင်းတွေကို share ချင်ရင် [ဒီ web app](https://firstcontributions.github.io/#social-share) ကို သွားပါ။ တခြားအကူအညီများနဲ့ မေးစရာများရှိပါက ကျွန်တော်တို့ရဲ့ Slack team ကို ဝင်ရောက် မေးမြန်းနိုင်ပါတယ်။[Join slack team သို့ ဝင်ရန်](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). နောက်ထပ် ပရောဂျက်များကိုလည်း ဝင်ရောက်ကူညီလိုပါက ကျွန်တော်တို့ ပြုစုထားတဲ့ ပရောဂျက်စာရင်းကို လေ့လာနိုင်ပါတယ်။ [web app ထဲမှ ပရောဂျက်စာရင်း](https://firstcontributions.github.io/#project-list). ### [အခြား ထွေလီကာလီများ](additional-material/git_workflow_scenarios/additional-material.md) ## အခြား Tools များ အသုံးပြုသည့် tutorial | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.mn.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions Нээлттэй эх код баазад өөрийн хувь нэмрээ оруулах хүсэл програмч болгонд байдаг байх. Харин яг хаанаас эхлэхээ мэдэхгүй үе тохиолдох нь элбэг. Иймд, бид хэд шиг будилсан хөгжүүлэгч нарт ядаж хийх үйлдлийн зохих дарааллыг нь таниулчих зорилгоор энэхүү төсөл нь эхэлжээ. Та ч бас нээлттэй эх код баазад өөрийн нэмрээ оруулмаар байгаа бол доорх алхмуудыг дагаад хийгээрэй. _Терминалтай ажиллах дургүй бол [GUI ашигласан хичээл рүү ороорой.](#tutorials-using-other-tools)_ fork this repository #### Компьютер дээрээ git суулгаагүй бол [энд дарж суулгана уу.](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Энэ рэпог форклох Та энэ хуудасны дээд хэсэгт орших fork товчийг дарснаар энэ рэпоны хуулбар таны хаягт үүсэх юм. ## Энэ рэпог хувилах clone this repository Форк хийчихсэн рэпогоо компьютер дээрээ суулгахын тулд хлээд Гитхаб хаяг дээрээ очоод, форклосон рэпогоо олоод, code гэсэн товчин даар дараад, SSH хэсэг дээр дарж, _хуулах_ товчлуур дээр дарах хэрэгтэй. Дараа нь, терминалаа нээгээд доорх үйлдлийг хийнэ: ```bash git clone "саяны хуулсан линк" ``` "саяны хуулсан линк" хэсгийн оронд эхний алхам дээр хуулсан линкээ наана. copy URL to clipboard Жишээ нь: ```bash git clone git@github.com:таны-гитхаб-хаяг/first-contributions.git ``` `таны-гитхаб-хаяг` гэсний оронд Гитхабын хэрэглэгчийн нэрээ бичнэ. Ингэснээр та өөрийн хаяг дээрээ үүсгэсэн энэхүү рэпоны хуулбарыг өөрийн компьютер дээрээ хувилан авч чадлаа. ## Шинэ бранч үүсгэх Дараа нь, хувилсан рэпоныхоо фолдер луу шилжинэ: ```bash cd first-contributions ``` `git switch` үйлдлийг ашиглан шинэ бранч үүсгэнэ: ```bash git switch -c шинэ-бранчийн-нэр ``` Жишээ нь: ```bash git switch -c add-alonzo-church ```
git switch үйлдлийг хийхэд ямар нэгэн алдаа гарсан бол энд дар: Дараах алдаа гарсан бол Гит програмын чинь хувилбар нийцэхгүй байна гэсэн үг: "Git: `switch` is not a git command. See `git –help`" Дээрх тохиолдолд `git checkout` үйлдлийг хэрэглээд үзээрэй: ```bash git checkout -b шинэ-бранчийн-нэр ```
## Код баазад өөрчлөлт хийгээд өөрчлөлтөө коммит хийх `Contributors.md` файлыг дурын текст эдитор дээр нээгээд өөрийн нэрээ нэмээрэй. Файлын эхэнд болон сүүлд нэмэхгүй л байхад болно. git status Дараа нь, үндсэн фолдер луу шилжээд `git status` үйдлийг хийвэл танд таны өөрчилсөн файлууд харагдана. Харагдаж буй өөрчлөлтүүдээ эхлээд бранчдаа `git add` үйлдлийг ашиглан нэмнэ: ```bash git add Contributors.md ``` Дараа нь `git commit` үйлдлийг ашиглан коммит хийнэ (`your-name` гэснийг нэмсэн нэрээрээ солихоо мартуузай): ```bash git commit -m "Add your-name to Contributors list" ``` ## Гитхаб руу пушлэх Дараа нь, `git push` үйлдлийг ашиглан саяны коммитоо пушлэнэ (`your-branch-name` гэснийг үүсгэсэн бранчийнхаа нэрээр солихоо мартуузай): ```bash git push -u origin your-branch-name ```
Пушлэх үйлдэл дээр ямар нэгэн алдаа заавал энд дарж харах: - ### Нэвтрэх эрхийн алдаа 
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//first-contributions.git/'
Хэрэв дээрх янзаар алдаа зааж байвал шинэ SSH түлхүүр үүсгэн хаягтайгаа холбох хэрэгтэй гэсэн үг бөгөөд хэрхэн холбохыг [энд дарж харна уу](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account). Мөн, аль рэпотой холбогдсон байгаагаа 'git remote -v' үйлдлээр шалгачихад гэмгүй. Хэрэв дээрх үйлдлийн хариу доорх маягаар байвал: 
origin	https://github.com/таны-хэрэглэгчийн-нэр/таны-рэпо-нэр.git (fetch)
  origin	https://github.com/таны-хэрэглэгчийн-нэр/таны-рэпо-нэр.git (push)
дараах үйлдлээр өөрчлөх хэрэгтэй: ```bash git remote set-url origin git@github.com:таны-хэрэглэгчийн-нэр/таны-рэпо-нэр.git ``` Ингэснээр та нууц үгээр биш хаягтай чинь холбогдсон SSH түлхүүрээр нэвтэрч эхэлнэ.
## Нэгтгэх хүсэлт илгээх Гитхаб дээрх рэпо руу очмогц `Compare & pull request` товчлуур харагдах болно. Уг товчлуур дээр дарснаар шинэ нэгтгэх хүсэлт (pull request) үүсгэх хуудас гарч ирнэ. create a pull request Дараа нь нэгтгэх хүсэлтээ илгээнэ. submit pull request Таны хүсэлтийг бид хүлээн аваад автоматаар код бааздаа нэгтгэсэн байх болно. Энэ талаар бүртгэлтэй и-мейл хаяг дээр чинь мэдэгдэл ирнэ. ## Одоо яг яах билээ? Нээлттэй эх код баазад өөрийн нэмрээ оруулахын тулд ерөнхийд нь мөрдөх ёстой _fork -> clone -> edit -> pull request_ гэсэн дарааллыг та одоо мэддэг боллоо. Нээлттэй эхэд нэмэр оруулж эхлэх анхны алхамаа хийсэн талаараа [энд дарж](https://firstcontributions.github.io/#social-share) нөхөдтэйгөө хуваалцана уу. Өшөө дасгал ажиллахын тулд [энд дар](https://github.com/roshanjossey/code-contributions). Нээлттэй эх код баазтай янз бүрийн төслүүдийн жагсаалтыг [энд дарж харна уу](https://firstcontributions.github.io/#project-list). ### [Нэмэлт материал](docs/additional-material/git_workflow_scenarios/additional-material.md) ## Өөр програмууд ашигласан хичээлүүд | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](docs/gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](docs/gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](docs/gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](docs/gui-tool-tutorials/github-windows-intellij-tutorial.md) |

Энэ төслийг дэмжсэн:

================================================ FILE: docs/translations/README.mr.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # प्रथम योगदान सुरुवातीला कुठलीही गोष्ट करणे कठीण असते. विशेषत: आपण एकत्र काम करत असताना चुका होणे स्वाभाविकच आहे. परंतु एकमेकांसोबत भेटणे आणि एकत्र कार्य करणे हेच तर मुक्त स्त्रोत (Open Source) चे गमक आहे. आम्ही आपले प्रथम मुक्त स्त्रोत योगदान (Contribution) सुलभ करण्यास मदत करू. लेख वाचणे आणि ट्यूटोरियल पाहण्याने आपणास मदत होऊ शकते परंतु प्रत्यक्षात सराव करण्यापेक्षा काय चांगले आहे? या प्रकल्पाचा हेतू नवशिक्यांना आपले प्रथम योगदान देण्यासंदर्भात सोप्या स्वरुपात मार्गदर्शन प्रदान करण्याचा आहे. आपण आपले प्रथम योगदान देत असल्यास, खालील पायऱ्यांचे अनुसरण करा. #### *जर आपल्याला कमांड लाईन (CLI) सोयीस्कर वाटत नसेल तर [GUI टूल्स वापरण्यासंदर्भात ट्यूटोरियल येथे आहेत.](#इतर-साधने-वापरण्याबाबतीत-ट्युटोरियल)* [](translations/README.en-pirate.md) ही रेपॉझिटरी फोर्क करा आपण आपल्या मशीनवर Git नसेल तर, [येथुन इन्स्टॉल करा](https://help.github.com/articles/set-up-git/). ## रिपॉझिटरी (Repository) ला फोर्क (Fork) करणे फोर्क (fork) बटण क्लिक करून या रिपोला (repository) फोर्क करा. हे आपल्या खात्यात या रिपॉझिटरीची प्रत (कॉपी) तयार करेल. ## रिपॉझिटरी (Repository) ला क्लोन (Clone) करणे ही रेपॉझिटरी क्लोन करा आता फोर्क केलेला रिपो आपल्या संगणकावर क्लोन (Clone) करा. यासाठी आपण आपल्या गिटहब (GitHub) खात्यावर जा. जो रिपो आपण फोर्क केलेला आहे, त्याला उघडा. उघडलेल्या रिपोत उजव्या बाजुला वर `Clone or download` बटण दिसेल, त्यावर क्लिक करा. नंतर तेथील `Copy to clipboard` या आयकॉनवर क्लिक करा. याद्वारे प्रस्तुत रिपोची लिंक (URL) कॉपी झालेली असेल. आता आपले टर्मिनल (Terminal) उघडा व त्यात खालील git आदेश (Command) चालवा. ```Bash git clone <कॉपी-केलेली-लिंक> ``` URL क्लिपबोर्डवर कॉपी करा येथे `<कॉपी-केलेली-लिंक>` (त्रिकोणी कंस वगळता) यास आपण आताच कॉपी केलेली URL लिंक असे ग्राह्य धरण्यात यावे. ही URL लिंक मिळवण्याकरता याआधीच्या पायरीचे अवलोकन करावे. उदाहरणार्थ: ```Bash git clone https://github.com/तुमचे-युझर-नाव/first-contributions.git ``` येथे `तुमचे-युझर-नाव` याचा अर्थ आहे, आपल्या गिटहब खात्याचे नाव (Username). आता एंटर (Enter/Return) बटण दाबा. याद्वारे प्रस्तुत रिपो `first-contributions` आपल्या संगणकावर कॉपी होईल. ## ब्रांच (Branch) बनवणे. आपल्या टर्मिनल वरुन आपली रिपो फोल्डर/डायरेक्टरी (Folder/Directory) बदला (जर आपण अद्याप बदलले नसेल तर). ```Bash cd first-contributions ``` आता `git checkout` ही कमांड वापरुन नवीन ब्रांच तयार करा. ```Bash git checkout -b <आपल्या-ब्रांचचे-नाव-येथे-टाका> ``` उदा: ```Bash git checkout -b add-rahul-thakare ``` (प्रत्येक ब्रांचच्या नावात `add` हा शब्द असणे आवश्यक नाही, परंतु वरील उदाहरणात त्याचा समावेश असणे ही एक वाजवी गोष्ट आहे कारण ईथे आपले नाव सूचीमध्ये जोडणे हा या शाखेचा उद्देश आहे.) ## आवश्यक बदल करणे आणि ते बदल कमिट (Commit) करणे. आता मजकूर संपादक मध्ये `Contributors.md` फाइल उघडा, व त्यात आपले नाव जोडा. फाइलच्या सुरवातीस किंवा समाप्तीमध्ये जोडू नका. त्यामध्ये कुठेही ठेवा. आता फाईल सेव्ह (Save) करा. गिट स्थिती आता तुम्ही पुन्हा टर्मिनल कडे जाल आणि `git status` ही कमांड चालवाल तर तुम्हाला त्यात काही बदल झालेले दिसतील. `git add` कमांड वापरुन आपण तयार केलेल्या शाखेत ते बदल जोडा ```Bash git add Contributors.md ``` आता `git commit` ही कमांड वापरुन आपले बदल कमिट/सुरक्षित करा. ```Bash git commit -m "Add <तुमचे-नाव> to Contributors list" ``` `<तुमचे-नाव>` च्याऐवजी आपले नाव टाका. ## गिटहब मध्ये आपले बदल पुश करणे. `git push` वापरून आपले बदल पुश करा ```Bash git push origin <आपल्या-शाखेचे-नाव> ``` `<आपल्या-शाखेचे-नाव>` च्या जागी आपल्या ब्रांचचे नाव टाका. ## पुनरावलोकनासाठी आपले बदल सबमिट करणे. आपण आपल्या गिटहब प्रोफाइलवर आपल्या रिपो वर गेल्यास, आपल्याला `Compare & pull request` पाठविण्याचा पर्याय दिसेल, ते दाबा. पुल रिक्वेस्ट तयार करा आता आपल्या `Pull request` सबमिट करा. पुल रिक्वेस्ट सबमिट करा लवकरच मी आपले बदल या प्रकल्पाच्या मुख्य शाखेत विलीन करेन. जेव्हा आपले बदल विलीन होतील तेव्हा आपल्याला ई-मेल मिळेल. ## आता पुढे काय? अभिनंदन! आपण नुकतीच _fork -> clone -> edit -> PR_ ही कार्यपद्धती पूर्ण केली आहे ज्यास आपणास एक योगदानकर्ता (Contributor) म्हणून सदैवच तोंड द्यावे लागते! आपले योगदान साजरे करा आणि [येथे](https://firstcontributions.github.io/#social-share) जाऊन आपल्या मित्र आणि अनुयायांसह शेअर/सामायिक करा. आपल्याला कोणत्याही मदतीची आवश्यकता असल्यास किंवा काही प्रश्न असल्यास आपण आमच्या स्लॅक टीममध्ये सामील होऊ शकता. [स्लॅक टीममध्ये सामील व्हा](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). आता आपण इतर प्रकल्पांमध्येही आपले योगदान देऊ शकता. आपण प्रारंभ करू शकाल अशा सुलभ समस्यांसह (Issues) आम्ही काही प्रोजेक्टची सूची संकलित केली आहे. [येथे वेब अॅप मधील प्रकल्पांची यादी पहा.](https://firstcontributions.github.io/#project-list) ## इतर साधने वापरण्याबाबतीत ट्युटोरियल | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.mx.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeras contribuciones Siempre resulta difícil la primera vez que haces algo. Principalmente cuando colaboras con otros, ya que cometer errores no es agradable. Es por ello que, queremos hacer más sencilla la forma en la que los nuevos contribuyentes de _open source_ aprenden y contribuyen por primera vez. Leer artículos y ver tutoriales puede ayudar, pero ¿qué mejor que hacer las cosas en un ambiente de prácticas? Este proyecto se enfoca en guiar y en simplificar la forma en la que los principiantes hacen su primera contribución. Si buscas hacer tu primera contribución, sigue los pasos que se muestran a continuación. #### *Si no estás cómodo con la línea de comandos, [aquí hay unos tutoriales usando herramientas gráficas.](#Tutoriales-con-otras-herramientas)* Imagen de la interfaz de Github con el botón de Fork del repositorio encerrado en un rectángulo rojo Si no tienes Git en tu equipo, aquí las instrucciones para instalarlo en el [enlace]( https://help.github.com/articles/set-up-git/ ) ## Dale Fork al repositorio Dale "fork" a este repositorio dando clic en el botón "*Fork*" en la parte superior derecha de la página. Esto creará una copia de este repositorio en tu cuenta. ## Clona "Clone" el repositorio Imagen de la interfaz del repositorio con el botón verde de Code encerrado en un rectángulo rojo Ahora clona este repositorio en tu equipo. Ve a tu cuenta de Github, y da clic en el botón "*clone or download*" y luego da clic en el ícono para *copiar*. Abre tu consola o terminal y ejecuta el siguiente comando: ``` git clone "la url del repositorio que copiaste" ``` Donde "la url del repositorio que copiaste" (sin las comillas dobles) es la *url* a este repositorio (tu *fork* a este proyecto). Mira los pasos previos para obtener la *url*. Seeción de Github para copiar repositorio, con la pestaña de SSH mostrándose y al lado un icono para copiar el URL al portapapeles Por ejemplo: ``` git clone https://github.com/usuarioGitHub/first-contributions.git ``` Donde `usuarioGitHub` es tu usuario de GitHub. Aquí estás copiando los contenidos del repositorio *first-contributions* en GitHub a tu equipo. ## Crea una rama (*Branch*) Cambia al directorio del repositorio en tu equipo (si es que no estás ahí ya). ``` cd first-contributions ``` Ahora crea una rama (*branch*) usando el comando `git switch`: ``` git switch -c ``` Por ejemplo: ``` git switch -c add-juan-perez ``` (El nombre de la rama no tiene porqué contener la palabra *add*, pero es razonable que lo tenga porque el objetivo de esta rama es añadir tu nombre a la lista.) ## Haz los cambios necesarios y guarda (*Commit*) esos cambios Abre el archivo `Contributors.md` en un editor de texto y añade tu nombre. No lo añadas ni al principio ni al final del archivo, hazlo en cualquier otro sitio. Guarda el archivo. Terminal mostrando el estado del repositorio después de un git status, mostrando que se realizaron cambios en Contributors.md Si vas al directorio del proyecto y ejecutas el comando `git status`, podrás ver los cambios ya reflejados. Agrega esos cambios a la rama (*branch*) que creaste antes usando el comando `git add`: ``` git add Contributors.md ``` Ahora puedes hacer un *commit* sobre estos cambios ejecutando el comando `git commit`: ``` git commit -m "Add to Contributors list" ``` reemplazando `` con tu nombre. ## Carga (*Push*) tus cambios a GitHub Mandar un *push* de tus cambios usando el comando `git push`: ``` git push origin ``` Reemplaza `` con el nombre de la rama que creaste anteriormente. ## Envía (*Submit*) tus cambios para ser revisados Si vas a tu repositorio en GitHub, verás un botón `Compare & pull request`. Haz clic sobre este botón. Imagen de la interfaz de Github con el mensaje `Compare & pull request` resaltado en un botón verde para crear una pull request Ahora envía el *pull request*. Interfaz de pull request donde se comparan las ramas del fork con un mensaje verde que indica que se pueden fusionar automáticamente. Con el título de pull request y una sección para comentarios Pronto estaré combinando tus cambios (haciendo *merge*) con la rama master de este proyecto. Recibirás una notificación por correo electrónico cuando los cambios hayan sido combinados. ## ¿Cuáles son los siguientes pasos? ¡Felicidades! ¡Has completado la línea de trabajo *_fork -> clone -> edit -> PR_* que encontrarás habitualmente como contribuidor! Festeja tu contribución y compártela con tus amigos y seguidores yendo a [web app](https://firstcontributions.github.io/#social-share). Si desea más práctica, consulte [contribuciones de código](https://github.com/roshanjossey/code-contributions). Ahora empieza a contribuir a otros proyectos. Hemos reunido una lista de proyectos con *issues* sencillas para que puedas empezar. Échale un ojo a la [lista de proyectos en la web app](https://firstcontributions.github.io/#project-list). ### [Material adicional](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriales con otras herramientas |GitHub Desktop|Visual Studio 2017|GitKraken|VS Code|Sourcetree App|IntelliJ IDEA| |---|---|---|---|---|---| |[GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md)|[Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md)|[GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md)|[Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md)| [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md)|[IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md)| ================================================ FILE: docs/translations/README.my.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Sumbangan Pertama Projek ini bertujuan untuk memberikan panduan dan memudahkan individu yang baru mula belajar membuat sumbangan pertama mereka. Jika anda ingin membuat sumbangan pertama anda, sila ikuti arahan yang disediakan di bawah. #### *Sekiranya anda tidak selesa dengan menggunakan antara muka baris perintah (CLI), anda boleh mengikuti [panduan untuk menggunakan alat GUI di sini.](#Tutorial-Menggunakan-Alat-Lain)* Fork repositori ini Jika git belum dipasang di mesin anda, sila memasangnya [di sini](https://help.github.com/articles/set-up-git/). ## Fork repositori ini Fork repositori ini dengan menekankan butang 'Fork' yang terletak di bahagian atas halaman ini. Tindakan tersebut akan menghasilkan salinan repositori ini ke dalam akaun GitHub anda. ## Klon repositori ini Klon repositori ini Klon repositori yang anda telah fork ke mesin anda. Selepas itu, layari akaun GitHub anda, buka repositori yang baru dicabang, klik butang Clone, dan kemudian klik ikon *Copy url to clipboard*. Buka terminal dan jalankan arahan git berikut: ```bash git clone "URL anda baru disalin" ``` di mana "URL anda baru disalin" (tanpa tanda petikan) adalah URL ke repositori ini (fork anda bagi projek ini). Rujuk langkah-langkah sebelumnya untuk mendapatkan URL tersebut. Salin URL ke papan keratan Contoh: ```bash git clone https://github.com//first-contributions.git ``` di mana `this-is-you` adalah nama pengguna GitHub anda. Di sini, anda menyalinkan kandungan repositori GitHub 'first-contributions' ke komputer anda. ## Membuat branch Tukar ke direktori repositori pada komputer anda (jika lokasi CLI belum berada di sana): ```bash cd first-contributions ``` Sila buat branch menggunakan arahan `git switch`: ```bash git switch -c add-your-name ``` Contoh: ```bash git switch -c add-emma-maembong ``` ## Buat perubahan yang diperlukan dan komit perubahan tersebut Sekarang, buka fail `Contributors.md` dalam sebuah editor teks, dan tambahkan nama anda ke dalam fail itu. Jangan tambahkan pada awal atau akhir fail. Letakkan di mana-mana bahagian di antara kedua-duanya. Kemudian, simpan fail tersebut. git status Jika anda pergi ke direktori projek dan laksanakan arahan `git status`, anda akan melihat perubahan tersebut. Tambahkan perubahan itu ke branch yang baru anda cipta menggunakan arahan `git add`: ```bash git add Contributors.md ``` Selepas itu, komit perubahan tersebut menggunakan arahan `git commit`: ```bash git commit -m "Add to Contributors list" ``` menggantikan `` dengan nama anda. ## Push perubahan ke dalam GitHub Tolak perubahan anda menggunakan arahan `git push`: ```bash git push -u origin ``` menggantikan `` dengan nama branch yang kamu cipta sebelumnya. ## Hantar perubahan anda untuk semakan Jika anda pergi ke repositori anda di GitHub, anda akan melihat butang `Compare & pull request`. Klik butang tersebut. Cipta pull request Hantar 'pull request' tersebut. Hantar pull request Tidak lama lagi, saya akan menggabungkan semua perubahan anda ke dalam branch 'main' projek ini. Anda akan menerima e-mel pemberitahuan sebaik sahaja perubahan telah digabungkan. ## Pergi ke mana selepas ini? Tahniah! Anda baru saja selesai melaksanakan aliran kerja standard _fork -> clone -> edit -> pull request_ yang sering anda akan temui sebagai seorang penyumbang! Raikan sumbangan anda dan kongsi dengan rakan-rakan serta pengikut melalui [aplikasi web](https://firstcontributions.github.io/#social-share). Mari kita mulakan dengan menyumbang kepada projek lain. Kami telah menyediakan senarai projek dengan isu-isu mudah yang boleh anda mula sumbangkan. Sila rujuk [senarai projek dalam aplikasi web](https://firstcontributions.github.io/#project-list). ### [Bahan tambahan](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutorial Menggunakan Alat Lain | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.nl.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Eerste bijdragen Dit project heeft als doel het versimpelen en het begeleiden van beginners in het maken van hun eerste bijdragen. Als je op het punt staat om je eerste bijdragen te maken, volg dan onderstaande stappen. _Als je je niet comfortable voelt met de command line, vind je [hier handleidingen voor het gebruik van GUI tools.](#handleidingen-voor-andere-tools)_ fork deze repository ### Indien je git nog niet hebt op je systeem, [installeer het dan eerst](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Deze repository forken Fork deze repository door op de fork knop te klikken. Dit creëert een kopie van deze repository in jouw account. ## De repository clonen kloon deze repository Kloon nu deze repository naar je systeem. Klik op de kloon knop en dan op het kopiëren naar klembord icoon. Open een terminal en voer het volgende git commando uit: ```bash git clone "Gekopieerde repository url" ``` Waar "Gekopieerde repository url" (zonder aanhalingstekens) de url naar (jouw fork van) deze repository is. Zie de vorige stappen om de url te vinden. kopieer URL naar het klembord Bijvoorbeeld: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` Waar 'this-is-you' staat, vul jij je GitHub gebruikersnaam is. Hiermee kopieer je de inhoud van de first-contributions repo op GitHub naar je systeem. ## Een branch aanmaken Navigeer naar de map van de repository op je systeem (mocht je daar niet al zijn). ```bash cd first-contributions ``` Maak nu een branch aan door middel van het `git switch` commando: ```bash git switch -c je-nieuwe-branch-naam ``` Bijvoorbeeld: ```bash git switch -c add-alonzo-church ``` ## Maak de benodigde wijzigingen en commit deze Open nu het `Contributors.md` bestand in een teksteditor en voeg je naam toe. Doe dit niet aan het begin of eind, maar ergens in het midden. Sla vervolgens het bestand op. Uitvoer van git status Als je naar de projectmap gaat en `git status` doet, zul je zien dat er wijzigingen zijn. Voeg deze toe aan je branch met behulp van onderstaand `git add` commando. ```bash git add Contributors.md ``` Commit nu deze wijzigingen door onderstaand `git commit` commando te gebruiken. ```bash git commit -m "Add jouw-naam to Contributors list" ``` vervang `jouw-naam` met jouw naam ## Push de wijzigingen naar GitHub Push je wijzigingen met `git push`: ```bash git push -u origin je-nieuwe-branch-naam ``` Vervang `je-nieuwe-branch-naam` met de naam van de branch die je eerder hebt aangemaakt.
Als je foutmeldingen krijgt tijdens het pushen, klik dan hier: - ### Authentication Error 
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//first-contributions.git/'
Ga naar [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) voor het genereren en configureren van een SSH-sleutel in je account.
## Verstuur je wijzigingen voor review Als je naar je repository gaat op GitHub, zal je zien dat er een `Compare & pull request` knop staat. Klik hierop. creëer een pull request Verstuur nu je pull request. verstuur je pull request Nu ga ik (de beheerder) al je wijzigingen mergen in de master branch van dit project. Als de veranderingen gemerged zijn, zul je hier een e-mailnotificatie over ontvangen. ## Hoe nu verder? Gefeliciteerd! Je hebt zojuist de standaard _fork -> clone -> edit -> PR_ workflow doorlopen die je vaak zult tegenkomen als bijdrager! Vier je bijdrage en deel het met je vrienden en volgers via de [web app](https://firstcontributions.github.io/#social-share). Wil je meer oefenen, bekijk dan [code contributions](https://github.com/roshanjossey/code-contributions). Laten we je nu op weg helpen met het bijdragen aan andere projecten. We hebben een lijst samengesteld met projecten die makkelijke issues bevatten waar je aan kunt werken. Bekijk [de lijst op de web app](https://firstcontributions.github.io/#project-list) ## Handleidingen voor andere tools | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |

Dit project is gesponsord door:

================================================ FILE: docs/translations/README.no.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Første bidrag Det er alltid vanskelig å gjøre noe for første gang. Spesielt når man samarbeider med andre kan det være tungt å gjøre feil. Vi ønsker å gjøre det lettere for nybegynnere å bidra til open-source. Å lese artikler og se videoer kan hjelpe, men hva kan vel være bedre enn å gjøre det i praksis? Dette prosjektet håper å kunne tilby en enkel veiledning og gjøre det lett for nybegynnere å gi sitt første bidrag. Følg trinnene nedenfor hvis du ønsker å gi ditt første bidrag til dette prosjektet. _Hvis du ikke er komfortabel med terminal, [så finnes det andre metoder med bruk av GUI.](#tutorials-using-other-tools)_ #### Om du ikke har git installert på din maskin, [følg denne veiledningen](https://help.github.com/articles/set-up-git/).

## Fork dette prosjektet fork dette prosjektet Fork prosjektet ved å klikke på "fork" knappen på toppen av denne siden. Dette vil legge til en kopi av dette prosjektet til din GitHub konto (prosjekter kalles repository på GitHub).



## Clone prosjektet klon dette prosjektet Nå skal vi klone prosjektet fra GitHub til din maskin. Gå til din GitHub konto og åpne din nye fork, deretter klikk på "clone" knappen og kopier linken. Åpne en terminal/kommandolinje og kjør følgende git kommando: ```bash git clone "din-link" ``` Erstatt `` med linken du kopierte i forrige trinn. kopier URL til utklippstavle Eksempelvis: ```bash git clone https://github.com/ditt-brukernavn/first-contributions.git ``` der `ditt-brukernavn` er ditt GitHub brukernavn. Her kopierer vi innholdet i first-contributions prosjektet fra din GitHub konto til din lokale maskin.



## Opprett en branch Naviger terminalen inn i prosjektet (hvis du ikke er der allerede): ```bash cd first-contributions ``` Opprett en branch med `git checkout` kommandoen: ```bash git checkout -b ``` Eksempel: ```bash git checkout -b add-alonzo-church ``` Navnet på din branch behøver ikke å inneholde ordet _add_, men det gir mening å inkludere det i denne sammenhengen. Endre "alonzo-church" til ditt navn.

## Lag nødvendige endringer og commit dem Åpne filen `Contributors.md` i et program for å redigere tekst og legg til ditt navn i listen. Ikke legg det til i begynnelsen eller slutten av filen, legg det til hvor som helst i mellom. Når du har gjort dette kan du lagre filen. git status Hvis du åpner terminalen igjen og kjører kommandoen `git status`, vil du se dine endringer. Legg endringene til i din nye branch med kommandoen `git add`: ```bash git add Contributors.md ``` Commit endringene med kommandoen `git commit`: ```bash git commit -m "Add to Contributors list" ``` Erstatt `` med ditt navn.

## Push endringene til GitHub Push til GitHub med kommandoen `git push`: ```bash git push origin ``` Erstatt `` med navnet på branch som du opprettet tidligere.
Hvis du får noen feilmeldinger når du pusher til Github, klikk her: - ### Authentication Error 
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//first-contributions.git/'
Gå til [GitHub's brukansvisning](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) med generering og konfigurering av SHH nøkkelen til kontoen din.


## Send inn endringene for gjennomgang Hvis du går til ditt prosjekt på GitHub, vil du se en `Compare & pull request` knapp. Klikk på den for å opprette en pull request. opprett en pull request Send inn din pull request når du er klar. send inn pull request Snart vil jeg merge dine endringer inn i master branch av mitt prosjekt. Du vil motta en notifikasjon på epost når dine endringer er lagt til.

## Hva nå? Gratulerer! Du har gjennomført standardprosessen for _fork -> clone -> edit -> PR_, en prosess du vil møte på ofte! Feir ditt bidrag og del det med dine venner og følgere ved å gå til [web app](https://firstcontributions.github.io/#social-share). Hvis du vil ha mer øvelse, sjekk [code contributions](https://github.com/roshanjossey/code-contributions). Nå kan du gå videre og bidra til andre open-source prosjekter. Vi har satt sammen en liste med enkle og overkommelige problemer du kan starte med. Sjekk den ut her: [the list of projects in the web app](https://firstcontributions.github.io/#project-list).

### [Ekstramateriale](additional-material/git_workflow_scenarios/additional-material.md) ## Veiledning for andre verktøy | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) |

This project is supported by:

================================================ FILE: docs/translations/README.np.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) #### _अन्य [भाषाहरूमा](translations/Translations.md) पढ्नुहोस्।_ [Shqip](translations/README.al.md) [Uzbek language](translations/README.uz.md) [Azərbaycan dili](translations/README.aze.md) [বাংলা](translations/README.bn.md) [Bulgarian](translations/README.bg.md) [Português (Brasil)](translations/README.pt_br.md) [Català](translations/README.ca.md) [中文 (Simplified)](translations/README.zh-cn.md) [Czech](translations/README.cs.md) [Deutsch](translations/README.de.md) [Dansk](translations/README.da.md) [العربية](translations/README.eg.md) [Española](translations/README.es.md) [Française](translations/README.fr.md) [Galego](translations/README.gl.md) [Ελληνικά](translations/README.gr.md) [ქართული](translations/README.ge.md) [Magyar](translations/README.hu.md) [Bahasa Indonesia](translations/README.id.md) [עִברִית](translations/README.hb.md) [हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்](translations/Translations.md) [தமிழ்](translations/README.ta.md) [فارسی](translations/README.fa.md) [پښتو](translations/README.pus.md) [Italiano](translations/README.it.md) [日本語](translations/README.ja.md) [සිංහල](translations/README.si.md) [Kiswahili (Kenya)](translations/README.kws.md) [한국어 한국어](translations/README.ko.md) [Lietuvių kalba](translations/README.lt.md) [Limba Română Limba Română](translations/README.ro.md) [မြန်မာ](translations/README.mm_unicode.md) [Македонски](translations/README.mk.md) [Español de México](translations/README.mx.md) [Bahasa Melayu / بهاس ملايو‎ / Malay](translations/README.my.md) [Dutch](translations/README.nl.md) [Norsk](translations/README.no.md) [नेपाली](translations/README.np.md) [Wikang Filipino](translations/README.tl.md) [English (Pirate)](translations/README.en-pirate.md) [اردو](translations/README.ur.md) [Polski](translations/README.pl.md) [Português (Portugal)](translations/README.pt-pt.md) [Русский язык](translations/README.ru.md) [عربى](translations/README.ar.md) [Svenska](translations/README.se.md) [Slovenčina](translations/README.slk.md) [Slovenščina](translations/README.sl.md) [ภาษาไทย](translations/README.th.md) [Türkçe](translations/README.tr.md) [中文(Traditional)](translations/README.zh-tw.md) [Українська](translations/README.ua.md) [Tiếng Việt](translations/README.vn.md) [Zulu (South Africa)](translations/README.zul.md) [Afrikaans (South Africa)](translations/README.afk.md) [Igbo (Nigeria)](translations/README.igb.md) [Yoruba (Nigeria)](translations/README.yor.md) [Hausa (Nigeria)](translations/README.hau.md) [Latvia](translations/README.lv.md) [Suomeksi](translations/README.fi.md) [Беларуская мова](translations/README.by.md) [Српски](translations/README.sr-Cyrl.md) [Srpski](translations/README.sr-Latn.md) [Қазақша](translations/README.kz.md) [Bosanski](translations/README.bih.md) [Bosanski](translations/README.bih.md) [Hrvatski](translations/README.hr.md) [پښتو](translations/README.ps.md) [Somalia](translations/README.so.md) [Ecuador](translations/README.ec.md) # पहिलो योगदान(contribution)। यस प्रोजेक्टले शुरुवातकर्ताहरूले आफ्नो पहिलो योगदान गर्ने तरिकालाई सरल बनाउने र मार्गदर्शन गर्ने लक्ष्य राखेको छ। यदि तपाईं आफ्नो पहिलो योगदान गर्न खोज्दै हुनुहुन्छ भने, तलका चरणहरूको पालना गर्नुहोस्। हामी पहिलो योगदान (contribution) को लागि यसै repository को प्रयोग गर्नेछौ । _यदि तपाईं कमाण्ड लाइन (command line) सँग सहज हुनुहुन्न भने, [यहाँ GUI tool हरु प्रयोग गर्ने Tutorial हरु छन्।](#अन्य-उपकरणहरू-प्रयोग-गर्ने-tutorial-हरु)_ fork this repository. #### यदि तपाईंसँग तपाइँको कम्प्यूटरमा git छैन भने,[ यहाँबाट install गर्नुहोस्।]( https://help.github.com/articles/set-up-git/) ## Repository Fork गर्नुहोस्। यस page को Top मा रहेको `Fork` बटनमा क्लिक गरेर यो repository लाई Fork गर्नुहोस। यसले तपाईंको GitHub account मा यस रिपोको प्रतिलिपि(copy) बनाउदछ । ## Repository Clone गर्नुहोस्। यो repository clone गर्नुहोस् अब ` Fork ` गरेको repository लाई आफ्नो कम्प्युटरमा ` Clone ` गर्नको लागी तपाइको GitHub account मा जानुहोस् र Fork गरिएको Repository खोल्नुहोस्। अब ` Code ` बटनमा क्लिक गर्नुहोस् र त्यसपछि *copy to clipboard* आइकनमा क्लिक गर्नुहोस्। टर्मिनल खोल्नुहोस् र निम्न git कमाण्ड चलाउनुहोस्: ```bash git clone "तपाइले copy गरेको URL" ``` जहाँ `"तपाइले copy गरेको URL"` छ, त्यो तपाईले fork गरेको repository को url हो । ( Url प्राप्त गर्न clone गर्ने चित्रहरुमा हेर्नुहोस्। ) URL लाई क्लिपबोर्डमा प्रतिलिपि बनाउनुहोस् उदाहरणका लागि: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` जहाँ `this-is-you` छ, त्यहाँ तपाईंको GitHub username लेख्नुहोस् । यहाँ तपाइँले GitHub बाट तपाईंको कम्प्युटरमा `first-contributions` repository को file हरु प्रतिलिपि (copy) गर्दै हुनुहुन्छ। ## Repository Branch बनाउनुहोस्। तपाईंको कम्प्यूटरमा Clone गरेको repository को directory लाई खोल्नुहोस् (यदि तपाईं पहिले नै हुनुहुन्न भने): ```bash cd first-contributions ``` अब `git switch` कमाण्ड प्रयोग गरेर एउटा branch बनाउनुहोस् : ```bash git switch -c ब्रन्चको-नाम ``` उदाहरणको लागि: ```bash git switch -c add-ram-regmi ``` (ब्रान्चको नाममा *add* शब्दको आवश्यकता छैन, तर यसमा add समावेश गर्न उचित छ किनभने यस branch को उद्देश्य तपाईंको नामलाई contributors को सूचीमा थप्ने हो।) ## Repository मा आवश्यक परिवर्तनहरू गर्नुहोस् र तिनी परिवर्तनहरूलाई commit गर्नुहोस्। अब टेक्स्ट एडिटर (text editor) मा `Contributors.md` फाइल खोल्नुहोस्, यसमा तपाईंको नाम add गर्नुहोस् । तपाईंको नामलाई फाइलका नामहरुको बीचमा राख्नुहोस् , *सुरुवात वा अन्त्यमा तपाईंको नाम नथप्नुहोस्*। । अब फाईल save गर्नुहोस्। git status अब यदि तपाई project directory जानुभयो र `git status` कमाण्डलाई रन (run) गर्नुभयो भने,तपाइँले त्यहाँ परिवर्तन भएका फाइलहरुको सुची देख्नुहुनेछ। तपाइले भर्खरै बनाउनु भएको branch मा `git add` कमाण्ड प्रयोग गरी तिनी परिवर्तनहरू थप्नुहोस्: ```bash git add Contributors.md ``` अब `git commit` कमाण्ड प्रयोग गरेर तिनी परिवर्तनहरू कमिट (commit) गर्नुहोस्: ```bash git commit -m "Add to Contributors list" ``` `` को साटोमा तपाईंको आफ्नो नाम लेख्नुहोला। ## GitHub मा परिवर्तनहरुलाई push गर्नुहोस। `git push` कमाण्डको प्रयोग गरेर आफ्नो परिवर्तनहरु पुश (push) गर्नुहोस्: ```bash git push -u origin ``` `` को सट्टामा तपाईले पहिले बनाएको branch को नामको लेख्नुहोस्। उदाहरणको लागि: ```bash git push -u origin add-ram-regmi ```
यदि push गर्दा केहि समस्या परेमा यहाँ क्लिक गर्नुहोस् : - ### Authentication Error 
remote: पासवर्ड प्रमाणीकरण (authentication) को समर्थन अगस्ट 13, 2021 मा हटाइएको थियो। कृपया यसको सट्टा personal access token प्रयोग गर्नुहोस्।
  remote: थप जानकारीको लागी https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ हेर्नुहोस्।
  fatal: 'https://github.com//first-contributions.git/' को लागी प्रमाणीकरण असफल भयो।
[GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) मा गएर आफ्नो account को लागी SSH key generate र configure गर्नुहोस्।
## Review को लागि तपाईंको परिवर्तनहरू पेश गर्नुहोस्। यदि तपाईं आफ्नो गिटहब रिपोजिटोरी ( GitHub Repository) मा जानुहुन्छ भने, तपाइँले `Compare & pull request` बटन देख्नुहुनेछ। त्यस बटनमा क्लिक गर्नुहोस्। एउटा पुल अनुरोध सिर्जना गर्नुहोस् अब 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 हरूमा पनि शेयर गर्नुहोस् । यदि तपाईंलाई थप अभ्यास चाहियो भने, [कोड योगदानहरू](https://github.com/roshanjossey/code-contributions) हेर्नुहोस्। अब तपाईले अन्य प्रोजेक्टहरूमा योगदान दिन सुरु गर्नुहोस्। हामीले तपाईंले गर्न सक्नुहुने सजिलो समस्याहरू(issues)को साथमा प्रोजेक्टहरूको सूची संकलन गरेका छौ। [web app मा प्रोजेक्टहरूको सूची](https://firstcontributions.github.io/#project-list) हेर्नुहोस्। ### [थप सामग्री](../additional-material/git_workflow_scenarios/additional-material.md) ## अन्य उपकरणहरू प्रयोग गर्ने tutorial हरु | गिटहब डेस्कटप | भिजुअल स्टुडियो २०१७ | गिटक्राकेन | भिएस कोड | सोर्सट्री एप | इन्टेलिजे आईडिया | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |

यो project लाई समर्थन गर्ने:

================================================ FILE: docs/translations/README.od.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # ପ୍ରଥମ ଅବଦାନ ଏହି ପ୍ରୋଜେକ୍ଟଟି ଆରମ୍ଭକାରୀମାନଙ୍କୁ ସେମାନଙ୍କର ପ୍ରଥମ ଅବଦାନକୁ ସରଳ ଏବଂ ମାର୍ଗଦର୍ଶନ କରିବାକୁ ଲକ୍ଷ୍ୟ ରଖିଛି | ଯଦି ତୁମେ ତୁମର ପ୍ରଥମ ଅବଦାନ ଦେବାକୁ ଚାହୁଁଛ, ନିମ୍ନରେ ଥିବା ପଦକ୍ଷେପଗୁଡ଼ିକୁ ଅନୁସରଣ କର | _ଯଦି ଆପଣ କମାଣ୍ଡ୍ ଲାଇନ୍ ସହିତ ଆରାମଦାୟକ ନୁହଁନ୍ତି, [ଏଠାରେ GUI ଉପକରଣ ବ୍ୟବହାର କରି ଟ୍ୟୁଟୋରିଆଲ୍ ଅଛି |](https://github.com/firstcontributions/first-contributions/blob/main/translations/README.od.md#ଅନ୍ୟାନ୍ୟ-ଉପକରଣ-ବ୍ୟବହାର-କରି-ଟ୍ୟୁଟୋରିଆଲ୍-)_ ଏହି ସଂଗ୍ରହାଳୟକୁ ଫଙ୍କ୍ #### ଯଦି ଆପଣଙ୍କର ମେସିନରେ ଗିଟ୍ ନାହିଁ, ତେବେ ଏହାକୁ [ସଂସ୍ଥାପନ କରନ୍ତୁ](https://docs.github.com/en/get-started/quickstart/set-up-git) | ## ଏହି ଭଣ୍ଡାରକୁ ଫର୍କ କରନ୍ତୁ | ଏହି ପୃଷ୍ଠାର ଉପରି ଭାଗରେ ଥିବା ଫଙ୍କ ବଟନ୍ ଉପରେ କ୍ଲିକ୍ କରି ଏହି ସଂଗ୍ରହାଳୟକୁ ଫର୍କ କରନ୍ତୁ | ଏହା ଆପଣଙ୍କ ଆକାଉଣ୍ଟରେ ଏହି ସଂଗ୍ରହାଳୟର ଏକ କପି ସୃଷ୍ଟି କରିବ | ## ସଂଗ୍ରହାଳୟକୁ କ୍ଲୋନ କରନ୍ତୁ | ଏହି ସଂଗ୍ରହାଳୟକୁ କ୍ଲୋନ କରନ୍ତୁ ବର୍ତ୍ତମାନ ତୁମର ଯନ୍ତ୍ରରେ ଫଙ୍କଡ୍ ରେପୋଜିଟୋରୀକୁ କ୍ଲୋନ୍ କର | ଆପଣଙ୍କର GitHub ଆକାଉଣ୍ଟକୁ ଯାଆନ୍ତୁ, ଫଙ୍କଡ୍ ରେପୋଜିଟୋରୀ ଖୋଲନ୍ତୁ, କୋଡ୍ ବଟନ୍ ଉପରେ କ୍ଲିକ୍ କରନ୍ତୁ ଏବଂ ତା’ପରେ କ୍ଲିପବୋର୍ଡ_ ଆଇକନ୍ ପାଇଁ _ କପି କ୍ଲିକ୍ କରନ୍ତୁ | ଏକ ଟର୍ମିନାଲ୍ ଖୋଲନ୍ତୁ ଏବଂ ନିମ୍ନଲିଖିତ git ନିର୍ଦ୍ଦେଶକୁ ଚଲାନ୍ତୁ: ```bash git clone "url ତୁମେ କେବଳ କପି କରିଛ" ``` ଯେଉଁଠାରେ "url ତୁମେ କେବଳ କପି କରିଛ" (କୋଟେସନ୍ ମାର୍କ ବିନା) ଏହି ସଂଗ୍ରହାଳୟର url (ଏହି ପ୍ରୋଜେକ୍ଟର ଫଙ୍କ୍) | Url ପାଇବା ପାଇଁ ପୂର୍ବ ପଦକ୍ଷେପଗୁଡିକ ଦେଖନ୍ତୁ | କ୍ଲିପବୋର୍ଡକୁ URL କପି କରନ୍ତୁ ଉଦାହରଣ ସ୍ଵରୁପ: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` ଯେଉଁଠାରେ "ଏହା-ତୁମେ" ତୁମର GitHub ଉପଯୋଗକର୍ତ୍ତା ନାମ | ଏଠାରେ ଆପଣ GitHub ରେ ପ୍ରଥମ-ଅବଦାନ ସଂଗ୍ରହାଳୟର ବିଷୟବସ୍ତୁକୁ ଆପଣଙ୍କ କମ୍ପ୍ୟୁଟରରେ କପି କରୁଛନ୍ତି | ## ଏକ ଶାଖା ସୃଷ୍ଟି କରନ୍ତୁ | ଆପଣଙ୍କ କମ୍ପ୍ୟୁଟରରେ ରେପୋଜିଟୋରୀ ଡିରେକ୍ଟୋରୀକୁ ପରିବର୍ତ୍ତନ କରନ୍ତୁ (ଯଦି ଆପଣ ପୂର୍ବରୁ ନାହାଁନ୍ତି): ```bash cd first-contributions ``` ବର୍ତ୍ତମାନ `git switch` କମାଣ୍ଡ ବ୍ୟବହାର କରି ଏକ ଶାଖା ସୃଷ୍ଟି କରନ୍ତୁ: ```bash git switch -c <ତୁମର-ନୂତନ-ଶାଖା-ନାମ> ``` ଉଦାହରଣ ସ୍ଵରୁପ: ```bash git switch -c add-alonzo-church ``` ## ଆବଶ୍ୟକ ପରିବର୍ତ୍ତନ କର ଏବଂ ସେହି ପରିବର୍ତ୍ତନଗୁଡିକ କର | ବର୍ତ୍ତମାନ ଟେକ୍ସଟ୍ ଏଡିଟର୍ ରେ `Contributors.md` ଫାଇଲ୍ ଖୋଲ, ଏଥିରେ ତୁମର ନାମ ଯୋଡ | ଫାଇଲ୍ ର ଆରମ୍ଭ କିମ୍ବା ଶେଷରେ ଏହାକୁ ଯୋଡନ୍ତୁ ନାହିଁ | ଏହାକୁ ଯେକ ଣସି ସ୍ଥାନରେ ରଖନ୍ତୁ | ବର୍ତ୍ତମାନ, ଫାଇଲ୍ ସେଭ୍ କରନ୍ତୁ | git status ଯଦି ଆପଣ ପ୍ରୋଜେକ୍ଟ ଡିରେକ୍ଟୋରୀକୁ ଯାଆନ୍ତି ଏବଂ `git status` କମାଣ୍ଡ୍ ଏକଜେକ୍ୟୁଟ୍ କରନ୍ତି, ଆପଣ ଦେଖିବେ ସେଠାରେ କିଛି ପରିବର୍ତ୍ତନ ଅଛି | ସେହି ପରିବର୍ତ୍ତନଗୁଡ଼ିକୁ ଆପଣ `git add` କମାଣ୍ଡ ବ୍ୟବହାର କରି ସୃଷ୍ଟି କରିଥିବା ଶାଖାରେ ଯୋଡନ୍ତୁ: ```bash git add Contributors.md ``` ବର୍ତ୍ତମାନ `git commit` କମାଣ୍ଡ ବ୍ୟବହାର କରି ସେହି ପରିବର୍ତ୍ତନଗୁଡ଼ିକୁ କର: ```bash git commit -m "Add <ତୁମର ନାମ> to Contributors list" ``` <ତୁମର ନାମ> ସହିତ ତୁମର ନାମ ବଦଳାଇବା | ## GitHub କୁ ପରିବର୍ତ୍ତନ କର | `git push` 'କମାଣ୍ଡ ବ୍ୟବହାର କରି ତୁମର ପରିବର୍ତ୍ତନକୁ ଠେଲିଦିଅ: ```bash git push -u <ଉତ୍ପତ୍ତି ତୁମର ଶାଖା-ନାମ> ``` ଆପଣ ପୂର୍ବରୁ ସୃଷ୍ଟି କରିଥିବା ଶାଖାର ନାମ ସହିତ `ଉତ୍ପତ୍ତି ତୁମର ଶାଖା-ନାମ` କୁ ବଦଳାନ୍ତୁ |
ଯଦି ଆପଣ ଠେଲିବା ସମୟରେ କ any ଣସି ତ୍ରୁଟି ପାଆନ୍ତି, ତେବେ ଏଠାରେ କ୍ଲିକ୍ କରନ୍ତୁ: - ### ପ୍ରାମାଣିକିକରଣ ତ୍ରୁଟି | 
 ସୁଦୂର: ପାସୱାର୍ଡ ପ୍ରାମାଣିକିକରଣ ପାଇଁ ସମର୍ଥନ ଅଗଷ୍ଟ 13, 2021 ରେ ଅପସାରିତ ହୋଇଥିଲା। ଦୟାକରି ଏହା ବଦଳରେ ଏକ ବ୍ୟକ୍ତିଗତ ପ୍ରବେଶ ଟୋକେନ୍ ବ୍ୟବହାର କରନ୍ତୁ |
  ସୁଦୂର: ଅଧିକ ସୂଚନା ପାଇଁ ଦୟାକରି https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ ଦେଖନ୍ତୁ |
  ସାଂଘାତିକ: 'https://github.com/  /first-contributions.git/'
ପାଇଁ ପ୍ରାମାଣିକିକରଣ ବିଫଳ ହେଲା | [GitHub ର ଟ୍ୟୁଟୋରିଆଲ୍] କୁ ଯାଆନ୍ତୁ (https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ଆପଣଙ୍କ ଖାତାକୁ ଏକ SSH କି ସୃଷ୍ଟି ଏବଂ ବିନ୍ୟାସ କରିବା |
## ସମୀକ୍ଷା ପାଇଁ ଆପଣଙ୍କର ପରିବର୍ତ୍ତନ ଦାଖଲ କରନ୍ତୁ | ଯଦି ଆପଣ GitHub ରେ ଥିବା ରେପୋଜିଟୋରୀକୁ ଯାଆନ୍ତି, ତେବେ ଆପଣ ଏକ “ତୁଳନା ଏବଂ ଟାଣ ଅନୁରୋଧ” ବଟନ୍ ଦେଖିବେ | ସେହି ବଟନ୍ ଉପରେ କ୍ଲିକ୍ କରନ୍ତୁ | ଏକ ଟାଣ ଅନୁରୋଧ ସୃଷ୍ଟି କରନ୍ତୁ ବର୍ତ୍ତମାନ ଟାଣ ଅନୁରୋଧ ଦାଖଲ କରନ୍ତୁ | ଟାଣ ଅନୁରୋଧ ଦାଖଲ ଶୀଘ୍ର ମୁଁ ତୁମର ସମସ୍ତ ପରିବର୍ତ୍ତନକୁ ଏହି ପ୍ରକଳ୍ପର ମୁଖ୍ୟ ଶାଖାରେ ମିଶ୍ରଣ କରିବି | ପରିବର୍ତ୍ତନଗୁଡ଼ିକ ମିଶ୍ରିତ ହେବା ପରେ ତୁମେ ଏକ ବିଜ୍ email ପ୍ତି ଇମେଲ ପାଇବ | ## ଏଠାରୁ କେଉଁଠିକୁ ଯିବା? ଅଭିନନ୍ଦନ! ତୁମେ କେବଳ ମାନକ _ଫୋର୍କ୍ -> କ୍ଲୋନ୍ -> ସଂପାଦନ -> ଟାଣ ଅନୁରୋଧ_ ୱାର୍କଫ୍ଲୋ ଯାହା ତୁମେ ପ୍ରାୟତ a ଏକ ସହଯୋଗୀ ଭାବରେ ସାମ୍ନା କରିବ! ଆପଣଙ୍କର ଅବଦାନକୁ ପାଳନ କରନ୍ତୁ ଏବଂ [ୱେବ୍ ଆପ୍](https://firstcontributions.github.io/#social-share) କୁ ଯାଇ ଆପଣଙ୍କର ସାଙ୍ଗ ଏବଂ ଅନୁସରଣକାରୀଙ୍କ ସହିତ ଅଂଶୀଦାର କରନ୍ତୁ | ଯଦି ତୁମର କ ଣସି ସାହାଯ୍ୟ ଦରକାର କିମ୍ବା କ ଣସି ପ୍ରଶ୍ନ ଅଛି ତେବେ ତୁମେ ଆମର ଅଳସୁଆ ଦଳରେ ଯୋଗ ଦେଇ ପାରିବ | [ଅଳିଆ ଦଳରେ ଯୋଗ ଦିଅନ୍ତୁ](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) ବର୍ତ୍ତମାନ, ଅନ୍ୟ ପ୍ରୋଜେକ୍ଟରେ ଯୋଗଦାନ ସହିତ ଆରମ୍ଭ କରିବା | ସହଜ ପ୍ରସଙ୍ଗଗୁଡିକ ସହିତ ଆମେ ପ୍ରୋଜେକ୍ଟଗୁଡିକର ଏକ ତାଲିକା ସଂକଳନ କରିଛୁ ଯାହାକୁ ଆପଣ ଆରମ୍ଭ କରିପାରିବେ | [ୱେବ୍ ଆପରେ ପ୍ରୋଜେକ୍ଟଗୁଡିକର ତାଲିକା](https://firstcontributions.github.io/#project-list) ଦେଖନ୍ତୁ | ### [ଅତିରିକ୍ତ ସାମଗ୍ରୀ](additional-material/git_workflow_scenarios/additional-material.md) ## ଅନ୍ୟାନ୍ୟ ଉପକରଣ ବ୍ୟବହାର କରି ଟ୍ୟୁଟୋରିଆଲ୍ | | GitHub Desktop | Visual Studio 2017 | GitKraken | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.pb.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) # ਪਹਿਲਾ ਯੋਗਦਾਨ ਇਸ ਪ੍ਰੋਜੈਕਟ ਦਾ ਉਦੇਸ਼ ਸ਼ੁਰੂਆਤੀ ਲੋਕਾਂ ਦਾ ਆਪਣਾ ਪਹਿਲਾ ਯੋਗਦਾਨ ਪਾਉਣ ਦੇ ਕਮ ਨੂੰ ਸਰਲ ਬਣਾਉਣ ਅਤੇ ਮਾਰਗਦਰਸ਼ਨ ਕਰਨਾ ਹੈ। ਜੇ ਤੁਸੀਂ ਆਪਣਾ ਪਹਿਲਾ ਯੋਗਦਾਨ ਪਾਉਣ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰ ਰਹੇ ਹੋ, ਤਾਂ ਹੇਠਾਂ ਦਿੱਤੇ ਕਦਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ। ਜੇ ਤੁਸੀਂ ਕਮਾਂਡ ਲਾਈਨ ਨਾਲ ਸੁਖੀ ਨਹੀਂ ਹੋ, [ਇੱਥੇ ਜੀ.ਯੁ.ਆੀ ਟੂਲਸ ਦੀ ਵਰਤੋਂ ਕਰਨ ਦਿਆਂ ਟੁਟੋਰਿਅਲਸ ਹਨ.](#ਹੋਰ-ਟੂਲਜ-ਦੀ-ਵਰਤੋਂ-ਕਰਦਿਆਂ-ਟੁਟੋਰਿਅਲ) ਇਸ ਰੀਪੋਜ਼ਿਟਰੀ ਨੂੰ ਫੋਰਕ ਕਰੋ #### ਜੇ ਤੁਹਾਡੀ ਮਸ਼ੀਨ ਤੇ ਗਿੱਟ ਨਹੀਂ ਹੈ, [ਇਸ ਨੂੰ ਇੰਸਟਾਲ ਕਰੋ](https://help.github.com/articles/set-up-git/)। ## ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਫੋਰਕ ਕਰੋ ਇਸ ਪੰਨੇ ਦੇ ਸਿਖਰ ਤੇ 'ਫੋਰਕ ਬਟਨ' ਤੇ ਕਲਿੱਕ ਕਰਕੇ ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਫੋਰਕ ਕਰੋ. ਇਹ ਤੁਹਾਡੇ ਖਾਤੇ ਵਿੱਚ ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਦੀ ਇੱਕ ਕਾਪੀ ਬਣਾਏਗਾ. ## ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਕਲੋਨ ਕਰੋ ਇਸ ਰੀਪੋਜ਼ਿਟਰੀ ਨੂੰ ਕਲੋਨ ਕਰੋ ਹੁਣ ਆਪਣੀ ਮਸ਼ੀਨ ਤੇ ਫੋਰਕਡ ਰਿਪੋਜ਼ਟਰੀ ਦਾ ਕਲੋਨ ਕਰੋ। ਆਪਣੇ ਗਿਟ-ਹਬ ਅਕਾਉਂਟ ਤੇ ਜਾਓ, ਫੋਰਕਡ ਰਿਪੋਜ਼ਟਰੀ ਖੋਲ੍ਹੋ, ਕੋਡ ਬਟਨ ਤੇ ਕਲਿਕ ਕਰੋ ਅਤੇ ਫਿਰ ਕਲਿੱਪਬੋਰਡ ਆਈਕਨ ਤੇ ਕਾਪੀ ਕਲਿੱਕ ਕਰੋ. ਇੱਕ ਟਰਮੀਨਲ ਖੋਲ੍ਹੋ ਅਤੇ ਹੇਠਲੀ ਗਿਟ ਕਮਾਂਡ ਚਲਾਓ: ```bash git clone "ਯੂ.ਆਰ.ਐਲ ਜੇੈਕਰ ਤੁਸੀਂ ਹੁਣੇ ਨਕਲ ਕੀਤੀ" ``` ਜਿੱਥੇ “ਯੂ.ਆਰ.ਐਲ ਜੇੈਕਰ ਤੁਸੀਂ ਹੁਣੇ ਨਕਲ ਕੀਤੀ” (ਹਵਾਲਾ ਨਿਸ਼ਾਨਾਂ ਤੋਂ ਬਿਨਾਂ) ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਦਾ ਯੂ.ਆਰ.ਐਲ ਹੈ (ਇਸ ਪ੍ਰੋਜੈਕਟ ਦਾ ਤੁਹਾਡਾ ਫੋਰਕ)। ਯੂ.ਆਰ.ਐਲ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ ਪਿਛਲੇ ਕਦਮ ਵੇਖੋ। URL ਨੂੰ ਕਲਿੱਪਬੋਰਡ ਵਿੱਚ ਕਾਪੀ ਕਰੋ ਉਦਾਹਰਣ ਲਈ: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` ਜਿੱਥੇ `this-is-you` ਤੁਹਾਡਾ ਗਿਟ-ਹਬ ਉਪਯੋਗਕਰਤਾ ਨਾਮ ਹੈ। ਇੱਥੇ ਤੁਸੀਂ ਆਪਣੇ ਕੰਪਿਊਟਰ ਤੇ ਗਿਟ-ਹਬ ਉੱਤੇ ਪਹਿਲੇ-ਯੋਗਦਾਨ ਰਿਪੋਜ਼ਟਰੀ ਦੇ ਭਾਗਾਂ ਦੀ ਨਕਲ ਕਰ ਰਹੇ ਹੋ. ## ਇੱਕ ਸ਼ਾਖਾ ਬਣਾਓ ਆਪਣੇ ਕੰਪਿਊਟਰ ਉੱਤੇ ਰਿਪੋਜ਼ਟਰੀ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਬਦਲੋ (ਜੇ ਤੁਸੀਂ ਪਹਿਲਾਂ ਤੋਂ ਨਹੀਂ ਹੋ): ```bash cd first-contributions ``` ਹੁਣ `git checkout` ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਸ਼ਾਖਾ ਬਣਾਓ: ```bash git checkout -b ਤੁਹਾਡਾ-ਨਵੀਂ-ਸ਼ਾਖਾ-ਦਾ-ਨਾਮ ``` ਉਦਾਹਰਣ ਲਈ: ```bash git checkout -b add-alonzo-church ``` (ਸ਼ਾਖਾ ਦੇ ਨਾਮ ਨੂੰ ਇਸ ਵਿਚ _add_ ਸ਼ਬਦ ਦੀ ਜ਼ਰੂਰਤ ਨਹੀਂ ਹੈ, ਪਰ ਇਹ ਸ਼ਾਮਲ ਕਰਨਾ ਇਕ ਵਾਜਬ ਚੀਜ਼ ਹੈ ਕਿਉਂਕਿ ਇਸ ਸ਼ਾਖਾ ਦਾ ਉਦੇਸ਼ ਤੁਹਾਡੇ ਨਾਮ ਨੂੰ ਇਕ ਸੂਚੀ ਵਿਚ ਸ਼ਾਮਲ ਕਰਨਾ ਹੈ.) ## ਜ਼ਰੂਰੀ ਤਬਦੀਲੀਆਂ ਕਰੋ ਅਤੇ ਉਨ੍ਹਾਂ ਬਦਲਾਵਾਂ ਨੂੰ ਪ੍ਰਤੀਬੱਧ ਕਰੋ ਹੁਣ ਟੈਕਸਟ ਐਡੀਟਰ ਵਿੱਚ `Contributors.md` ਫਾਈਲ ਖੋਲ੍ਹੋ, ਇਸ ਵਿੱਚ ਆਪਣਾ ਨਾਮ ਸ਼ਾਮਲ ਕਰੋ. ਇਸ ਨੂੰ ਫਾਈਲ ਦੇ ਸ਼ੁਰੂ ਜਾਂ ਅੰਤ 'ਤੇ ਨਾ ਸ਼ਾਮਲ ਕਰੋ. ਇਸ ਨੂੰ ਕਿਤੇ ਵੀ ਵਿਚਕਾਰ ਰੱਖੋ। ਹੁਣ, ਫਾਈਲ ਸੇਵ ਕਰੋ। git status ਕਮਾਂਡ ਦਾ ਆਉਟਪੁੱਟ ਜੇ ਤੁਸੀਂ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਤੇ ਜਾਂਦੇ ਹੋ ਅਤੇ `git status` ਕਮਾਂਡ ਚਲਾਉਂਦੇ ਹੋ, ਤਾਂ ਤੁਸੀਂ ਦੇਖੋਗੇ ਕਿ ਬਦਲਾਅ ਹਨ। ਸ਼ਾਖਾ ਵਿੱਚ ਉਹ ਬਦਲਾਵ ਸ਼ਾਮਲ ਕਰੋ ਜੋ ਤੁਸੀਂ ਹੁਣੇ ਬਣਾਇਆ `git add` ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਬਣਾਈ ਹੈ: ```bash git add Contributors.md ``` ਹੁਣ ਉਹ ਤਬਦੀਲੀਆਂ `git ਕਮਿ`` ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਨਾਲ ਕਰੋ: ```bash git commit -m "Add to Contributors list" ``` ਤੁਹਾਡੇ ਨਾਮ ਨਾਲ `<ਤੁਹਾਡੇ ਆਪਣੇ ਨਾਮ> rep ਨੂੰ ਬਦਲਣਾ. ## GitHub ਵਿੱਚ ਬਦਲੋ ਧੱਕੋ ਕਮਾਂਡ `git push` ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਆਪਣੀਆਂ ਤਬਦੀਲੀਆਂ ਧੱਕੋ: ```bash git push origin ``` ਉਸ ਬ੍ਰਾਂਚ ਦੇ ਨਾਮ ਨਾਲ ` la ਨੂੰ ਬਦਲਣਾ ਜੋ ਤੁਸੀਂ ਪਹਿਲਾਂ ਬਣਾਈ ਸੀ. ## ਆਪਣੀਆਂ ਤਬਦੀਲੀਆਂ ਨੂੰ ਸਮੀਖਿਆ ਲਈ ਦਰਜ ਕਰੋ ਜੇ ਤੁਸੀਂ ਗਿੱਟਹੱਬ 'ਤੇ ਆਪਣੀ ਰਿਪੋਜ਼ਟਰੀ' ਤੇ ਜਾਂਦੇ ਹੋ, ਤਾਂ ਤੁਸੀਂ `ਤੁਲਨਾ ਕਰੋ ਅਤੇ ਖਿੱਚੋ ਬੇਨਤੀ` ਬਟਨ ਨੂੰ ਵੇਖੋਗੇ. ਉਸ ਬਟਨ 'ਤੇ ਕਲਿੱਕ ਕਰੋ. ਪੁੱਲ ਰਿਕਵੇਸਟ ਬਣਾਓt ਹੁਣ ਪੁਲੀ ਬੇਨਤੀ ਨੂੰ ਜਮ੍ਹਾ ਕਰੋ. ਪੁੱਲ ਰਿਕਵੇਸਟ ਜਮ੍ਹਾਂ ਕਰੋs ਜਲਦੀ ਹੀ ਮੈਂ ਤੁਹਾਡੀਆਂ ਸਾਰੀਆਂ ਤਬਦੀਲੀਆਂ ਨੂੰ ਇਸ ਪ੍ਰੋਜੈਕਟ ਦੀ ਮਾਸਟਰ ਬ੍ਰਾਂਚ ਵਿੱਚ ਮਿਲਾ ਦੇਵਾਂਗਾ. ਇਕ ਵਾਰ ਤਬਦੀਲੀਆਂ ਨੂੰ ਮਿਲਾਉਣ ਤੋਂ ਬਾਅਦ ਤੁਹਾਨੂੰ ਇਕ ਸੂਚਨਾ ਈਮੇਲ ਮਿਲੇਗੀ. ## ਇਥੋਂ ਕਿੱਥੇ ਜਾਣਾ ਹੈ? ਵਧਾਈਆਂ! ਤੁਸੀਂ ਹੁਣੇ ਹੀ ਸਟੈਂਡਰਡ _ਫੋਰਕ -> ਕਲੋਨ -> ਐਡਿਟ -> ਖਿੱਚ ਬੇਨਤੀ_ ਵਰਕਫਲੋ ਪੂਰਾ ਕੀਤਾ ਹੈ ਜਿਸਦਾ ਤੁਸੀਂ ਅਕਸਰ ਇੱਕ ਯੋਗਦਾਨ ਪਾਉਣ ਵਾਲੇ ਦੇ ਰੂਪ ਵਿੱਚ ਸਾਹਮਣਾ ਕਰੋਗੇ! ਆਪਣੇ ਯੋਗਦਾਨ ਦਾ ਜਸ਼ਨ ਮਨਾਓ ਅਤੇ ਜਾ ਕੇ ਇਸ ਨੂੰ ਆਪਣੇ ਦੋਸਤਾਂ ਅਤੇ ਪੈਰੋਕਾਰਾਂ ਨਾਲ ਸਾਂਝਾ ਕਰੋ। [ਵੈੱਬ ਐਪ](https://firstcontributions.github.io/#social-share). ਜੇਕਰ ਤੁਸੀਂ ਹੋਰ ਅਭਿਆਸ ਚਾਹੁੰਦੇ ਹੋ, ਤਾਂ [ਕੋਡ ਯੋਗਦਾਨਾਂ](https://github.com/roshanjossey/code-contributions) ਨੂੰ ਚੈੱਕਆਉਟ ਕਰੋ। ਆਓ ਹੁਣ ਤੁਹਾਨੂੰ ਹੋਰ ਪ੍ਰੋਜੈਕਟਾਂ ਵਿੱਚ ਯੋਗਦਾਨ ਪਾਉਣ ਲਈ ਸ਼ੁਰੂਆਤ ਕਰੀਏ. ਅਸੀਂ ਪ੍ਰੋਜੈਕਟਾਂ ਦੀ ਇੱਕ ਸੂਚੀ ਤਿਆਰ ਕੀਤੀ ਹੈ ਜਿਸ ਨਾਲ ਤੁਸੀਂ ਅਸਾਨ ਮੁੱਦਿਆਂ ਨੂੰ ਸ਼ੁਰੂ ਕਰ ਸਕਦੇ ਹੋ। [ਪ੍ਰੋਜੈਕਟਾਂ ਦੀ ਸੂਚੀ](https://firstcontributions.github.io/#project-list). ### [ਵਾਧੂ ਸਮੱਗਰੀ](additional-material/git_workflow_scenarios/additional-material.md) ## ਹੋਰ ਟੂਲਜ ਦੀ ਵਰਤੋਂ ਕਰਦਿਆਂ ਟੁਟੋਰਿਅਲ | GitHub ਡੈਸਕਟਾਪ ਐਪ | ਵਿਜੁਅਲ ਸਟੂਡੀਓ 2017 | GitKraken ਪ੍ਰੋਗਰਾਮ | VS ਕੋਡ ਐਡੀਟਰ | Sourcetree ਐਪ | IntelliJ IDEA ਪ੍ਰੋਗਰਾਮ | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.pcm.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions Dis project dey to make am simple and guide beginners how dem go make their first contribution. If you wan make your first contribution, follow these steps wey dey below. _If command line no dey comfortable for you, [see tutorials wey use GUI tools here.](#tutorials-using-other-tools)_ fork dis repo #### If you no get git for your machine, [install am](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Fork this repository Fork this repository by clicking on the fork button for the top of this page. Dis one go create copy of dis repository for your account. ## Clone the repository clone dis repo Now clone the forked repository go your machine. Go to your GitHub account, open the forked repository, click on the code button and then click the _copy to clipboard_ icon. Open a terminal and run the following git command: ```bash git clone "url wey you just copy" ``` where "url wey you just copy" (without the quotation marks) na the url to this repository (your fork of this project). See the previous steps to get the url. copy di URL go clipboard For example: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` where this-is-you na your GitHub username. Here you dey copy the contents of the first-contributions repository for GitHub go your computer. ## Create a branch Change go the repository directory for your computer (if you no dey there already): ```bash cd first-contributions ``` Now create a branch using the git switch command: ```bash git switch -c your-new-branch-name ``` For example: ```bash git switch -c add-desmond-ezo-ojile ``` ## Make necessary changes and commit those changes Now open Contributors.md file for a text editor, add your name to am. No add am for the beginning or end of the file. Put am anywhere for middle. Now, save the file. git status If you go to the project directory and run the command git status, you go see say changes dey. Add those changes to the branch wey you just create using the git add command: ```bash git add Contributors.md ``` Now commit those changes using the git commit command: ```bash git commit -m "Add your-name to Contributors list" ``` replace your-name with your own name. ## Push changes to GitHub Push your changes using the command git push: ```bash git push -u origin your-branch-name ``` replace your-branch-name with the name of the branch wey you create before.
If you get any errors while pushing, click here: ## Authentication Error 
remote: Support for password authentication don remove since 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//first-contributions.git/'
Go to GitHub's tutorial on how to generate and add SSH key to your account.
## Submit your changes for review If you go to your repository on GitHub, you go see Compare & pull request button. Click on that button. create pull request Now submit the pull request. submit pull request Soon I go merge all your changes into the main branch of this project. You go get notification email once the changes don merge. ## Where to go from here? Congrats! ================================================ FILE: docs/translations/README.pl.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Pierwsze kontrybucje Zawsze jest ciężko, kiedy robisz coś po raz pierwszy. Szczególnie gdy współpracujesz z innymi ludźmi, ponieważ popełnianie błędów nie jest niczym przyjemnym. Jednak właśnie na współpracy opiera się idea otwartego oprogramowania. Chcemy nauczyć w prosty sposób nowych programistów jak wgrać swoją pierwszą zmianę w obcym projekcie. Czytanie artykułów i oglądanie poradników może pomóc, ale czy jest coś lepszego niż spróbowanie czegoś samemu bez obaw, że się coś zepsuje? Ten projekt ma na celu dostarczyć nowicjuszom wskazówek i uprościć proces wgrania pierwszej zmiany. Pamiętaj: im bardziej jesteś zrelaksowany, tym lepiej się uczysz. Jeśli chcesz wgrać swoją pierwszą kontrybucję wykonaj kilka prostych kroków poniżej. Będzie fajnie, obiecujemy. zrób fork tego repozytorium Jeśli nie masz Gita na swoim komputerze, [ zainstaluj go ](https://help.github.com/articles/set-up-git/). ## Zrób fork repozytorium (`fork`) Zrób fork tego repozytorium klikając przycisk `Fork` na górze tej strony. Stworzysz tym samym kopię tego repozytorium na swoim koncie. ## Sklonuj repozytorium (`clone`) sklonuj to repozytorium Teraz sklonuj repozytorium na swój komputer. Przejdź do swojego konta GitHub, otwórz skopiowane repozytorium, kliknij przycisk `Code`, a później ikonkę _skopiuj do schowka_. Otwórz konsolę i uruchom komendę git: ```bash git clone ``` Gdzie `` to adres tego repozytorium (twojej kopii tego projektu). Zobacz poprzedni krok aby skopiować adres. skopiuj adres URL do schowka Przykład: ```bash git clone https://github.com/to-ty/first-contributions.git ``` W miejscu `to-ty` to twój login na GitHubie. W tym kroku ściągasz zawartość twojej kopii repozytorium `first-contributions` z githuba na swój komputer. ## Stwórz gałąź (`branch`) Wejdź do folderu ze swoim repozytorium (jeżeli jeszcze tam nie jesteś): ```bash cd first-contributions ``` Teraz utwórz nową gałąź wykonując polecenie `git switch`: ```bash git switch -c ``` Przykład ```bash git switch -c add-adam-kowalski ``` (Nazwa gałęzi nie musi zawierać słowa _add_, ale dobrze jest je dodać z racji tego, że celem tej gałęzi jest dodanie twojego imienia do listy.) ## Wprowadź zmiany i wgraj je Otwórz plik `Contributors.md` w edytorze tekstu. Musisz znać Markdown, lekki język znaczników. Tu masz ściągawkę gdzie znajdziesz informację jak go używać. Dodaj następującą linię w `Contributors.md` ``` [Twoje imię](https://github.com/Twoja-nazwa-użytkownika) ``` Przykład: ``` [John Doe](https://github.com/johndoe) ``` Nie dodawaj jej na początku ani na końcu pliku. Umieść ją w dowolnym miejscu pomiędzy. Upewnij się że nie ma spacji pomiędzy `](`. Zapisz plik i następnie go zamknij. Jeżeli wejdziesz do folderu ze swoim repozytorium i wykonasz komendę `git status`, zobaczysz, że są tam zmiany. Dodaj te zmiany do gałęzi którą właśnie utworzyłeś używając komendy `git add`: ```bash git add Contributors.md ``` Teraz zapisz te zmiany wykonując komendę `git commit`: ```bash git commit -m "Add to Contributors list" ``` Zastąp `` swoim imieniem i nazwiskiem. ## Wyślij zmiany na GitHub Wyślij swoje zmiany komendą `git push`: ```bash git push -u origin ``` Zastąp `` nazwą gałęzi, którą wcześniej utworzyłeś. ## Wyślij swoje zmiany do zatwierdzenia W swoim repozytorium na GitHubie znajdziesz przycisk `Compare & pull request`. Kliknij go. utwórz prośbę o scalenie Teraz wyślij prośbę o scalenie. wyślij prośbę o scalenie Niedługo dodam proponowane przez ciebie zmiany do głównej gałęzi projektu. Zostaniesz powiadomiony mailowo kiedy zmiany zostaną scalone. ## Co dalej? Brawo! Właśnie ukończyłeś standardowy workflow _fork -> clone -> edit -> pull request_, który często będziesz napotykać jako współtwórca! Świętuj swoją pierwszą zmianę i podziel się nią z przyjaciółmi i obserwującymi poprzez aplikację. Możesz teraz zacząć uczestniczyć w innych projektach. Przygotowaliśmy listę projektów z prostymi zadaniami które będą dobre na początek. Sprawdź listę projektów. ### [Materiały dodatkowe](../additional-material/git_workflow_scenarios/additional-material.md) ## Ćwiczenia przy użyciu innych narzędzi | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.ps.md ================================================
Open Source Love MIT License Open Source Helpers --- ## لومړی ګډون **د دې پروژې هدف دا دی چې نویو ګډونوالو ته په خلاصو سرچینو پروژو (Open Source Projects) کې د ګډون اسانه طریقه وښيي.** که غواړئ خپله لومړنۍ مرسته وکړئ، لاندې ګامونه تعقیب کړئ. **که د کمانډ لاین (CLI) سره راحت نه یاست،** [کولی شئ تصویري لارښود دلته وګورئ](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) **که مو Git انسټال نه وي،** [له دې ځایه یې ښکته او نصب کړئ](https://help.github.com/articles/set-up-git/). ## دا ذخیره (repository) فورک کړئ د دې زیرمې فورک کول - د دې پاڼې په سر کې د Fork تڼۍ کلیک کړئ. - فورک کول به د دې ذخیرې یوه کاپي ستاسو د GitHub اکاونټ ته انتقال کړي.
## دا ذخیره (repository) کلون کړئ د دې زیرمې کلون کول - خپل اکاونټ ته لاړ شئ او د فورک شوې ذخیرې لینک د **Code** تڼۍ څخه کاپي کړئ.
- ترمینل یا CMD خلاص کړئ او دا کمانډ اجرا کړئ: ```bash git clone https://github.com/YourUsername/first-contributions.git ``` **یادونه:** دلته `YourUsername` باید ستاسو د GitHub اکاونټ نوم وي. ## نوې څانګه (branch) جوړ کړئ - د first-contribution پروژه په خپل کوډ ایډیټر کې خلاصه کړئ. - ترمینل کې دا کمانډ اجرا کړئ ترڅو نوې څانګه جوړه کړئ. ددې لپاره چې زمونږ د بدلونونو لپاره خپله څانګه وي او له نورو سره شریکه نشي. دې څانګې کې به مونږ ایډیټ کوو او بیا به یې له عمومي څانګې سره یوځای کوو. ```bash git switch -c your-branch-name ``` your-branch-name ستاسو د څانګې نوم دی. کولای شئ چې هر نوم تاسې ټاکلی شئ. ## اړین بدلونونه راوړئ او commit کړئ - د `Contributors.md` فایل خلاص کړئ او خپل نوم پکې اضافه کړئ کې). - فایل ذخیره کړئ. د Git حالت - ترمینل ته لاړ شئ او دا کمانډ اجرا کړئ ترڅو وګورئ کوم فایلونه مو بدل کړي دي: ```bash git status ``` - بدلونونه ذخیره کړئ: ```bash git add Contributors.md ``` - اوس مو بدلونونه کمټ Commit کړئ: ```bash git commit -m "message" ``` د مسیج پر ځای تاسې هر څه لیکلی شئ. بهتره دا ده چې تاسې په دې ځای کې ولیکئ چې کوم بدلونونه مو پروژې کې راوستل. ## بدلونونه GitHub ته push کړئ - خپل بدلونونه کیټ هب ته پورته کړئ: ```bash git push origin -u your-branch-name ``` د your-branch-name پر ځای باید تاسې په دقیق ډول سره د خپلې څانګې نوم ورکړئ. هغه نوم چې لږ مخکې مو انتخاب کړی وه.
که چېرې په دې لړ کې د کومې ستونزې سره مخ شوئ دا ځای کېکاږئ که چېرته ستاسې ستونزه داسي وي. 
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/
[نو بیا دلته زده کړئ چې دا ستونزه څنګه حل کړئ](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)
## خپل بدلونونه د بیاکتنې لپاره وسپارئ - خپل GitHub اکاونټ کې دې ریپوزیټوري ته لاړ شئ. - د **Compare & pull request** تڼۍ به ووینئ. پر هغې کلیک وکړئ. create a pull request - اوس د pull request غوښتنه وسپارئ. submit pull request - له دې وروسته به ستاسو بدلونه د اصلي یا main څانګې سره یوځای شي او ستاسو نوم به د ګډون کوونکو لیست ته اضافه کړل شي. ## له دې وروسته څه وکړئ؟ تاسو په بریالیتوب سره د فورک، کلون، ایډیټ، او pull request مرحلې بشپړې کړې. تاسې له دې نه وروسته کولی شئ چې په خلاص-سرچېنه پروژو کې په همدې طریقه برخه واخلئ. - خپل لومړئ ګډون ولمانځئ او له خپلو ملګرو سره یې [شریک کړئ](https://firstcontributions.github.io/#social-share). - که کومه ستونزه یا پوښتنه لرئ، کولای شئ زموږ د Slack ټیم سره یوځای شئ. - اوس کولای شئ په نورو پروژو کې هم ګډون وکړئ. [دلته د پروژو لیست وګورئ](https://firstcontributions.github.io/#project-list). ## اضافي مواد ## د نورو وسیلو په کارولو سره درسونه | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) |
================================================ FILE: docs/translations/README.pt-ao.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições Começando no **Mundo Open-source ?** Então aqui você tem a sua oportunidade de fazer a sua primeira contribuição open-source, Siga os passos abaixo e no final você terá provalmente ter feito a sua primeira contribuição 🙂 Primeiramente, vamos começar por instalar o [Git](https://pt.wikipedia.org/wiki/Git) para que seja possível continuar os passos abaixos descritos, você poderá fazer a instalação do git, caso não tenha do através do link para a [Página de Instalação]( https://help.github.com/articles/set-up-git/ ). ## Faz Fork deste repositório bifurcar este repositório Faz Fork clicando no botão "Fork" no topo desta página e de seguida click na opção *Create a new Fork(Criar novo fork, em português)*



## Clone o repositório clonar este repositório Pós o fork, clone o repositorío para o seu dispositivo, Clicando no botão de *Code(código, em português)* e de seguida copiar o link, que aparecerá. Abra o seu Terminal ou PowerShell e digite o seguinte: ```bash git clone ``` Para que fique assim: ```bash git clone https://github.com/firstcontributions/first-contributions.git ``` De seguida dê Enter ## Cria uma nova Branch Abra a pasta que foi criada quando você fez o clone Agora crie uma nova Branch usando o comando no terminal: `git checkout`: ```bash git checkout -b ``` Por exemplo: ```bash git checkout -b edgar-dikenge ``` Obs.: O nome do Branch não precisa de ter a sigla "add", mas neste caso é recomendável, porque a finalidade deste Branch é a de adicionar o teu nome a uma lista. ## Efetua as alterações necessárias e faz um Commit Agora vá para ficheiro `Contributors.md` no teu editor de código e adicione o seu nome e salve o ficheiro. Se fores para o diretório do projeto e executares o comando `git status`, verás que há alterações. Adiciona essas alterações ao Branch que acabaste de criar utilizando o comando `git add`: ```bash git add Contributors.md ``` Agora faz um Commit dessas alterações utilizando o comando `git commit`: ```bash git commit -m "Add to Contributors list" ``` substitui `` pelo teu nome ou nickname. ## Faz um Push das alterações para o GitHub Faz um Push utilizando o comando `git push`: ```bash git push origin ``` substitui `` pelo nome do Branch que criaste anteriormente. ## Envia as tuas alterações para serem revistas Se fores para o teu repositório no GitHub, verás um botão `Compare & pull request`. Clica nesse botão. criar um pedido de pull Agora envia um Pull Request. submeter pedido de pull Quando puder incorporarei as tuas mudanças no Branch principal (master) deste projeto. Vais receber um e-mail de notificação quando as alterações forem incorporadas. ## E agora ? Partilhe com seus amigos e seguidores [web app](https://firstcontributions.github.io/#social-share). Podes também juntar-te à nossa equipa no Slack caso precises de alguma ajuda ou tenhas alguma dúvida. [Junta-te à nossa equipa no Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). Aqui tens mais suguestões para a sua próxima contribuição, Baza lá dar uma olhada: ### [ Material adicional ](../additional-material/translations/Portuguese/additional-material.pt_br.md) ## Tutoriais com outras ferramentas | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | -- | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.pt-pt.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições É difícil. É sempre difícil fazer algo pela primeira vez. Especialmente quando se está a colaborar, errar não é algo agradável. Mas *open source* (código aberto) trata-se de colaboração e de trabalharmos juntos. Queremos simplificar a forma com que novos colaboradores *open source* aprendem e contribuem pela primeira vez. Ler artigos e ver tutoriais pode ajudar, mas nada melhor do que realmente "pôr a mão na massa" sem estragar nada. Este projecto visa simplificar a forma com que os novatos fazem a sua primeira contribuição. Lembre-se: quanto mais relaxado(a) estiveres, melhor aprenderás. Se quiseres fazer a tua primeira contribuição, siga os passos abaixo. Nós prometemos, será divertido. Se não te sentires à vontade com a linha de comandos, [aqui tens tutoriais que usam as ferramentas GUI](#tutoriais-com-outras-ferramentas). Se ainda não tens o git na tua máquina, [instala-o aqui]( https://help.github.com/articles/set-up-git/ ). ## Faz Fork deste repositório fork deste repositorio Faz Fork clicando no botão "Fork" no topo desta página. Esta operação criará uma cópia deste repositório na tua conta.



## Clona o repositório clonar este repositório Agora clona este repositório para a tua máquina local. Clique no botão "Clone or download" e, em seguida, clica no ícone "Copy to clipboard" para copiar o URL. Abre o teu terminal e executa o comando seguinte: ```bash git clone "url que copiou" ``` onde "url que copiou" (sem as aspas) é o URL deste repositório. Consulte as etapas anteriores para obter o URL. copiar URL Por exemplo: ```bash git clone https://github.com/este-é-voce/first-contributions.git ``` onde "este-é-voce" é o teu nome de usuário do GitHub. Aqui estás a copiar o conteúdo do repositório first-contributions para o teu computador. ## Cria um Branch Vá para o diretório do repositório no teu computador (caso ainda não estejas lá): ```bash cd first-contributions ``` Agora crie um novo Branch usando o comando `git checkout`: ```bash git checkout -b ``` Por exemplo: ```bash git checkout -b add-alonzo-church ``` Obs.: O nome do Branch não precisa de ter a sigla "add", mas neste caso é recomendável, porque a finalidade deste Branch é a de adicionar o teu nome a uma lista. ## Efetua as alterações necessárias e faz um Commit Agora abra o ficheiro `Contributors.md` no teu editor de código, adiciona o teu nome e guarda o ficheiro. Se fores para o diretório do projeto e executares o comando `git status`, verás que há alterações. Adiciona essas alterações ao Branch que acabaste de criar utilizando o comando `git add`: ```bash git add Contributors.md ``` Agora faz um Commit dessas alterações utilizando o comando `git commit`: ```bash git commit -m "Add to Contributors list" ``` substitui `` pelo teu nome ou nickname. ## Faz um Push das alterações para o GitHub Faz um Push utilizando o comando `git push`: ```bash git push origin ``` substitui `` pelo nome do Branch que criaste anteriormente. ## Envia as tuas alterações para serem revistas Se fores para o teu repositório no GitHub, verás um botão `Compare & pull request`. Clica nesse botão. Cria um Pull Request Agora envia um Pull Request. Envia um pull request Quando puder incorporarei as tuas mudanças no Branch principal (master) deste projeto. Vais receber um e-mail de notificação quando as alterações forem incorporadas. ## Para onde ir a partir daqui? Celebra as tuas contribuições e partilha-as com amigos e seguidores através da [web app](https://firstcontributions.github.io/#social-share). Se quiseres praticar mais, acede a [code contributions](https://github.com/roshanjossey/code-contributions). Aqui estão alguns repositórios com Issues a nível de principiante em que tu podes ajudar a resolver. Vai em frente e clica nos repositórios para saber mais. ### [ Material adicional ](../additional-material/translations/Portugues/additional-material.pt_br.md) ## Tutoriais com outras ferramentas | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | -- | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.pt_br.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primeiras Contribuições Este projeto visa facilitar o caminho e guiar os iniciantes em suas primeiras contribuições. Se você deseja fazer a sua primeira contribuição, siga os passos abaixo. #### _Se não se sente confortável com a linha de comando, [aqui estão alguns tutoriais de ferramentas gráficas.](#Tutoriais-usando-outras-ferramentas)_ fork deste repositório Se não possui o git em sua máquina, [instale-o aqui](https://help.github.com/articles/set-up-git/). ## Faça um _Fork_ deste repositório Faça um _Fork_ clicando no botão "_Fork_" no topo desta página, uma cópia deste repositório será criada em sua conta. ## Clone o repositório clonar este repositório Agora clone este repositório para a sua máquina. Clique no botão "_Code_" e, em seguida, clique no ícone "_Copy to clipboard_" para copiar a URL. Abra um terminal e execute o seguinte comando do git: ```bash git clone "url que copiou" ``` onde "url que copiou" (sem as aspas) é a URL deste repositório (seu fork deste projeto). Consulte as etapas anteriores para obter a URL. copiar URL Por exemplo: ```bash git clone https://github.com/seu-usuario/first-contributions.git ``` onde "seu-usuário" é o seu usuário do _GitHub_. Aqui você estará copiando o conteúdo do repositório _first-contributions_ para o seu computador. ## Crie um Branch Acesse o diretório do repositório no seu computador (caso você não esteja nele): ```bash cd first-contributions ``` Agora crie um _Branch_ usando o comando `git switch`: ```bash git switch -c ``` Por exemplo: ```bash git switch -c add-andre-oliveira ``` Obs.: O nome do _Branch_ não precisa ter a sigla "add", mas nesse caso é recomendável, porque a finalidade deste _Branch_ é a de adicionar o seu nome à uma lista. ## Efetue as alterações necessárias e faça um _Commit_ Agora, abra o arquivo `Contributors.md` em seu editor de código e adicione o seu nome a ele. Não o adicione no início ou no final do arquivo. Coloque-o em qualquer lugar no meio. Agora, salve o arquivo. git status Se você for para o diretório do projeto e executar o comando `git status`, verá que há alterações. Adicione essas alterações ao _Branch_ que você acabou de criar utilizando o comando `git add`: ```bash git add Contributors.md ``` Agora, confirme essas alterações usando o comando git commit `git commit`: ```bash git commit -m "Add to Contributors list" ``` substituindo `` pelo seu nome. ## Faça um Push das alterações para o _GitHub_ Envie suas alterações usando o comando `git push`: ```bash git push origin ``` substituindo `` pelo nome do _Branch_ que você criou anteriormente. ## Envie suas alterações para serem revisadas Se você for para o seu repositório no _GitHub_, verá um botão `Compare & pull request`. Clique nesse botão. Crie um Pull Request Agora envie um _Pull Request_. Envie o Pull Request Logo estará mesclando ('mergeando') as suas mudanças no _Branch_ principal (main) deste projeto. Você receberá um e-mail de notificação quando as alterações forem mescladas. ## Para onde ir a partir daqui? Parabéns! Você completou o fluxo de trabalho básico _fork -> clone -> edit -> PR_ que você encontrará frequentemente como contribuidor! Celebre sua contribuição e compartilhe com seus amigos e seguidores no [app web](https://firstcontributions.github.io/#social-share). Se você quiser mais prática, verifique [code contributions](https://github.com/roshanjossey/code-contributions). Agora você pode colaborar com outros projetos. Nós compilamos uma lista de projetos com problemas simples que você pode começar. Verifique em [a lista de projetos no web app](https://firstcontributions.github.io/#project-list). ### [ Material adicional ](../additional-material/translations/Portugues/additional-material.pt_br.md) ## Tutoriais usando outras ferramentas | GitHub Desktop | Visual Studio 2017 | IntelliJ IDEA | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [GitHub Desktop](../gui-tool-tutorials/translations/github-desktop-tutorial.pt_br.md) | [Visual Studio 2017](../gui-tool-tutorials/translations/github-windows-vs2017-tutorial.pt_br.md) | [IntelliJ IDEA](../gui-tool-tutorials/translations/github-windows-intellij-tutorial.pt_br.md) | ================================================ FILE: docs/translations/README.ro.md ================================================ [![Surse Deschise Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![Licență: MIT](https://img.shields.io/badge/Licență-MIT-green)](https://opensource.org/licenses/MIT) [![Contribuitori](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Primele Contribuții Acest proiect își propune să simplifice și să îndrume modul în care începătorii își fac prima contribuție. Dacă doriți să faceți prima contribuție, urmați pașii de mai jos. _Dacă nu vă simțiți confortabil folosind linia de comandă, [aici sunt tutoriale folosind alte unelte (GUI)](#tutoriale-folosind-alte-unelte)._ Realizați bifurcația depozitului #### Dacă nu ai git instalat, [instalează-l](https://help.github.com/articles/set-up-git/). ## Realizați bifurcația depozitului Efectuați bifurcația acestui depozit apăsând pe butonul `Fork` din partea de sus a acestei pagini. Aceasta va crea o copie a acestui depozit în contul dvs. ## Clonați depozitul Clonați acest depozit Acum clonați depozitul bifurcat pe computerul dvs. Mergeți în contul dvs. GitHub, deschideți depozitul bifurcat, apăsați pe butonul `Code` și apoi pe pictograma de _copiere în clipboard_. Deschideți un terminal și executați următoarea comandă Git: ```bash git clone "URL-ul pe care l-ați copiat" ``` unde `URL-ul pe care l-ați copiat` (fără ghilimele) este URL-ul către acest depozit (bifurcarea dvs. a acestui proiect). Consultați pașii anteriori pentru a obține URL-ul. Copiați URL-ul în clipboard De exemplu: ```bash git clone https://github.com/numele-tau/first-contributions.git ``` unde `numele-tau` reprezintă numele dvs. de utilizator GitHub. Aici copiați conținutul depozitului _first-contributions_ de pe GitHub pe computerul dvs. ## Creați o ramură Schimbați directorul depozitului de pe computerul dvs. (dacă nu sunteți deja acolo): ```bash cd first-contributions ``` Acum creați o ramură folosind comanda `git switch`: ```bash git switch -c numele-noii-ramuri ``` De exemplu: ```bash git switch -c adaug-alonzo-church ``` ## Efectuați modificările necesare și comiteți acele modificări Acum deschideți fișierul `Contributors.md` într-un editor de text, adăugați-vă numele în el. Nu-l adăugați la începutul sau la sfârșitul fișierului. Puneți-l oriunde între acestea. Apoi, salvați fișierul. Stare git Dacă mergeți în directorul proiectului și executați comanda `git status`, veți vedea că există modificări. Adăugați aceste modificări în ramura pe care tocmai ați creat-o folosind comanda `git add`: ```bash git add Contributors.md ``` Acum comiteți acele modificări folosind comanda `git commit`: ```bash git commit -m "Adaug numele-tau la lista de Contribuitori" ``` înlocuind `numele-tau` cu numele dvs. ## Încărcați modificările pe GitHub Împinge schimbările tale cu comanda `git push`: ```bash git push -u origin numele-ramurii-tale ``` înlocuind `numele-ramurii-tale` cu numele ramurii pe care ați creat-o anterior.
Dacă întâmpinați erori în timpul încărcării, apăsați aici: - ### Eroare de autentificare 
remote: Suportul pentru autentificarea prin parolă a fost eliminat la 13 august 2021. Vă rugăm să utilizați un token de acces personal în schimb.
remote: Vă rugăm să consultați https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ pentru mai multe informații.
fatal: Autentificare eșuată pentru 'https://github.com//first-contributions.git/'
înlocuind `numele-tau` cu numele dvs. de utilizator GitHub. Mergeți la [tutorialul GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) pentru a genera și configura o cheie SSH pentru contul dvs.
## Trimiteți modificările pentru a fi revizuite Dacă mergeți în depozitul dvs. de pe GitHub, veți vedea un buton `Compară și cereți trageri`. Faceți clic pe acest buton. Creați o cerere de tragere Acum trimiteți cererea de tragere. Trimiteți cererea de tragere În curând, voi integra toate modificările dvs. în ramura principală a acestui proiect. Veți primi o notificare prin e-mail odată ce modificările vor fi integrate. ## Unde să mergeți de aici? Felicitări! Ați finalizat fluxul standard _fork -> clone -> edit -> pull request_ pe care îl veți întâlni adesea ca contributor! Sărbătoriți-vă contribuția și partajați-o cu prietenii și urmăritorii dvs., accesând [aplicația web](https://firstcontributions.github.io/#social-share). Dacă doriți mai multă practică, consultați [code contributions](https://github.com/roshanjossey/code-contributions). Acum să vă începem cu contribuția la alte proiecte. Am compilat o listă de proiecte cu probleme ușoare cu care puteți începe. Verificați [lista de proiecte din aplicația web](https://firstcontributions.github.io/#project-list). ### [Materiale suplimentare](additional-material/git_workflow_scenarios/additional-material.md) ## Tutoriale Folosind Alte Unelte (GUI) | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) |

Acest proiect este susținut de:

================================================ FILE: docs/translations/README.ru.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Первый вклад в проект Сложно. Всегда сложно начинать что-то с самого начала. Довольно неприятно совершать ошибки, особенно если вы работаете в команде. Весь open source состоит из сотрудничества и совместной работы. Мы хотим облегчить первые шаги в обучении и сотрудничестве начинающим разработчикам. Чтение статей и учебников может помочь, но что может быть лучше, чем настоящий практический опыт, без риска что-либо испортить? Цель этого проекта - должным образом направить молодых новобранцев, а также предоставить им возможность сделать их первый вклад. Помните: чем меньше вы напряжены, тем лучше вы учитесь. Если вы ищете возможность осуществить свой первый вклад, просто следуйте простым шагам, расположенным ниже. Обещаем, будет интересно. Если вам нужна помощь с командной строкой, [это руководство использует инструменты графической операционной системы (GUI).](#Использование-других-инструментов) форкните этот репозиторий Если у вас не установлен git на компьютере, [ установите его. ](https://help.github.com/articles/set-up-git/) ## Создайте ветку Создайте собственную ветку, нажав на кнопку `fork` сверху этой страницы. Таким образом, вы создадите копию этого репозитория в своем аккаунте. ## Клонируйте репозиторий клонируйте этот репозиторий Теперь клонируйте ваш репозиторий на ПК. Нажмите на кнопку `clone`, а затем на иконку `copy to clipboard`, чтобы скопировать ссылку. Откройте терминал и запустите следующую git команду: ```bash git clone "ссылка на репозиторий" ``` Где "ссылка на репозиторий" (без кавычек) - это ссылка на ваш репозиторий. Посмотрите предыдущие шаги, чтобы получить эту ссылку. скопируйте ссылку в буфер обмена Например: ```bash git clone https://github.com/ваш-логин/first-contributions.git ``` Где `ваш логин` ваш логин на github'e. Таким образом вы копируете репозиторий 'first-contributions' с GitHub на ваш ПК. ## Создайте ветку Перейдите в каталог репозитория на вашем компьютере, если вы еще не там. ```bash cd first-contributions ``` Теперь создайте ветку с помощью команды `git checkout` ```bash git checkout -b ``` Например: ```bash git checkout -b add-alonzo-church ``` (Синтаксически не требуется, чтобы название ветки содержало слово _add_, но это оправдано, поскольку подчеркивает назначение этой ветки: добавить ваше имя в список.) ## Внесите необходимые изменения и создайте коммит Теперь откройте файл `Contributors.md` в вашем текстовом редакторе, впишите ваше имя и сохраните файл. Если вы перейдёте в директорию проекта и выполните `git status`, вы увидите изменения. Добавьте эти изменения с помощью команды `git add`. ```bash git add Contributors.md ``` Теперь закоммитьте данные изменения с помощью команды `git commit`. ```bash git commit -m "Add to Contributors list" ``` Измените `` на ваше имя ## Запушьте изменения на github Запушьте ваши изменения с помощью `git push` ```bash git push origin ``` Измените `` на имя ветки, которую вы создали ранее. ## Подтвердите изменения для ревью Если вы зайдете в свой репозиторий на GitHub, вы увидите кнопку `Compare & pull request`. Нажмите на нее. создайте запрос на слияние Теперь подтвердите пулл-реквест. отправьте запрос на слияние Скоро я произведу объединение всех ваших изменений с основной веткой данного проекта. Вы получите сообщение по электронной почте, когда изменения будут приняты (смержены). Основная ветка вашего репозитория не будет изменена. Для синхронизации выполните шаги, расположенные ниже. ## Синхронизируйте вашу ветку с данным репозиторием Прежде всего перейдите в основную ветку: ```bash git checkout main ``` Затем добавьте url моего репозитория в поле `upstream remote url`: ```bash git remote add upstream https://github.com/Roshanjossey/first-contributions ``` Таким образом мы сообщим git'у, что существует другая версия данного проекта по определенной ссылке, и мы ее считаем мастером. Как только изменения смержены, подгрузите новую версию моего репозитория. ```bash git fetch upstream ``` Таким образом мы забрали все изменения в моём ответвлении (upstream remote). После, вам нужно смержить новую версию моего репозитория с вашей мастер-веткой. ```bash git rebase upstream/main ``` Так вы применяете все изменения, которые вы подтянули к вашей мастер-ветке. Если вы запушите сейчас мастер-ветку, ваше ответвление тоже будет содержать изменения. ```bash git push origin main ``` Обратите внимание, что вы пушите в удаленный репозиторий origin. На этом этапе я объединил вашу ветку `` со своей мастер-веткой, а вы объединили свою мастер-ветку с моей. Ваша ветка больше не нужна, вы можете удалить её: ```bash git branch -d ``` Так же можете удалить её версию в удалённом репозитории: ```bash git push origin --delete ``` Это совершенно не обязательно, но название этой ветки отражает её довольно специфическое назначение. И продолжительность её жизни может быть соответствующе короткой. ## Использование других инструментов | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.se.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # First Contributions Det är alltid svårt första gången man gör något och speciellt när du samarbetar med andra kan det vara extra känsligt att göra misstag. Vi vill göra det lättare för dig att lära dig hur man bidrar till ett öppet källkods-projekt. Att läsa artiklar och titta på handledningar kan så klart hjälpa men det är alltid bättre att göra det på riktigt. Detta projeket har som syfte att tillhandahålla en guide och göra det enkelt för nybörjare att göra sina första bidrag. Om du är ute efter att göra ditt första bidrag kan du följa stegen nedan. #### *Om du inte känner dig bekväm med kommandoraden, [så finns en vägledning här.](#Handledningar-för-andra-verktyg)* Gör en fork av detta repository Om du inte har git installerat [så installera det]( https://help.github.com/articles/set-up-git/ ) ## Gör en Fork på detta repository Forka repot genom att klicka på fork-knappen överst på denna sida. Detta kommer att skapa en kopia av repot i ditt GitHub-konto. ## Klona repository Klona detta repository Klona repot till din dator. Gå till ditt GitHub-konto och klicka på clone-knappen och klicka sedan på *copy to clipboard*-ikonen. Öppna en terminal och kör följande kommando: ```bash git clone "url you just copied" ``` där "url you just copied" (utan citat-tecken) är URL:en för detta repo (din fork för detta projekt). Se föregående steg för att hitta URL:en. Kopiera URL till urklipp Till exempel: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` där `this-is-you` är ditt användarnamn på GitHub. På detta sätt kopierar du innehållet i repot till din dator. ## Skapa en branch Gå till repo-katalogen på din dator (om du inte redan står i den katalogen): ```bash cd first-contributions ``` Nu skapar du en branch genom att använda kommandot `git checkout`: ```bash git checkout -b ``` Till exempel: ```bash git checkout -b mitt-tillag ``` ## Gör de ändringar du vill göra och commita dem Nu öppnar du `Contributors.md` i en text-editor och lägger till ditt namn. Lägg inte till något i början eller slutet av dokumentet utan lägg till någonstans mitt emellan. Spara filen. Visa git-status Mata in kommandot `git status` i projektkatalogen för att se de ändringar du gjort. Lägg till dina ändringar genom att använda kommando `git add`: ```bash git add Contributors.md ``` Commita dina ändringar genom att använda `git commit`: ```bash git commit -m "Add to Contributors list" ``` ersätt `` med ditt namn. ## Pusha ändringar till GitHub Pusha dina ändringar genom att använda kommando `git push`: ```bash git push origin ``` ersätt `` med det branch-namn du använt tidigare. ## Skicka iväg dina ändringar för granskning Om du navigerar till ditt repo på GitHub kan du se en knapp med texten `Compare & pull request`. Klicka på den. Skapa en pull request Skicka iväg din s.k. pull request. Skicka in pull request Snart kommer jag införa dina ändringar i huvudprojektet. Du kommer att få ett e-mail så fort dina ändringar blivit införda. ## Hur går man vidare? Gratulerar! Du har just genomfört standardprocessen för _fork -> clone -> edit -> PR_, en process du kommer att stöta på ofta! Fira genom att dela med dina vänner och följare genom att gå till [web app](https://firstcontributions.github.io/#social-share). Behöver du hjälp eller vill du bidra till projektet? eller kolla in våra [Code Contributions](https://github.com/roshanjossey/code-contributions). Nu kan du gå vidare genom att bidra i andra projekt. Vi har sammanställt en lista med enkla uppgifter som du kan starta med. Kolla in [projektlistan i webbapplikationen](https://firstcontributions.github.io/#project-list). ### [Ytterligare material](../additional-material/git_workflow_scenarios/additional-material.md) ## Handledningar för andra verktyg | GitHub Desktop-appen | Visual Studio 2017 | GitKraken-programmet | VS Code VS Code-redigeraren | VS Code-redigeraren Sourcetree App Sourcetree-appen | IntelliJ IDEA-programmet | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.si.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # පළමු දායකත්වය (First Contribution) මේ project එකේ අරමුණ, open-source වලට අලුත් අයට, ඒ අයගේ පළමු දායකත්වය (contribution) ලබාදෙන එක සරල කරලා, ඒකට මග පෙන්වීමක් ලබා දෙන එකයි. ඔයත් ඔයාගේ පළමු contribution එක කරන්න බලාගෙන ඉන්නවා නම්, මේ පියවර අනුගමනය කරන්න. #### _Command line (terminal) එක භාවිතා කරලා මේ දේවල් කරන එක අමාරුයි වගේ නම්, [GUI මෙවලම් පාවිච්චි කරන මේ tutorials බලන්න.](#වෙනත්-මෙවලම්-සඳහා-වන-මාර්ගෝපදේශ)_ **සටහන:** ඔයාගේ computer එකේ git install කරලා නැත්නම්, මුලින්ම [මේ link එකෙන් ගිහින් install කරගන්න](https://docs.github.com/en/get-started/quickstart/set-up-git). ## 1. මේ Repository එක Fork කරගන්න මෙම repository එක fork කරන්න මේ පිටුවේ උඩ දකුණු පැත්තේ තියෙන 'Fork' button එක click කරන්න. එතකොට මේ repository එකේ copy එකක් ඔයාගේ GitHub ගිණුමේ හැදෙයි. ## 2. Fork කරගත්තු Repository එක Clone කරගන්න මෙම repository එක clone කරන්න දැන් ඔයා fork කරගත්ත repository එක ඔයාගේ computer එකට clone කරගන්න ඕන. ඒකට, ඔයාගේ GitHub ගිණුමට යන්න. Fork කරගත්ත repository එක open කරලා, 'Code' button එක click කරලා, එන URL එක copy කරගන්න. දැන් ඔබේ පරිගණකට fork කරපු repository ය ක්ලෝන කරන්න. ඔබට ඔබගේ GitHub ගිණුමට ගොස් fork කරපු repository විවෘත කර code බොත්තම ක්ලික් කර,පසුව SSH ටැබය මත ක්ලික් කිරීමෙන් ලැබෙන url එක පසුරු පුවරුවට (clipboard) පිටපත් කිරීමෙන් මෙය කළ හැක. දැන් ඔයාගේ computer එකේ terminal (command prompt) එක open කරලා, මේ git command එක run කරන්න: ```bash git clone "ඔයා දැන් copy කරගත්තු url එක" ``` "ඔයා දැන් copy කරගත්තු url එක" කියන තැනට (කමාන්ඩ් එකේදී උඩු කොමා දාන්නේ නැතුව) ඔයාගේ forked repository එකේ URL එක දාන්න. උදාහරණයක් විදියට: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` `this-is-you` කියන තැනට ඔයාගේ GitHub username එක එන්න ඕන. මේ command එකෙන් කරන්නේ, _first-contributions repository_ එකේ අන්තර්ගතය ඔයාගේ computer එකට copy කරන එකයි. ## 3. අලුත් Branch එකක් හදන්න Terminal එකේ ඉඳන් ඔයා දැන් clone කරගත්ත repository එකේ folder එකට යන්න (ඔයා දැනටමත් ඒක ඇතුලේ නෙවෙයි නම්): ```bash cd first-contributions ``` දැන්, ඔයාගේ වෙනස්කම් ටික කරන්න අලුත් branch එකක් හදන්න `git switch` command එක run කරන්න: ```bash git switch -c ඔයාගේ-අලුත්-branch-එකේ-නම ``` උදාහරණයක් විදියට: ```bash git switch -c add-kasun-perera ```
git switch භාවිතා කරන විට error එකක් ආවොත්, මෙතන click කරන්න: "Git: `switch` is not a git command. See `git –help`" වගේ error පණිවිඩයක් ආවොත්, ඒකට හේතුව වෙන්න පුළුවන් ඔයා git වල පරණ version එකක් use කරන එක. ඒ වගේ වෙලාවක, `git switch` වෙනුවට `git checkout` command එක use කරලා බලන්න: ```bash git checkout -b your-new-branch-name ```
_(Branch එකේ නමට `add-` වගේ කෑල්ලක් එකතු කරන එක අනිවාර්ය නැහැ. ඒත්, අපි මේ branch එකෙන් කරන්නේ නමක් එකතු කරන එක නිසා, ඒ වගේ නමක් දාන එක හොඳ පුරුද්දක්.)_ ## 4. අවශ්‍ය වෙනස්කම් කරලා Commit කරන්න git status විධානය දැන් `Contributors.md` file එක ඔයා කැමති text editor එකකින් (උදා: VS Code, Notepad) open කරලා, ඔයාගේ නම ඒකට එකතු කරන්න. File එකේ මුලටම හරි අගටම හරි නම දාන්න එපා. මැද හරියට කොතනට හරි දාන්න. දැන් file එක save කරන්න. ඔයා project folder එකේ terminal එකට ගිහින් `git status` කියලා type කලොත්, ඔයා කරපු වෙනස්කම් ටික පෙන්නයි. ඒ වෙනස්කම් ටික ඔයා හදපු අලුත් branch එකට add කරන්න `git add` command එක run කරන්න: ```bash git add Contributors.md ``` දැන්, `git commit` command එකෙන් මේ වෙනස්කම් ටික commit කරන්න: ```bash git commit -m "Add your-name to Contributors list" ``` your-name` කියන තැනට ඔයාගේ නම දාන්න. ## 5. වෙනස්කම් ටික GitHub වලට Push කරන්න ඔයා කරපු වෙනස්කම් ටික GitHub එකට push (upload) කරන්න `git push` command එක run කරන්න: ```bash git push -u origin ඔයාගේ-branch-එකේ-නම ``` ඔයාගේ-branch-එකේ-නම` කියන තැනට ඔයා කලින් හදපු branch එකේ නම දාන්න. ## 6. ඔයාගේ වෙනස්කම් Pull Request එකක් ලෙස යවන්න pull request එකක් හදන්න ඔයාගේ GitHub ගිණුමේ තියෙන repository එකට ගියාම, ඔයාට `'Compare & pull request'` කියලා button එකක් පෙනෙයි. ඒක click කරන්න. pull request එක submit කරන්න දැන් ඔයාගේ pull request එක submit කරන්න. ඉක්මනින්ම මම ඔයාගේ වෙනස්කම් ටික මේ project එකේ ප්‍රධාන (main) branch එකට merge කරන්නම්. ඒක merge කරාට පස්සේ ඔයාට notification email එකක් එයි. ## මෙතැන් සිට කොහේ යන්නද? සුභ පැතුම්! Open-source contributor කෙනෙක් විදියට ඔයා නිතරම භාවිතා කරන **fork -> clone -> edit -> pull request** කියන සම්පූර්ණ ක්‍රියාවලියම ඔයා දැන් සාර්ථකව අවසන් කරලා තියෙන්නේ! ඔයාගේ මේ පළමු දායකත්වය සමරන්න, ඒ වගේම යාළුවොත් එක්ක share කරගන්න [web app](https://firstcontributions.github.io/#social-share) එකට යන්න. තවත් පුහුණුවක් ලබන්න කැමති නම්, [code contributions](https://github.com/roshanjossey/code-contributions) බලන්න. දැන් ඔයාට වෙනත් projects වලටත් contribute කරන්න පටන්ගන්න උදව් කරමු. අපි ඔයාට පටන් ගන්නම ලේසි issues (ගැටළු) තියෙන projects ලැයිස්තුවක් හදලා තියෙනවා. [Web app එකෙන් ඒ projects ලැයිස්තුව බලන්න](https://firstcontributions.github.io/#project-list). ### [අතිරේක සම්පත්](../additional-material/git_workflow_scenarios/additional-material.md) ## වෙනත් මෙවලම් සඳහා වන මාර්ගෝපදේශ | GitHub Desktop යෙදුම | Visual Studio 2017 | GitKraken මෘදුකාංගය | VS Code සංස්කාරකය | Sourcetree යෙදුම | IntelliJ IDEA මෘදුකාංගය | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.sindhi.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # پهريون تعاون اهو ڏکيو آهي. اهو هميشه مشڪل آهي پهريون دفعو توهان ڪجهه ڪيو خاص طور تي جڏهن توهان تعاون ڪري رهيا آهيو ، غلطيون ڪرڻ هڪ آرام واري شيءِ نه آهي. اسان پهريون طريقو کولڻ چاهيون ٿا نئون کليل ذريعو مددگار سکن ٿا ۽ پهريون ڀيرو حصو وٺن ٿا. پڙهائي آرٽيڪل ۽ ڏسڻ وارا سبق مدد ڪري سگھن ٿا ، پر اصل ۾ عملي ماحول ۾ شيون ڪرڻ سان سٺو ڇا آهي؟ ھن پروجيڪٽ جو مقصد مقصد مهيا ڪرڻ ۽ آسانيون جوڙيندڙن کي پنھنجي ابتدائي مدد ڪرڻ جو طريقو آھي. جيڪڏھن توھان پنھنجو پھريون حصو بڻائڻ جي ڪوشش ڪري رھيا آھيو ، ھيٺين قدمن تي عمل ڪريو. ### جيڪڏهن توهان ڪمانڊ لائن سان مطمئن نه آهيو ، [هتي GUI ٽولز استعمال ڪرڻ وارا سبق آهن.] (# سبق استعمال ڪندڙ-ٻئي اوزار) _ #### _ ھن [ٻين ٻولين ۾] پڙھو (ترجما / ترجما. ايم ڊي) ._ ھن ريزاپوزيٽري کي فورڪ ڪيو #### جيڪڏهن توهان کي پنهنجي مشين تي گٽ نه آهي ، ته [انسٽال ڪريو] (https://help.github.com/articles/set-up-git/). ## هن مخزن کي سنڀاليو هن صفحي جي مٿئين حصي تي فورڪ بٽن تي ڪلڪ ڪري هن مخزن کي دٻايو. اهو توهان جي اڪائونٽ ۾ هن مخزن جي ڪاپي ٺاهي ڏيندو. ## مخزن کي کلون ھن ريزاپوزيٽري کي ڪلون ڪيو هاڻي ڪلون محفوظ ڪيل مخزن کي توهان جي مشين ڏانهن پهچايو. پنھنجي GitHub اڪائونٽ ڏانھن وڃو ، فورڪ ٿيل مخزن کي کوليو ، ڪوڊ واري بٽڻ تي ڪلڪ ڪريو ۽ پوءِ _ ڪپي ڪلپ بورڊ جي آئڪن تي ڪلڪ ڪريو. هڪ ٽرمينل کوليو ۽ هيٺيان گٽ ڪمانڊ هلايو. " گٽ کلون ”يو آر ايل توهان ڪاپي ئي ڪئي آهي“ " جتي "صرف توهان يوپي ايل ڪاپي ڪئي آهي" (ڪڻڪ جي نشانين کانسواءِ) هن ريزنزوري ڏانهن يو آر ايل (هن پراجيڪٽ جي ڪانٽ). يو آر ايل حاصل ڪرڻ لاءِ پوئين قدم ڏسو. URL کي ڪلپ بورڊ ۾ نقل ڪيو مثال طور: " گٽ کلون https://github.com/this-is-you/first-contactions.git " جتي-هي-تون-توهان جو آهي توهان جو GitHub صارف نالو هتي توهان پنهنجي ڪمپيوٽر ڏانهن GitHub تي سڀ کان پهرين شراڪت جي مخزن جو مواد نقل ڪري رهيا آهيو. ## هڪ شاخ ٺاهيو توهان جي ڪمپيوٽر تي مخزن ڊاريڪٽري ۾ تبديل ڪريو (جيڪڏهن توهان پهريان ئي نه آهيو) " سي ڊي پهرين تعاون " ھاڻي شاخ ٺاھيو حڪم "گٽ چيڪ آئوٽ" استعمال ڪندي. " ڏسي چڪاس ڪريو -آب نئون-شاخ-نالو " مثال طور: " گٽ چيڪ آئوٽ -b شامل الونزو-چرچ " (شاخ جو نالو _add_ لفظ شامل ڪرڻ جي ضرورت ناهي ، پر ان ۾ شامل ٿيڻ مناسب ڳالهه آهي ڇاڪاڻ ته هن برانچ جو مقصد توهان جي نالي کي لسٽ ۾ شامل ڪرڻ آهي.) ## ضروري تبديليون ڪيو ۽ انهن تبديلين کي انجام ڏيو ھاڻي ٽيڪسٽ ايڊيٽر ۾ Contributors.md فائل کوليو ، پنھنجو نالو ان ۾ شامل ڪريو. فائل جي شروعات يا آخر ۾ ان کي شامل نه ڪريو. ان کي وچ ۾ ڪٿي به وجھو. ھاڻي ، فائل کي بچايو. گِٽ جي حالت جيڪڏهن توهان پروجيڪٽ ڊاريڪٽري ڏانهن وڃو ۽ حڪم کي ختم ڪريو گٽ اسٽيٽس ، توهان ڏسندا ته هتي تبديليون آهن. جن شاخن کي توھان ٺاھيو آھي انھن کي شامل ڪريو جيڪي تبديلي آڻي سگھوٿا " git شامل ڪريو Contributors.md " ھاڻي انھن تبديلين کي انجام ڏيو "گٽ ڪمٽ" حڪم استعمال ڪندي: " git commit -m "شرڪت ڪندڙن جي لسٽ ۾ <توھان جو نالو شامل ڪريو" " توهان جي نالي سان "توهان جو نالو" بدلجي ٿو. ## گٽ هب ۾ پش تبديلين پنھنجن تبديلين کي ھٿ سان ڌڪايو "گشت پش": " گٽ پش اصل " توهان جي ٺاهي ڪيل شاخ جي نالي سان "کي تبديل ڪرڻ ## پنھنجون تبديليون راءِ لاءِ پيش ڪريو جيڪڏهن توهان GitHub تي پنهنجي مخزن ڏانهن ويندا آهيو ، توهان ڏسندا "تقابلي ۽ پلڻ واري درخواست" بٽڻ. انهي بٽڻ تي ڪلڪ ڪيو. ھڪ پل رِڪوئسٽ ٺاهيو هاڻي پل جي درخواست جمع ڪر. پل رِڪوئسٽ جمع ڪرائيو جلد ئي آئون توهان جي سڀني تبديلين کي ان منصوبي جي ماسٽر برانچ ۾ ضم ڪري ڇڏيندس. توهان جون هڪ ڀيرو اطلاع ملڻ واري اي ميل حاصل ٿيندي هڪ ڀيرو تبديليون ضم ٿي ويون آهن. ## ڪيڏانهن وڃڻو آهي؟ مبارڪون هجن! توهان صرف معياري _فورڪ -> ڪلون -> ايڊٽ ڪيو -> پل درخواست_ ڪم جي وهڪري کي مڪمل ڪيو جنهن سان توهان اڪثر منهن ڏيڻ ۾ مدد ڪندا! پنهنجي حصي جو جشن ملهايو ۽ ان کي [ويب ايپ] تي وڃڻ سان پنهنجن دوستن ۽ پوئلڳن سان حصيداري ڪريو (https://firstcontactions.github.io/#social-share). هاڻي اچو ته توهان شروع ڪيو ٻين منصوبن ۾ ڀاڙي سان حصو وٺي اسان منصوبن جي هڪ فهرست مرتب ڪئي آهي توهان کي آسان مسئلن تي جيڪي توهان شروع ڪري سگهو ٿا. [ويب ائپ ۾ منصوبن جي فهرست] چيڪ ڪريو (https://firstcontactions.github.io/#project-list). ### [اضافي مواد] (additional-material/git_workflow_scenarios/extra-material.md) ## ٻين اوزارن کي استعمال ڪندي سبق | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.sk.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Prvý príspevok Začiatky sú ťažké, najmä keď robíte niečo po prvýkrát. V prípade, že na niečom spolupracujete, nie je robenie chýb niečo, čo by vám robilo radosť. My by sme radi zjednodušili cestu novým prispievateľom do open-source pri ich učení sa ako na to. Čítanie článkov alebo zhliadnutie video návodov sú tiež cesty, ale čo je lepšie ako si danú vec priamo ohmatať na vlastnej koži v reálnom prostredí? Tento projekt je zameraný na poskytnutie pomoci začiatočníkom s ich prvým prispením do open-source. Ak ste ním práve vy, nasledujte kroky popísané nižšie. #### *Ak nemáte radi príkazový riadok, [tu nájdete návody na použitie nástrojov s GUI (grafické užívateľské rozhranie)](#Návod-za-použitie-ďalších-nástrojov)* forknite tento repozitár Ak máte nainštalovaný git, [nainštalujte si ho]( https://help.github.com/articles/set-up-git/). ## Forknite tento repozitár Forknite (vytvorenie kópie z originálu, z anglického *fork* - *vidlička*, ako vytvorenie novej odnože) tento repozitár kliknutím na tlačidlo **Fork** hore na tejto stránke. Tým vytvoríte kópiu tohto repozitára na svojom vlastnom GitHib účte. ## Naklonujte repozitár naklonujte tento repozitár Teraz naklonujte (anglicky *clone*) forknutý repozitár na váš počítač, naklonovanie nie je nič iné ako stiahnutie obrazu repozitára k vám na počítač. Na vašom GitHub účte si otvoríte forknutý repozitár, kliknite na tlačidlo **Clone or download** a následne v okienku, ktoré sa objaví, kliknite na tlačidlo s ikonkou **copy to clipboard** vedľa URL adresy, čím si ju skopírujete do schránky. Teraz otvorte terminál a spustite nasledujúci príkaz: ````bash git clone "url ktoré ste práve skopírovali" ```` skopírujte adresu do schránky Napríklad: ````bash git clone https://github.com/vas-username/first-contributions.git ```` Týmto na svojom počítači vytvoríte priečinok so súbormi daného repozitára. ## Vytvorte vetvu V príkazovom riadku sa prepnite do zložky s repozitárom (ak v nej už nie ste) ````bash cd first-contributions ```` Teraz vytvorte novú vetvu (anglicky *branch*) za použitia príkazu `git checkout`: ````bash git checkout -b ```` Napríklad: ````bash git checkout -b pridanie-mojho-mena ```` Meno vetvy by malo vypovedať o tom, čo kód alebo čokoľvek iné do nej pridané bude robiť/vykonávať, prípadne prečo sa daná vec deje. ## Urobte zmeny a zaznamenajte ich Otvorte súbor `Contributors.md` v textovom editore a pridajte do neho svoje meno. Napíšte ho niekam doprostred a súbor uložte. git status Pokiaľ teraz v príkazovom riadku spustíte príkaz `git status`, uvidíte aké zmeny boli v repozitári vykonané. Tieto zmeny do danej vetvy pridáte príkazom `git add`: ````bash git add Contributors.md ```` Zostáva už len potvrdiť (anglicky *commit*) zmeny príkazom `git commit`: ````bash git commit -m "Add to Contributors list" ```` Za prepínač `-m` sa píše čo dané zmeny predstavujú, popis by mal byť jednoduchý ale výstižný. ## Pretlačte zmeny na GitHub Teraz zmeny vykonané lokálne na počítači pretlačíme (anglicky *push*) na GitHub príkazom `git push`: ````bash git push origin ```` ## Predložte svoje zmeny na posúdenie Pokiaľ sa teraz pozriete do svojho GitHub repozitára, uvidíte tlačidlo **Compare & pull request**. Kliknite naň. vytvorte pull request Teraz vytvorte žiadosť o pretiahnutie vašej vetvy do originálneho repozitára (anglicky *pull request*). potvrďte pull request Čoskoro budú správcovia vykonávať zapracovanie vašich zmien do hlavnej (anglicky *master*) vetvy tohto projektu. Až sa do nej vaše zmeny dostanú, dostanete emailové upozornenie. ## Kam ďalej? Blahoželáme! Práve ste dokončili štandardný _fork -> clone -> edit ->_ priebeh práce (anglicky *workflow), s ktorým sa ako prispievateľ do projektov stretnete dennodenne. Oslávte svoj prvý príspevok so svojimi priateľmi a nasledovníkmi cez [webovú aplikáciu](https://firstcontributions.github.io/#social-share). Teraz vám už nič nebráni v prispievaní do ostatných projektov. Pripravili sme pre vás zoznam projektov, ktoré majú jednoduché záležitosti na vyriešenie/naprogramovanie, s ktorými môžete začať. Pozrite sa [tu](https://firstcontributions.github.io/#project-list). ### [Ďalšie materiály](../additional-material/git_workflow_scenarios/additional-material.md) ## Návod za použitia ďalších nástrojov |Aplikácia GitHub Desktop|Visual Studio 2017|Program GitKraken|Editor VS Code| |---|---|---|---| |[GitHub Desktop](../github-desktop-tutorial.md)|[Visual Studio 2017](../github-windows-vs2017-tutorial.md)|[GitKraken](../gitkraken-tutorial.md )|[Visual Studio Code](../github-windows-vs-code-tutorial.md)| ================================================ FILE: docs/translations/README.sl.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Prvi prispevek Vsak začetek je težak. Ko sodeluješ z drugimi, so napake še veliko bolj neprijetne. Zato smo se odločili, da novincem olajšamo prispevanje k odprti kodi (ang. Open source). Branje člankov in sledenje vodičem lahko pomaga, vendar je še vedno najbolje da nove veščine vadimo sami v varnem okolju. Namen tega projekta je da novince vodi in jim olajša prvi prispevek k odprti kodi. Če želite narediti prvi prispevek, sledite spodnjim korakom. Angleški izrazi so v oklepajih, da dodajo kontekst vsebini. #### *Če se ne počutite dobro v ukazni vrstici (ang. command line), so tukaj [navodila za uporabo orodij z grafičnim vmesnikom.]( #vodiči-za-uporabo-drugih-orodij )* razvej tega repozitorij Če na svojem računalniku še nimaš "git", si ga [naloži]( https://help.github.com/articles/set-up-git/). ## Ustvari svojo različico repository-ja ( Fork this repository ) S pritiskom na gumb "Fork" na vrhu te strani, ustvari svojo različico repositorya ( pogosto skrajšano v "repo" ) v svojem GitHub računu. ## Kloniraj ta repository ( Clone the repository ) skloniraj ta repozitorij Sedaj kloniraj ta repository na svoj računalnik. Pojdi v svoj GitHub račun in poišči svojo različico tega repositorya, klikni na gumb "Clone or download" in si kopiraj povezavo. Lahko uporabiš "Ctrl+C" ali pa klikni na ikono na desni strani povezave *copy to clipboard*. Odpri terminal in se postavi v direktorij, v katerem želiš imeti svojo kopijo repositorya. Nato zaženi naslednji ukaz: ```bash git clone "url naslov, ki si ga ravno skopiral" ``` "url naslov, ki si ga ravno skopiral" (brez navednic) je naslov, ki si ga skopiral na Githubu ( naslov tvoje različice projekta ). Glej prejšne korake da dobiš url naslov. kopiraj URL v odložišče Primer: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` `this-is-you` je tvoje GitHub uporabniško ime. Ta ukaz skopira vsebino repositorya "first-contributions" z GitHuba v tvoj računalnik. ## Ustvari vejo ( Create a branch ) Prestavi se v direktorij repositorya na svojem računalniku (če še nisi v njem): ```bash cd first-contributions ``` Sedaj ustvari vejo z uporabo ukaza `git checkout`: ```bash git checkout -b ``` Primer: ```bash git checkout -b add-janez-novak ``` (Ni potrebno da je v imenu veje *add*, vendar je v tem primeru smiselno, ker je namen veje da dodaš svoje ime na seznam.) ## Naredi spremembe in izvedi commmit teh sprememb ( Make necessary changes and commit those changes ) Odpri datoteko `Contributors.md` v urejevalniku besedila in dodaj svoje ime. Ne dodajaj ga na začetek ali konec datoteke, dodaj ga nekje vmes. Shrani datoteko. stanje gita Če se postaviš v direktorij projekta in izvedeš ukaz `git status`, vidiš da obstajajo spremembe v projektu. Dodaj te spremembe veji, ki si jo ravno ustvaril, z ukazom `git add`: ```bash git add Contributors.md ``` Sedaj izvedi commit teh sprememb z ukazom `git commit`: ```bash git commit -m "Add to Contributors list" ``` Zamenjaj `` s svojim imenom. Tekst med navednicami je komentar spremembe, ki se shrani s spremembo. ## Pošlji spremembe na GitHub ( Push changes to GitHub ) Pošlji svoje spremembe z ukazom `git push`: ```bash git push origin ``` Zamenjaj `` z imenom veje, ki si jo ustvaril. ## Vloži svoje spremembe v pregled ( Submit your changes for review ) Če preveriš svoj repository na GitHubu, vidiš gumb `Compare & pull request`. Klikni na ta gumb. ustvari pull request Sedaj izvedi submit svojega pull requesta. pošlji pull request Kmalu bom združil tvoje spremembe v master vejo tega projekta. V svoj e-poštni nabiralnik boš dobil sporočilo, da so bile spremembe združene. ## Kako nadaljevati? ( Where to go from here? ) Čestitke! Pravkar si končal običajni _fork -> clone -> edit -> PR_ potek dela, ki ga boš srečal kot sodelavec v odprto kodnih projektih! Sedaj lahko začneš prispevati drugim projektom. Sestavili smo seznam projektov z enostavnimi problemi (issues), ki jih lahko začneš reševati. Preveri [seznam projektov v spletni aplikaciji](https://firstcontributions.github.io/#project-list). ### [Dodatne informacije](../additional-material/translations/Slovenian/additional-material.sl.md) ## Vodiči za uporabo drugih orodij | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.slk.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Prvé príspevky Je to ťažké. Je to vždy ťažké, keď niečo robíš prvýkrát. Najmä vtedy, keď spolupracuješ, robiť chyby nie je pohodlná vec. Chceli sme zjednodušiť spôsob, akým sa noví prispievatelia do open source učia a prispievajú prvýkrát. Čítanie článkov a sledovanie tutoriálov môže pomôcť, ale čo je lepšie, ako skutočne robiť veci v skúšobnom prostredí? Cieľom tohto projektu je poskytnúť usmernenie a zjednodušiť spôsob, akým prvýkrát prispievajú začiatočníci. Ak máš záujem o prvý príspevok, postupuj podľa nižšie uvedených krokov. #### *Ak sa ti nedarí s príkazovým riadkom, [tu sú návody s nástrojmi grafického rozhrania.]( #návody-pomocou-iných-nástrojov )* vytvoriť vetvu tohto repozitára Ak nemáš na svojom počítači git, [nainštaluj ho]( https://help.github.com/articles/set-up-git/). ## Skopíruj toto úložisko Skopíruj toto úložisko kliknutím na tlačidlo vidlice(fork) v hornej časti tejto stránky. Tým sa vytvorí kópia tohto úložiska na tvojom účte. ## Stiahni toto úložisko skopírovať tento repozitár Teraz stiahni toto úložisko do tvojho zariadenia. Prejdi do tvojho účtu GitHub, otvor skopírované úložisko, klikni na tlačidlo klonovania a potom klikni na ikonu * kopírovať do schránky *. Otvor terminál a spusti nasledujúci git príkaz: ```bash git clone "adresa, ktorú si práve skopíroval" ``` kde "adresa ktorú si práve skopíroval" (bez úvodzoviek) je adresa URL tohto úložiska (tvoja kópia tohto projektu). Pozri si predchádzajúce kroky na získanie adresy URL. skopírovať URL do schránky Napríklad: ```bash git clone https://github.com/toto-si-ty/prve-prispevky.git ``` kde `toto-si-ty` je tvoje GitHub užívateľské meno. Tu skopíruješ obsah GitHub úložiska prve-prispevky do tvojho počítača. ## Vytvor vetvu Prejdi do adresára úložiska v tvojom počítači (ak ešte nie si tam): ```bash cd prve-prispevky ``` Teraz vytvor vetvu pomocou príkazu `git checkout`: ```bash git checkout -b ``` Napríklad: ```bash git checkout -b pridaj-ferko-mrkvicka ``` (Názov pobočky nemusí obsahovať slovo * pridaj *, ale je rozumné pridať ho, pretože účelom tejto pobočky je pridať tvoje meno do zoznamu.) ## Vykonaj potrebné zmeny a potvrď tieto zmeny Teraz otvor súbor `Contributors.md` v textovom editore a pridaj do neho svoje meno. Nepridávaj ho na začiatok alebo na koniec súboru. Daj ho kdekoľvek medzi tým. Teraz súbor ulož. stav gitu Ak prejdeš do adresára projektu a vykonáš príkaz `git status`, uvidíš zmeny. Pridaj tieto zmeny do vetvy, ktorú si práve vytvoril, pomocou príkazu `git add`: ```bash git add Contributors.md ``` Teraz vykonaj tieto zmeny pomocou príkazu `git commit`: ```bash git commit -m "Pridaj do zoznamu pripievateľov" ``` nahraď `` tvojim menon. ## Nahraj zmeny na GitHub Nahraj svoje zmeny pomocou príkazu `git push`: ```bash git push origin ``` nahraď `` názvom vetvy, ktorú si vytvoril skôr. ## Odošli svoje zmeny na kontrolu Ak prejdeš do tvojho úložiska v službe GitHub, zobrazí sa tlačidlo `Compare & pull request`. Klikni na toto tlačidlo. vytvoriť pull request Teraz predlož požiadavku na vytiahnutie. odoslať pull request Čoskoro budem zlučovat všetky vaše zmeny do hlavnej pobočky tohto projektu. Po zlúčení zmien dostaneš upozornenie. ## Kam ísť odtiaľto? Gratulujem! Práve si dokončil štandardný _fork -> klon -> upraviť -> PR_ pracovný postup, ktorý sa často stretneš ako prispievateľ! Osláv svoj príspevok a zdieľaj ho so svojimi priateľmi a nasledníkmi [web app](https://firstcontributions.github.io/#social-share). Môžeš sa pripojiť k nášmu slack tímu v prípade, že potrebuješ nejakú pomoc alebo máš nejaké otázky. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). Teraz začni s účasťou na iných projektoch. Vytvorili sme zoznam projektov s jednoduchými problémami, s ktorými môžeš začať. Pozri [zoznam projektov vo webovej aplikácii](https://firstcontributions.github.io/#project-list). ### [Dodatočný materiál](../additional-material/git_workflow_scenarios/additional-material.md) ## Návody pomocou iných nástrojov | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.so.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Wax ku biirinta kowaad Mashruucan ujeedadiisu waxey tahay in la fududeyo iyo in la hago kuwa bilawga ah si ay usameyan wax ku biirintooda kowaad "First contribution". Hadii aad raadinayso sida aad usameyn laheyd wax ku biirintaada kowaad, talaabooyinkan soo socda raac. Sawir muujinaya badhanka fork ee kaydkan #### Haddii git uusan kuugu jirrin kombiyuutarkaaga, [Soo dagso](https://docs.github.com/en/get-started/quickstart/set-up-git). ## kala qeybi Kaydkan (Repository) Kala qeybi kaydkan adigoo gujinayo badhanka kore ee page-ka kuna qoran "Fork". Tani waxay ciwaankaga kudhax abuuri doontaa koobiga kaydkan ## Koobbi (clone) kaydka Sawir muujinaya sida loo soo dejiyo kaydkan adiga oo clone ka samaynaya Hadda ku koobbi kaydkan kombiyuutarkaaga.Tag Akoonkaaga GitHub, Waxaad furtaa kaydki aad Kala qeybisay, Waxaad gujisa badhanka ku qoran "Code" ka dibna taabo koobiga sumadda sabuuradda. Waxaad furta "Teminal" ka kadib waxad ku qorta amarada git-ka soo socda: ``` git clone "url-ka aad hadda soo koobbiyeysay" ``` Iyadoo "url-ka aad hadda soo koobbiyeysay" (oo aan lahayn calaamadaha xigashada) uu yahay url-ka ama linkiga kaydkaan. waxaad dib usoo eegtaa talaabooyinkii hore si aad u hesho url-ka Sawir muujinaya badhanka lagu koobiyeeyo URL‑ka Tusaale: ``` git clone https://github.com/magaca-isticmalaha/first-contributions.git ``` Halka `magaca-isticmalaha` uu yahay magacaaga aad ku isticmasho Github.Halkan waxa aad kombayutarkaaga ku koobiyaynaysaa waxa ku jira kaydka wax ku biirinta koowaad ee GitHub. ## Abuur laan (branch) Haddii aadan weli ku jirin galka (folder), u gudub halka uu kaaga yaalo galka kombiyuutarkaaga: ``` cd first-contributions ``` Abuur laan cusub adigoo isticmaalaya amarka `git checkout`: ``` git checkout -b ``` Tusaale: ``` git checkout -b kudar-nur-farah-omar ``` Waajib ma ahan inaad ku darto ereyga `kudar` magaca laanta, laakin waxey uyeleysa micno maadama laantaan loo sameeyay in aad magacaada ku darto listiga wax kubiiriyasha. ## Samee isbedelada lagama maarmaanka ah oo gali (commit) Github isbedeladaas Hadda ku fur faylka `Contributors.md` tafatiraha qoraalka, Waa inaad aqoon u leedahay "Markdown", oo ah luqad calaamadeyn ah oo fudud. Fiiri [xaashida qishka](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) si aad u barato sida loo isticmaalo. Ku dar magacaada, Hana ku darin bilowga ama dhamaadka faylka. Kudar meel kasta oo u dhaxaysa. ``` - [Magacaada](https://github.com/magaca-isticmalaha) ``` Tusaale: ``` - [Nur Farah](https://github.com/Nur-farah) ``` Hubi in aysan jirin meelo bannaan oo u dhexeeya `](`. Keydi oo xidh faylka. Sawir shaashad terminal ah oo muujinaysa natiijada amarka git status Haddii aad tagto galka aad fuliso amarka `git status` waxaad arki doonta inay jiraan isbedelo Ku dar isbeddeladaas laanta aad hadda abuurtay adigoo isticmaalaya ammarka `git add`: ``` git add Contributors.md ``` Hadda gali (commit) isbeddeladaas adigoo isticmaalaya amarka `git commit`: ``` git commit -m "Kudar Magacaada listiga wax biirinta kowaad" ``` Adigoo `Magacaada` ku badalayo magacaada shaqsiga. (N.B: Waxaad ku qori kartaa fariinta xaqiijinta Ingiriisi maadaama aad la shaqayn doonto dad ka kala yimid meelo kala duwan oo adduunka ah.) ## Ku riix isbedelada GitHub Riix isbedeladaada adigoo isticmaalaya amarka `git push`: ``` git push -u origin magaca-laantaada ``` Adigoo `magaca-laantaada` ku badalaya magaca laanta aad hore u abuurtay.
Haddii aad wax qalad ah aad aragto markaad riixayso, guji halkan: - ### Cilad Xaqiijin 
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//first-contributions.git/'
Tag [casharrada GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ee ku saabsan abuuritaanka iyo habaynta furaha SSH ee akoonkaaga
## Soo gudbi isbeddelladaada si dib loogu eego Haddii aad tagto kaydkaaga GitHub,waxaad arki doontaa badhanka `Compare & pull request`. Badhankaas guji. Sawir muujinaya bogga GitHub ee la adeegsanayo si loo abuuro pull request cusub Hadda soo gudbi codsiga jiidista (pull request). Sawir muujinaya badhanka lagu gudbiyo pull request‑ka Dhawaan waxaan ku dari doonaa dhammaan isbeddelladaada laanta ugu weyn ee mashruucan (master). Waxaad heli doontaa iimayl ogeysiin ah marka isbeddelada la isku daro. ## Halkee laga aadaa halkan? Hambalyo! Waxaad hadda dhamaystirtay heerka caadiga ah ee kalaqaybinta(fork) -> koobbi-ga (clone) -> wax kabedelka -> codsiga jiidista habka shaqada oo aad inta badan la kulmi doonto ka qaybqaate ahaan! U dabaaldeg wax ku biirintaada oo la wadaag asxaabtaada iyo kuwa ku raacsan adiga oo aadaya [abka shabakada](https://firstcontributions.github.io/#social-share). Haddii aad rabto tababar dheeraad ah, eeg [code contributions](https://github.com/roshanjossey/code-contributions). Hadda aan kuu bilowno ka qayb qaadashada mashaariicda kale. Waxaan soo diyaarinay liis mashruucyo ah oo leh qaladaad sahlan oo aad ku bilaabi karto. Fiiri [liiska mashaariicda ku jira abka shabakada](https://firstcontributions.github.io/#project-list). ### [Waxyaabo dheeraad ah](additional-material/git_workflow_scenarios/additional-material.md) ## Casharrada Isticmaalka Aalado Kale | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.sr-Cyrl.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) #### _Прочитај ово на [другим језицима](Translations.md)._ [Shqip](README.al.md) [Armenian](README.arm.md) [Uzbek language](README.uz.md) [Azərbaycan dili](README.aze.md) [বাংলা](README.bn.md) [Bulgarian](README.bg.md) [Português (Brasil)](README.pt_br.md) [Català](README.ca.md) [中文 (Simplified)](README.zh-cn.md) [Czech](README.cs.md) [Deutsch](README.de.md) [Dansk](README.da.md) [المصرية](README.eg.md) [Dezéiriya](README.dz.md) [Español de España](README.es.md) [Française](README.fr.md) [Gaeilge](README.ga.md) [Galego](README.gl.md) [Ελληνικά](README.gr.md) [ქართული](README.ge.md) [Magyar](README.hu.md) [Bahasa Indonesia](README.id.md) [עִברִית](README.hb.md) [हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்](docs/translations/Translations.md) [தமிழ்](README.ta.md) [فارسی](README.fa.md) [Italiano](README.it.md) [日本語](README.ja.md) [සිංහල](README.si.md) [Kiswahili (Kenya)](README.kws.md) [한국어](README.ko.md) [Lietuvių kalba](README.lt.md) [Limba Română Limba Română](README.ro.md) [မြန်မာ](README.mm_unicode.md) [Македонски](README.mk.md) [Español de México](README.mx.md) [Bahasa Melayu / بهاس ملايو‎ / Malay](README.my.md) [Dutch](README.nl.md) [Norsk](README.no.md) [नेपाली](README.np.md) [Wikang Filipino](README.fil.md) [English (Pirate)](README.en-pirate.md) [اردو](README.ur.md) [Twi (Ghana)](README.gh.md) [Polski](README.pl.md) [Português (Portugal)](README.pt-pt.md) [Русский язык](README.ru.md) [العربية](README.ar.md) [Svenska](README.se.md) [Slovenčina](README.slk.md) [Slovenščina](README.sl.md) [ภาษาไทย](README.th.md) [Türkçe](README.tr.md) [中文(Traditional)](README.zh-tw.md) [Українська](README.ua.md) [Tiếng Việt](README.vn.md) [Swahili language](README.sw.md) [Zulu (South Africa)](README.zul.md) [Afrikaans (South Africa)](README.afk.md) [Igbo (Nigeria)](README.igb.md) [Bambara (Mali)](README.mli.md) [Hausa (Nigeria)](README.hau.md) [Yoruba (Nigeria)](README.yor.md) [Latvia](README.lv.md) [Suomeksi](README.fi.md) [Беларуская мова](README.by.md) [Српски](README.sr-Cyrl.md) [Srpski](README.sr-Latn.md) [Қазақша](README.kz.md) [Bosanski](README.bih.md) [Hrvatski](README.hr.md) [پښتو](README.ps.md) [Somalia](README.so.md) [Ecuador](README.ec.md) [Luganda (Uganda)](README.lug.md) [Turkmen language](README.tm.md) [Ewe (TOGO)](README.ewe.md) [አማርኛ](README.am.md) [Kurdî](README.kr.md) [Malagasy](README.mg.md) [ភាសាខ្មែរ](README.kh.md) [Moroccan Darija](README.ma.md) [Mongolian](docs/translations/README.mn.md) [Tounsi](docs/translations/README.tn.md) # Први допринос (енг. _contribution_) Овај пројекат има за циљ да упути почетнике како да једноставно направе свој први допринос. Ако тражите како да направите свој први допринос, пратите кораке испод. _Ако вам је незгодно да користите командну линију, [ево упутства за GUI алате](#tutorials-using-other-tools)._ fork-уј овај репозиторијум #### Уколико немате git на вашој машини, [инсталирајте га](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Направити fork овог репозиторијума Направите fork овог репозиторијума кликом на fork дугме на врху ове странице. То ће направити копију овог репозиторијума на Вашем налогу. ## Клонирати репозиторијум клонирај овај репозиторијум Сада клонирајте fork-овани репозиторијум на вашу машину. Отворите свој GitHub профил, отворите репозиторијум који сте fork-овали, кликните на дугме code, онда на SSH tab, а онда кликните _copy url to clipboard_ иконицу. Отворите терминал и покрените следећу git команду: ```bash git clone "url you just copied" ``` Уместо "url you just copied" (без наводника) упишите url овог репозиторијума (вашег fork-а овог пројекта). Погледајте претходне кораке да бисте добавили url. копирај URL у clipboard На пример: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` где `this-is-you` представља ваше GitHub корисничко име. Овим копирате садржај first-contributions репозиторијума на GitHub-у на ваш рачунар. ## Направити грану Позиционирајте се у директоријум репозиторијума на Вашем рачунару (ако већ нисте тамо): ```bash cd first-contributions ``` Направите грану употребом `git switch` команде: ```bash git switch -c your-new-branch-name ``` На пример: ```bash git switch -c add-alonzo-church ```
Ако добијате грешке приликом употребе git switch, кликните овде: Ако порука грешке гласи "Git: `switch` is not a git command. See `git –help`", вероватно користите старију верзију git-а. У овом случају, пробајте да користите `git checkout`: ```bash git checkout -b your-new-branch-name ```
## Направите потребне измене и commit-ујте их Отворите `Contributors.md` фајл у текстуалном едитору и додајте своје име. Немојте додавати име на сам почетак или крај. Додајте га негде у средину. Потом сачувајте фајл. git status Уколико одете у директоријум пројекта и извршите команду `git status`, приметићете да постоје измене. Додајте ове измене на грану коју сте управо направили употребом `git add` команде: ```bash git add Contributors.md ``` Сада commit-ујте те измене помоћу `git commit` команде: ```bash git commit -m "Add your-name to Contributors list" ``` замењујући `your-name` са Вашим именом. ## Push-овање измена на GitHub Push-ујте своје измене употребом команде `git push`: ```bash git push -u origin your-branch-name ``` замењујући `your-branch-name` са именом гране коју сте раније направили.
Ако добијате грешке приликом push-овања, кликните овде: - ### Грешка приликом аутентификације 
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//first-contributions.git/'
Погледајте [GitHub-ов туторијал](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) за генерисање и конфигурацију SSH кључа за Ваш налог. Такође, можда ћете желети да извршите 'git remote -v' да бисте проверили Вашу удаљену адресу. Ако личи на ово: 
origin	https://github.com/your-username/your_repo.git (fetch)
  origin	https://github.com/your-username/your_repo.git (push)
извршите ову команду: ```bash git remote set-url origin git@github.com:your-username/your_repo.git ``` У супротном ће Вам се тражити корисничко име и лозинка и добијаћете грешку приликом аутентификације.
## Пошаљите измене на ревизију (енг. _review_) Ако одете на Ваш репозиторијум на GitHub-у, приметићете `Compare & pull request` дугме. Кликните на њега. креирај pull request Сада пошаљите pull request. пошаљи pull request Недуго након тога ћу ја спојити (енг. _merge_) измене које Сте направили са master граном ovog пројекта. Добићете обавештење на email када измене буду спојене. ## Шта даље? Честитамо! Завршили сте стандардни _fork -> clone -> edit -> pull request_ ток развоја (енг. _workflow_) са којим ћете се често сусретати као сарадник! Прославите свој допринос са пријатељима и пратиоцима тако што ћете отићи на овај [сајт](https://firstcontributions.github.io/#social-share). Ако желите још вежбе, погледајте [code contributions](https://github.com/roshanjossey/code-contributions). А сада, хајде да почнете са доприносом на другим пројектима. Направили смо списак пројеката са једноставним проблемима на којима можете почети да радите. Погледајте [списак пројеката на сајту](https://firstcontributions.github.io/#project-list). ### [Додатни материјали](../additional-material/git_workflow_scenarios/additional-material.md) ## Упутства за друге алате | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../../docs/gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../../docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../../docs/gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../../docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../../docs/gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../../docs/gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.sr-Latn.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) #### _Pročitaj ovo na [drugim jezicima](Translations.md)._ [Shqip](README.al.md) [Armenian](README.arm.md) [Uzbek language](README.uz.md) [Azərbaycan dili](README.aze.md) [বাংলা](README.bn.md) [Bulgarian](README.bg.md) [Português (Brasil)](README.pt_br.md) [Català](README.ca.md) [中文 (Simplified)](README.zh-cn.md) [Czech](README.cs.md) [Deutsch](README.de.md) [Dansk](README.da.md) [المصرية](README.eg.md) [Dezéiriya](README.dz.md) [Español de España](README.es.md) [Française](README.fr.md) [Gaeilge](README.ga.md) [Galego](README.gl.md) [Ελληνικά](README.gr.md) [ქართული](README.ge.md) [Magyar](README.hu.md) [Bahasa Indonesia](README.id.md) [עִברִית](README.hb.md) [हिंदी/ગુજરાતી/मराठी/മലയാളം/ಕನ್ನಡ/తెలుగు/छत्तीसगढ़ी/বাংলা/தமிழ்](docs/translations/Translations.md) [தமிழ்](README.ta.md) [فارسی](README.fa.md) [Italiano](README.it.md) [日本語](README.ja.md) [සිංහල](README.si.md) [Kiswahili (Kenya)](README.kws.md) [한국어](README.ko.md) [Lietuvių kalba](README.lt.md) [Limba Română Limba Română](README.ro.md) [မြန်မာ](README.mm_unicode.md) [Makedonski](README.mk.md) [Español de México](README.mx.md) [Bahasa Melayu / بهاس ملايو‎ / Malay](README.my.md) [Dutch](README.nl.md) [Norsk](README.no.md) [नेपाली](README.np.md) [Wikang Filipino](README.fil.md) [English (Pirate)](README.en-pirate.md) [اردو](README.ur.md) [Twi (Ghana)](README.gh.md) [Polski](README.pl.md) [Português (Portugal)](README.pt-pt.md) [Russkiй яzыk](README.ru.md) [العربية](README.ar.md) [Svenska](README.se.md) [Slovenčina](README.slk.md) [Slovenščina](README.sl.md) [ภาษาไทย](README.th.md) [Türkçe](README.tr.md) [中文(Traditional)](README.zh-tw.md) [Ukraїnsьka](README.ua.md) [Tiếng Việt](README.vn.md) [Swahili language](README.sw.md) [Zulu (South Africa)](README.zul.md) [Afrikaans (South Africa)](README.afk.md) [Igbo (Nigeria)](README.igb.md) [Bambara (Mali)](README.mli.md) [Hausa (Nigeria)](README.hau.md) [Yoruba (Nigeria)](README.yor.md) [Latvia](README.lv.md) [Suomeksi](README.fi.md) [Belaruskaя mova](README.by.md) [Српски](README.sr-Cyrl.md) [Srpski](README.sr-Latn.md) [Қazaқša](README.kz.md) [Bosanski](README.bih.md) [Hrvatski](README.hr.md) [پښتو](README.ps.md) [Somalia](README.so.md) [Ecuador](README.ec.md) [Luganda (Uganda)](README.lug.md) [Turkmen language](README.tm.md) [Ewe (TOGO)](README.ewe.md) [አማርኛ](README.am.md) [Kurdî](README.kr.md) [Malagasy](README.mg.md) [ភាសាខ្មែរ](README.kh.md) [Moroccan Darija](README.ma.md) [Mongolian](docs/translations/README.mn.md) [Tounsi](docs/translations/README.tn.md) # Prvi doprinos (eng. _contribution_) Ovaj projekat ima za cilj da uputi početnike kako da jednostavno naprave svoj prvi doprinos. Ako tražite kako da napravite svoj prvi doprinos, pratite korake ispod. _Ako vam je nezgodno da koristite komandnu liniju, [evo uputstva za GUI alate](#tutorials-using-other-tools)._ fork-uj ovaj repozitorijum #### Ukoliko nemate git na vašoj mašini, [instalirajte ga](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Napraviti fork ovog repozitorijuma Napravite fork ovog repozitorijuma klikom na fork dugme na vrhu ove stranice. To će napraviti kopiju ovog repozitorijuma na Vašem nalogu. ## Klonirati repozitorijum kloniraj ovaj repozitorijum Sada klonirajte fork-ovani repozitorijum na vašu mašinu. Otvorite svoj GitHub profil, otvorite repozitorijum koji ste fork-ovali, kliknite na dugme code, onda na SSH tab, a onda kliknite _copy url to clipboard_ ikonicu. Otvorite terminal i pokrenite sledeću git komandu: ```bash git clone "url you just copied" ``` Umesto "url you just copied" (bez navodnika) upišite url ovog repozitorijuma (vašeg fork-a ovog projekta). Pogledajte prethodne korake da biste dobavili url. kopiraj URL u clipboard Na primer: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` gde `this-is-you` predstavlja vaše GitHub korisničko ime. Ovim kopirate sadržaj first-contributions repozitorijuma na GitHub-u na vaš računar. ## Napraviti granu Pozicionirajte se u direktorijum repozitorijuma na Vašem računaru (ako već niste tamo): ```bash cd first-contributions ``` Napravite granu upotrebom `git switch` komande: ```bash git switch -c your-new-branch-name ``` Na primer: ```bash git switch -c add-alonzo-church ```
Ako dobijate greške prilikom upotrebe git switch, kliknite ovde: Ako poruka greške glasi "Git: `switch` is not a git command. See `git –help`", verovatno koristite stariju verziju git-a. U ovom slučaju, probajte da koristite `git checkout`: ```bash git checkout -b your-new-branch-name ```
## Napravite potrebne izmene i commit-ujte ih Otvorite `Contributors.md` fajl u tekstualnom editoru i dodajte svoje ime. Nemojte dodavati ime na sam početak ili kraj. Dodajte ga negde u sredinu. Potom sačuvajte fajl. git status Ukoliko odete u direktorijum projekta i izvršite komandu `git status`, primetićete da postoje izmene. Dodajte ove izmene na granu koju ste upravo napravili upotrebom `git add` komande: ```bash git add Contributors.md ``` Sada commit-ujte te izmene pomoću `git commit` komande: ```bash git commit -m "Add your-name to Contributors list" ``` zamenjujući `your-name` sa Vašim imenom. ## Push-ovanje izmena na GitHub Push-ujte svoje izmene upotrebom komande `git push`: ```bash git push -u origin your-branch-name ``` zamenjujući `your-branch-name` sa imenom grane koju ste ranije napravili.
Ako dobijate greške prilikom push-ovanja, kliknite ovde: - ### Greška prilikom autentifikacije 
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//first-contributions.git/'
Pogledajte [GitHub-ov tutorijal](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) za generisanje i konfiguraciju SSH ključa za Vaš nalog. Takođe, možda ćete želeti da izvršite 'git remote -v' da biste proverili Vašu udaljenu adresu. Ako liči na ovo: 
origin	https://github.com/your-username/your_repo.git (fetch)
  origin	https://github.com/your-username/your_repo.git (push)
izvršite ovu komandu: ```bash git remote set-url origin git@github.com:your-username/your_repo.git ``` U suprotnom će Vam se tražiti korisničko ime i lozinka i dobijaćete grešku prilikom autentifikacije.
## Pošaljite izmene na reviziju (eng. _review_) Ako odete na Vaš repozitorijum na GitHub-u, primetićete `Compare & pull request` dugme. Kliknite na njega. kreiraj pull request Sada pošaljite pull request. pošalji pull request Nedugo nakon toga ću ja spojiti (eng. _merge_) izmene koje Ste napravili sa master granom ovog projekta. Dobićete obaveštenje na email kada izmene budu spojene. ## Šta dalje? Čestitamo! Završili ste standardni _fork -> clone -> edit -> pull request_ tok razvoja (eng. _workflow_) sa kojim ćete se često susretati kao saradnik! Proslavite svoj doprinos sa prijateljima i pratiocima tako što ćete otići na ovaj [sajt](https://firstcontributions.github.io/#social-share). Ako želite još vežbe, pogledajte [code contributions](https://github.com/roshanjossey/code-contributions). A sada, hajde da počnete sa doprinosom na drugim projektima. Napravili smo spisak projekata sa jednostavnim problemima na kojima možete početi da radite. Pogledajte [spisak projekata na sajtu](https://firstcontributions.github.io/#project-list). ### [Dodatni materijali](../additional-material/git_workflow_scenarios/additional-material.md) ## Uputstva za druge alate | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../../docs/gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../../docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../../docs/gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../../docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../../docs/gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../../docs/gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.sw.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Mchango wa Kwanza Ni vigumu. Mara zote ni vigumu kufanya kitu kwa mara ya kwanza. Hasa kama unashirikiana na wengine, kufanya makosa sio jambo la kushangaza. Tulitaka kurahisisha namna ambavyo wachangiaji wapya wa mifumo ya wazi wanavyojifunza na kuchangia kwa mara ya kwanza. Kusoma makala na kuangalia mafunzo ya video yaweza kusaidia, lakini ni jambo lipi bora zaidi kuliko kufanya kwa vitendo katika mazingira ya kujifunzia? Mradi huu unalenga kutoa mwongozo na kurahisisha namna ambavyo wachangiaji wapya wanavyoweza kuchangia kwa mara ya kwanza. Ikiwa unataka kuchangia kwa mara ya kwanza , fuata hatua zifuatazo. #### *Kama haujazoea kutumia 'command line', [waweza kutumia GUI.](#Makala ya namna ya kutumia nyenzo nyingine)* fanya fork ya hazina hii Kama hauna git kwenye kompyuta yako, [pakua](https://help.github.com/articles/set-up-git/). ## Tengeneza nakala ya repository kwenye akaunti yako ya Github 'Fork' repository hii kwa kubonyeza kitufe kilichopo juu ya ukurasa huu Kwa kufanya hivyo nakala ya repository hii itatengenezwa kwenye akaunti yako ya Github. ## Tengeneza nakala ya repository kwenye kompyuta yako clone hazina hii Sasa clone repository kwenye kompyuta yako. Nenda kwenye akaunti yako ya Github bonyeza kitufe kilichoandikwa clone na baada ya hapo bonyeza kitufe kilichoandikwa *copy to clipboard* icon. Fungua terminal >_ kwenye kompyuta yako kisha command ifuatayo: ```bash git clone "url-uliyo-nakili-github" ``` url hiyo inapatikana kwenye hatua ya ku clone, hakikisha unaondoa fungua semi na funga semi. nakili URL kwenda clipboard Kwa mfano: ```bash git clone https://github.com/jina-lako-unalotumia-Github/first-contributions.git ``` Kwa kufanya hivyo utakuwa umenakili first-contributions repository kutoka Github kwenda kwenye kompyuta yako. ## Tengeneza branch: Kwenye kompyuta yako, ukiwa kwenye terminal ingia kwenye repository uliyonakili ```bash cd first-contributions ``` Sasa tengeneza branch kwa kutumia command ifuatayo `git checkout` command: ```bash git checkout -b ``` Kwa mfano: ```bash git checkout -b add-luke-oliff ``` (Jina la branch sio lazima lianze na neno *add*.) ## Fanya mabadiliko na baada ya hapo commit: Sasa fungua faili linaloitwa `Contributors.md`, Andika jina lako. Usiweke jina lako mwanzoni au mwishoni mwa faili. Weka sehemu yoyote katikati. Baada ya hapo save faili. git status Ukiwa ndani ya directory hii kwenye terminal command ya `git status` itakuonesha mabadiliko yote uliyoyafanya. Jumuisha mabadiliko yote uliyoyafanya kwenye branch uliyotengeneza kwa kutumia command `git add` command: ```bash git add Contributors.md ``` Sasa commit mabadiliko uliyoyafanya kwa kutumia command ya `git commit`: ```bash git commit -m "Add to Contributor list" ``` Badilisha neno `` na jina lako. ## Tuma mabadiliko uliyoyafanya kwenda Github Tuma mabadiliko uliyoyafanya kwa kutumia command ya `git push`: ```bash git push origin ``` Badilisha `` na jina la branch ulilotengeneza hapo awali. ## Kusanya mabadiliko uliyoyafanya kwa ajili ya uhakiki Ukiwa Github kwenye repository hii utaona kitufe kilichoandikwa `Compare & pull request`. Bonyeza kitufe hicho. unda pull request Sasa tuma pull request. tuma pull request Haitochukua muda mrefu nitaanza kuchukua mabadiliko yaliyofanyika na kuyapeleka kwenye master branch ya mradi huu. Utapokea email kukujulisha mara tu hatua hii itakapokamilika. ## Nini cha kufanya baada ya hapa? Hongera! Umeweza kumaliza hatua za msingi ambazo ni _fork -> clone -> edit -> PR_ ambazo utakutana nazo mara nyingi ukiwa kama mchangiaji! Sherehekea hatua uliyofikia na wajulishe wengine kwa kwenda kwenye [wavuti](https://roshanjossey.github.io/first-contributions/#social-share). Waweza kujiunga na kundi letu la slack endapo utakuwa unahitaji msaada wowote. [Jiunge na kundi letu la slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). Sasa tuanze kuchangia kwenye miradi mingine. Tumekusanya orodha ya miradi ambayo ina mambo mepesi unayoweza kuanza kushughulika nayo. Angalia [Orodha ya miradi](https://roshanjossey.github.io/first-contributions/#project-list). ### [Nyenzo za ziada](../additional-material/git_workflow_scenarios/additional-material.md) ## Mafunzo ya namna ya kutumia nyenzo nyingine | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.ta.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # முதல் பங்களிப்புகள் நீங்கள் ஏதாவது ஒன்றை முதல் முறை செய்யும் போது அது எப்போதுமே கடினமாக தான் இருக்கும். குறிப்பாக, நீங்கள் குழுவாக சேர்ந்து வேலை செய்யும் போது, தவறு செய்துவிட்டால் அது மிகவும் வருத்தம் அளிக்கக்கூடியதாக இருக்கும். ஆகையால், திறந்த மூல மென்பொருள் (open-source software) பங்களிப்பாளர்களாக எவ்வாறு செயலாற்ற வேண்டும் என்பதையும் அதில் முதல் முறையாக பங்களிப்பு செய்வதை எளிதாக்குவதுமே எங்கள் நோக்கம். கட்டுரைகளைப் படிப்பதும், பயிற்சிகளைப் பார்ப்பதும் உதவக்கூடும், ஆனால் நடைமுறைச் சூழலில் செய்முறையாகச் செய்வதை விட சிறந்தது என்ன? இந்த திட்டம் வழிகாட்டுதல்களை வழங்குவதையும், ஆரம்பநிலை பங்களிப்பாளர்களை அவர்களின் முதல் பங்களிப்பை எளிதாக்குவதையும் நோக்கமாகக் கொண்டுள்ளது. உங்கள் முதல் பங்களிப்பை வழங்க விரும்பினால், கீழே உள்ள வழிமுறைகளை பின்பற்றவும். #### *command line tool உங்களுக்கு வசதியாக இல்லை என்றால், [இங்கே GUI tools ஐ பயன்படுத்தி பயிற்சிகள் உள்ளன.](#பிற-கருவிகளைப்-பயன்படுத்தி-பயிற்சிகள்)* இந்த repository ஐ fork செய்யவும் உங்கள் கணினியில் git இல்லை என்றால், [install செய்யவும்](https://help.github.com/articles/set-up-git/). ## இந்த repository ஐ fork செய்தல் இந்த பக்கத்தின் மேலே உள்ள fork பொத்தானைக் சொடுக்குவதன் மூலம் செயல்படுத்தலாம். இது உங்கள் account இல் ஒரு நகலை உருவாக்கும். ## இந்த repository ஐ clone செய்தல் இந்த repository ஐ clone செய்யவும் இப்போது உங்கள் கணினியில் fork செய்யப்பட்ட repository ஐ clone செய்யவும். உங்கள் GitHub கணக்கிற்குச் சென்று, forked செய்யப்பட்ட repository ஐ திறந்து clone பொத்தானைக் சொடுக்கிய பின் copy to clipboard சொடுக்குவதன் மூலம் நிறைவேற்றலாம். *terminal* அல்லது *command prompt* ஐ திறந்து பின்வரும் git கட்டளையை இயக்கவும்: ```bash git clone "நீங்கள் copy செய்த url" ``` URL ஐ கிளிப்போர்டுக்கு நகலெடுக்கவும் உதாரணத்திற்கு: ``` git clone https://github.com/<உங்கள்-பயனர்பெயர்>/first-contributions.git ``` இங்கு `<உங்கள்-பயனர்பெயர்>` என்பது GitHub username என்பதாகும். இதன் மூலம் நீங்கள் first-contributions repository இன் பிரதி ஒன்றை உங்கள் GitHub கணக்கில் செயட்படுத்துகிறீர்கள். ## கிளையொன்றை உருவாக்குதல் repository directory க்கு செல்லவும் (நீங்கள் ஏற்கனவே அங்கு இல்லையென்றால்): ```bash cd first-contributions ``` இப்போது `git checkout` கட்டளையைப் பயன்படுத்தி ஒரு கிளையை உருவாக்கவும்: ```bash git checkout -b <உங்கள்-கிளையின்-பெயர்> ``` உதாரணத்திற்கு: ```bash git checkout -b உங்கள்-கிளையின்-பெயர் ``` (கிளையின் பெயருக்கு அதில் *add* சேர்க்க வேண்டிய அவசியமில்லை, ஆனால் இது ஒரு நியாயமான விஷயம், ஏனெனில் இந்த கிளையின் நோக்கம் உங்கள் பெயரை ஒரு பட்டியலில் சேர்ப்பதுதான்.) ## தேவையான மாற்றங்களைச் செய்து அந்த மாற்றங்களை commit செய்யுங்கள் இப்போது *text editor* அல்லது *notepad* இல் `Contributors.md` கோப்பைத் திறந்து, அதில் உங்கள் பெயரைச் சேர்க்கவும். கோப்பின் தொடக்கத்திலோ அல்லது முடிவிலோ இதைச் சேர்க்க வேண்டாம். இடையில் எங்கும் வைக்கவும். இப்போது, ​​கோப்பை சேமிக்கவும். கிட் ஸ்டாடஸ் நீங்கள் project directory க்கு சென்று `git status` இயக்கினால், மாற்றங்கள் இருப்பதை நீங்கள் காண்பீர்கள். `git add` கட்டளையைப் பயன்படுத்தி நீங்கள் உருவாக்கிய கிளையில் அந்த மாற்றங்களைச் சேர்க்கவும்: ```bash git add Contributors.md ``` இப்போது `git commit` கட்டளையைப் பயன்படுத்தி அந்த மாற்றங்களைச் செய்யுங்கள்: ``` git commit -m "Add <உங்கள்-பெயர்> to Contributors list" ``` `<உங்கள்-பெயர்>` என்ற இடத்தில் உங்கள் பெயரை கொடுங்கள். ## மாற்றங்களை GitHub ற்கு push செய்தல் `git push` கட்டளையைப் பயன்படுத்தி உங்கள் மாற்றங்களைத் தள்ளுங்கள்: ```bash git push origin <உங்கள்-கிளையின்-பெயர்> ``` `<உங்கள்-கிளையின்-பெயர்>` என்றிருக்கும் இடத்தில் நீங்கள் முன்பு உருவாக்கிய கிளையின் பெயரை உள்ளிடுங்கள்.
push செய்யும் போது ஏதேனும் பிழைகள் ஏற்பட்டால், இங்கே சொடுக்கவும்: - ### அங்கீகாரப் பிழை 
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//first-contributions.git/'
உங்கள் account இல் ஒரு SSH key உருவாக்குதல் மற்றும் கட்டமைத்தல் பற்றிய [GitHub இன் பயிற்சிக்கு](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) செல்லவும்.
## உங்கள் மாற்றங்களை மதிப்பாய்வுக்கு சமர்ப்பிக்கவும் GitHub இல் உள்ள உங்கள் களஞ்சியத்திற்குச் சென்றால், `Compare & pull request` கோரிக்கை பொத்தானைக் காண்பீர்கள். அந்த பொத்தானை சொடுக்கவும். Pull கோரிக்கையை உருவாக்கவும் இப்போது இழுக்கும் கோரிக்கையை சமர்ப்பிக்கவும். Pull கோரிக்கையை சமர்ப்பிக்கவும் விரைவில் உங்கள் எல்லா மாற்றங்களும் இந்த திட்டத்தின் முதன்மை கிளையில் இணைக்கப்படும். மாற்றங்கள் ஒன்றிணைக்கப்பட்டவுடன் உங்களுக்கு அறிவிப்பு மின்னஞ்சல் கிடைக்கும். ## இங்கிருந்து எங்கு செல்வது? வாழ்த்துக்கள்! நீங்கள் ஒரு பங்களிப்பாளராக அடிக்கடி சந்திக்கும் _fork -> clone -> edit -> PR_ பணிப்பாய்வை முடித்துவிட்டீர்கள். உங்கள் பங்களிப்பைக் கொண்டாடுங்கள் மற்றும் உங்கள் நண்பர்கள் மற்றும் பின்தொடர்பவர்களுடன் [web app](https://firstcontributions.github.io/#social-share) சென்று பகிர்ந்து கொள்ளுங்கள். உங்களுக்கு மேலும் பயிற்சி தேவைப்பட்டால், [code contributions](https://github.com/roshanjossey/code-contributions) என்னும் செயலை சரிபார்க்கலாம். இப்போது மற்ற திட்டங்களுக்கு பங்களிப்பதன் மூலம் தொடங்குவோம். நீங்கள் தொடங்கக்கூடிய எளிதான சிக்கல்களுடன் திட்டங்களின் பட்டியலை நாங்கள் தொகுத்துள்ளோம். பாருங்கள் [the list of projects in the web app](https://firstcontributions.github.io/#project-list). ### [கூடுதல் வளங்கள்](../additional-material/git_workflow_scenarios/additional-material.md) ## பிற கருவிகளைப் பயன்படுத்தி பயிற்சிகள் | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.te.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # ఓపెన్‌సోర్స్‌కు మీ మొదటి సహకారం ఇది కష్టం. మీరు ఏదైనా మొదటిసారి చేస్తున్నప్పుడు, ముఖ్యంగా ఇతరులతో కలిసి పని చేస్తున్నప్పుడు, తప్పులు చేయడం సౌకర్యంగా ఉండదు. కానీ ఓపెన్ సోర్స్ అంటే సహకారం మరియు కలిసి పనిచేయడం. మొదటిసారి ఓపెన్ సోర్స్ కంట్రిబ్యూటర్లు నేర్చుకోవాలని మరియు కంట్రిబ్యూట్ చేయాలని అనుకునే విధానాన్ని సరళం చేయాలని మేము అనుకుంటున్నాము. వ్యాసాలు చదవడం మరియు ట్యుటోరియల్స్ చూడటం సహాయపడవచ్చు, కానీ వాస్తవంగా ఆచరణాత్మక వాతావరణంలో చేయడం కంటే మెరుగైనది ఏముంది? ఈ ప్రాజెక్ట్ యొక్క లక్ష్యం ప్రారంభకులకు మార్గదర్శకత్వం మరియు వారి మొదటి కంట్రిబ్యూషన్ చేసే విధానాన్ని సరళీకరించడం. మీరు మీ మొదటి కంట్రిబ్యూషన్ చేయాలని చూస్తున్నట్లయితే, దిగువ దశలను అనుసరించండి. #### *మీకు ఆదేశం లైన్‌తో సౌకర్యంగా లేకపోతే, [ఇక్కడ GUI సాధనాలను ఉపయోగించి ట్యుటోరియల్స్ ఉన్నాయి.](#ఇతర-సాధనాలను-ఉపయోగించి-ట్యుటోరియల్స్)* ఈ రిపోజిటరీని ఫోర్క్ చేయండి #### మీ కంప్యూటర్‌లో git లేకపోతే, [దాన్ని ఇన్‌స్టాల్ చేయండి](https://docs.github.com/en/get-started/quickstart/set-up-git). ## ఈ రిపోజిటరీని ఫోర్క్ చేయండి ఈ రిపోజిటరీని ఫోర్క్ చేయండి ఈ పేజీ ఎగువ భాగంలో ఫోర్క్ బటన్‌పై క్లిక్ చేయడం ద్వారా. ఇది మీ ఖాతాలో ఈ రిపోజిటరీ కాపీని సృష్టిస్తుంది. ## రిపోజిటరీని క్లోన్ చేయండి ఈ రిపోజిటరీని క్లోన్ చేయండి ఇప్పుడు మీ కంప్యూటరులో ఫోర్క్ రిపోను క్లోన్ చేయండి. మీ GitHub ఖాతాకు వెళ్లండి, ఫోర్క్ చేసిన రిపోజిటరీని తెరిచి, క్లోన్ బటన్పై క్లిక్ చేసి, ఆపై * కాపీ * క్లిప్బోర్డ్కు క్లిక్ చేయండి. టెర్మినల్ తెరిచి కింది git ఆదేశాన్ని అమలు చేయండి: ``` git clone "మీరు ఇప్పుడే కాపీ చేసిన url" ``` ఇక్కడ "మీరు ఇప్పుడే కాపీ చేసిన url" (కోట్ మార్కులు లేకుండా) ఈ రిపోజిటరీకి URL (ఈ ప్రాజెక్టు మీ ఫోర్క్). Url ను పొందడానికి మునుపటి దశలను చూడండి. URLని క్లిప్‌బోర్డ్‌కి కాపీ చేయండి ఉదాహరణకి: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` ఇక్కడ 'this-is-you' మీ GitHub ప్రొఫైల్ నేమ్. ఇక్కడ మీరు `first-contribution` రిపోజిటరీ యొక్క కంటెంట్లను మీ GitHub ఖాతా లో మీ కంప్యూటర్కు కాపీ చేస్తున్నారు. ## నూతన బ్రాంచ్ ను సృష్టించుకోండి మీ కంప్యూటర్‌లోని రిపోజిటరీ డైరెక్టరీకి మార్చండి (మీరు ఇప్పటికే అక్కడ లేకపోతే): ```bash cd first-contributions ``` ఇప్పుడు 'git checkout' ఆదేశం ను ఉపయోగించి ఒక బ్రాంచ్ ను సృష్టించుకోండి: ఉదాహరణకి: ```bash git checkout -b add-alonzo-church ``` (బ్రాంచ్ యొక్క పేరు దానిలో పదం * add * ను కలిగి ఉండవలసిన అవసరం లేదు. ## అవసరమైన మార్పులు - చేర్పులు చేసి, ఆ మార్పులను నిరూపించండి. టెక్స్ట్ ఎడిటర్లో ఇప్పుడు ఓపెన్ `Contributors.md` ఫైల్లో, **మీ పేరుని జోడించండి. ఫైల్ ప్రారంభంలో లేదా ముగింపులో జోడించవద్దు. మధ్యలో ఎక్కడైనా ఉంచండి. ఇప్పుడు, ఫైలును సేవ్ చేయండి.** గిట్ స్థితి మీరు ప్రాజెక్ట్ డైరెక్టరీకి వెళ్లి `git status` ఆదేశం ని ఆదేశిస్తే, **మార్పులు-చేర్పులు ఉన్నాయి** అని మీరు చూస్తారు. `Git add ` ఆదేశం ను ఉపయోగించి మీరు సృష్టించిన బ్రాంచ్లో ఈ మార్పులను జోడించండి. `Git add` ఆదేశంను ఉపయోగించి మీరు సృష్టించిన బ్రాంచ్లో ఈ మార్పులను జోడించండి: ```bash git add Contributors.md ``` ఇప్పుడు ఆ మార్పులను 'git commit' ఆదేశం ఉపయోగించి కట్టుకోండి: ```bash git commit -m "Add to Contributors list" ``` `` ని తొలగించి మీ పేరును కలపండి. ## GitHubకి మార్పులను పుష్ చేయండి ఆదేశం ఉపయోగించి మీ మార్పులను పంపండి `git push`: ```bash git push origin ``` మీరు ముందుగా సృష్టించిన బ్రాంచీ పేరుతో `` ను జోడించుము.
GitHubలోకి పుష్ చేస్తున్నప్పుడు మీకు ఏవైనా లోపాలు వస్తే, ఇక్కడ క్లిక్ చేయండి: - ### ప్రమాణీకరణ లోపం 
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//first-contributions.git/'
మీ ఖాతాకు SSH కీని రూపొందించడం మరియు కాన్ఫిగర్ చేయడంపై [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) వెళ్లండి.
## సమీక్ష కోసం మీ మార్పులను సమర్పించండి మీరు GitHub లో మీ రిపోజిటరీకి వెళ్లినట్లయితే, మీరు 'Compare & pull request' బటన్ను చూస్తారు. ఆ బటన్పై క్లిక్ చేయండి. పుల్ రిక్వెస్ట్ సృష్టించుకోండి ఇప్పుడు పుల్ అభ్యర్థనను సమర్పించండి. పుల్ రిక్వెస్ట్ సమర్పించండి నేను మీ అన్ని మార్పులను ఈ ప్రాజెక్ట్ యొక్క ప్రధాన విభాగానికి విలీనం`merge to main branch` చేస్తాను. మార్పులు విలీనం`merge` అయిన తర్వాత మీరు ఒక నోటిఫికేషన్ ఈమెయిల్ పొందుతారు. ## ఇక్కడ నుండి ఎక్కడికి వెళ్లాలి? అభినందనలు! మీరు స్టాండర్డ్ _fork -> clone -> edit -> PR_ వర్క్ ఫ్లో ను పూర్తి చేసారు. [వెబ్ యాప్‌కి](https://firstcontributions.github.io/#social-share) వెళ్లడం ద్వారా మీ సహకారాన్ని జరుపుకోండి మరియు మీ స్నేహితులు మరియు అనుచరులతో భాగస్వామ్యం చేయండి. మీకు ఇంకా సాధన కావాలనుకుంటే, [కోడ్ కాంట్రిబ్యూషన్స్ రిపోజిటరీ](https://github.com/roshanjossey/code-contributions) ఇక, ఇప్పుడు మీరు ఇతర ప్రాజెక్టులకు తోడ్పడటం ప్రారంభించండి. మీరు ప్రారంభించగల సులభమైన సమస్యలతో ప్రాజెక్టుల జాబితాను మేము రెడీ చేసాము. [వెబ్ ప్రాజెక్టుల జాబితాలు](https://firstcontributions.github.io/#project-list) ను చూడండి. ### [అదనపు విషయం](../additional-material/git_workflow_scenarios/additional-material.md) ## ఇతర సాధనాలను ఉపయోగించి ట్యుటోరియల్స్ | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.th.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # อยากเริ่ม Contribute โปรเจคใน GitHub ของผู้อื่นเป็นครั้งแรกใช่ไหม? แน่นอนว่ามันอาจฟังดูเป็นเรื่องยาก, เพราะครั้งแรกของทุกอย่างมันมักจะยากเสมอแหละ โดยเฉพาะการทำงานร่วมกับผู้อื่น เพราะเมื่อเราทำอะไรผิดพลาดเรามักจะรู้สึกไม่สบายใจ แต่สำหรับโลกของโอเพนซอร์ส(open source) มันคือโลกของการทำงานร่วมกัน! ดังนั้นไม่ต้องกลัว เราจะสอนให้คุณรู้วิธีในการ contribute ผลงานร่วมกับผู้อื่นใน GitHub แบบง่ายๆ เลยล่ะ การอ่านบทความและการทำตามตัวอย่างต่างๆ ก็อาจจะช่วยได้ แต่จะมีอะไรดีไปกว่าการที่เราได้ลงมือทำสิ่งนั้นๆ ด้วยตัวเองล่ะ! สำหรับโปรเจ็คนี้จะช่วยสอนให้มือใหม่ส่ง contribute กับโปรเจคต่างๆได้อย่างง่ายๆเลย เพียงทำตามขั้นตอนต่อไปนี้ โปรดทำใจให้สบาย ยิ่งคุณผ่อนคลายมากเท่าไหร่ คุณก็ยิ่งเรียนรู้ได้ดีมากขึ้นเท่านั้น! fork this repository ถ้าหากคุณยังไม่ได้ติดตั้ง git ลงบนเครื่องของคุณ คุณสามารถ[ติดตั้งได้ที่นี่]( https://help.github.com/articles/set-up-git/) ก่อนอื่นเลย หาโปรเจคที่คุณอยากจะร่วม contribute ก่อนเลย เมื่อคุณเจอโปรเจคที่สนใจแล้วมาเริ่มทำตามขั้นตอนต่อไปนี้กัน (ต่อไปนี้เราจะขอเรียกโปรเจคต้นทางว่า "โปรเจ็คต้นน้ำ" (Source-project\Upstream-project)) ## การ "Fork" โปรเจ็ค เพื่อให้คุณสามารถคัดลอกเพื่อแยกโปรเจ็คต้นน้ำออกไปทำที่แอคเคาน์ส่วนตัวของคุณได้ โดยการกดปุ่ม "Fork" ที่ด้านบนของหน้านี้ แล้วโปรเจ็คต้นน้ำจะถูกคัดลอกนำไปใส่ไว้ในแอคเคาน์ของคุณ ## การ "Clone" โปรเจ็ค clone this repository การ clone โปรเจคนั้น เป็นการ download sourcecode จาก GtiHub repository นั้นๆ มาลงคอมพิวเตอร์ของคุณ โดยการคลิ๊กที่ปุ่ม "Clone" แล้วเลือก *Copy to clipboard* (คำสั่งคัดลอก) เปิดโปรแกรมเทอร์มินอลในเครื่อง (เช่น Terminal ใน MacOS หรือ cmd ใน Windows) แล้วรันคำสั่ง git ต่อไปนี้: ```bash git clone "url ที่คัดลอกไว้" ``` "url ที่คัดลอกไว้" (ไม่ต้องใส่ " ") คือ url ของโปรเจ็คของคุณ คุณสามารถเลื่อนกลับไปดูวิธีการคัดลอก url ได้จากหัวข้อก่อนหน้านี้ copy URL to clipboard ตัวอย่าง: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` `this-is-you` คือชื่อ username ของคุณบน GitHub ถึงตรงนี้คุณได้ "Clone" โปรเจ็ค first-contributions ไปไว้ที่คอมพิวเตอร์ของคุณแล้ว ## การสร้าง branch ในโปรแกรมเทอร์มินอล เปลี่ยน directory ไปยังที่ที่คุณได้ Clone โปรเจ็คไว้: ```bash cd first-contributions ``` ตรงนี้ให้สร้าง branch (แตกกิ่งการทำงานใหม่) ด้วยคำสั่ง `git checkout`: ```bash git checkout -b <ชื่อ branch> ``` ตัวอย่าง: ```bash git checkout -b add-alonzo-church ``` (ปกติชื่อของ branch ไม่จำเป็นต้องมีคำว่า *add* แต่ในโปรเจ็คนี้อยากให้ใช้ add-ชื่อ-ของ-คุณ เพราะชื่อของคุณจะไปแสดงอยู่ในรายชื่อ Contributors (ผู้เข้าร่วม) ของโปรเจ็คนี้ ## เพิ่มหรือลดโค้ดลงไปเลย แล้วอย่าลืม "Commit" บอกว่าคุณได้เปลี่ยนอะไรไปบ้างล่ะ ตอนนี้ให้เปิดไฟล์ `Contributors.md` ในโปรแกรม text editor เพิ่มชื่อของคุณลงไป จากนั้นเซฟไฟล์ git status ในโปรแกรมเทอร์มินอล ถ้าคุณอยู่ที่ directory ของโปรเจ็ค ให้ลองพิมพ์คำสั่ง `git status` จะเห็นว่าคุณได้ทำการเปลี่ยนอะไรไปบ้าง เพิ่มการเปลี่ยนแปลงนั้น ๆ เข้าไปใน branch ที่เพิ่งสร้าง ด้วยคำสั่ง `git add`: ```bash git add Contributors.md ``` ตอนนี้ "Commit" การเปลี่ยนแปลงนั้น ๆ ด้วยคำสั่ง `git commit`: ```bash git commit -m "Add <ชื่อของคุณ> to Contributors list" ``` แทนที่ `<ชื่อของคุณ>` ด้วยชื่อจริง ๆ ของคุณ. ## "Push" โค้ดที่เปลี่ยนไปขึ้นบน GitHub "Push" ผลงานที่คุณทำเมื่อกี้นี้ขึ้น GitHub ด้วยคำสั่ง `git push`: ```bash git push origin <ชื่อ branch ของคุณ> ``` แทนที่ `<ชื่อ branch ของคุณ>` ด้วยชื่อของ branch ของคุณที่เพิ่งสร้างไปเมื่อหัวข้อที่แล้ว ๆ (add-ชื่อ-ของ-คุณ) ## ส่งผลงานของคุณและรอรีวิวจากเจ้าของโปรเจ็ค ไปที่ repository ของคุณบน GitHub คลิ๊กที่ `Compare & pull request` create a pull request ตอนนี้ก็ส่ง Pull Request ไปที่โปรเจ็คต้นน้ำได้เลย submit pull request แล้วเดี๋ยวเราจะ "Merge" หรือรวมผลงานที่คุณได้เปลี่ยนแปลงโค้ดมาที่ master branch ของโปรเจ็คนี้ คุณจะได้รับอีเมล เมื่อเราได้ทำการ Merge ผลงานของคุณเรียบร้อยแล้ว ## เสร็จแล้วทำยังไงต่อดี ยินดีด้วย คุณเพิ่งทำวัฏจักรพื้นฐานของการทำ contribute คือ fork -> clone -> edit -> pull request ซึ่งสิ่งเหล่านี้คุณจะพบเจอเป็นปกติเมื่อเป็น contributor ฉลองการมีส่วนร่วมของคุณ จากนั้นก็แบ่งปันให้เพื่อน ๆ ได้ทราบ โดยการไปที่ [หน้าเว็บนี้](https://firstcontributions.github.io/#social-share) จากนี้คุณสามารถคอนทริบิ้วต์ให้กับโครงการอื่น ๆ ได้ โดยเราได้สร้างรายการบางส่วน เพื่อให้ง่ายต่อการเริ่มต้น [รายชื่อโครงการที่น่าสนใจ](https://firstcontributions.github.io/#project-list) ### [ข้อมูลอื่น ๆ เพิ่มเติม](../additional-material/git_workflow_scenarios/additional-material.md) ## ฝึกการคอนทริบิ้วต์โดยใช้เครื่องมืออื่น ๆ | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/translations/github-desktop-tutorial.th.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.tl.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Mga unang kontribusyon Mahirap. Palaging mahirap sa unang pagkakataon ng anumang gawain. Lalo na sa isang kolaborasyon, kung saan hindi komportableng paglaanan ng tuon ang mga pagkakamali. Gusto naming simplehan at linawin ang modernong pamamaraan kung papaanong matuto at tumulong ang mga bagong *open-source contributors*. Maaaring makatulong ang pagbabasa ng mga artikulo at panonood ng mga *tutorials*, pero ano pa bang mas epektibong pamamaraan kaysa sa aktual na aplikasyon ng isang pagsasanay? Ang pangunahing pakay ng proyektong ito ay gabayan ang mga baguhan na gawin ang kanilang unang *contribution*. Kung ikaw ay isa sa mga taong iyon, sundin lang ang mga sumusunod na tagubilin. Kung hindi comfortable sa paggamit ng *command line*, [may mga tutorials din gamit ang mga *GUI* tools.](#Mga-tutorials-gamit-ang-ibang-tools)* i-fork ang repository na ito Kung wala pang *git* sa iyong computer, [i-install ito](https://help.github.com/articles/set-up-git/). ## I-fork ang repository I-fork ang *repository* sa pamamagitan ng pag-click sa *fork* *button* na matatagpuan sa bandang itaas na kanan ng *webpage* na ito. Magkakaroon na ng kopya ng *repository* na ito sa iyong account. ## I-clone ang repository i-clone ang repository na ito Ngayon, i-clone ang repository na iyong na-fork sa iyong computer. Pumunta lang sa iyong GitHub account, buksan ang nai-fork na repository, i-click ang clone button pagkatapos i-click ang *copy to clipboard* icon. Buksan ang terminal at i-enter ang sumusunod na git command: ```bash git clone "url na nakopya mo" ``` kung saan ang "url na nakopya mo" (wala ang mga panipi) ay ang URL ng repository (ang fork ng iyong proyekto). Pakitingnan nang mabuti ang mga nakaraang hakbang upang makuha ang url. kopyahin ang URL sa clipboard Halimbawa: ```bash git clone https://github.com/iyong-username/first-contributions.git ``` kung saan ang `iyong-username` ang iyong username sa GitHub. Mula sa command na ito, dito nagsisimula ng paggawa ng kopya ng nilalaman ng first-contributions repository mula sa GitHub papunta sa iyong kompyuter. ## Gumawa ng isang branch Pumunta sa kompyuter directory ng iyong repository (kung hindi ka pa nakapunta): ```bash cd first-contributions ``` Ngayon, gumawa na ng isang branch gamit ang `git checkout` command: ```bash git checkout -b ``` Halimbawa: ```bash git checkout -b dagdag-juan-dela-cruz ``` (Hindi kailangan ng salitang *"dagdag"* sa pangalan ng i-dadagdag na branch pero makatwiran pa rin na gawin dahil layunin ng branch ang pagdagdag ng iyong pangalan sa isang listahan.) ## Gumawa ng kinakailangan na pagbabago at i-commit ang mga nagawang pagbabago Ngayon, buksan ang `Contributors.md` file sa isang text editor, idagdag ang iyong pangalan. Huwag mong idagdag sa simula o sa hulian ng tinutukoy na file. Ilagay sa kalagitnaan ng file. At i-save and file. katayuan ng git Kapag pumunta ka sa directory ng iyong proyekto at i-enter ang command na `git status`, may makikita kang mga pagbabago. Idagdag ang mga pagbabagong naganap papunta sa iyong branch gamit ang `git add` command: ```bash git add Contributors.md ``` Ngayon, i-commit ang mga nabagong files gamit ang `git commit` command: ```bash git commit -m "Add to Contributors list" ``` kung saan ang `` ay ang iyong pangalan. ## I-push ang mga changes sa GitHub I-push ang mga nabago mong files gamit ang command na `git push`: ```bash git push origin ``` kung saan ang `` ay ang pangalan ng branch na naidagdag mo kani-kanila lang. ## I-submit ang changes para sa review Pumunta sa iyong repository sa GitHub at may makikita kang `Compare & pull request` button, i-click mo ang tumutukoy na button. gumawa ng pull request I-submit ang pull request. ipasa ang pull request Pagkalipas ng ilang oras ay isasama ko ang mga pagbabago na nagawa mo papunta sa master branch ng proyekto na ito. May makukuha kang notification email kapag ang mga pagbabago ay na-isama sa proyekto. ## Ano ang susunod na hakbang? Congrats! Nakumpleto mo ang standard _fork -> clone -> edit -> PR_ na workflow na lagi mong magagamit bilang isang kontribyutor! I-celebrate ang iyong kontribusyon at i-share mo sa mga kaibigan at followers mo sa pagpunta sa [web app](https://firstcontributions.github.io/#social-share). Ngayon, magsimula ka na mag-contribute sa ibang proyekto. Nagtipon kami ng listahan ng mga proyekto na may madaling issues na puwedeng-puwede kang makisabay. Paki-visit lang [ang listahan mula sa web app](https://firstcontributions.github.io/#project-list). ### [Mga karagdagan na materyal](../additional-material/git_workflow_scenarios/additional-material.md) ## Mga tutorials gamit ang ibang tools | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.tm.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Ilkinji goşantlar Bu proýektiň maksady, GitHub-y täze öwrenýänlere ilkinji goşantlaryny (contribution) nädip goşup biljeklerini görkezmekdir. Kyn bolup biler. Täze bir işi ilkinji sapar etmek hemişe kyn bolýar. Başga kişiler bilen bilelikde işlemeli bolsaň, ýalňyşlyk etmäne çekinýäň we gorkýaň. Ýöne açyk çeşmäniň (open source) düýbünde başga adamlar bilen bilelikde işleşmek ýatýar. Biz açyk çeşme (open source) proýektlerine ilkinji sapar goşant goşjaklara ýol görkezip, olaryň ilkinji goşantlaryny has aňsatlaşdyrmak isleýäris. Blog postlary okamak ýa-da wideolary görüp öwrenmek kömek edip biler, ýöne bir zady edip öwrenmegiň ýerini tutup biljek zat ýok, şeýle dälmi? Eger ilkinji goşandyňyzy goşmak isleýän bolsaňyz, aşakdaky görkezmeleri yzarlaň. şu repositoryny forklaň #### Eger kompýuteriňizde git ýok bolsa, [şu ýerden ýükläň](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Şu repositoryny forklaň Şu sahypanyň ýokarsynda duran fork düwmesine basyp şu repositoryny forklap bilýaňiz. Şunlukda, şu repositorynyň kopiýasy siziň hasabyňyzda bolyar. (Şu proýektiň eýesiniň hasabynda-da, siziň hasabyňyzda-da bolýar) ## Şu repositoryny klonlaň(clone) şu repositoryny klonlaň Indi, forklan repositoryny öz kompýuteriňize klonlaň(clone). Bu diýmek, ýaňy siziň github hasabyňyza kopiýasy gelen(forklan) şu proýekti oz kompyuteriňizde-de bir kopiýasyna eýe bolup bilýäňiz. Github hasabyňyza gidiň, forklan repositoryny açyň, code düwmesine basyň, soňra _copy to clipboard_ nyşanyna basyň. Terminaly açyp aşakdaky git buýruguny işlediň: ```bash git clone "ýaňy kopiýa eden url-ňyz" ``` "ýaňy kopiýa eden url-ňyz"(goşa dyrnaksyz) şu repositorynyň url-y (şu proýektiň siziň eden forkuňyz).Url-ny almak üçin ýokarda görkezilenleri yzarlaň. URL-ny buferiň içine kopiýalaň Mysal üçin: ```bash git clone https://github.com/ulanyjy-ady/first-contributions.git ``` `ulanyjy-ady` diýip duran bölegiň deregine siziň Githubdaky ulanyjy adyňyz. Şu ýerde, Githubdaky first-contributions repositorynyň içindäki ähli zatlary kompýuteriňize kopiýalaýarsyňyz. ## Şaha(branch) döretmek Repositorynyň duran papkasynda däl bolsaňyz, şol ýere gidiň: ```bash cd first-contributions ``` Indi, `git switch` buýrugy arkaly täze şaha(branch) dörediň: ```bash git switch -c siziň-täze-şahaňyzyň-ady ``` Mysal üçin: ```bash git switch -c goş-ahmet-ahmedow ``` (Şahanyň adynda _goş_ sözüni hökman ýazmasaňyzam bolyar, ýöne bu şahanyň maksady adyňyzy goşant goşanlaryň hasabyna goşmak bolany üçin, _goş_ sözüni ulanmak düşnükli bolar) ## Gerekli üýtgeşmeleri edip, ol üýtgeşmeleri bellige almak (commit etmek). Indi, tekst redaktorynda(m.ü VSCode) `Contributors.md` faýlyny açyň, içinde iň soňunda adyňyzy giriziň we ýatda saklaň(save) ```bash - [Adyňyz](https://github.com/ulanyjy-adyňyz) ``` Mysal üçin: ```bash - [Ahmet Ahmedow](https://github.com/ahmetahmedow) ``` ```](``` arasynda boşluk ýokdur git ýagdaýy Terminalda eger proýektiň duran ýerine gidip,```git status``` buýrugyny işletseňiz, şol ýerde bolan üýtgeşmeleri görýaňiz. ```git add ``` buýrugyny ulanyp şol üýtgeşmeleri ýokarda döreden şahamyza(branch) goşýas: ```bash git add Contributors.md ``` Indi, `git commit` buýrugy arkaly şol üýtgeşmeleri bellige alyp(commit) goýýas: ```bash git commit -m " goşant goşanlaryň hataryna girizildi" ``` `` diýen ýere öz adyňyzy ýazyň (BELLIK: açyk çeşme(open source) dünýäsinde dünýäniň her dürli ýerlerinden her dürli adamlar bilen bilelikde işleşýaniňiz üçin bellige alyş(commit) tekstini iňlis dilinde ýazyp bilýaňiz). ## Üýtgeşmeleri Githuba ibermek(Push) `git push` buýrugy arkaly üýtgeşmeleriňizi iberiň(push): ```bash git push -u origin siziň-şahaňyzyň-ady ``` `siziň-şahaňyzyň-ady` bölegini ýokarda doreden şahaňyzyň ady bilen çalşyň. ## Üýtgeşmeleriňizi gözden geçirmek üçin ýollaň Eger Githubda şu repositoryňyza gitseňiz, `Compare & pull request` düwmesini görýäňiz. Şol düwmä basyň. çekiş haýyşnamasyny dörediň Indi, Çekiş haýyşnamasyny(pull request) ýollaň. çekiş haýyşnamasyny iberiň Basym, Eden ähli üýtgeşmeleriňizi gözden geçirip, proýektiň esasy şahasy(main branch) bilen birleşdirýäs. Üýtgeşmeler birleşdirilen soň, habarnama alarsyňyz. ## Mundan soň näme edip bilersiňiz? Gutlaýas! Siz standart goşant goşujy hökmünde kän gabat gelinýän _forklamak(fork) -> Klonlamak(clone) -> Üýtgetmek(edit) -> Çekiş haýyşnamasy(pull request)_ yzygiderliligini tamamladyňyz! Eden goşandyňyza begeniň we dostlaryňyz bilen paýlaşyň! [Bu baglanma](https://firstcontributions.github.io/#social-share) arkaly hem birnäçe gyzykly proýektlere öz goşandyňyzy goşup bilýäňiz. ### [Goşmaça maglumat](additional-material/git_workflow_scenarios/additional-material.md) ## Başga gurallar hakynda sapaklar (ýöne iňlis dilinde) | GitHub Desktop gatnaşygynyň programmasy | Visual Studio 2017 | GitKraken programmasy | VS Code redaktory | Sourcetree programmasy | IntelliJ IDEA programmasy | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) |

Bu proýektiň goldaýjysy:

================================================ FILE: docs/translations/README.tn.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Awel Contribution fil github bil tounsi 🇹🇳 Dima tesme3 bil term "contribute to open source" ama mata3rech kifh tebda? Houni bch tel9a bil 5otwa bil 5otwa kifh tebda wtkonlek awel contribution ta3melha 3al github bch tkon pratique tjareb wtchof kolchy b3inik. _Ken mat7ebech tesa3mel el cmd, [hedhom tutorials o5rin testa3mel fihom des logiciles.](#tutorials-using-other-tools)_ fork this repository #### Edhaken moch sabeb git 3andek fil pc, [sobo mil lien hedha](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Forki el repo Inzel 3ala "Fork" mil fo9 bch tforki el repository. Haka iwali 3andek copie f compte mt3ek tejem tebedel fiha kima t7eb. ## Cloni el repo clone this repository Tw cloni el repo li 3meltelha fork lil machine mte3ek. Imchi lil compte github 7el el forked repo inzel 3al button "code" b3d el ssh b3d copi lien el mawjoud. Tw 7el terminal wekteb el commande hedhi ```bash git clone "lien li copito" ``` Win "lien li copito" (m8ir el quotation marks) 7ot lien lil repo li 3meltelha fork. chof steps li t3adew bch te5o el lien. Par exemple: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` Win this-is-you edheka nom mte3 el github mte3ek. honi 9e3ed tcopi el contenu mta3 the first-contributions repo 3al github lil pc mte3ek. ## A3mel branch jdid Badel lil directory mta3 el repo fil pc mte3ek (edhaken moch deja 8ad): ```bash cd first-contributions ``` Tw a3mel branch bil command `git switch`: ```bash git switch -c your-new-branch-name ``` Par exemple: ```bash git switch -c awel-contribution-github ```
Edhaken jek error wenti testa3mel fil git switch, Inzel lena: Edhaken lerror "Git: `switch` is not a git command. See `git –help`" dhohret, yomken 5tr testa3mel fi version 9dima mta3 git. Fil 7ala hedhi, jareb ista3mel `git checkout`: ```bash git checkout -b your-new-branch-name ```
## A3mel les changements lezmin b3d commiti les changements Tw 7el el file `Contributors.md` fil editor, zid ismek fiha. Mat7otoch milowel wala filo5er mta3 el file. 7ot fi plasa fil west. Tw, a3melo save. git status Ken temchi lil directory mta3 repo wtekteb el command `git status`, tw tchof fama changements saret. Zid les changements hedhom lil branch eli 3meltha bil command `git add`: ```bash git add Contributors.md ``` Tw a3mel commit lil les changements bil commande `git commit`: ```bash git commit -m "Add your-name to Contributors list" ``` Badel `your-name` bismek. ## Pushi les changements 3al GitHub A3mel push lil les changements bi ista3mel el command `git push`: ```bash git push -u origin your-branch-name ``` Badel `your-branch-name` bi isem lbranch l3meltha se3a.
Edhaken jek error w9t tpushu, inzel lena: - ### Authentication Error 
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//first-contributions.git/'
imchi el [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) kifh tgeneri wtconfiguri SSH key el compte mte3ek. Zeda, tejem t5adem 'git remote -v' bch tchof remote address mte3ek. Edhaken dhohretlek 7aja haka: 
origin	https://github.com/your-username/your_repo.git (fetch)
  origin	https://github.com/your-username/your_repo.git (push)
bedelha bil command hedhi: ```bash git remote set-url origin git@github.com:your-username/your_repo.git ``` Sinon bch yo93ed ijik el error mta3 el username wel password wel get authentication.
## Submiti les changements mte3ek lil review Ken temchi lil repo mte3ek 3al github, tw tchof button `Compare & pull request`. Enzel 3lih. create a pull request Tw a3mel sumbit lil pull request. submit pull request 3ala 9rib tw na3mel merge lil les changements mete3ek lil main branch mta3 lprojet hedha. Tw tjik notification email ki tsir merge lil les changements. ## chnowa ta3mel taw? Mabrouk! kamelt el workflow standard mta3 _fork -> clone -> edit -> pull request_ eli 3al a8leb yete7seblek ka contributor! I7tefel w Cherek el contribution hedhi m3a s7abek wel followers 3al site [web app](https://firstcontributions.github.io/#social-share). Edhaken t7eb practice akther, chof [code contributions](https://github.com/roshanjossey/code-contributions). Tw 5al nebdew ncontributiw fi des projets o5rin. a3melna list fiha des projets fihom error sehlin tejem tebda bihom. Chof [the list of projects in the web app](https://firstcontributions.github.io/#project-list). ### [material o5rin](docs/additional-material/git_workflow_scenarios/additional-material.md) ## Tutorials bista3mel Tools o5rin | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](docs/gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](docs/gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](docs/gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](docs/gui-tool-tutorials/github-windows-intellij-tutorial.md) |

This project is supported by:

================================================ FILE: docs/translations/README.tr.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # İlk katkı Zor gelir... Herhangi bir işi ilk kez yapmak daima zor gelir. Özellikle başkalarıyla ortak çalışıyorsanız, hata yapmak içinize sinmez. Ancak "Açık Kaynağın" temelinde işbirliği ve birlikte çalışma yatmakta. Biz, açık kaynak projelere ilk kez katkıda bulunacak kişilerin bu süreci öğrenmesini ve ilk katkılarını sunmalarını kolaylaştırmayı istiyoruz. Makale okumak ve eğitim videoları izlemek yardımcı olabilir, fakat bir işi gerçekten yapmanın yerini ne tutabilir ki? Bu proje yeni başlayanların veya ilk defa katkıda bulunacakların işini kolaylaştırmak ve onlara rehberlik etmek amacındadır. Unutmayın ki ne kadar rahat olursanız o kadar rahat öğrenirsiniz. Eğer bir GitHub projesine ilk defa katkıda bulunacaksanız, aşağıda gösterilen basit adımları takip etmeniz yeterli olacaktır. Söz veriyoruz, eğlenceli olacak. Bu projeyi GitHub üzerinde çatallayın (forklayın) Eğer bilgisayarınızda git kurulu değil ise, [ yükleyin ]( https://help.github.com/articles/set-up-git/ ). ## Projeyi "forklama" Sayfanın sağ üst köşesinde bulunan "Fork" butonuna basıp bu projeyi çatallayın. Bu işlem sizin hesabınız altında projenin bir kopyasını oluşturacaktır. ## Depoyu (Repository) klonlama Bu depoyu (repository) bilgisayarınıza kopyalayın (klonlayın) Şimdi bu depoyu bilgisayarınıza klonlayın. GitHub hesabınıza gidin, çatalladığınız depoyu açın, 'clone' butonuna basıp ardından *copy to clipboard* simgesine basın. Daha sonra komut istemini açıp aşağıdaki git komutunu çalıştırın: ```bash git clone "kopyaladığınız-url" ``` "kopyaladığınız-url" (tırnak işaretleri olmadan) yerine bu deponun GitHub sayfasından aldığınız linki kopyalayın. Bu bağlantının (linkin) URL adresini panoya kopyalayın Örneğin: ```bash git clone https://github.com/kullanıcı-adi/first-contributions.git ``` `kullanıcı-adi` sizin GitHub kullanıcı adınız. Burada GitHub üzerinde bulunan first-contributions reposunun içeriğini bilgisayarınıza kopyalıyorsunuz. ## Dal (Branch) oluşturma Eğer henüz klasör içerisinde değilseniz komut isteminde ana klasörünün konumuna gidin: ```bash cd first-contributions ``` `git checkout` komutunu kullanarak yeni bir dal(branch) oluşturun: ```bash git checkout -b ``` Örneğin: ```bash git checkout -b ekle-aydin-cagri-dumlu ``` (Dal ismi içinde *ekle* kelimesinin geçme zorunluluğu yok, fakat bu dal isminizi katkı sunanlar listesine ekleme amacıyla oluşturulduğundan, ekle yazmak mantıklı olacaktır.) ## Gerekli değişiklikleri yapma ve değişiklikleri onaylama Şimdi, bir metin editöründe `Contributors.md` dosyasını açın. Basit bir işaretleme dili olan Markdown'a alışkın olmanız gerekmektedir. Nasıl kullanacağınızı öğrenmek için bu [kopya kağıdına](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) göz atabilirsiniz. `Contributors.md` dosyasının sonuna bu satırı ekleyin: ```markdown - [İsminiz](https://github.com/kullanici-adiniz) ``` Örneğin: ```markdown - [Ahmet Yılmaz](https://github.com/ahmet-yilmaz) ``` `](` arasında boşluk olmadığından emin olun. Dosyayı kaydedin ve kapatın. Komut isteminde çalıştırılan git status komutunun çıktısı Komut istemi üzerinde proje klasörüne gidip `git status` komutunu yazdığınızda yaptığınız değişiklikleri göreceksiniz. `git add` komutu ile bu değişiklikleri oluşturduğunuz dal içerisine ekleyin. ```bash git add Contributors.md ``` Şimdi `git commit` komutunu kullanarak değişikliklerinizi onaylayın (commit): ```bash git commit -m " katkıda bulunanlar listesine eklendi" ``` `` yerine kendi isminizi yazın. (Ç.N: Açık kaynak dünyasında dünyanın farklı yerlerinden insanlarla birlikte çalışacağınız için onay mesajını İngilizce yazabilirsiniz.) ## Değişiklikleri GitHub üzerine "itme" (Push) `git push` komutu ile değişikliklerinizi ittirin: ```bash git push origin ``` `` yerine daha önce oluşturduğunuz dalın ismini girin. ## Değişikliklerinizi inceleme için gönderin Oluşturduğunuz deponun Github sayfasında `Compare & pull request` butonunu göreceksiniz. Bu butona basın. GitHub üzerinde yeni bir çekme isteği (pull request) oluşturma ekranı Şimdi çekme isteğini (pull request) gönderin. Çekme isteğini (pull request) gönderme ekranı Yaptığınız değişiklikleri en kısa zamanda projenin "master" dalı ile birleştireceğiz. Bu işlem tamamlandığı zaman bir bilgilendirme e-postası alacaksınız. ## Bundan sonra ne yapabilirim? Tebrikler! Katkıda bulunan kişi olarak sıklıkla karşılaşacağınız standart _çatal -> klon -> düzenle -> çekme isteği_ iş akışını tamamladınız! Sunduğunuz katkının coşkusunu yaşamak ve bunu arkadaşlarınız ve takipçilerinizle paylaşmak için [bu bağlantıdaki](https://firstcontributions.github.io/#social-share) uygulamamızı kullanabilirsiniz. Artık diğer projelere katkı sunmaya hazırsınız. Çözmeye başlayabileceğiniz giriş seviyesindeki konulara (issue) sahip projeleri [sizin için derledik](https://firstcontributions.github.io/#project-list). ### [Ek bilgi](../additional-material/git_workflow_scenarios/additional-material.md) ## Diğer araçlarla ilgili eğitimler | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.ua.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Перший внесок Цей проєкт спрямований на те, щоб спростити та спрямувати шлях новачків, які роблять свій перший внесок. Якщо ви хочете зробити свій перший внесок, виконайте наведені нижче дії. _Якщо ви не вмієте працювати з командним рядком, [ось навчальні посібники з використанням інструментів GUI.](#tutorials-using-other-tools)_ форкніть цей репозиторій Якщо ви ще не встановили git, тоді [зробіть це](https://help.github.com/articles/set-up-git/). ## Форкніть репозиторій Форкніть свою власну копію цього репозиторію, натиснувши кнопку `fork` вгорі цієї сторінки. Таким чином, ви створите копію цього репозиторію у вашому акаунті. ## Клонуйте репозиторій Клонуйте цей репозиторій Тепер клонуйте цей репозиторій на ваш комп’ютер. Натисніть на кнопку `clone`, а потім - на іконку `copy to clipboard`. Відкрийте термінал і виконайте наступні команди: ```bash git clone "посилання, яке ви щойно скопіювали" ``` де `посилання, яке ви щойно скопіювали` (без лапок) - адреса цього репозиторію. Дивіться попередній крок для того, щоб отримати цю адресу. Скопіюйте посилання Наприклад: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` де `this-is-you` - ваш нікнейм з GitHub. Таким чином, ви копіюєте вміст репозиторію з GitHub, в який збираєтесь зробити внесок, на ваш комп’ютер. ## Створюємо гілку Перейдіть в директорію з репозиторієм на вашому комп’ютері (якщо ви ще цього не зробили): ```bash cd first-contributions ``` Тепер створюємо гілку за допомогою команди `git checkout`: ```bash git checkout -b ``` Наприклад: ```bash git checkout -b add-petro-church ``` (Назва гілки не повинна обов’язково містити слово *add*, але це має сенс, якщо майбутні зміни передбачають додавання чогось, наприклад, вашого імені у список контрибуторів.) ## Робимо необхідні зміни та записуємо їх в репозиторій Тепер відкриваємо файл `Contributors.md` в текстовому редакторі та додаємо ваше ім’я, а потім зберігаємо файл. Якщо ви перейдете в директорію проєкту і виконаєте команду `git status`, ви побачите зміни. Додайте ці зміни до гілки, яку ви тільки що створили, за допомогою команди `git add`: ```bash git add Contributors.md ``` Тепер запишіть ці зміни за допомогою команди `git commit`: ```bash git commit -m "Add to Contributors list" ``` замініть `` своїм іменем. ## Відправляємо зміни в GitHub Відправте зміни на віддалений репозиторій в GitHub за допомогою команди `git push`: ```bash git push -г origin ``` Замініть `` назвою гілки, яку ви створили раніше.
Якщо під час натискання виникають помилки, натисніть тут: - ### Authentication Error 
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//first-contributions.git/'
Перейдіть до [туторіалу GitHub](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) щодо створення та налаштування ключа SSH для вашого облікового запису.
## Відправляємо зміни на перевірку Коли ви перейдете до свого репозиторію в GitHub, ви побачите кнопку `Compare & pull request`. Сміливо натисніть на неї. створіть pull запит Тепер зміни відправлені на перевірку і затвердження. надішліть pull запит на перевірку Згодом я об’єднаю ваші запропоновані зміни з основною гілкою цього репозиторію. Ви отримаєте повідомлення, коли це буде зроблено. ## Що далі? Вітаю! Ви щойно виконали стандартний робочий процес _fork -> clone -> edit -> pull request_, з яким ви часто стикаєтеся як контрибутор! Відзначте свій внесок і поділіться ним із друзями та читачами, перейшовши до [веб-програми](https://firstcontributions.github.io/#social-share). Тепер почнімо робити внески в інші проєкти. Ми склали список проєктів із простими проблемами, з яких ви можете почати. Перегляньте [список проєктів у веб-додатку](https://firstcontributions.github.io/#project-list). ### [Додаткові матеріали](additional-material/git_workflow_scenarios/additional-material.md) ## Інструкції для інших інструментів | Додаток GitHub Desktop | Visual Studio 2017 | Програма GitKraken | Редактор VS Code | Додаток Sourcetree | Програма IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |

Цей проєкт підтримується:

================================================ FILE: docs/translations/README.un-aln.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # ⎎⟟⍀⌇⏁ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏⌇ ⏁⊑⟟⌇ ⌿⍀⍜⟊⟒☊⏁ ⏃⟟⋔⌇ ⏁⍜ ⌇⟟⋔⌿⌰⟟⎎⊬ ⏃⋏⎅ ☌⎍⟟⎅⟒ ⏁⊑⟒ ⍙⏃⊬ ⏚⟒☌⟟⋏⋏⟒⍀⌇ ⋔⏃☍⟒ ⏁⊑⟒⟟⍀ ⎎⟟⍀⌇⏁ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏. ⟟⎎ ⊬⍜⎍ ⏃⍀⟒ ⌰⍜⍜☍⟟⋏☌ ⏁⍜ ⋔⏃☍⟒ ⊬⍜⎍⍀ ⎎⟟⍀⌇⏁ ☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏, ⎎⍜⌰⌰⍜⍙ ⏁⊑⟒ ⌇⏁⟒⌿⌇ ⏚⟒⌰⍜⍙. _⟟⎎ ⊬⍜⎍'⍀⟒ ⋏⍜⏁ ☊⍜⋔⎎⍜⍀⏁⏃⏚⌰⟒ ⍙⟟⏁⊑ ☊⍜⋔⋔⏃⋏⎅ ⌰⟟⋏⟒, [⊑⟒⍀⟒ ⏃⍀⟒ ⏁⎍⏁⍜⍀⟟⏃⌰⌇ ⎍⌇⟟⋏☌ ☌⎍⟟ ⏁⍜⍜⌰⌇.](#tutorials-using-other-tools)_ fork this repository #### ⟟⎎ ⊬⍜⎍ ⎅⍜⋏'⏁ ⊑⏃⎐⟒ ☌⟟⏁ ⍜⋏ ⊬⍜⎍⍀ ⋔⏃☊⊑⟟⋏⟒, [⟟⋏⌇⏁⏃⌰⌰ ⟟⏁](https://help.github.com/articles/set-up-git/). ## ⎎⍜⍀☍ ⏁⊑⟟⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⎎⍜⍀☍ ⏁⊑⟟⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⏚⊬ ☊⌰⟟☊☍⟟⋏☌ ⍜⋏ ⏁⊑⟒ `fork` ⏚⎍⏁⏁⍜⋏ ⍜⋏ ⏁⊑⟒ ⏁⍜⌿ ⍜⎎ ⏁⊑⟟⌇ ⌿⏃☌⟒. ⏁⊑⟟⌇ ⍙⟟⌰⌰ ☊⍀⟒⏃⏁⟒ ⏃ ☊⍜⌿⊬ ⍜⎎ ⏁⊑⟟⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⟟⋏ ⊬⍜⎍⍀ ⏃☊☊⍜⎍⋏⏁. ## ☊⌰⍜⋏⟒ ⏁⊑⟒ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ clone this repository ⋏⍜⍙ ☊⌰⍜⋏⟒ ⏁⊑⟒ ⎎⍜⍀☍⟒⎅ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⏁⍜ ⊬⍜⎍⍀ ⋔⏃☊⊑⟟⋏⟒. ☌⍜ ⏁⍜ ⊬⍜⎍⍀ ☌⟟⏁⊑⎍⏚ ⏃☊☊⍜⎍⋏⏁, ⍜⌿⟒⋏ ⏁⊑⟒ ⎎⍜⍀☍⟒⎅ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬, ☊⌰⟟☊☍ ⍜⋏ ⏁⊑⟒ ☊⍜⎅⟒ ⏚⎍⏁⏁⍜⋏ ⏃⋏⎅ ⏁⊑⟒⋏ ☊⌰⟟☊☍ ⏁⊑⟒ _copy to clipboard_ ⟟☊⍜⋏. ⍜⌿⟒⋏ ⏃ ⏁⟒⍀⋔⟟⋏⏃⌰ ⏃⋏⎅ ⍀⎍⋏ ⏁⊑⟒ ⎎⍜⌰⌰⍜⍙⟟⋏☌ `git` ☊⍜⋔⋔⏃⋏⎅: ```bash git clone "url you just copied" ``` ⍙⊑⟒⍀⟒ "url you just copied" (⍙⟟⏁⊑⍜⎍⏁ ⏁⊑⟒ ⍾⎍⍜⏁⏃⏁⟟⍜⋏ ⋔⏃⍀☍⌇) ⟟⌇ ⏁⊑⟒ ⎍⍀⌰ ⏁⍜ ⏁⊑⟟⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ (⊬⍜⎍⍀ ⎎⍜⍀☍ ⍜⎎ ⏁⊑⟟⌇ ⌿⍀⍜⟊⟒☊⏁). ⌇⟒⟒ ⏁⊑⟒ ⌿⍀⟒⎐⟟⍜⎍⌇ ⌇⏁⟒⌿⌇ ⏁⍜ ⍜⏚⏁⏃⟟⋏ ⏁⊑⟒ ⎍⍀⌰. copy URL to clipboard ⎎⍜⍀ ⟒⌖⏃⋔⌿⌰⟒: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` ⍙⊑⟒⍀⟒ `this-is-you` ⟟⌇ ⊬⍜⎍⍀ GitHub ⎍⌇⟒⍀⋏⏃⋔⟒. ⊑⟒⍀⟒ ⊬⍜⎍'⍀⟒ ☊⍜⌿⊬⟟⋏☌ ⏁⊑⟒ ☊⍜⋏⏁⟒⋏⏁⌇ ⍜⎎ ⏁⊑⟒ ⎎⟟⍀⌇⏁-☊⍜⋏⏁⍀⟟⏚⎍⏁⟟⍜⋏⌇ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⍜⋏ GitHub ⏁⍜ ⊬⍜⎍⍀ ☊⍜⋔⌿⎍⏁⟒⍀. ## ☊⍀⟒⏃⏁⟒ ⏃ ⏚⍀⏃⋏☊⊑ ☊⊑⏃⋏☌⟒ ⏁⍜ ⏁⊑⟒ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⎅⟟⍀⟒☊⏁⍜⍀⊬ ⍜⋏ ⊬⍜⎍⍀ ☊⍜⋔⌿⎍⏁⟒⍀ (⟟⎎ ⊬⍜⎍ ⏃⍀⟒ ⋏⍜⏁ ⏃⌰⍀⟒⏃⎅⊬ ⏁⊑⟒⍀⟒): ```bash cd first-contributions ``` ⋏⍜⍙ ☊⍀⟒⏃⏁⟒ ⏃ ⏚⍀⏃⋏☊⊑ ⎍⌇⟟⋏☌ ⏁⊑⟒ `git checkout` ☊⍜⋔⋔⏃⋏⎅: ```bash git checkout -b your-new-branch-name ``` ⎎⍜⍀ ⟒⌖⏃⋔⌿⌰⟒: ```bash git checkout -b add-alonzo-church ``` ## ⋔⏃☍⟒ ⋏⟒☊⟒⌇⌇⏃⍀⊬ ☊⊑⏃⋏☌⟒⌇ ⏃⋏⎅ ☊⍜⋔⋔⟟⏁ ⏁⊑⍜⌇⟒ ☊⊑⏃⋏☌⟒⌇ ⋏⍜⍙ ⍜⌿⟒⋏ `Contributors.md` ⎎⟟⌰⟒ ⟟⋏ ⏃ ⏁⟒⌖⏁ ⟒⎅⟟⏁⍜⍀, ⏃⎅⎅ ⊬⍜⎍⍀ ⋏⏃⋔⟒ ⏁⍜ ⟟⏁. ⎅⍜⋏'⏁ ⏃⎅⎅ ⟟⏁ ⏃⏁ ⏁⊑⟒ ⏚⟒☌⟟⋏⋏⟟⋏☌ ⍜⍀ ⟒⋏⎅ ⍜⎎ ⏁⊑⟒ ⎎⟟⌰⟒. ⌿⎍⏁ ⟟⏁ ⏃⋏⊬⍙⊑⟒⍀⟒ ⟟⋏ ⏚⟒⏁⍙⟒⟒⋏. ⋏⍜⍙, ⌇⏃⎐⟒ ⏁⊑⟒ ⎎⟟⌰⟒. git status ⟟⎎ ⊬⍜⎍ ☌⍜ ⏁⍜ ⏁⊑⟒ ⌿⍀⍜⟊⟒☊⏁ ⎅⟟⍀⟒☊⏁⍜⍀⊬ ⏃⋏⎅ ⟒⌖⟒☊⎍⏁⟒ ⏁⊑⟒ ☊⍜⋔⋔⏃⋏⎅ `git status`, ⊬⍜⎍'⌰⌰ ⌇⟒⟒ ⏁⊑⟒⍀⟒ ⏃⍀⟒ ☊⊑⏃⋏☌⟒⌇. ⏃⎅⎅ ⏁⊑⍜⌇⟒ ☊⊑⏃⋏☌⟒⌇ ⏁⍜ ⏁⊑⟒ ⏚⍀⏃⋏☊⊑ ⊬⍜⎍ ⟊⎍⌇⏁ ☊⍀⟒⏃⏁⟒⎅ ⎍⌇⟟⋏☌ ⏁⊑⟒ `git add` ☊⍜⋔⋔⏃⋏⎅: ```bash git add Contributors.md ``` ⋏⍜⍙ ☊⍜⋔⋔⟟⏁ ⏁⊑⍜⌇⟒ ☊⊑⏃⋏☌⟒⌇ ⎍⌇⟟⋏☌ ⏁⊑⟒ `git commit` ☊⍜⋔⋔⏃⋏⎅: ```bash git commit -m "Add to Contributors list" ``` ⍀⟒⌿⌰⏃☊⟟⋏☌ `` ⍙⟟⏁⊑ ⊬⍜⎍⍀ ⋏⏃⋔⟒. ## ⌿⎍⌇⊑ ☊⊑⏃⋏☌⟒⌇ ⏁⍜ GitHub ⌿⎍⌇⊑ ⊬⍜⎍⍀ ☊⊑⏃⋏☌⟒⌇ ⎍⌇⟟⋏☌ ⏁⊑⟒ ☊⍜⋔⋔⏃⋏⎅ `git push`: ```bash git push origin -u ``` ⍀⟒⌿⌰⏃☊⟟⋏☌ `` ⍙⟟⏁⊑ ⏁⊑⟒ ⋏⏃⋔⟒ ⍜⎎ ⏁⊑⟒ ⏚⍀⏃⋏☊⊑ ⊬⍜⎍ ☊⍀⟒⏃⏁⟒⎅ ⟒⏃⍀⌰⟟⟒⍀.
⟟⎎ ⊬⍜⎍ ☌⟒⏁ ⏃⋏⊬ ⟒⍀⍀⍜⍀⌇ ⍙⊑⟟⌰⟒ ⌿⎍⌇⊑⟟⋏☌, ☊⌰⟟☊☍ ⊑⟒⍀⟒: - ### ⏃⎍⏁⊑⟒⋏⏁⟟☊⏃⏁⟟⍜⋏ ⟒⍀⍀⍜⍀ 
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//first-contributions.git/'
☌⍜ ⏁⍜ [GitHub's ⏁⎍⏁⍜⍀⟟⏃⌰](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ⍜⋏ ☌⟒⋏⟒⍀⏃⏁⟟⋏☌ ⏃⋏⎅ ☊⍜⋏⎎⟟☌⎍⍀⟟⋏☌ ⏃⋏ ⌇⌇⊑ ☍⟒⊬ ⏁⍜ ⊬⍜⎍⍀ ⏃☊☊⍜⎍⋏⏁.
## ⌇⎍⏚⋔⟟⏁ ⊬⍜⎍⍀ ☊⊑⏃⋏☌⟒⌇ ⎎⍜⍀ ⍀⟒⎐⟟⟒⍙ ⟟⎎ ⊬⍜⎍ ☌⍜ ⏁⍜ ⊬⍜⎍⍀ ⍀⟒⌿⍜⌇⟟⏁⍜⍀⊬ ⍜⋏ ☌⟟⏁⊑⎍⏚, ⊬⍜⎍'⌰⌰ ⌇⟒⟒ ⏃ `Compare & pull request` ⏚⎍⏁⏁⍜⋏. ☊⌰⟟☊☍ ⍜⋏ ⏁⊑⏃⏁ ⏚⎍⏁⏁⍜⋏. create a pull request ⋏⍜⍙ ⌇⎍⏚⋔⟟⏁ ⏁⊑⟒ `pull request`. 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). ================================================ FILE: docs/translations/README.ur.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) #
پہلی شراکت يا کانٹریبیوشن
اس پروجیکٹ کا مقصد ابتدائی افراد کے اپنا پہلى شركت يا کانٹریبیوشن کرنے کے طریقے کو آسان بنانا اور رہنمائی کرنا ہے۔ اگر آپ اپنا پہلا حصہ ڈالنا چاہتے ہیں تو نیچے دیے گئے مراحل پر عمل کریں۔

اگر آپ کمانڈ لائن سے واقف نہیں ہیں تو، یہاں جى يو آئ ٹولز استعمال کرنے كا طریقہ موجود ہے۔

اگر آپ کی مشین پر گٹ نہیں ہے تو، انسٹال کریں
##
اس ریپوزٹری کو فورک کریں
اس صفحے کے سب سے اوپر فورک بٹن دبا کر اس ریپوزٹری کا استعمال کریں. اس ریپوزٹری کوفورک کریں
یہ آپ کے اکاؤنٹ میں اس کی ایک نقل بنا كے ذخیرہ کرے گا۔.

##
ریپوزٹری کا کلون کیجیے
اب آپ اپنے کمپیوٹر مشین پر یہ ریپوزٹری کلون کریں.
ریپوزٹری کا کلون کیجیئے
کلون بٹن کو دبائیں اور پھر "copy to clipboard" آئیکن کو دبائیں۔
یوآرایل کلپ بورڈ پر کاپی کریں
ایک ٹرمینل کھولیں اور مندرجہ ذیل گٹ کمانڈ چلائیں:
```bash git clone "یو آر ایل جو آپ نے ابھی کاپی کیا" ```
جہاں "یو آر ایل جو آپ نے ابھی کاپی کیا" (اقتباس کے نشانات " " کے بغیر) اس ریپوزٹری کو کلون کرنے کا یو آر ایل کا اندراج مراد ہے. یو آر ایل حاصل کرنے کیلئے پچھلے مرحلے کو دیکھیں.
مثال کے طور پر:
```bash git clone https://github.com/this-is-you/first-contributions.git ```
اس میں 'this-is-you' آپکا GitHub یوزرنیم ہے۔ یہاں آپ first-contributions GitHub ریپوزٹری کے مندرجات کمپیوٹر پر نقل کر رہے ہیں.
##
ایک شاخ (برانچ) بنائیں
اپنے کمپیوٹر پر ریپوزٹری کی ڈائرکٹری تبدیل کریں (اگرآپ پہلے سے وہاں نہیں ہیں):
```bash cd first-contributions ```
اب git checkout کمانڈ استعمال کرتے ہوئے ایک شاخ/برانچ تشکیل دیں :
```bash git checkout -b ```
مثال کے طور پر:
```bash git checkout -b add-alonzo-church ```
شاخ (برانچ) کا نام میں ضروری نہیں add شامل کریں، لیکن یہ مناسب ہے کہ اس میں یہ شامل ہو، کیونکہ اس شاخ کا مقصد آپ کے نام کو فہرست میں شامل کرنا ہے.
##
ضروری تبدیلیاں کریں اور ان تبدیلیوں کو انجام دیں۔
اب Contributors.md فائل کو ٹیکسٹ ایڈیٹر پر کھولیں، اپنا نام اس میں شامل کریں، اور پھر فائل کو محفوظ کریں۔ نام فائل کے شروع یا آخر میں شامل نہ کریں۔ اسے درمیان میں کہیں بھی ڈال دیں۔اگر آپ پراجیکٹ ڈائرکٹری میں جاتے ہیں اور کمانڈ git status کو چلاتے ہیں، تو آپ دیکھیں گے کہ تبدیلیاں موجود ہیں. ان تبدیلیوں کو اس شاخ میں git add کمانڈ استعمال کرتے ہوئے شامل کریں، جسے ابھی آپ نے بنایا تھا۔ :
```bash git add Contributors.md ```
اب git commit کمانڈ کا استعمال کرتے ہوئے ان تبدیلیوں کا ارتکاب کریں:
```bash git commit -m "Add to Contributors list" ```
<your-name> کو اپنے نام کے ساتھ تبدیل کردیں.
##
ان تبدیلیوں کو GitHub پردهکیل دیں۔
git push کمانڈ کے ذریعے اپنی تبدیلیوں کو پش کریں:
```bash git push origin ```
<add-your-name> کو شاخ کے نام کے ساتھ بدل دیں، جسے آپ نے پہلے بنایا تھا.
##
اپنی تبدیلیوں کو جائزے کیلئے جمع کروائیں۔
اگر آپ GitHub پر اپنی ریپوزٹری پر جاتے ہیں تو، آپ کو Compare & pull request دکھائی دے گا. اس بٹن کو دبائیں.
پل ریکویسٹ بنائیں
اب پل درخواست جمع کروائیں.
پل ریکویسٹ جمع کروائیں
جلد ہی میں آپ کی تمام تبدیلیوں کو اس پروجیکٹ کی ماسٹر شاخ میں ضم کر دونگا. تبدیلیوں کو ضم کرنے کے بعد آپ کو نوٹیفکیشن ای میل مل جائے گی
##
آگے کیا کرنا چاہیے؟
مبارک ہو! آپ نے کامیابی سے فورک -> کلون -> ترمیم -> پل ریکویسٹ ورک فلو مکمل کر لیا ہے جو آپ کو اکثر ایک شراکت دار کے طور پر ملے گا اپنی شراکت کا جشن منائیں اور اپنے دوستوں اور فالوورز کے ساتھ اسے ویب ایپ پر جا کر شیئر کریں۔

اب ہم آپ کو دوسرے پراجيكٹس میں شراکت کرنے کے لئے دعوت ديتے ہیں۔ ادھر آپ چند مقبول ذخیروں میں کچھ ابتدائی سطح کے مسائل حل کر سکتے ہیں. آگے بڑھیے اور مزید جاننے کے لئے ان ذخیروں پر جائیے۔
###
[ اضافی مواد ](../additional-material/git_workflow_scenarios/additional-material.md)
##
دوسرے ٹولز کو استعمال کرتے ہوئے سبق۔
| گِٹ ہب ڈیسک ٹاپ | ویژول اسٹوڈیو 2017 | گِٹ کریکن | ویژول اسٹوڈیو کوڈ | سورس ٹری ایپ | انٹیلی جے آئی ڈی ای اے | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |
اس منصوبے کی حمایت کی ہے

================================================ FILE: docs/translations/README.uz.md ================================================ [![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Birinchi hissalar Ushbu loyiha yangi boshlanuvchilarning birinchi hissasini(Contribution) qo'shish usullarini soddalashtirish va yo'naltirishga qaratilgan. Agar siz birinchi hissangizni qo'shmoqchi bo'lsangiz, quyidagi amallarni bajaring. _Agar buyruq satri sizga mos bo'lmasa, [Bu erda GUI vositalaridan foydalanib amalga oshirishga oid darsliklari mavjud](#boshqa-vositalardan-foydalanish-uchun-qollanmalar)_ repositoryni fork qiling #### Agar kompyuteringizda git mavjud bo'lmasa, [buni o'rnating](https://help.github.com/articles/set-up-git/). ## Bu repositoryni fork qilib oling Bu repositoryni ushbu sahifaning yuqorisidagi fork tugmasini bosish orqali fork qilib oling. Bu hisobingizda ushbu repositoryning nusxasini yaratadi. ## Bu repositoryni klon qilib oling bu repositoryni klon qilib oling Endi fork qilingan repositoryni kompyuteringizga klon qiling. GitHub akkountingizga kirib, fork qilingan repositoryni oching, code tugmasi ustiga bosing va keyin _copy to clipboard_ belgisi (icon) ustiga bosing. Terminalni oching va quyidagi git buyruqlarini yurg'izing: ```bash git clone "siz hozirgina ko'chirib olgan url" ``` bu yerda "siz hozirgina ko'chirib olgan url" (qo'shtirnoqlarsiz) ushbu repositoryning (siz fork qilingan proyekt) 'URL'idir. URLni olish uchun oldingi bosqichlarni ko'ring. urlni klipboardga ko'chiring Misol uchun: ```bash git clone https://github.com/bu-siz/first-contributions.git ``` bu yerdagi `bu-siz` sizning Github hisobingiz nomi (username). Bu yerda Githubdagi first-contributions repositorysining kontentlarini kompyuteringizga ko'chiryapsiz. ## Branch yaratish Kompyuteringizda repository papkasiga kiring (agar u yerda bo'lmasangiz) ```bash cd first-contributions ``` Endi `git switch` buyrug'i orqali branch yarating: ```bash git switch -c yangi-branch-nomingiz ``` Misol uchun: ```bash git switch -c new_branch # yangi branch ``` ## O'zgartirishlar kiriting va commit yarating! Endi matn muharririda `Contributors.md` faylini oching, unga ismingizni qo'shing. Uni faylning boshiga yoki oxiriga qo'shmang. Uni istalgan o'rta qismga qo'shing. Endi faylni saqlang. git status Agar proyekt papkasiga o'tsangiz va `git status` buyrug'ini ishga tushirsangiz, o'zgarishlar borligini ko'rasiz. `git add` buyrug'i yordamida hosil qilgan branchingizga o'zgarishlarni qo'shing: ```bash git add Contributors.md ``` Endi `git commit` buyrug'i yordamida bu o'zgarishlarni commit qiling: ```bash git commit -m "Contributors ro'yxatiga ismingiz-ni kiritish" ``` `ismingiz-` ni o'rniga o'zingizni ismingizni yozing. ## O'zgarishlarni Githubga push qilish `git push` buyrug'i bilan o'zgartishlaringizni push qiling: ```bash git push origin -u new_branch # siz yaratgan yangi branch ```
Push qilish vaqtida biror xatolarni ko'rsangiz, bu yerni bosing - ### Autentifikatsiya Xatoligi 
  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//first-contributions.git/'
Akkountingizga SSH kalit yaratish va konfiguratsiya qilish uchun [GitHub qo'llanma](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ga o'ting.
## O'zgartirishlaringizni ko'rib chiqilishi uchun topshirish Agar Githubdagi repositoryingizga o'tsangiz, `Compare & pull request` tugmasini ko'rasiz. Shu tugma ustiga bosing!. pull request hosil qilish Endi Pull Requestni submit qiling. pull request submit qilish Tez orada men sizning barcha o'zgarishlaringizni ushbu proyektning main branchiga birlashtiraman. O'zgarishlar birlashtirilgandan so'ng sizga elektron pochta xabarnomasi keladi. ## Bu yerdan qayerga borish? Tabriklayman! Siz hozirgina contributor sifatida tez-tez uchraydigan standard ish ketma-ketligi ya'ni _fork -> clone -> edit -> pull request_ ni tamonladingiz. Hissangizni nishonlang va [web app](https://firstcontributions.github.io/#social-share)ga o'tish orqali do'stlaringizga va ergashuvchilaringizga ulashing. Agar koʻproq mashq qilishni istasangiz, [kod hissalarini](https://github.com/roshanjossey/code-contributions) tekshiring. Endi boshqa proyektlarga hissa qo‘shishni boshlaylik. Siz boshlashingiz mumkin bo'lgan oson masalalar bilan proyektlar ro'yxatini tuzdik. Ko'zdan kechiring [web appdagi proyektlar ro'yxati](https://firstcontributions.github.io/#project-list). ### [Qo'shimcha materiallar](additional-material/git_workflow_scenarios/additional-material.md) ## Boshqa Vositalardan Foydalanish Uchun Qollanmalar | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.vn.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Những đóng góp đầu tiên Lần đầu tiên bạn làm điều gì đó có thể gặp nhiều trở ngại. Đặc biệt khi bạn đang cộng tác, sai lầm là điều rất khó tránh khỏi. Việc đọc hướng dẫn có tác dụng, nhưng có gì tốt hơn là thực sự đóng góp trong môi trường thực tiễn? Dự án này là nhằm mục đích cung cấp sự hướng dẫn và đơn giản hóa cách thức những người mới tham gia đóng góp. Nếu bạn mong muốn thực hiện việc đóng góp đầu tiên của mình, chỉ cần làm theo các bước đơn giản bên dưới. #### *Nếu bạn không thoải mái khi làm việc với dòng lệnh, [đây là các hướng dẫn sử dụng các công cụ có giao diện đồ họa (GUI).]( #Hướng-dẫn-sử-dụng-các-công-cụ-khác )* Rẽ nhánh kho lưu trữ Nếu bạn không có git trên máy tính của bạn, [cài đặt git](https://help.github.com/articles/set-up-git/). ## Rẽ nhánh kho lưu trữ (Fork) Rẽ nhánh kho lưu trữ mã nguồn (repository) này bằng cách nhấn vào nút `Fork` trên đầu trang này. Một bản sao kho lưu trữ này sẽ được tạo ra trong tài khoản của bạn. ## Tạo bản lưu nội bộ của kho lưu trữ trên máy tính của bạn (clone) Tạo bản lưu nội bộ của kho lưu trữ Bây giờ, hãy sao chép, tạo bản lưu nội bộ của kho lưu trữ này vào máy của bạn. Để thực hiện thao tác này, truy xuất vào tài khoản GitHub của bạn, mở kho lưu trữ đã tạo nhánh rồi nhấn vào nút `Code`, và sau đó nhấn vào biểu tượng *copy to clipboard* Mở một cửa sổ terminal và chạy lệnh git sau đây: ```bash git clone "url bạn vừa sao chép" ``` Trong đó `"url bạn vừa sao chép"` (không có dấu ngoặc kép) là url dẫn vào kho lưu trữ mà bạn đã tạo ra trong tài khoản của bạn). Xem các bước trước đó để có được url. sao chép URL vào clipboard Ví dụ: ```bash git clone https://github.com/tên-bạn/first-contributions.git ``` Trong đó `tên-bạn` là tên người dùng (username) tài khoản GitHub của bạn. Ở đây bạn đang sao chép nội dung của kho mã nguồn "first-contributions" trên GitHub vào máy tính của bạn ## Tạo nhánh (branch) Di chuyển đến thư mục chứa kho lưu trữ trên máy tính của bạn (nếu bạn chưa ở đó): ```bash cd first-contributions ``` Bây giờ tạo ra một nhánh (branch) sử dụng lệnh `git switch` ```bash git switch -c ``` Ví dụ: ```bash git switch -c thêm-Tran-Ly-Vu ``` (Tên của nhánh mới không cần phải có từ *thêm* trong đó, nhưng nó được dùng vì mục đích của nhánh này là thêm tên của bạn vào danh sách.) ## Thực hiện những thay đổi cần thiết và chấp nhận (commit) những thay đổi này Bây giờ mở tập tin `Contributors.md` trong một trình soạn thảo văn bản và thêm tên của bạn vào. Đừng thêm vào đầu hoặc cuối tập tin. Thêm vào bất cứ nơi nào ở giữa. Sau đó, lưu tập tin. trạng thái git Nếu bạn vào thư mục hiện tại của project và thực hiện lệnh `git status` (trạng thái git), bạn sẽ thấy những thay đổi. Thêm những thay đổi vào nhánh bạn vừa tạo bằng lệnh `git add`: ```bash git add Contributors.md ``` Bây giờ chấp nhận những thay đổi bằng cách sử dụng dòng lệnh `git commit` dưới đây: ```bash git commit -m "Them vào danh sách Cộng tác viên" ``` thay thế `` bằng tên của bạn. ## Đẩy (push) các thay đổi lên GitHub Đẩy những thay đổi của bạn sử dụng `git push`: ```bash git push origin ``` thay thế `` với tên của nhánh bạn tạo ra trước đó.
Nếu bạn gặp bất cứ lỗi gì trong lúc thực hiện thao tác push, nhấn vào đây: - ### Lỗi xác thực (Authentication Error) 
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//first-contributions.git/'
Truy cập vào [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) về việc tạo cấu hình khóa SSH cho tài khoản của bạn.
## Gửi yêu cầu xem xét các thay đổi của bạn Nếu bạn mở kho mã nguồn của bạn trên GitHub, bạn sẽ thấy nút `Compare & pull request`. Nhấn vào nút đó. yêu cầu hợp nhất Bây giờ, hãy gửi yêu cầu hợp nhất (pull request) gửi yêu cầu hợp nhất Tôi sẽ sớm hợp nhất (merge) tất cả các thay đổi của bạn vào nhánh chính (master branch) của dự án này. Bạn sẽ nhận được email thông báo sau khi các thay đổi đã được gộp. ## Bước tiếp theo là gì? Chúc mừng! Bạn vừa hoàn thành quy trình tiêu rẽ nhánh (fork) -> Sao chép (clone) -> chỉnh sửa (edit) -> yêu cầu hợp nhất (pull request) mà bạn sẽ thường gặp khi đóng góp vào những dự án! Hãy ăn mừng đóng góp của bạn, và chia sẻ nó với bạn bè và những người theo dõi của bạn bằng cách truy cập [ứng dụng web](https://firstcontributions.github.io/#social-share). Để hỗ trợ bạn với việc đóng góp cho các dự án (project) khác, chúng tôi đã tổng hợp một danh sách các dự án có các vấn đề đơn giản mà bạn có thể bắt đầu. Hãy kiểm tra [danh sách dự án trong ứng dụng web](https://firstcontributions.github.io/#project-list). ### [Tài liệu bổ sung](../additional-material/git_workflow_scenarios/additional-material.md) ## Hướng dẫn sử dụng các công cụ khác | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.yor.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Akọkọ ilowosi Lati dasi nko lakoko n'le, pataki ti a ba ronu nipa asise ti a le bapade, a fe ko rorun fun awon ilowosi akoko lati le dasi ise agbese lakoko, ise agbese yi a ko yin be ese le se, e tele ilana ni isalẹ #### *to ba le lo pipaṣẹ, [awon ona mi re.](#Tutorials-Usin'-Other-Tools)* ṣe fork repository yìí e fi git sori ẹrọ [install it](https://help.github.com/articles/set-up-git/). ## orita ibi ipamọ yii orita ibi ipamọ yii, e te ' fork bọtini' ni oke oju iwe yi, e leyi a fun yin ni daako ni accounti yin ## Dide ibi ipamọ ṣe clone repository yìí oya e de ibi ipamọ yi si account yin, e lo si githubu accounti yin, e te 'clone botini, ke wa te 'copy to clipboard' . e sii ebute in ero ise yin, e te pipaṣẹ to be a labe oro yi si: ```bash git clone "ọna asopọ ' te daakọ" ``` ibi, "ọna asopọ ' te daakọ" (lai awọn ' quote iṣmiṣ) lo je ono asopo ti e dide ibi ipamo (e dide ibi ipamo ise igbesi). e wo awon atono ti tele to n be loke da URL sí clipboard oye ko ri bi: ```bash git clone https://github.com/oruko yin/first-contributions.git ``` ibi `oruko yin` ni oruko githubu accounti yin. ni bi yi en didako awon akoonu ' first-contributions repository in GitHubu' si ero ise yin. ## ṣẹda ẹka seda eka si ero, amo ko to sebe te pipaṣẹ yi si ibe ```bash cd first-contributions ``` oya seda eka si pelu ' `git checkout` pipase: ```bash git checkout -b ``` fun apere: ```bash git checkout -b add-luke-oliff ``` (kon se dadun ki e lo "add", amo o daa fun irun nnkan bayii) ## Ṣe awọn ayipada to ṣe pataki 'n ṣe awọn ayipada yẹn oya shi faili `Contributors.md` ninu olootu ọrọ, fi oruko re mo awon oruko to 'n wan be, ma fe se akoko tabi igbeyn, fi si arin. git status to ba te pipase `git status` si ebute re, wa re awon ayipada ti ose fi won mo eka ti ode pelu pipase yii `git add`: ```bash git add Contributors.md ``` oya dawon papop pelu pipase yi `git commit`: ```bash git commit -m "Add to Contributors list" ``` yi `` pada si oruko re. ## Titari awọn ayipada si GitHub te pipase yi `git push`: ```bash git push origin ``` yi `` pada si orku e da ti ese ni ibere ## Fi yer ayipada fer awotẹlẹ Ti o ba lọ t' yer ibi ipamọ lori GitHub, iwọ yoo ri a `Compare & pull request` botini. te botini yen. ṣe ìbéèrè pull request oya fi silẹ. fi pull request ranṣẹ To ba ya a ma so gbogo yipada ti e se papo, e o gba iwifunni lori imeeli yin ## Nibo ni lati lọ? Ku ise oti pari boṣewa bisesenlo _fork -> clone -> edit -> PR_ bisesenlo ti o ma bapade ni ise asowopo Ṣe ayẹyẹ ilowosi yer 'ki o pin pẹlu' awọn ọkan ati awọn ọmọlẹyin nipasẹ lilọ’ si [web app](https://firstcontributions.github.io/#social-share). Bayi jẹ ki a bẹrẹ pẹlu' idasi' t' awọn iṣẹ akanṣe miiran. A ti ṣe akojọpọ awọn iṣẹ akanṣe pẹlu awọn ọran irọrun ti o le bẹrẹ. Ṣayẹwo [awon re](https://firstcontributions.github.io/#project-list). ### [Ptu le ka](../additional-material/git_workflow_scenarios/additional-material.md) ## Tutorial lilo 'miiran Irinṣẹ | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/README.zh-cn.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # 第一次参与开源项目 万事开头难。特别是和其他人合作时，出错往往会令人不适。不过，开源的本质就是和他人合作。这个项目的初衷就是为初学者提供一个简单的方法去学习以及参与开源项目。 你可以通过阅读文章和观看教程来得到帮助，但上手实操才是最好的学习方式。本项目旨在简化并指导初学者参与他们的第一次开源。记住：过程越轻松，学习效益越高。如果你想要做出第一次贡献，只需按照以下简单步骤操作即可。这将会是一个很有趣的过程 :) _如果你对 command line（命令行）不熟悉，请参考以下的 [GUI 工具教程](#使用其他工具的教程)。_ 复制此仓库代码 #### 如果你的电脑上未安装 git, 请参考 [GitHub 文档](https://docs.github.com/cn/get-started/quickstart/set-up-git) 进行安装。 ## Fork（复制）本代码仓库 点击图示中的按钮去 Fork 这个代码仓库。 这个操作会将代码仓库复制到你的账户名下。 ## Clone（克隆）代码仓库 克隆此仓库代码 接下来将复制的代码仓库克隆到你的电脑上。点击图示中的绿色按钮，接着点击复制到剪切板按钮（将代码仓库地址复制下来） 随后打开命令行窗口，敲入如下 git 命令： ``` git clone "刚才复制的 url 链接" ``` "刚才复制的 url 链接"（去掉双引号）就是复制到你账户名下的代码仓库地址。获取该链接的方法详见上一步。 将url链接复制到剪贴板 譬如： ```bash git clone git@github.com:/first-contributions.git ``` 'Github 用户名' 指的是你的 Github 用户名。这一步，这个操作将会克隆你账户名下 first-contributions 这个代码仓库到本地电脑上。 ## 新建一个代码分支 在命令行窗口中把目录切换到 first-contributions ```bash cd first-contributions ``` 接下来使用 `git switch` 命令新建一个代码分支 ```bash git switch -c <新分支的名称> ``` 譬如： ```bash git switch -c add-myname ``` (新分支的名称不一定需要有 *add*。然而，在新分支的名称加入 *add* 是一件合理的事情，因为这个分支的目的是将你的名字添加到列表中。) ## 对代码进行修改，然后 Commit (提交) 修改 打开 `Contributors.md` 这个文件，更新文件内容，将你的名字加上去，保存修改。`git status` 这命令会列出被改动的文件。接着 `git add` 这命令则可以添加你的改动，就像如下这条命令。 修改`Contributors.md`后的git状态 ```bash git add Contributors.md ``` 现在就可以使用 `git commit` 命令 commit 你的修改了。 ```bash git commit -m "Add <你的名字> to Contributors list" ``` 将 `<你的名字>` 替换成你的名字 ## 将改动 Push（推送）到 GitHub 使用 `git push` 命令推送代码 ```bash git push origin <分支的名称> ``` 将 `<分支的名称>` 替换为之前新建的分支名称。
如果在 push（发布）过程中出 error（错误），点击这里 - ### Authentication Error 
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//first-contributions.git/'
去 [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) 学习如何生成新的 SSH 密匙以及配置。
## 提出 Pull Request 将你的修改供他人审阅 前往你的 Github 代码仓库，你会看到一个 `Compare & pull request` 的按钮。点击该按钮。 创建 pull request 接着再点击 `Create pull request` 按钮，正式提交 pull request。 提交 pull request 不久之后，我便会把你所有的变化合并到这个项目的主分支。更改合并后，你会收到一封电子邮件通知。 ### [ 更多资料 ](../additional-material/git_workflow_scenarios/additional-material.md) ## 接下来该做什么呢？ 祝贺！你刚刚完成了作为贡献者经常会使用到的标准流程：_fork -> clone -> edit -> pull request_ ！ 为你的第一次贡献庆祝吧，不要忘记和你的朋友以及你的小迷弟小迷妹们分享我们的[网站](https://roshanjossey.github.io/first-contributions/#social-share)哟！ 如果您想更多练习，请查看 [code contributions](https://github.com/roshanjossey/code-contributions)。 接下来，让我们带你开始参与到其他项目中来。我们整理了一份包含一些简单入门问题的项目清单，方便你快速上手。请查看这个[项目清单](https://firstcontributions.github.io/#project-list)。 ### [附加材料](additional-material/git_workflow_scenarios/additional-material.md) ## 使用其他工具的教程 | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |

项目支持者:

================================================ FILE: docs/translations/README.zh-tw.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # 第一次參與開源 萬事起頭難。特別是和其他人合作時，犯錯格外令人不舒服。不過，開源的本質就是和其他人合作。我們希望為初學者帶來一個簡單的方法來學習及參與開源項目。 閱讀文章和觀看教學會有所幫助。不過，有什麼方法能比在不會弄亂任何東西的情況下，實際動手做來得更好？本項目旨在指導初學者及簡化初學者參與開源的方式。記住：過程越輕鬆，學習效益越高。如果妳/你想要做出第一次貢獻，只需按照以下簡單步驟操作即可。跟你保證，這會很好玩 :) _如果你不喜歡使用指令列，[這裡有使用圖形界面工具的教學。](#使用其他工具的教學)_ 分叉本儲存庫 #### 如果你的電腦上尚未安裝 git，請按照這個[安裝指南（英文）](https://help.github.com/articles/set-up-git/)進行安裝。 ## 分叉（Fork）本儲存庫 點選圖示中的按鈕來 Fork 這個 Git 儲存庫。 這個操作會將儲存庫分叉到你/妳的 GitHub 帳號下。 ## 複製（Clone）儲存庫 複製本儲存庫 接下來，將分叉後的儲存庫複製到你/妳的電腦上。前往你/妳的GitHub帳號，打開分叉到帳號下的儲存庫，點選圖示中的綠色按鈕，接著在SSH分頁上點選*複製到剪貼簿*按鈕（將儲存庫網址複製下來）。 隨後打開命令列視窗，輸入如下 git 命令： ```bash git clone "url you just copied" ``` "url you just copied"（去掉雙引號）就是複製到妳/你帳戶名下的儲存庫網址。取得這網址的方法請見上一步。 複製連結到剪貼簿 譬如： ```bash git clone git@github.com:this-is-you/first-contributions.git ``` `this-is-you` 指的就是你/妳的 GitHub 用戶名。這一步會將你/妳的 first-contributions 儲存庫複製到你的電腦上。 ## 新建一個分支（Branch） 下面的命令能在命令行窗口中，把目錄切換到 first-contributions（如果你/妳尚未切換到該目錄）： ```bash cd first-contributions ``` 接下來使用 `git switch` 命令建立一個分支： ```bash git switch -c your-new-branch-name ``` 譬如： ```bash git switch -c add-david ``` （新分支的名稱不一定需要有 _add_。然而，在這個新分支的名稱加入 _add_ 是一件合理的事情，因為這個分支的目的是將妳/你的名字添加到貢獻者列表中。）
如果在使用 git switch 命令的過程中出現錯誤（error），點擊這裡： 如果顯示錯誤訊息 "Git: `switch` is not a git command. See `git –help`"，這可能是因為你/妳使用的是舊版的 git。 在這種情況下，請改為使用 `git checkout` 命令： ```bash git checkout -b your-new-branch-name ```
## 對程式碼進行修改，然後提交 (Commit) 修改 使用妳/你喜歡的編輯器打開 `Contributors.md` 這個文件，將自己的名字加在檔案中，不要將其添加到文件的開頭或結尾。將其新增至文件中間的任意位置，然後存檔。 被更動的文件 在命令窗口執行 `git status`，這會列出被更動的文件。 接著 `git add` 這命令則可以添加更動項目到分支裡，就像以下這條命令： ```bash git add Contributors.md ``` 現在就可以使用 `git commit` 命令 commit（提交）你/妳的修改了： ```bash git commit -m "Add your-name to Contributors list" ``` 將 `your-name` 替換為自己的名字。 ## 將更動發佈（Push）到 GitHub 使用 `git push` 命令發佈代碼： ```bash git push -u origin your-branch-name ``` 將 `your-branch-name` 替換為之前新建的分支名稱。
如果在發佈（push）過程中出現錯誤（error），點擊這裡： - ### 身份驗證錯誤（Authentication Error） 
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/'
去 [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) 學習如何生成新的 SSH 密匙以及配置。 此外，你/妳可能需要執行 'git remote -v' 來檢查遠端儲存庫的URL。 如果看起來與這樣有一點相似： 
origin	https://github.com/your-username/your_repo.git (fetch)
  origin	https://github.com/your-username/your_repo.git (push)
使用以下命令更改它： ```bash git remote set-url origin git@github.com:your-username/your_repo.git ``` 否則，你/妳仍會收到要求輸入使用者名稱和密碼的提示，並出現身份驗證錯誤。
## 提出 Pull Request 將你/妳的修改供他人審閱 前往你/妳的GitHub帳號，打開分叉到帳號下的儲存庫，會看到一個 `Compare & pull request` 的按鈕，點選該按鈕。 建立一個 pull request 接著再點選 `Create pull request` 按鈕，正式提交 pull request。 提出 pull request 不久之後，如果妳/你更改的文件與原本沒有衝突，我們會把所有的變化合併到這個項目的主分支。 變更合併後，妳/你會收到通知 email。 ## 下一步？ 恭喜！妳/你剛剛完成了作為一個貢獻者會經常使用的標準工作流程：_fork -> clone -> edit -> pull request_！ 在[這個網站](https://firstcontributions.github.io/#social-share)慶祝妳/你的貢獻並跟朋友及追隨者分享。 如果你想要更多練習，請看 [code contributions](https://github.com/roshanjossey/code-contributions)。 現在就動手為其他專案貢獻你/妳的心力。我們整理了一個清單，裡面的專案都有簡單的議題可以著手。[去看看吧！](https://firstcontributions.github.io/#project-list) ### [ 更多資料 ](../additional-material/git_workflow_scenarios/additional-material.md) ## 使用其他工具的教學 | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) |

項目支持者:

================================================ FILE: docs/translations/README.zul.md ================================================ [![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions) # Iminikelo Yokuqala Sifuna ukusiza nokubonisa abanikeli abasha indlela yokuqala ngokunikela. Uma ufuna ukunikela kokuqala, landela lezinyathelo ezilandelayo. #### *Uma ungakhululekile ngomugqa womyalo, [nazi izifundo ezisebenzisa amathuluzi we-GUI.](#Izinto-ezengeziwe)* thola le repository Uma ungenayo i-git kumshini wakho, [ifake]( https://help.github.com/articles/set-up-git/). ## Fometha le ndawo yokugcina Fometha le repo ngokuchofoza inkinobho yemfoloko phezulu kwaleli khasi. Lokhu kuzokhipha ikhophi yalesi sikhwama ku-akhawunti yakho. ## Qalisa i-repository kopisha le repository Manje faka i-repo efakwe emshini wakho kumshini wakho. Yiya ku-akhawunti yakho ye-GitHub, vula i-repo evuliwe, chofoza inkinobho ye-clone bese uchofoza ikhophi ku-clipboard icon. Vula i-console bese ugijima umyalo we-git: ```bash git clone "url you just copied" ``` lapho "u-url osuvele ukopishe khona" (ngaphandle kwama-quote marks) yi-url kule ndawo yokugcina (ifomu lakho lephrojekthi). Bona izinyathelo zangaphambilini ukuthola i-url. kopisha i-URL kuphaneli Ngokwesibonelo: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` La kubalwe `this-is-you` faka i-username yakho yaku GitHub. Lapha ukopisha okuqukethwe kokulondoloza kokuqala ku-GitHub kwikhompyutha yakho. ## Dala igatsha Shintsha kwirekhodi lokugcina ekhompyutheni yakho (uma ungasekho kakade): ```bash cd first-contributions ``` Manje dala igatsha usebenzisa `git checkout` umyalo: ```bash git checkout -b ``` Ngokwesibonelo ```bash git checkout -b engeza-adam-kowalski ``` (Igama legatsha alidingi ukuba izwi engeza kuwo, kodwa into enengqondo ukufaka ngoba inhloso yaleli gatsha ukwengeza igama lakho uhlu.) ## Yenza ushintsho oludingekile bese wenza lezo zinguquko Manje `Contributors.md` ifayela evulekile kumhleli wombhalo, engeza igama lakho kuyo. Ungayifaki ekuqaleni noma ekupheleni kwefayela. Beka noma kuphi phakathi. Manje, londoloza ifayela. isimo se-git Uma uya encwadini yomhlahlandlela bese wenza umyalo `git status`, uzobona kukhona izinguquko. Engeza lezo zinguquko egatsheni owake wadala usebenzisa `git add` umyalo: ```bash git add Contributors.md ``` Manje yenza lezo zinguquko usebenzisa `git commit` umyalo: ```bash git commit -m "Add to Contributors list" ``` ukufaka esikhundleni `` ngegama lakho. ## Shintsha izinguquko ku-GitHub Pusha izinguquko zakho ngokusebenzisa umyalo `git push`: ```bash git push origin ``` kufaka esikhundleni `` igama legatsha owadala ngaphambilini. ## Thumela izinguquko zakho ukuze zibuyekezwe Uma uya endaweni yakho yokugcina ku-GitHub, uzobona `Compare & pull request` inkinobho. Chofoza kuleyo nkinobho. dala isicelo sokudonsa Manje thumela isicelo sokudonsa. thumela isicelo sokudonsa Ngizohlanganisa zonke izinguquko zakho ngokushesha zibe yigatsha eliyinhloko laphrojekthi. Uzothola i-imeyili yesaziso uma izinguquko sezihlanganisiwe. ## Ungaphi lapho? Siyakuhalalisela! Usanda kuqedela umshini ojwayelekile -> clone -> edit -> PR ukuhamba komsebenzi ozohlangana ngaso sonke isikhathi njengomnikelo! Gubha umnikelo wakho bese uwabelana nabangani bakho nabalandeli ngokuya kuhlelo [lokusebenza lewebhu](https://firstcontributions.github.io/#social-share). Manje ake siqale ngokunikela ngeminye imiklamo. Senze uhlu lwamaphrojekthi ngezinkinga ezilula ongaqala ngazo. Hlola [uhlu lwamaphrojekthi kuhlelo lokusebenza lewebhu .](https://firstcontributions.github.io/#project-list). ### [Izinto ezengeziwe](../additional-material/git_workflow_scenarios/additional-material.md) ## Izinto ezengeziwe | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [GitHub Desktop](../gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](../gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](../gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](../gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](../gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](../gui-tool-tutorials/github-windows-intellij-tutorial.md) | ================================================ FILE: docs/translations/Translations.md ================================================ # Translations | | Translated Link | |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------| | ગુજરાતી | [ગુજરાતી](README.guj.md) | | हिन्दी | [हिन्दी](README.hi.md) | | मराठी | [मराठी](README.mr.md) | | മലയാളം | [മലയാളം](README.ml.md) | | ಕನ್ನಡ | [ಕನ್ನಡ](README.ka.md) | | తెలుగు | [తెలుగు](README.te.md) | | ଓଡିଆ | [ଓଡିଆ](README.od.md) | | छत्तीसगढ़ी | [छत्तीसगढ़ी](README.hne.md) | | ਪੰਜਾਬੀ | [ਪੰਜਾਬੀ](README.pb.md) | | বাংলা বাংলা | [বাংলা](README.bn.md) | | தமிழ் தமிழ் | [தமிழ்](README.ta.md) | | မြန်မာ | [မြန်မာ](README.mm_unicode.md) | | Bahasa Indonesia | [Bahasa Indonesia](README.id.md) | | Català | [Català](README.ca.md) | | Français | [Français](README.fr.md) | | Español | [Español](README.es.md) | | Nederlands | [Nederlands](README.nl.md) | | Русский язык | [Русский язык](README.ru.md) | | Bulgarian | [Bulgarian](README.bg.md) | | Македонски | [Македонски](README.mk.md) | | Magyar | [Magyar](README.hu.md) | | Slovenčina | [Slovenčina](README.slk.md) | | 日本語 | [日本語](README.ja.md) | | Tiếng Việt | [Tiếng Việt](README.vn.md) | | Polski | [Polski](README.pl.md) | | فارسی | [فارسی](README.fa.md) | | | Lietuvių kalba | [Lietuvių kalba](README.lt.md) | | [한국어 [한국어 | [한국어](README.ko.md) | | Deutsch | [Deutsch](README.de.md) | | 中文 中文 | [中文(Simplified)](README.zh-cn.md), [中文(Traditional)](README.zh-tw.md) | | ελληνικά | [ελληνικά](README.gr.md) | | العربية | [العربية](README.ar.md) | | Українська | [Українська](README.ua.md) | | Português (Brasil) | [Português (Brasil)](README.pt_br.md) | | Português (Portugal) | [Português (Portugal)](README.pt-pt.md) | | Italiano | [Italiano](README.it.md) | | ภาษาไทย | [ภาษาไทย](README.th.md) | | 󠁥󠁳󠁧󠁡Galego | [Galego](README.gl.md) | | नेपाली | [नेपाली](README.np.md) | | اردو | [اردو](README.ur.md) | | Limba Română Limba Română | [Limba Română](README.ro.md) | | English | [English](../README.md) | | English (Pirate) | [English (Pirate)](README.en-pirate.md) | | Türkçe | [Türkçe](README.tr.md) | | עברית | [עברית](README.hb.md) | | Bahasa Melayu / بهاس ملايو‎ / Malay | [Bahasa Melayu / بهاس ملايو‎ / Malay](README.my.md) | | Czech | [Czech](README.cs.md) | | Slovenščina | [Slovenščina](README.sl.md) | | Norsk | [Norsk](README.no.md) | | Svenska | [Svenska](README.se.md) | | Dansk | [Dansk](README.da.md) | | المصرية | [المصرية](README.eg.md) | | Wikang Filipino | [Wikang Filipino](README.tl.md) | | Қазақша | [Қазақша](README.kz.md) | | Afrikaans (South Africa) | [Afrikaans (South Africa)](README.afk.md) | | Zulu (South Africa) | [Zulu (South Africa)](README.zul.md) | | Kiswahili (Kenya) | [Kiswahili (Kenya)](README.kws.md) | | ქართული | [ქართული](README.ge.md) | | Igbo (Nigeria) | [Igbo (Nigeria)](README.igb.md) | | Yoruba (Nigeria) | [Yoruba (Nigeria)](README.yor.md) | Hausa (Nigeria) | [Hausa (Nigeria)](README.hau.md) | | Pidgin (Nigeria) | [Pidgin (Nigeria)](README.pcm.md) | | Suomeksi | [Suomeksi](README.fi.md) | | Español de México | [Español de México](README.mx.md) | | Српски | [Српски](README.sr-Cyrl.md) | | Srpski | [Srpski](README.sr-Latn.md) | | Latvia | [Latvia](README.lv.md) | | Shqip | [Shqip](README.al.md) | | Беларуская мова | [Беларуская мова](README.by.md) | | Íslenska | [Íslenska](README.is.md) | | Azərbaycan dili | [Azərbaycan dili](translations/README.aze.md) | | Bosanski | [Bosanski](README.bih.md) | | پښتو | [پښتو - Pashto](README.ps.md) | | Dezéiriya | [Dezéiriya](README.dz.md)| | ພາສາລາວ | [ພາສາລາວ](README.la.md) | | Somalia |[Af-soomaali](README.so.md) | አማርኛ |[አማርኛ(Ethiopia)](README.am.md) | සිංහල | [සිංහල(Sri Lanka)](README.si.md) | Tükmençe | [Türkmençe](README.tm.md) | | հայերեն | [հայերեն](README.arm.md) | | Kurdî | [Kurdî](README.kr.md) | | Javanese | [Javanese](README.jv.md) | | Монгол хэл | [Монгол хэл](README.mn.md) |