From b166a1d130c49bc14cfd0a64edbf48b1d2ec2c79 Mon Sep 17 00:00:00 2001 From: Roshanjossey Date: Fri, 3 Jan 2025 22:30:04 +0100 Subject: [PATCH] reset repo --- .github/CODE_OF_CONDUCT.md | 133 ++ .github/CONTRIBUTING.md | 86 + .github/FUNDING.yml | 12 + .github/ISSUE_TEMPLATE.md | 20 + .github/ISSUE_TEMPLATE/issue-template.md | 30 + .github/funding.json | 98 + .github/workflows/auto-pr-merge.yml | 218 ++ .gitignore | 395 ++++ .prettierignore | 2 + Contributors.md | 2089 +++++++++++++++++ LICENSE | 21 + README.md | 255 ++ .../Things a non Programmer can do.es.md | 124 + .../Things a non Programmer can do.fr.md | 52 + .../Things a non Programmer can do.md | 124 + .../Things a non Programmer can do.ta.md | 157 ++ .../Things a non Programmer can do.th.md | 125 + .../Useful-links-for-further-learning.md | 46 + .../additional-material.md | 52 + .../amending-a-commit.md | 65 + .../check-commit-log.md | 37 + .../git_workflow_scenarios/configuring-git.md | 76 + .../creating-a-gitignore-file.md | 73 + .../delete-branch-locally.md | 19 + .../git_workflow_scenarios/gitflow.md | 119 + .../installing-git-ubuntu.md | 104 + ...g-your-fork-synced-with-this-repository.md | 45 + .../moving-a-commit-to-a-different-branch.md | 25 + .../git_workflow_scenarios/removing-a-file.md | 23 + .../removing-branch-from-your-repository.md | 31 + .../resetting-a-branch.md | 18 + .../resetting-a-commit.md | 20 + .../resolving-merge-conflicts.md | 35 + .../reverting-a-commit.md | 41 + .../squashing-commits.md | 86 + .../git_workflow_scenarios/stashing-a-file.md | 137 ++ .../storing-credentials.md | 48 + .../undoing-a-commit.md | 55 + .../why-using-branches.md | 53 + .../Useful-links-for-further-learning.by.md | 36 + .../Belarusian/additional-material.by.md | 46 + .../Belarusian/amending-a-commit.by.md | 46 + .../Belarusian/configuring-git.by.md | 76 + ...our-fork-synced-with-this-repository.by.md | 42 + ...oving-a-commit-to-a-different-branch.by.md | 25 + .../Belarusian/removing-a-file.by.md | 23 + ...removing-branch-from-your-repository.by.md | 31 + .../resolving-merge-conflicts.by.md | 33 + .../Belarusian/reverting-a-commit.by.md | 40 + .../Belarusian/squashing-commits.by.md | 86 + .../Belarusian/stashing-a-file.by.md | 137 ++ .../Belarusian/undoing-a-commit.by.md | 59 + .../translations/Bengali/add-file.bn.md | 31 + .../Bengali/additional-material.be.md | 52 + .../Chinese/additional-material.zh-cn.md | 46 + .../Chinese/addtional-material.cht.md | 46 + .../Farsi/amending-a-commit.fa.md | 85 + .../Farsi/delete-branch-locally.fa.md | 19 + ...oving-a-commit-to-a-different-branch.fa.md | 21 + .../French/additional-material.fr.md | 49 + .../French/amending-a-commit.fr.md | 52 + .../French/check-commit-log.fr.md | 20 + .../additional-material.gr.md | 52 + .../amending-a-commit.gr.md | 69 + .../check-commit-log.gr.md | 25 + .../configuring-git.gr.md | 78 + .../creating-a-gitignore-file.gr.md | 76 + .../delete-branch-locally.gr.md | 19 + .../git_workflow_scenarios/gitflow.gr.md | 125 + .../translations/Hindi/Amending a Commit | 65 + .../Hindi/Things a non Programmer can do | 128 + .../Useful-links-for-further-learning.hi.md | 45 + .../translations/Hindi/add-file.hi.md | 31 + ...oving-a-commit-to-a-different-branch.hi.md | 23 + .../translations/Hindi/removing-a-file.hi.md | 22 + ...removing-branch-from-your-repository.hi.md | 31 + .../Hindi/resetting-a-branch.hi.md | 18 + .../Hindi/resetting-a-commit.hi.md | 19 + .../Useful-links-for-further-learning.id.md | 46 + .../Indonesian/additional-material.id.md | 67 + .../Indonesian/removing-a-file.id.md | 23 + ...removing-branch-from-your-repository.id.md | 31 + .../Indonesian/resetting-a-commit.id.md | 21 + .../Italian/removing-a-file.it.md | 23 + .../Italian/reverting-a-commit.it.md | 40 + .../Korean/additional-material.ko.md | 52 + .../Korean/amending-a-commit.ko.md | 46 + .../Korean/check-commit-log.ko.md | 37 + .../Korean/delete-branch-locally.ko.md | 19 + ...our-fork-synced-with-this-repository.ko.md | 41 + ...oving-a-commit-to-a-different-branch.ko.md | 28 + ...removing-branch-from-your-repository.ko.md | 30 + .../Korean/resolving-merge-conflicts.ko.md | 43 + .../Korean/reverting-a-commit.ko.md | 35 + .../Korean/undoing-a-commit.ko.md | 59 + .../Things-a-non-programmer-can-do.ml.md | 123 + .../Marathi/Removing-a-file.ma.md | 20 + .../Marathi/additional-material.ma.md | 46 + .../Nepali/additional-material.np.md | 48 + .../Nepali/amending-a-commit.np.md | 50 + .../translations/Nepali/configuring-git.np.md | 77 + .../Things a non Programmer can do.pt-br.md | 126 + .../Portugues/additional-material.pt_br.md | 46 + .../Portugues/amending-a-commit.pt_br.md | 52 + .../Portugues/confinguring-git.pt-br.md | 78 + ...-fork-synced-with-this-repository.pt_br.md | 40 + ...ng-a-commit-to-a-different-branch.pt_br.md | 25 + .../Portugues/removing-a-file.pt_br.md | 24 + ...oving-branch-from-your-repository.pt_br.md | 31 + .../Russian/additional-material.ru.md | 46 + .../Russian/amending-a-commit.ru.md | 45 + .../Russian/configuring-git.ru.md | 76 + ...oving-a-commit-to-a-different-branch.ru.md | 25 + .../Russian/removing-a-file.ru.md | 23 + .../translations/Sinhala/amending-a-commit.md | 75 + .../Sinhala/removing-a-file.sin.md | 23 + .../Slovenian/additional-material.sl.md | 46 + .../Slovenian/amending-a-commit.sl.md | 48 + .../Slovenian/configuring-git.sl.md | 77 + ...our-fork-synced-with-this-repository.sl.md | 40 + ...oving-a-commit-to-a-different-branch.sl.md | 24 + .../Slovenian/removing-a-file.sl.md | 23 + ...removing-branch-from-your-repository.sl.md | 30 + .../Slovenian/resolving-merge-conflicts.sl.md | 34 + .../Slovenian/reverting-a-commit.sl.md | 38 + .../Slovenian/squashing-commits.sl.md | 94 + .../Slovenian/stashing-a-file.sl.md | 136 ++ .../Slovenian/undoing-a-commit.sl.md | 55 + .../Spanish/additional-material.es.md | 46 + .../Spanish/additional-material.sp_mx.md | 46 + .../Spanish/amending-a-commit.es.md | 44 + .../Spanish/amending-a-commit.sp_mx.md | 52 + .../Spanish/configuring-git.sp_mx.md | 78 + .../Spanish/creating-a-gitignore-file.md | 66 + .../Spanish/delete-branch-locally.md | 19 + .../Tamil/additional-material.ta.md | 52 + .../Telugu/ప్రోగ్రామింగ్ తెలియని వ్యక్తి చేయగల పనులు.md | 85 + .../Twi/additional-matrial-twi.md | 54 + .../translations/Twi/amending-a-commit-twi.md | 0 .../Ukrainian/removing-a-file.ua.md | 23 + .../Urdu/additional-material.ur.md | 46 + .../translations/Urdu/amending-a-commit.ur.md | 51 + ...oving-a-commit-to-a-different-branch.vi.md | 25 + .../resolving-merge-conflicts.vi.md | 33 + .../Marathi/github-cli-tutorial.marathi.md | 104 + .../Spanish/github-cli-tutorial.es.md | 101 + .../git-bash-windows-tutorial.md | 140 ++ .../git-cli-tutorial-kannada.md | 107 + .../github-cli-tutorial-Hindi.md | 128 + .../github-cli-tutorial-Urdu.md | 104 + .../github-cli-tutorial-id.md | 108 + .../github-cli-tutorial-pt-br.md | 101 + .../github-cli-tutorial-sinhala.md | 109 + .../github-cli-tutorial-tamil.md | 108 + .../cli-tool-tutorials/github-cli-tutorial.md | 109 + .../github-cli-tutorials-francais.md | 103 + .../Greek/git-bash-windows-tutorial.gr.md | 132 ++ .../Greek/github-cli-tutorial.gr.md | 104 + .../Ukrainian/github-cli-tutorial.ua.md | 101 + .../github-cli-tutorial-malayalam.md | 97 + .../translations/github-cli-tutorial.hi.md | 102 + .../github-desktop-old-version-tutorial.md | 108 + .../github-desktop-tutorial.md | 118 + .../github-windows-intellij-tutorial.md | 112 + .../github-windows-vs-code-tutorial.md | 118 + .../github-windows-vs2017-tutorial.md | 140 ++ docs/gui-tool-tutorials/gitkraken-tutorial.md | 123 + .../sourcetree-macos-tutorial.md | 139 ++ .../sublime-merge-tutorial.md | 121 + .../Chinese/github-desktop-tutorial.zh-cn.md | 117 + .../Chinese/gitkraken-tutorial-zh-cn.md | 108 + .../github-desktop-old-version-tutorial.gr.md | 80 + .../Greek/github-desktop-tutorial.gr.md | 113 + .../github-windows-intellij-tutorial.gr.md | 110 + .../github-windows-vs-code-tutorial.gr.md | 115 + .../github-windows-vs2017-tutorial.gr.md | 145 ++ .../Greek/gitkraken-tutorial.gr.md | 107 + .../Greek/sourcetree-macos-tutorial.gr.md | 133 ++ .../Greek/sublime-merge-tutorial.gr.md | 118 + .../github-windows-vs-code-tutorial-hi.md | 116 + .../github-windows-vs-code-tutorial_id.md | 121 + .../github-windows-vs-code-tutorial-hi.md | 116 + .../Persian/github-desktop-tutorial.fa.md | 118 + .../github-desktop-tutorial.pt_br.md | 118 + .../github-windows-intellij-tutorial.pt_br.md | 126 + .../github-windows-vs-code-tutorial.pt_br.md | 117 + .../github-windows-vs-code-tutorial_pt_br.md | 124 + .../github-windows-vs2017-tutorial.pt_br.md | 149 ++ .../Portuguese/gitkraken-tutorial.pt-br.md | 126 + .../Spanish/gitkraken-tutorial-es.md | 116 + .../Yoruba/github-desktop-tutorial.ng_yo.md | 104 + .../github-desktop-tutorial-np.md | 121 + .../github-desktop-tutorial.cn.md | 126 + .../github-desktop-tutorial.ng_yr.md | 104 + .../github-desktop-tutorial.pt_br.md | 118 + .../github-desktop-tutorial.th.md | 121 + .../github-desktop-tutorial.vn.md | 134 ++ .../github-windows-intellij-tutorial.pt_br.md | 126 + .../github-windows-vs-code-tutorial-hi.md | 116 + .../github-windows-vs-code-tutorial.ml.md | 115 + .../github-windows-vs-code-tutorial.pt_br.md | 117 + .../github-windows-vs-code-tutorial_id.md | 121 + .../github-windows-vs-code-tutorial_pt_br.md | 124 + .../github-windows-vs2017-tutorial.pt_br.md | 149 ++ .../translations/gitkraken-tutorial-es.md | 116 + .../translations/gitkraken-tutorial-fr.md | 120 + .../translations/gitkraken-tutorial.pt-br.md | 126 + .../malayalam/githiub-desktop-tutorial-ml.md | 128 + docs/translations/README.afk.md | 129 + docs/translations/README.al.md | 127 + docs/translations/README.am.md | 124 + docs/translations/README.amh.md | 146 ++ docs/translations/README.ar.md | 176 ++ docs/translations/README.arm.md | 142 ++ docs/translations/README.assamese.md | 166 ++ docs/translations/README.aze.md | 116 + docs/translations/README.bg.md | 124 + docs/translations/README.bih.md | 124 + docs/translations/README.bn.md | 135 ++ docs/translations/README.by.md | 151 ++ docs/translations/README.ca.md | 122 + docs/translations/README.col.md | 129 + docs/translations/README.cs.md | 127 + docs/translations/README.da.md | 123 + docs/translations/README.de.md | 122 + docs/translations/README.dz.md | 143 ++ docs/translations/README.ec.md | 120 + docs/translations/README.eg.md | 154 ++ docs/translations/README.en-pirate.md | 130 + docs/translations/README.eo.md | 133 ++ docs/translations/README.es.md | 125 + docs/translations/README.et.md | 131 ++ docs/translations/README.ewe.md | 141 ++ docs/translations/README.fa.md | 130 + docs/translations/README.fi.md | 129 + docs/translations/README.fil.md | 136 ++ docs/translations/README.fr.md | 141 ++ docs/translations/README.ga.md | 152 ++ docs/translations/README.ge.md | 123 + docs/translations/README.gh.md | 142 ++ docs/translations/README.gl.md | 112 + docs/translations/README.gr.md | 139 ++ docs/translations/README.guj.md | 143 ++ docs/translations/README.hau.md | 133 ++ docs/translations/README.hb.md | 216 ++ docs/translations/README.hi.md | 125 + docs/translations/README.hne.md | 123 + docs/translations/README.hr.md | 124 + docs/translations/README.hu.md | 124 + docs/translations/README.hy.md | 136 ++ docs/translations/README.id.md | 135 ++ docs/translations/README.igb.md | 128 + docs/translations/README.it.md | 128 + docs/translations/README.ja.md | 115 + docs/translations/README.ka.md | 89 + docs/translations/README.kh.md | 222 ++ docs/translations/README.ko.md | 144 ++ docs/translations/README.kr.md | 222 ++ docs/translations/README.kws.md | 134 ++ docs/translations/README.kz.md | 108 + docs/translations/README.la.md | 119 + docs/translations/README.lt.md | 109 + docs/translations/README.lug.md | 125 + docs/translations/README.lv.md | 123 + docs/translations/README.ma.md | 141 ++ docs/translations/README.me.md | 129 + docs/translations/README.mg.md | 145 ++ docs/translations/README.mk.md | 124 + docs/translations/README.ml.md | 137 ++ docs/translations/README.mli.md | 139 ++ docs/translations/README.mm_unicode.md | 130 + docs/translations/README.mr.md | 131 ++ docs/translations/README.mx.md | 124 + docs/translations/README.my.md | 119 + docs/translations/README.ng-pidgin.md | 120 + docs/translations/README.nl.md | 142 ++ docs/translations/README.no.md | 158 ++ docs/translations/README.np.md | 221 ++ docs/translations/README.od.md | 136 ++ docs/translations/README.pb.md | 117 + docs/translations/README.pl.md | 138 ++ docs/translations/README.ps.md | 142 ++ docs/translations/README.pt-ao.md | 97 + docs/translations/README.pt-pt.md | 104 + docs/translations/README.pt_br.md | 124 + docs/translations/README.pus.md | 107 + docs/translations/README.ro.md | 143 ++ docs/translations/README.ru.md | 174 ++ docs/translations/README.se.md | 123 + docs/translations/README.si.md | 129 + docs/translations/README.sindhi.md | 132 ++ docs/translations/README.sk.md | 125 + docs/translations/README.sl.md | 121 + docs/translations/README.slk.md | 121 + docs/translations/README.so.md | 154 ++ docs/translations/README.sr.md | 118 + docs/translations/README.sw.md | 130 + docs/translations/README.ta.md | 154 ++ docs/translations/README.te.md | 139 ++ docs/translations/README.th.md | 120 + docs/translations/README.tl.md | 127 + docs/translations/README.tm.md | 157 ++ docs/translations/README.tr.md | 133 ++ docs/translations/README.ua.md | 138 ++ docs/translations/README.un-aln.md | 129 + docs/translations/README.ur.md | 168 ++ docs/translations/README.uz.md | 142 ++ docs/translations/README.vn.md | 129 + docs/translations/README.yor.md | 129 + docs/translations/README.zh-cn.md | 134 ++ docs/translations/README.zh-tw.md | 133 ++ docs/translations/README.zul.md | 130 + docs/translations/Translations.md | 84 + docs/translations/gujarati/gujarati.md | 63 + 314 files changed, 31890 insertions(+) create mode 100644 .github/CODE_OF_CONDUCT.md create mode 100644 .github/CONTRIBUTING.md create mode 100644 .github/FUNDING.yml create mode 100644 .github/ISSUE_TEMPLATE.md create mode 100644 .github/ISSUE_TEMPLATE/issue-template.md create mode 100644 .github/funding.json create mode 100644 .github/workflows/auto-pr-merge.yml create mode 100644 .gitignore create mode 100644 .prettierignore create mode 100644 Contributors.md create mode 100644 LICENSE create mode 100644 README.md create mode 100644 docs/additional-material/Things a non Programmer can do.es.md create mode 100644 docs/additional-material/Things a non Programmer can do.fr.md create mode 100644 docs/additional-material/Things a non Programmer can do.md create mode 100644 docs/additional-material/Things a non Programmer can do.ta.md create mode 100644 docs/additional-material/Things a non Programmer can do.th.md create mode 100644 docs/additional-material/git_workflow_scenarios/Useful-links-for-further-learning.md create mode 100644 docs/additional-material/git_workflow_scenarios/additional-material.md create mode 100644 docs/additional-material/git_workflow_scenarios/amending-a-commit.md create mode 100644 docs/additional-material/git_workflow_scenarios/check-commit-log.md create mode 100644 docs/additional-material/git_workflow_scenarios/configuring-git.md create mode 100644 docs/additional-material/git_workflow_scenarios/creating-a-gitignore-file.md create mode 100644 docs/additional-material/git_workflow_scenarios/delete-branch-locally.md create mode 100644 docs/additional-material/git_workflow_scenarios/gitflow.md create mode 100644 docs/additional-material/git_workflow_scenarios/installing-git-ubuntu.md create mode 100644 docs/additional-material/git_workflow_scenarios/keeping-your-fork-synced-with-this-repository.md create mode 100644 docs/additional-material/git_workflow_scenarios/moving-a-commit-to-a-different-branch.md create mode 100644 docs/additional-material/git_workflow_scenarios/removing-a-file.md create mode 100644 docs/additional-material/git_workflow_scenarios/removing-branch-from-your-repository.md create mode 100644 docs/additional-material/git_workflow_scenarios/resetting-a-branch.md create mode 100644 docs/additional-material/git_workflow_scenarios/resetting-a-commit.md create mode 100644 docs/additional-material/git_workflow_scenarios/resolving-merge-conflicts.md create mode 100644 docs/additional-material/git_workflow_scenarios/reverting-a-commit.md create mode 100644 docs/additional-material/git_workflow_scenarios/squashing-commits.md create mode 100644 docs/additional-material/git_workflow_scenarios/stashing-a-file.md create mode 100644 docs/additional-material/git_workflow_scenarios/storing-credentials.md create mode 100644 docs/additional-material/git_workflow_scenarios/undoing-a-commit.md create mode 100644 docs/additional-material/git_workflow_scenarios/why-using-branches.md create mode 100644 docs/additional-material/translations/Belarusian/Useful-links-for-further-learning.by.md create mode 100644 docs/additional-material/translations/Belarusian/additional-material.by.md create mode 100644 docs/additional-material/translations/Belarusian/amending-a-commit.by.md create mode 100644 docs/additional-material/translations/Belarusian/configuring-git.by.md create mode 100644 docs/additional-material/translations/Belarusian/keeping-your-fork-synced-with-this-repository.by.md create mode 100644 docs/additional-material/translations/Belarusian/moving-a-commit-to-a-different-branch.by.md create mode 100644 docs/additional-material/translations/Belarusian/removing-a-file.by.md create mode 100644 docs/additional-material/translations/Belarusian/removing-branch-from-your-repository.by.md create mode 100644 docs/additional-material/translations/Belarusian/resolving-merge-conflicts.by.md create mode 100644 docs/additional-material/translations/Belarusian/reverting-a-commit.by.md create mode 100644 docs/additional-material/translations/Belarusian/squashing-commits.by.md create mode 100644 docs/additional-material/translations/Belarusian/stashing-a-file.by.md create mode 100644 docs/additional-material/translations/Belarusian/undoing-a-commit.by.md create mode 100644 docs/additional-material/translations/Bengali/add-file.bn.md create mode 100644 docs/additional-material/translations/Bengali/additional-material.be.md create mode 100644 docs/additional-material/translations/Chinese/additional-material.zh-cn.md create mode 100644 docs/additional-material/translations/Chinese/addtional-material.cht.md create mode 100644 docs/additional-material/translations/Farsi/amending-a-commit.fa.md create mode 100644 docs/additional-material/translations/Farsi/delete-branch-locally.fa.md create mode 100644 docs/additional-material/translations/Farsi/moving-a-commit-to-a-different-branch.fa.md create mode 100644 docs/additional-material/translations/French/additional-material.fr.md create mode 100644 docs/additional-material/translations/French/amending-a-commit.fr.md create mode 100644 docs/additional-material/translations/French/check-commit-log.fr.md create mode 100644 docs/additional-material/translations/Greek/git_workflow_scenarios/additional-material.gr.md create mode 100644 docs/additional-material/translations/Greek/git_workflow_scenarios/amending-a-commit.gr.md create mode 100644 docs/additional-material/translations/Greek/git_workflow_scenarios/check-commit-log.gr.md create mode 100644 docs/additional-material/translations/Greek/git_workflow_scenarios/configuring-git.gr.md create mode 100644 docs/additional-material/translations/Greek/git_workflow_scenarios/creating-a-gitignore-file.gr.md create mode 100644 docs/additional-material/translations/Greek/git_workflow_scenarios/delete-branch-locally.gr.md create mode 100644 docs/additional-material/translations/Greek/git_workflow_scenarios/gitflow.gr.md create mode 100644 docs/additional-material/translations/Hindi/Amending a Commit create mode 100644 docs/additional-material/translations/Hindi/Things a non Programmer can do create mode 100644 docs/additional-material/translations/Hindi/Useful-links-for-further-learning.hi.md create mode 100644 docs/additional-material/translations/Hindi/add-file.hi.md create mode 100644 docs/additional-material/translations/Hindi/moving-a-commit-to-a-different-branch.hi.md create mode 100644 docs/additional-material/translations/Hindi/removing-a-file.hi.md create mode 100644 docs/additional-material/translations/Hindi/removing-branch-from-your-repository.hi.md create mode 100644 docs/additional-material/translations/Hindi/resetting-a-branch.hi.md create mode 100644 docs/additional-material/translations/Hindi/resetting-a-commit.hi.md create mode 100644 docs/additional-material/translations/Indonesian/Useful-links-for-further-learning.id.md create mode 100644 docs/additional-material/translations/Indonesian/additional-material.id.md create mode 100644 docs/additional-material/translations/Indonesian/removing-a-file.id.md create mode 100644 docs/additional-material/translations/Indonesian/removing-branch-from-your-repository.id.md create mode 100644 docs/additional-material/translations/Indonesian/resetting-a-commit.id.md create mode 100644 docs/additional-material/translations/Italian/removing-a-file.it.md create mode 100644 docs/additional-material/translations/Italian/reverting-a-commit.it.md create mode 100644 docs/additional-material/translations/Korean/additional-material.ko.md create mode 100644 docs/additional-material/translations/Korean/amending-a-commit.ko.md create mode 100644 docs/additional-material/translations/Korean/check-commit-log.ko.md create mode 100644 docs/additional-material/translations/Korean/delete-branch-locally.ko.md create mode 100644 docs/additional-material/translations/Korean/keeping-your-fork-synced-with-this-repository.ko.md create mode 100644 docs/additional-material/translations/Korean/moving-a-commit-to-a-different-branch.ko.md create mode 100644 docs/additional-material/translations/Korean/removing-branch-from-your-repository.ko.md create mode 100644 docs/additional-material/translations/Korean/resolving-merge-conflicts.ko.md create mode 100644 docs/additional-material/translations/Korean/reverting-a-commit.ko.md create mode 100644 docs/additional-material/translations/Korean/undoing-a-commit.ko.md create mode 100644 docs/additional-material/translations/Malayalam/Things-a-non-programmer-can-do.ml.md create mode 100644 docs/additional-material/translations/Marathi/Removing-a-file.ma.md create mode 100644 docs/additional-material/translations/Marathi/additional-material.ma.md create mode 100644 docs/additional-material/translations/Nepali/additional-material.np.md create mode 100644 docs/additional-material/translations/Nepali/amending-a-commit.np.md create mode 100644 docs/additional-material/translations/Nepali/configuring-git.np.md create mode 100644 docs/additional-material/translations/Portugues/Things a non Programmer can do.pt-br.md create mode 100644 docs/additional-material/translations/Portugues/additional-material.pt_br.md create mode 100644 docs/additional-material/translations/Portugues/amending-a-commit.pt_br.md create mode 100644 docs/additional-material/translations/Portugues/confinguring-git.pt-br.md create mode 100644 docs/additional-material/translations/Portugues/keeping-your-fork-synced-with-this-repository.pt_br.md create mode 100644 docs/additional-material/translations/Portugues/moving-a-commit-to-a-different-branch.pt_br.md create mode 100644 docs/additional-material/translations/Portugues/removing-a-file.pt_br.md create mode 100644 docs/additional-material/translations/Portugues/removing-branch-from-your-repository.pt_br.md create mode 100644 docs/additional-material/translations/Russian/additional-material.ru.md create mode 100644 docs/additional-material/translations/Russian/amending-a-commit.ru.md create mode 100644 docs/additional-material/translations/Russian/configuring-git.ru.md create mode 100644 docs/additional-material/translations/Russian/moving-a-commit-to-a-different-branch.ru.md create mode 100644 docs/additional-material/translations/Russian/removing-a-file.ru.md create mode 100644 docs/additional-material/translations/Sinhala/amending-a-commit.md create mode 100644 docs/additional-material/translations/Sinhala/removing-a-file.sin.md create mode 100644 docs/additional-material/translations/Slovenian/additional-material.sl.md create mode 100644 docs/additional-material/translations/Slovenian/amending-a-commit.sl.md create mode 100644 docs/additional-material/translations/Slovenian/configuring-git.sl.md create mode 100644 docs/additional-material/translations/Slovenian/keeping-your-fork-synced-with-this-repository.sl.md create mode 100644 docs/additional-material/translations/Slovenian/moving-a-commit-to-a-different-branch.sl.md create mode 100644 docs/additional-material/translations/Slovenian/removing-a-file.sl.md create mode 100644 docs/additional-material/translations/Slovenian/removing-branch-from-your-repository.sl.md create mode 100644 docs/additional-material/translations/Slovenian/resolving-merge-conflicts.sl.md create mode 100644 docs/additional-material/translations/Slovenian/reverting-a-commit.sl.md create mode 100644 docs/additional-material/translations/Slovenian/squashing-commits.sl.md create mode 100644 docs/additional-material/translations/Slovenian/stashing-a-file.sl.md create mode 100644 docs/additional-material/translations/Slovenian/undoing-a-commit.sl.md create mode 100644 docs/additional-material/translations/Spanish/additional-material.es.md create mode 100644 docs/additional-material/translations/Spanish/additional-material.sp_mx.md create mode 100644 docs/additional-material/translations/Spanish/amending-a-commit.es.md create mode 100644 docs/additional-material/translations/Spanish/amending-a-commit.sp_mx.md create mode 100644 docs/additional-material/translations/Spanish/configuring-git.sp_mx.md create mode 100644 docs/additional-material/translations/Spanish/creating-a-gitignore-file.md create mode 100644 docs/additional-material/translations/Spanish/delete-branch-locally.md create mode 100644 docs/additional-material/translations/Tamil/additional-material.ta.md create mode 100644 docs/additional-material/translations/Telugu/ప్రోగ్రామింగ్ తెలియని వ్యక్తి చేయగల పనులు.md create mode 100644 docs/additional-material/translations/Twi/additional-matrial-twi.md create mode 100644 docs/additional-material/translations/Twi/amending-a-commit-twi.md create mode 100644 docs/additional-material/translations/Ukrainian/removing-a-file.ua.md create mode 100644 docs/additional-material/translations/Urdu/additional-material.ur.md create mode 100644 docs/additional-material/translations/Urdu/amending-a-commit.ur.md create mode 100644 docs/additional-material/translations/Vietnamese/moving-a-commit-to-a-different-branch.vi.md create mode 100644 docs/additional-material/translations/Vietnamese/resolving-merge-conflicts.vi.md create mode 100644 docs/cli-tool-tutorials/Marathi/github-cli-tutorial.marathi.md create mode 100644 docs/cli-tool-tutorials/Spanish/github-cli-tutorial.es.md create mode 100644 docs/cli-tool-tutorials/git-bash-windows-tutorial.md create mode 100644 docs/cli-tool-tutorials/git-cli-tutorial-kannada.md create mode 100644 docs/cli-tool-tutorials/github-cli-tutorial-Hindi.md create mode 100644 docs/cli-tool-tutorials/github-cli-tutorial-Urdu.md create mode 100644 docs/cli-tool-tutorials/github-cli-tutorial-id.md create mode 100644 docs/cli-tool-tutorials/github-cli-tutorial-pt-br.md create mode 100644 docs/cli-tool-tutorials/github-cli-tutorial-sinhala.md create mode 100644 docs/cli-tool-tutorials/github-cli-tutorial-tamil.md create mode 100644 docs/cli-tool-tutorials/github-cli-tutorial.md create mode 100644 docs/cli-tool-tutorials/github-cli-tutorials-francais.md create mode 100644 docs/cli-tool-tutorials/translations/Greek/git-bash-windows-tutorial.gr.md create mode 100644 docs/cli-tool-tutorials/translations/Greek/github-cli-tutorial.gr.md create mode 100644 docs/cli-tool-tutorials/translations/Ukrainian/github-cli-tutorial.ua.md create mode 100644 docs/cli-tool-tutorials/translations/github-cli-tutorial-malayalam.md create mode 100644 docs/cli-tool-tutorials/translations/github-cli-tutorial.hi.md create mode 100644 docs/gui-tool-tutorials/github-desktop-old-version-tutorial.md create mode 100644 docs/gui-tool-tutorials/github-desktop-tutorial.md create mode 100644 docs/gui-tool-tutorials/github-windows-intellij-tutorial.md create mode 100644 docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md create mode 100644 docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md create mode 100644 docs/gui-tool-tutorials/gitkraken-tutorial.md create mode 100644 docs/gui-tool-tutorials/sourcetree-macos-tutorial.md create mode 100644 docs/gui-tool-tutorials/sublime-merge-tutorial.md create mode 100644 docs/gui-tool-tutorials/translations/Chinese/github-desktop-tutorial.zh-cn.md create mode 100644 docs/gui-tool-tutorials/translations/Chinese/gitkraken-tutorial-zh-cn.md create mode 100644 docs/gui-tool-tutorials/translations/Greek/github-desktop-old-version-tutorial.gr.md create mode 100644 docs/gui-tool-tutorials/translations/Greek/github-desktop-tutorial.gr.md create mode 100644 docs/gui-tool-tutorials/translations/Greek/github-windows-intellij-tutorial.gr.md create mode 100644 docs/gui-tool-tutorials/translations/Greek/github-windows-vs-code-tutorial.gr.md create mode 100644 docs/gui-tool-tutorials/translations/Greek/github-windows-vs2017-tutorial.gr.md create mode 100644 docs/gui-tool-tutorials/translations/Greek/gitkraken-tutorial.gr.md create mode 100644 docs/gui-tool-tutorials/translations/Greek/sourcetree-macos-tutorial.gr.md create mode 100644 docs/gui-tool-tutorials/translations/Greek/sublime-merge-tutorial.gr.md create mode 100644 docs/gui-tool-tutorials/translations/Hindi/github-windows-vs-code-tutorial-hi.md create mode 100644 docs/gui-tool-tutorials/translations/Indonesian/github-windows-vs-code-tutorial_id.md create mode 100644 docs/gui-tool-tutorials/translations/Marathi/github-windows-vs-code-tutorial-hi.md create mode 100644 docs/gui-tool-tutorials/translations/Persian/github-desktop-tutorial.fa.md create mode 100644 docs/gui-tool-tutorials/translations/Portuguese/github-desktop-tutorial.pt_br.md create mode 100644 docs/gui-tool-tutorials/translations/Portuguese/github-windows-intellij-tutorial.pt_br.md create mode 100644 docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs-code-tutorial.pt_br.md create mode 100644 docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs-code-tutorial_pt_br.md create mode 100644 docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs2017-tutorial.pt_br.md create mode 100644 docs/gui-tool-tutorials/translations/Portuguese/gitkraken-tutorial.pt-br.md create mode 100644 docs/gui-tool-tutorials/translations/Spanish/gitkraken-tutorial-es.md create mode 100644 docs/gui-tool-tutorials/translations/Yoruba/github-desktop-tutorial.ng_yo.md create mode 100644 docs/gui-tool-tutorials/translations/github-desktop-tutorial-np.md create mode 100644 docs/gui-tool-tutorials/translations/github-desktop-tutorial.cn.md create mode 100644 docs/gui-tool-tutorials/translations/github-desktop-tutorial.ng_yr.md create mode 100644 docs/gui-tool-tutorials/translations/github-desktop-tutorial.pt_br.md create mode 100644 docs/gui-tool-tutorials/translations/github-desktop-tutorial.th.md create mode 100644 docs/gui-tool-tutorials/translations/github-desktop-tutorial.vn.md create mode 100644 docs/gui-tool-tutorials/translations/github-windows-intellij-tutorial.pt_br.md create mode 100644 docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial-hi.md create mode 100644 docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial.ml.md create mode 100644 docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial.pt_br.md create mode 100644 docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial_id.md create mode 100644 docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial_pt_br.md create mode 100644 docs/gui-tool-tutorials/translations/github-windows-vs2017-tutorial.pt_br.md create mode 100644 docs/gui-tool-tutorials/translations/gitkraken-tutorial-es.md create mode 100644 docs/gui-tool-tutorials/translations/gitkraken-tutorial-fr.md create mode 100644 docs/gui-tool-tutorials/translations/gitkraken-tutorial.pt-br.md create mode 100644 docs/gui-tool-tutorials/translations/malayalam/githiub-desktop-tutorial-ml.md create mode 100644 docs/translations/README.afk.md create mode 100644 docs/translations/README.al.md create mode 100644 docs/translations/README.am.md create mode 100644 docs/translations/README.amh.md create mode 100644 docs/translations/README.ar.md create mode 100644 docs/translations/README.arm.md create mode 100644 docs/translations/README.assamese.md create mode 100644 docs/translations/README.aze.md create mode 100644 docs/translations/README.bg.md create mode 100644 docs/translations/README.bih.md create mode 100644 docs/translations/README.bn.md create mode 100644 docs/translations/README.by.md create mode 100644 docs/translations/README.ca.md create mode 100644 docs/translations/README.col.md create mode 100644 docs/translations/README.cs.md create mode 100644 docs/translations/README.da.md create mode 100644 docs/translations/README.de.md create mode 100644 docs/translations/README.dz.md create mode 100644 docs/translations/README.ec.md create mode 100644 docs/translations/README.eg.md create mode 100644 docs/translations/README.en-pirate.md create mode 100644 docs/translations/README.eo.md create mode 100644 docs/translations/README.es.md create mode 100644 docs/translations/README.et.md create mode 100644 docs/translations/README.ewe.md create mode 100644 docs/translations/README.fa.md create mode 100644 docs/translations/README.fi.md create mode 100644 docs/translations/README.fil.md create mode 100644 docs/translations/README.fr.md create mode 100644 docs/translations/README.ga.md create mode 100644 docs/translations/README.ge.md create mode 100644 docs/translations/README.gh.md create mode 100644 docs/translations/README.gl.md create mode 100644 docs/translations/README.gr.md create mode 100644 docs/translations/README.guj.md create mode 100644 docs/translations/README.hau.md create mode 100644 docs/translations/README.hb.md create mode 100644 docs/translations/README.hi.md create mode 100644 docs/translations/README.hne.md create mode 100644 docs/translations/README.hr.md create mode 100644 docs/translations/README.hu.md create mode 100644 docs/translations/README.hy.md create mode 100644 docs/translations/README.id.md create mode 100644 docs/translations/README.igb.md create mode 100644 docs/translations/README.it.md create mode 100644 docs/translations/README.ja.md create mode 100644 docs/translations/README.ka.md create mode 100644 docs/translations/README.kh.md create mode 100644 docs/translations/README.ko.md create mode 100644 docs/translations/README.kr.md create mode 100644 docs/translations/README.kws.md create mode 100644 docs/translations/README.kz.md create mode 100644 docs/translations/README.la.md create mode 100644 docs/translations/README.lt.md create mode 100644 docs/translations/README.lug.md create mode 100644 docs/translations/README.lv.md create mode 100644 docs/translations/README.ma.md create mode 100644 docs/translations/README.me.md create mode 100644 docs/translations/README.mg.md create mode 100644 docs/translations/README.mk.md create mode 100644 docs/translations/README.ml.md create mode 100644 docs/translations/README.mli.md create mode 100644 docs/translations/README.mm_unicode.md create mode 100644 docs/translations/README.mr.md create mode 100644 docs/translations/README.mx.md create mode 100644 docs/translations/README.my.md create mode 100644 docs/translations/README.ng-pidgin.md create mode 100644 docs/translations/README.nl.md create mode 100644 docs/translations/README.no.md create mode 100644 docs/translations/README.np.md create mode 100644 docs/translations/README.od.md create mode 100644 docs/translations/README.pb.md create mode 100644 docs/translations/README.pl.md create mode 100644 docs/translations/README.ps.md create mode 100644 docs/translations/README.pt-ao.md create mode 100644 docs/translations/README.pt-pt.md create mode 100644 docs/translations/README.pt_br.md create mode 100644 docs/translations/README.pus.md create mode 100644 docs/translations/README.ro.md create mode 100644 docs/translations/README.ru.md create mode 100644 docs/translations/README.se.md create mode 100644 docs/translations/README.si.md create mode 100644 docs/translations/README.sindhi.md create mode 100644 docs/translations/README.sk.md create mode 100644 docs/translations/README.sl.md create mode 100644 docs/translations/README.slk.md create mode 100644 docs/translations/README.so.md create mode 100644 docs/translations/README.sr.md create mode 100644 docs/translations/README.sw.md create mode 100644 docs/translations/README.ta.md create mode 100644 docs/translations/README.te.md create mode 100644 docs/translations/README.th.md create mode 100644 docs/translations/README.tl.md create mode 100644 docs/translations/README.tm.md create mode 100644 docs/translations/README.tr.md create mode 100644 docs/translations/README.ua.md create mode 100644 docs/translations/README.un-aln.md create mode 100644 docs/translations/README.ur.md create mode 100644 docs/translations/README.uz.md create mode 100644 docs/translations/README.vn.md create mode 100644 docs/translations/README.yor.md create mode 100644 docs/translations/README.zh-cn.md create mode 100644 docs/translations/README.zh-tw.md create mode 100644 docs/translations/README.zul.md create mode 100644 docs/translations/Translations.md create mode 100644 docs/translations/gujarati/gujarati.md diff --git a/.github/CODE_OF_CONDUCT.md b/.github/CODE_OF_CONDUCT.md new file mode 100644 index 00000000..8118d40e --- /dev/null +++ b/.github/CODE_OF_CONDUCT.md @@ -0,0 +1,133 @@ + +# 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 \ No newline at end of file diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md new file mode 100644 index 00000000..17c6fab6 --- /dev/null +++ b/.github/CONTRIBUTING.md @@ -0,0 +1,86 @@ +# 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](../translations/README.afk.md) | [@zecollokaris](https://github.com/zecollokaris) | +| Albanian | [Albanian](../translations/README.al.md) | [RronKurtishi](https://github.com/RronKurtishi) [RronKurtishi](https://github.com/auronvila) | +| العربية | [Arabic](../translations/README.ar.md) | [OsaidAlhomedy](https://github.com/OsaidAlhomedy) [AlaaYlula](https://github.com/AlaaYlula) [Laith-Alayassa](https://github.com/Laith-Alayassa) | +| Azerbaijani | [Azerbaijani](../translations/README.aze.md) | [@isakurbanov744](https://github.com/isakurbanov744) [@Ahm3tJ4f](https://github.com/Ahm3tJ4f) | +| Bulgarian | [Bulgarian](../translations/README.bg.md) | []() | +| Bosnian | [Bosnian](../translations/README.bih.md) | []() | +| বাংলা | [Bengali](../translations/README.bn.md) | [@cse031sust02](https://github.com/cse031sust02) | +| Belarusian | [Belarusian](../translations/README.by.md) | []() | +| Català | [Catalan](../translations/README.ca.md) | [@Sergih28](https://github.com/Sergih28) | +| čeština | [Czech](../translations/README.cs.md) | []() | +| Danish | [Danish](../translations/README.da.md) | [@7013145](https://github.com/7013145) | +| Deutsch | [German](../translations/README.de.md) | [@lkreimann](https://github.com/lkreimann) | +| المصرية | [Egyptian](../translations/README.eg.md) | [@MichaelKMalak](https://github.com/MichaelKMalak) | +| English (Pirate) | [English (Pirate)](../translations/README.en-pirate.md) | [@lukeoliff](https://github.com/lukeoliff) | +| Español | [Spanish](../translations/README.es.md) | [@yirini](https://github.com/yirini) [@aaossa](https://github.com/aaossa) | +| فارسی | [Persian](../translations/README.fa.md) | [@ThirdScript](https://github.com/ThirdScript) | +| Finnish | [Finnish](../translations/README.fi.md) | []() | +| Français | [French](../translations/README.fr.md) | [@LePetitRenard](https://github.com/LePetitRenard) | +| ქართული | [Georgian](../translations/README.ka.md) | [@iko1133](https://github.com/iko1133) | +| Galego | [Galician](../translations/README.gl.md) | [@siderio2](https://github.com/siderio2) | +| Greek | [Greek](../translations/README.gr.md) | [@adreaskar](https://github.com/adreaskar) [@porfanid](https://github.com/porfanid) | +| Gujarati | [Gujarati](../translations/README.guj.md) | [@smitgajjar](https://github.com/smitgajjar) [@kaushalgosaliya5](https://github.com/kaushalgosaliya5/) | +| Hausa | [Hausa](../translations/README.hau.md) | []() | +| עברית | [Hebrew](../translations/README.hb.md) | [@TomerPacific](https://github.com/TomerPacific) | +| हिन्दी | [Hindi](../translations/README.hi.md) | [@arshadkazmi42](https://github.com/arshadkazmi42) [@sara-02](https://github.com/sara-02) [shrut1996](https://github.com/shrut1996) | +| Chhattisgarhi | [Chhattisgarhi](../translations/README.hne.md) | [@pradyyadav](https://github.com/pradyyadav) | +| Magyar | [Hungarian](../translations/README.hu.md) | []() | +| Armenian | [Armenian](../translations/README.hy.md) | []() | +| Indonesian | [Indonesian](../translations/README.id.md) | [@hahn](https://github.com/hahn) | +| Igbo | [Igbo](../translations/README.igb.md) | [@zecollokaris](https://github.com/zecollokaris) []() | +| Italiano | [Italian](../translations/README.it.md) | [@platipo](https://github.com/platipo) | +| 日本語 | [Japanese](../translations/README.ja.md) | [@cbondurant](https://github.com/cbondurant) | +| ಕನ್ನಡ | [Kannada](../translations/README.ka.md) | []() | +| 한국어 | [Korean](../translations/README.ko.md) | [@espozbob](https://github.com/espozbob) | +| Kiswahili | [Kiswahili](../translations/README.ksw.md) |[@zecollokaris](https://github.com/zecollokaris) []() | +| Kazakh | [Kazakh](../translations/README.kz.md) | [@kurshakuz](https://github.com/kurshakuz) | +| Lietuvių kalba | [Lithuanian](../translations/README.lt.md) | [@neone35](https://github.com/neone35) | +| Latviešu valoda | [Latvian](../translations/README.lv.md) | []() | +| | [me](../translations/README.me.md) | [@neone35]() | +| Македонски | [Macedonian](../translations/README.mk.md) | []() | +| മലയാളം | [Malayalam](../translations/README.ml.md) | [@yedhukrishnan](https://github.com/yedhukrishnan) | +| Burmese | [Burmese](../translations/README.mm_unicode.md) | [@lwinkyawmyat](https://github.com/lwinkyawmyat) | +| मराठी | [Marathi](../translations/README.mr.md) | [@bantya](https://github.com/bantya) | +| Español de México | [Spanish of Mexico](../translations/README.mx.md) | []() | +| Bahasa Melayu | [Malay](../translations/README.my.md) | []() | +| Nederlandse | [Dutch](../translations/README.nl.md) | [@MJMajoor](https://github.com/MJMajoor) | +| Norsk | [Norwegian](../translations/README.no.md) | []() | +| नेपाली | [Nepali](../translations/README.np.md) | [@milap-neupane](https://github.com/milap-neupane) | +| ਪੰਜਾਬੀ | [Punjabi](../translations/README.pa.md) | []() | +| Polski | [Polish](../translations/README.pl.md) | [@P1X3L0V4](https://github.com/P1X3L0V4) [@mikowhy](https://github.com/mikowhy) | +| Português | [Portugues (Portugal)](../translations/README.pt-pt.md) | [@RamosCSV](https://github.com/RamosCSV) | +| Português do Brasil | [Portugues (Brazil)](../translations/README.pt-br.md) | [@OtacilioN](https://github.com/OtacilioN) [@gabrielsanttana](https://github.com/gabrielsanttana)| +| Română | [Romanian](../translations/README.ro.md) | [ @dp97](https://github.com/dp97) | +| Русский | [Russian](../translations/README.ru.md) | [@ayanovsk](https://github.com/ayanovsk) | +| Svenska | [Swedish](../translations/README.sv.md) | [@jcer](https://github.com/jcer) | +| Sinhala | [Sinhala](../translations/README.si.md) | []() | +| Sindhi | [Sindhi](../translations/README.sindhi.md) | []() | +| Slovenčina | [Slovak](../translations/README.sk.md) | [@CoderKlemen](https://github.com/CoderKlemen) | +| Slovenščina | [Slovenian](../translations/README.slk.md) | [@hercegtomas](https://github.com/hercegtomas) | +| Serbian | [Serbian](../translations/README.sr.md) | [@Mateja3m](https://github.com/Mateja3m) | +| தமிழ் | [Tamil](../translations/README.ta.md) | [@sathishkumar-manogaran](https://github.com/sathishkumar-manogaran) | +| తెలుగు | [Telugu](../translations/README.te.md) | []() | +| ไทย | [Thai](../translations/README.th.md) | [@AimeTPGM](https://github.com/AimeTPGM) | +| Tagalog | [Tagalog](../translations/README.tl.md) | []() | +| Türkçe | [Turkish](../translations/README.tr.md) | [@yamac-kurtulus](https://github.com/yamac-kurtulus) | +| Українська | [Ukrainian](../translations/README.ua.md) | []() | +| Universal Alien | [Universal Alien](../translations/README.un-aln.md) | [@debjit-bw]() | +| اردو | [Urdu](../translations/README.ur.md) | [@Shhzdmrz](https://github.com/Shhzdmrz) | +| Tiếng Việt | [Vietnamese](../translations/README.vn.md) | [@tranlyvu](https://github.com/tranlyvu) | +| Yorùbá | [Yorùbá](../translations/README.yor.md) | []() | +| 中文 | [Chinese (Simplified)](../translations/README.zh-cn.md) | [@yuzhoujr](https://github.com/yuzhoujr) | +| 中文 | [Chinese (Traditional)](../translations/README.zh-tw.md) | [@WeiChienHsu](https://github.com/WeiChienHsu) | +| Zulu | [Zulu](../translations/README.zu.md) | [@zecollokaris](https://github.com/zecollokaris) []() | + diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml new file mode 100644 index 00000000..1ea87da4 --- /dev/null +++ b/.github/FUNDING.yml @@ -0,0 +1,12 @@ +# 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'] diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md new file mode 100644 index 00000000..7eeb142f --- /dev/null +++ b/.github/ISSUE_TEMPLATE.md @@ -0,0 +1,20 @@ + + +🐞 **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. 🎉 diff --git a/.github/ISSUE_TEMPLATE/issue-template.md b/.github/ISSUE_TEMPLATE/issue-template.md new file mode 100644 index 00000000..edaaf5b6 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/issue-template.md @@ -0,0 +1,30 @@ +--- +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. 🎉 diff --git a/.github/funding.json b/.github/funding.json new file mode 100644 index 00000000..ebe0f436 --- /dev/null +++ b/.github/funding.json @@ -0,0 +1,98 @@ +{ + "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": "" + } + ] + } +} diff --git a/.github/workflows/auto-pr-merge.yml b/.github/workflows/auto-pr-merge.yml new file mode 100644 index 00000000..02d82a34 --- /dev/null +++ b/.github/workflows/auto-pr-merge.yml @@ -0,0 +1,218 @@ +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 slack_invite_url = 'https://join.slack.com/t/firstcontributors/shared_invite/zt-2vqegkew0-ZuzGM1LO33C6Ts4nZyat1Q' + const twitter_tweet_share = 'https://twitter.com/intent/tweet?text=Yay%21%20I%20just%20made%20my%20first%20open%20source%20contribution%20with%20@1stcontribution.%20You%20can%20too%20at%20https%3A//goo.gl/66Axwe%0A&hashtags=OpenSource,CodeNewbie' + 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 slack_logo = "https://edent.github.io/SuperTinyIcons/images/svg/slack.svg" + const twitter_logo = "https://edent.github.io/SuperTinyIcons/images/svg/twitter.svg" + 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 - Join our Slack group: We have a community to help/support contributors. [ Join slack group](${slack_invite_url}). \n - Share on social media: You can share this content to help more people.\n - [bluesky Post on Bluesky](${bluesky_share_link}).\n - [ twitter tweet](${twitter_tweet_share}).\n - [twitter 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/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 }} diff --git a/.gitignore b/.gitignore new file mode 100644 index 00000000..586ca874 --- /dev/null +++ b/.gitignore @@ -0,0 +1,395 @@ +.DS_Store; +.idea/ +.vs +.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 \ No newline at end of file diff --git a/.prettierignore b/.prettierignore new file mode 100644 index 00000000..eacce946 --- /dev/null +++ b/.prettierignore @@ -0,0 +1,2 @@ +# Ignore Contributors.md(to prevent future merge conflicts): +Contributors.md \ No newline at end of file diff --git a/Contributors.md b/Contributors.md new file mode 100644 index 00000000..663debaa --- /dev/null +++ b/Contributors.md @@ -0,0 +1,2089 @@ +# Contributors +- Add [Nill_The_Alchemist](https://github.com/Nill-The-Alchemist/) +- [Karim-M03](https://github.com/Karim-M03) +- [Louis7363](https://github.com/louis7363) +- [Dani Matuko](https://github.com/danimatuko) +- [DeathScytheZ](https://github.com/DeathScytheZ) +- [A N M Mashud](https://github.com/anmmashud) +- [Zhen Liu](https://github.com/zh3nl) +- [Chong Liu](https://github.com/lc87624) +- [Harshit Joshi](https://github.com/harsh040206) +- [Aditya Kumar Jha ](https://github.com/Aditya-myst) +- [Sanjai Kumar R](https://github.com/sanjai451) +- [Trevor Kibuba](https://github.com/kibuba-njihia) +- [SumitThakur](https://github.com/SumitThakur1600) +- [CaraMcG](https://github.com/caraMcG) +- [Arnav Joshi](https://github.com/Arnav020) +- [Vedant Pillai](https://github.com/Codewith-Vedant) +- [sls-1](https://github.com/sls-1) +- [Anurag Chaturvedi](https://github.com/anuragjcchaturvedi) +- [Manas Mahajan](https://github.com/ManasMahajan2003) +- [SNN](https://github.com/sungenyeint) + +[Rushikesh Amale] +- [Aditya Radadiya](https://github.com/RadadiyaAditya) +- [Jefferson Huisa](https://github.com/j3ffh95) +- [mrxc0de](https://github.com/mrxc0de) +- [Nihal Barua](https://github.com/nihal-bar) +- [Sanidhya Soni](https://github.com/sonisanidhya) +- [Chibuzor Israel](https://github.com/pseudoeazy) +- [Sumit Pandey](https://github.com/SumitPandey08) +- [Rushikesh Jadhav](https://github.com/Rushi543) +- [Arindam Dinda](https://github.com/Arindam2003) +- [EricccTaiwan](https://github.com/EricccTaiwan) +- [Daiwiik Harihar](https://github.com/daiv09) +- [Z-to-the-hp69](https://github.com/Z-to-the-hp69/) +- [FabioCamerota](https://github.com/FabioCamerota) +- [Anaïs Gatard](https://github.com/AnaisG14) +- [Jordan Atkins](https://github.com/Atkinss1) +- [Raunit Arya](https://github.com/RaunitArya) +- [Hemant](https://github.com/l1emant/) +- [AureDev](https://github.com/AureDev) +- [Akash Dahal](https://github.com/DARKAD10) +- [Harry C](https://github.com/campbellharry) + YoucefBoursali +- [vinod jaina](https://github.com/firstcontributions/first-contributions?tab=readme-ov-file) +- [Hetvi Shah] +- [raj-opensource] +- [rohithGana](https://github.com/Rohithgvmg) +- Lokesh +- [AC](https://github.com/FortKnoxWasTaken) +- [Yisel Cintora Vega](https://github.com/yisel260) +- [Mohit-Goswami](https://github.com/Mohitgoswami18) +- [hmdaslam97](https://github.com/hmdaslam97) +- [Ester Youngreis](https://github.com/eti-youngreis) +- [tuysh](https://github.com/Tuysh) +- [Esther Kalsmith](https://github.com/EstherKal) +- [Weirdo-147](https://github.com/Weirdo-147) +- [Akhila Sahithi](https://github.com/Akhila-Sahithi) +[SrivastavaAman8604](https://github.com/SrivastavaAman8604) +- [Zach Warmoth](https://github.com/ZWarmoth) +- [pratheek2474](https://github.com/Pratheek2474) : Learning +- [Issac-BK](https://github.com/issaccodes) : Issac was here +- [lomus-hona](https://github.com/lhona01) +- [Alexskald](https://github.com/jxuho) +- [Rodrigo](https://github.com/Rdgistauf) +- [Kelvin Yeboah](https://github.com/KelvCodes) +- [Rajkumar](https://github.com/Rajkumar-Adepu) +- [HKNain](https://github.com/HKNain) +- [Arun](https://github.com/Arun8698) +- [Bhavika](https://github.com/bhavikab04) +- [cloud-whisperer](https://github.com/cloud-whisperer) +- [Disha520](https://github.com/Disha520) +- [Daniel Guo](https://github.com/DiiGii) +- [Farhan Ilyas](https://github.com/Farhan2001M) + [Lovepreet Kaur](https://github.com/LovekUR) +- [Navneet Yadav](https://github.com/navnt00) +- [dylan-sacco](https://github.com/dylan-sacco) +- [Tawheed Ahmed](https://github.com/TawheedAhmed28) +- [Aarush-Parashar](https://github.com/Aarush-Parashar) +- [Ronahi Bağcı](https://github.com/RonayBagci) +- [AhmedRediwan](https://github.com/ahmed12-dev) +- [Erpipemio](https://github.com/Erpipemio) +- [Fabrice Pecot](https://github.com/FabriceAB1) +- [kazuma](https://github.com/Mio-3) +- [Vinothini Thangamani]( https://github.com/VinothiniSaravankumar) +- [Saif Mohammed](https://github.com/SaifMohammed22) +- [Ryan Tham](https://github.com/ryanjrt) +- [Ryan Gapp](https://github.com/ryan-gapp) +- [Navreet Kaur](https://github.com/NavreetKB) +- [Algorytmouse](https://github.com/algorytmouse) +- [Nidhin Sankar](https://github.com/nidhinsankar) +- [Hari Krishan](https://github.com/Hari-krishna-tech) +- [Pavani](https://github.com/pavani42) +- [Raghav Dwivedi](https://github.com/dwi4122) +- [gabecodessometimes](https://github.com/gabecodessometimes) +- [jasurgraduate](https://github.com/jasurgraduate) +- [Dipankaj](https://github.com/DipankajSingh/) +- [shubham goyal](https://github.com/shubgoyal23) +- [Sankalp Yerigeri](https://github.com/SankalpYerigeri) +- [Peleg Ben Barak](https://github.com/peleg-bb) +- [gaikwadyash905](https://github.com/gaikwadyash905) : My First Contribution, looking forward for more.. +- [isaacrea](https://github.com/isaacrea) +- [Swapneel_Singh](https://github.com/swapneelsingh) : Just the beginning.. +- [aqeelabpro](https://github.com/aqeelabpro) +- Bandish Patel. +- [gyanchandkabra](https://github.com/gyanchandkabra) +- [uzuraDev](https://github.com/uzuraDev) +- [Eugene Chia](https://github.com/eugenechia) +- [oogway-x3t](https://github.com/oogway-x3t) +- [Hamza Zahid Butt](https://github.com/HamzaZahid172) +- [Mohammad Nikvarz](https://github.com/Mohammad79-nkv) +- [Achintha Ekanayake](https://github.com/achintha-eknayake) +- [charan](https://github.com/CharanCodeCraft) +- [NJMcCoy](https://github.com/NJMcCoy) +- [Preethi Manoharan](https://github.com/preethimanoharan18) +- [Nikhil](My first contributions: https://github.com/Nikhil-NP) +- [vishalchauhan](My first contribution: https://github.com/V1sh4lC) +- [Nakshatra](My first contribution: https://github.com/Zburgers) +- [Deekshitha](My first contribution: https://github.com/NDeekshithaReddy) +- [Johnathan](https://github.com/Johnathanyes) +- [Vanshika Sirohi](https://github.com/sirohi-vanshika) +- [Nathaniel Maffly](https://github.com/nmaffly) +- [arshadali](https://github.com/Arshadalee) +- [Greem Fox](https://github.com/vulpes-viridis) +- [Charulekha P](https://github.com/charulekha-pandian) +- [aayamrajshakya](https://github.com/aayamrajshakya) +- [Vaibhav0725](https://github.com/vaibhav0725) +- Namu +- [meenakshiruia](https://github.com/meenakshiruia) +- [RomaniukNatalia](https://github.com/RomaniukNatalia) +- [Subramanya_M](https://github.com/RoronoaZoro1752) +- [Austin Banner](https://github.com/AustinBanner) +- [Hemlata_Sharma](https://github.com/HemaGarima) +- [Shankar-Balajee](https://github.com/Shankar-Balajee) +- [amir asghar akbar mahaleh ghazian tapeh] +- [stevee14] +- Aayush Poudel (https://github.com/aayushhh44) +- [misfit](https://github.com/slMiSFiT) +- [Gilbert-Koom](https://github.com/Gilbert-Koom/) +- [Shubhanjan](https://github.com/AnjanC0des) +- [Hashim](https://github.com/runtime-errrrorr) +- [Dyno-man](https://github.com/Dyno-man) +- [Sardorbek](https://github.com/Sardorbek-Kuvondikov) +- [Wendell Oliveira](https://github.com/wendelloliiver) +- [Ch-Umar-Aslam](https://github.com/CH-Umar-Aslam/) +- [Sonum Jaggi](http://github.com/sonum02) +- [Matt Bellardi](https://github.com/met97) +- [Thomas Sales](https://github.com/ThomasGSales) +- [Inifome Eleluwor](https://github.com/Inifomeeo) +- [Punnapareddy Bhaskar Rao](https://github.com/P-Bhaskar-Rao) +- [addpd](https://github.com/addpd) +- [Fabrice Pecot](https://github.com/FabriceAB1) +- [vishalchauhan](https://github.com/V1sh4lC) +- [adwaitp](https://github.com/adwaitdagitguy) +- [stevee14] +- [davidw1281](https://github.com/davidw1281) +- [antoineDELEBECQUE](https://github.com/AntoineDlb) +- [Josh Gregory](https://github.com/joshtype) +- [lepickel](https://github.com/lepickel) +- [Furanimus](https://github.com/Furanimus) +- [Adarsh84](https://github.com/adarshM84) +- [Rathin Subramaniam](https://github.com/rathinsubra) +- [hectoru10](https://github.com/Hectoru10) +- [Ahorts](https://github.com/Ahorts) +- [widespectrum](https://github.com/widespctr) +- [rinujohn](https://github.com/rinujohn) +- [lennyhurni](https://github.com/lennyhurni) +- [AShotOfCode] +- [Ullas Arwan](https://github.com/ullaslgd) +- [Dario Moreno](https://github.com/3dmoreno) +- [Gad](https://github.com/Gad) +- [Jeremiah](https://github.com/jrmhx) +- [Akshey](https://github.com/aksheyd) +- [Vaibhav Rawat](https://github.com/VaibhavRawat27) +- [Shubhranka Varma](https://github.com/shubhranka) +- [benoitmonchaninsupinfo](https://github.com/benoitmonchaninsupinfo) +- [NandamRishith](https://github.com/nandam2003) +- [Jonas Mikosch](https://github.com/jomik101) +- [Shogo Todoroki](https://github.com/n4304-ndensan) +- [Dhruba Bhattacharyya](https://github.com/Dev-Dhruba2) +- [simonpotel](https://github.com/simonpotel) +- binara nurlankyzy +- [Sophie Sokol](https://github.com/ippotheboxer) +- [X3R074](My first contribution: https://github.com/X3R074) +- [Seif Eddine Gadi](https://github.com/Seif-Eddine-Gadi) +- [Harsh Gharsandiya](https://github.com/harshgharsandiya) +- [Ayananth](https://github.com/Ayananth) +- [jorsyk](https://github.com/jorsyk) +- [rajeshwar](https://github.com/snehasuresh2005) +- [mayurk224](https://github.com/mayurk224) +- [Loubna Lekouaghet](https://github.com/loubna213) +- [Roshawn Brooks](https://github.com/rbrooks95) +- [Tarun Jakkula](https://github.com/TarunJakkula) +- [Jeston Lewis](https://github.com/jestoncolelewis) +- [Omer Cohen](https://github.com/OmerCohen7530) +- [Ravi singh](https://github.com/ravir0ushan) +- [Dhruv Pandey](https://github.com/Dhrupandey) +- [Laurian Iacob](https://github.com/iLaurian) +- [Fikre Tesfay](https://github.com/fikre4444) +- [Sahil Gulunjkar](https://github.com/Sahil4757) +- [EstherCamela](https://github.com/Esther-Assena-pro) +- [ikimathi](https://github.com/ikimathi) +- [mushrifshahreyar](My first contribution: https://github.com/mushrifshahreyar) +- [HarnoorK-06](https://github.com/HarnoorK-06) +- [Lawrence Garcia](https://github.com/lawrenceee04) +- [AmnaShouqi](https://github.com/amnashouqi) +- [Aicirou](https://github.com/Aicirou) +- [Gargi](https://github.com/gargig02) +- [Nenad](https://github.com/maglvoskiNenad) +- [Thisaga Jayaratna](https://github.com/thisagaa) +- [krshearman](https://github.com/krshearman) +- [KevinThomas](https://github.com/HELL-KERBECS) +- [LukaGakhokidze](https://github.com/Luka288) +- [Lucas Emanuel](https://github.com/lucasdev-err) +- [lukgav](https://github.com/lukgav) +- [HiroseTakuya](https://github.com/hiro-tech-taku/) +- [Joncineus](https://github.com/joncineus) +- [Krishiv](https://github.com/Krizzhiv) +- [John J](https://github.com/john310897) +- [JoachimC](https://github.com/Joachim280) +- [Tzipi W](https://github.com/Tzipi-Winefeld) +- [chandanvnk1](https://github.com/chandanvnk1) +- [AdityaRaj212](https://github.com/AdityaRaj212) +- [AvAdiii](https://github.com/AvAdiii) +- [Madhav Singh](https://github.com/maddy710) +- [David Okosa](https://github.com/dfw7th) +- [FloraPetit](https://github.com/PetitFlora) +- [anthocote19](https://github.com/anthocote19) +- [Arsalan Mohseni](https://github.com/arsalanmohseni) +- [Ariyan Pandian](https://github.com/AriyanPandian) +- [Iris Christa](https://github.com/I-christa) +- [sadiqhero](https://github.com/sadiqhero) +- [Caroline](https://github.com/perrywinkle2004) +- [Victor Muthii](https://github.com/muthii-10) +- [AkramMohammad](https://github.com/Akram1806) +- [Mangelib](https://github.com/mangelib) +- [tay24or](https://github.com/tay24lor) +- [Ravichandra](https://github.com/ravichandra-21/-contributions) +- [Raghav](https://github.com/Raghav9871) +- [bear-i](https://github.com/bear-i/first-contributions) +- [Edgar Flores](https://github.com/efloresCSE) +- [Sai Khay Khun Mong](https://github.com/KhayKhun) +- [Jewel Geea George](https://github.com/) +- [Kyrylo Sorokovskyi](https://github.com/sumdeusvitae) +- [Liquuid1](https://github.com/Liquuid1) +- [Nimisha](https://github.com/codehusler14) +- [Bhavishay Bharti](https://github.com/bhavi-b) +- [Shaswat Raj](https://github.com/sh20raj) +- [Ajay Dongare](https://github.com/GluconicAcid) +- [Manisha1679](https://github.com/Manisha1679) +- [Lachlan Robinson](https://github.com/lachlan-robinson) +- [Dascalu Dumitru](https://github.com/IronMemo) +- [Cesar Garcia](https://github.com/cesaralej) +- [Anthony Okechukwu Ubah](https://github.com/okeysbytes) +- [ARPITHA](https://github.com/Arpitha189) +- [All the World's a Stage](https://github.com/YourHateMyHeroin) +- [Sidhant Naik](https://github.com/Sidnaik04) +- [idrees](https://github.com/idrees2k22) +- [JaeHye0k](https://github.com/JaeHye0k) +- [JasonSA1993](https://github.com/JasonSa1993/) +- [OmkarS](https://github.com/omkar402) +- [Suresh Deora](https://github.com/SureshDeora) +- [Mohanshi Jain](https://github.com/Mohanshi04) +- [eesoyeon](https://github.com/eesoyeon) +- [Tournoy Noa](https://github.com/) +- Samarth Sharma +- [YU-XIN-JIAN](https://github.com/YU-XIN-JIAN) +- [Ankita Ayushi](https://github.com/a-ayushigit) +- [Chandan Achary](https://github.com/Adventurist2) +- [Christian Mayamba](https://github.com/chris-mayamba) +- [Fahad Haque](https://github.com/Daahaf) +- [Deepankar Sahoo](https://github.com/CodeByDeepankar) +- [Hisham](https://github.com/sikehish) +- [eesoyeon] (https://github.com/eesoyeon) +- [PhamNguyenDangHuy](https://github.com/pndh) +- [randompeep] +- [BinhTran2307](my first contribution) +- [smandadhi9] (https://github.com/smandadhi9) +- [Umang Agarwal](https://github.com/UmangAgarwal257) +- [Magonborn] (https://github.com/MagonBorn) +- [ricor07](https://github.com/ricor07) +- [devoceon](https://github.com/emy3) +- [Muskan](https://github.com/MUSKANFAYAZ) +- [Mohammed Ismail](https://github.com/mdaleardc) +- [ekadet](https://github.com/ekadetov) +- [Gitrhyme](https://github.com/gitrhyme) +- [Jide Falaki](https://github.com/jidefal) +- [andev77](https://github.com/AnDev77) +- [karim1safan](https://github.com/karim1safan) +- [Kevin Hu](https://github.com/sijun-kevin-hu) +- [Sidharth Manikandan](https://github.com/salazangar) +- [Zubayr Hassan] (https://github.com/ZHassan31) **Hello World!** +- [Sergio DG](https://github.com/dgsergio) +- [p-a-brown](https://github.com/p-a-brown) +- [Starkcover](https://github.com/Starkcover) +- [Nuhu El Adj Souleymane](https://github.com/elsouleymane) +- [Vivek Deshmukh](https://github.com/vivekd16) +- [Aditya Singh](https://github.com/devxaditya) +- [Rohan](https://github.com/Christopher-91) +- [Shangcheng Li](https://github.com/shangchengg) +- [Shadab Ahmed Qureshi](https://github.com/Shadab786-developer) +- [Shangcheng Li](https://https://github.com/shangchengg) +- [Tharushika Hirushani](https://github.com/TharuHiru) +- [Hasindu Thirasara](https://github.com/Hasindu071) +- [MichaelAlanAXL] +- [Minh Thang](https://github.com/thangved) +- [Bharath] +- [killjoybr](https://github.com/killjoybr +- [Jaydeep Khandla](https://github.com/jaydeep-khandla/) +- [Jobin Jose](https://github.com/jobin8921) +- [Abie Anders R](https://github.com/AbieAnders) +- [Kanishk Shukla](https://github.com/Kanishk819) +- [Goyomix325](https://github.com/Goyomix325) +- [sakib maniyar](https://github.com/Saquib45) +- [Lemar Tokham](https://github.com/LemarTokham) +- [Bird Dog](https://github.com/acuhlian) +- [Michael B.](https://github.com/mbyrd3) +- [ Supraja Gaonkar ](https://github.com/Supraja-Gao) +- [vedivero](https://github.com/vedivero) +- [Jasleen](https://github.com/JasleenSidhu20) +- [Pasindu Kavinda](https://github.com/pasindu-kavinda) +- [Rushang-github](https://github.com/Rushang-github) +- [DhritiTS](https://github.com/DhritiTS) +- [AutumnFrost](https://github.com/AutumnFrost) +- [Abhinav](https://github.com/saiabhinav75) +- [Wil](https://github.com/TechnicFyre) +- [Manoj Kumar R] (https://github.com/manoj1978) +- [Jeel Bera](https://github.com/beraj2330) +- [turtle-papa](https://github.com/turtle-papa)6 +- [Tejasri P R](https://github.com/Tejasri0608) +- [Emiakpor](https://github.com/Emiakpor) +- [hyenee99](https://github.com/hyenee99) +- [Pranav](https://github.com/Pranav0102) +- [Mzwandilemkhokha](https://github.com/mzwandilemkhokha) +- [Janvi Chetan Patel](https://github.com/JanviChetanPatel) +- [Apoorva garg](https://github.com/ApoorvaGarg629) +- Ramiaemi Dashler (https://github.com/dashleremi) +- [Desi Petkova Lee](https://github.com/DesiPetkovaLee) +- [Rahul Keswani] (https://github.com/rahulkeswani010) +- [GCabane](https://github.com/GCabane) +- [gatura](https://github.com/gatura-source) +- [Maruthi S](https://github.com/JSMaruthi) + [KristinnTh](https://github.com/KristinnTh) +- [KristinnTh](https://github.com/KristinnTh) +- [veekshitha](https://github.com/Veekshitha21) +- [TejasK](https://github.com/TejasKoravanavar) +- [ahmad777x86](https://github.com/ahmad777x86) +- [aakashsaini09](https://github.com/aakashsaini09) +- [Nikolai B.](https://github.com/nbardzinkevichh) -[Gabriel Vieira](https://www.linkedin.com/in/gabrielvieirasantos/) +- Mradul +- [Ahmer Mehmood](https://github.com/Itachi0007) +- Lucie C. +- Ron G. +- RhazhBash +- This is maya from The future. +- Vilkas +- Raj\_ + -FMaciejewski +- [Priyash Anand](https://github.com/priyashanand) +- [Ramunas Kazlauskas](https://github.com/akuyra1) +- Ketan Yadav +- johnie +- [samuel-b](https://github.com/samuel-b) +- [gavi021](https://github.com/gavi021) +- [gooseneedsbread](https://github.com/gooseneedsbread) +- [Rhea](https://github.com/RheaAtre) +- shyGuy +- jorsyk +- Utkarsh Kumar +- hi, iam anoof + michal +- [Juan Saavedra](https://github.com/JuanSaavedraB/) +- add-lansar +- [Felipe Chicaiza](https://github.com/FelipeChicaiza) +- [Twinkle](https://github.com/Twinkle748) +- Hi, I'm Anuj. +- Zahra +- ARYAN +- [Pranav Pise](https://github.com/TheCaptain1810) +- [Leaphea](https://github.com/sok-leaphea) +- [Jeanette Gonzalez](https://github.com/JeanetteGz) +- [GON-CAB-8](https://github.com/GON-CAB-8) +- [sinchana](https://github.com/Thesinchanaj) +- [Numix](https://github.com/ltsnumix) +- [Chidanand Gowda](https://github.com/chidanandgowda) +- [Daniel Molina](https://github.com/molinafm30) +- [notamudkipiguess](https://github.com/notamudkipiguess) +- [HannanToprakPia](https://github.com/HannanToprakPia) +- [Soaring Eagle](https://github.com/SoaringEagle910) +- [Floyd Carlo](https://github.com/floo69) +- [Omkar Guha](https://github.com/omkarguha) +- [Josmer Rodriguez](https://github.com/Josmerr) + [Shiva Prasad Reddy](https://github.com/Shiva-Prasad-Reddy-K) +- [Max Rauber](https://github.com/maxrbr) +- [TsvetislavRangelov](https://github.com/TsvetislavRangelov) +- [Tim Petri](https://github.com/timmytabasco) +- [Prathik Cherian] (https://github.com/prathik-codes) +- [@thenocturnaldevgypsy-io | TheNocturnalDevGypsy (Abegail Torrendon)](https://github.com/thenocturnaldevgypsy-io) +- Gail Lobo +- [Tsafac Nkombong Regine Cyrille](https://github.com/Regine12) +- [Mohamed Alam](https://github.com/the-ALAM) +- [Hongbi Ko](https://github.com/HongbiKo) +- Dante +- Pooja +- Anirudh +- DrFrank101 +- [leandroxd](https://github.com/leamequiell) +- [drak-o](https://github.com/drak-o) +- [Michael Gabriel](https://github.com/maranatha443) +- [SHP](https://github.com/Su-Hnin) +- [Arjit shandilya](https://github.com/arjitshandilya) +- [LoneWarrior147] +- [ITSMijaiL](https://github.com/ITSMijaiL) +- [Karnam Veerendra Prasad](https://github.com/Veerendra-Prasad) +- [aoe3](https://github.com/aoe3) +- [hide361](https://github.com/hide361) +- [rujeetjahagirdar](https://github.com/rujeetjahagirdar) +- [pateldevashish001](https://github.com/PatelDevashish001) +- [NikitaJaiswal77](https://github.com/NikitaJaiswal77) +- [Sarvesh](https://github.com/sarvesh-sr) +- [Vitvin](https://github.com/vitvinvaz) +- [SaginalaAzeez](https://github.com/asheedh) +- [bivekk51](https://github.com/bivekk51) +- [Mamduh](https://github.com/Mamduh5) +- [AjaySinghKunwar](https://github.com/AjaySinghKunwar007) +- [Felix Morara](https://github.com/felixmorara) +- [SaboorNisha](https://github.com/SaboorNisha) +- [Sanika Nair](https://github.com/sanika-n) +- [Vilashkumar Daate](https://github.com/vilash99) +- [Adhish Goswami](https://github.com/Adhishg704) +- [Zach Garza](https://github.com/ZachG1235) +- [Mwofoh-Adriel](https://github.com/Mwofoh-Adriel) +- [Priya](https://github.com/Priyamahesh24) +- [Eric-DaRosa](https://github.com/EricDar12) +- [Eddgar Rojas](https://github.com/Eddgar0) +- [Leandro Choque](https://github.com/Leannnmv) +- [Shagun Sharma](https://github.com/shagunsharma6677) +- [Vernwalker](https://github.com/Vernwalker) +- [hey bro](https://github.com/heybro123) +- [RahulRawat](https://github.com/RHL-RWT-01) +- [Magdalin princy](https://github.com/Magdalinprincy/) +- [Hector-Ventura](https://github.com/0Label0) +- [hide361](https://github.com/hide361) +- [Sneha Singh](https://github.com/snehasingh-25) +- [Varun Tadpatri](https://github.com/varun2799dev) +- [Sheikh Mujtaba](https://github.com/Sheikh-Muhammad-Mujtaba) +- [Hypothalamus](https://github.com/Hypothalamuss) +- [Andrew Tan](https://github.com/AndrewTan517) +- [YudisSutisna](https://github.com/Hanep77) +- [STA](https://github.com/sithuaung246810) +- [Ernest Muli](https://github.com/kunmuli) +- [Cole Oliva](https://github.com/ColeOliva) +- [m4tej](https://github.com/m4tej241) +- [Auwalu Hamza](https://github.com/afhamu) +- [Guilherme Andrade](https://github.com/ZeroRBK) +- [Moulya.K](https://github.com/MoulyaK2005) +- [Akshay Shahi](https://github.com/Akshayshahi900) +- [kabya deb](https://github.com/kabyadeb) +- [Khushi Ray](https://github.com/khushiray07) +- [Gnanendra Naidu N](https://github.com/gnanendranaidun) +- [Vasupriya Patnaik](https://github.com/VasupriyaPatnaik) +- [Sashakt Keshri](https://github.com/SASHAKT1290) +- [Varun Sharma](https://github.com/varunsh20/) +- [Keshav Kant](https://github.com/Keshav-Kant/) +- [emrlk](https://github.com/emrlk) +- [Chuffed](https://github.com/Chuffed-Code) +- [Sushanth hebri](https://github.com/Sushanth-Hebri/) +- [Sai Manogyana Tokachichu](https://github.com/scrapperDubiBear/) +- [reihori](https://github.com/reihori) +- [Swetha Kannan](https://github.com/swethakannan12) +- [gpalacios26](https://github.com/gpalacios26/curso-git-fork) +- [Fahad Shoaib](https://github.com/Fahad-S94) +- [Rohan Raj P](https://github.com/rohandeadshot) +- [damsoon](https://github.com/damhyeong) +- [Mounish Nanu](https://github.com/mounish123) +- [Juan Sarmiento](https://github.com/JuanEnriqueSF) +- [Fady Zaky](https://github.com/0ddAuto00) +- [Arnav](https://github.com/arnav-mi) +- [bereamk](https://github.com/bereamk) +- [rishabh1024](https://github.com/rishabh1024/) +- [Whitehackerneth](https://github.com/Whitehackerneth/first-contributions) +- [Simons Arhin](https://github.com/simonskayi) +- [Abdelwakil](https://github.com/fondbcn) +- [Andyple](https://github.com/andyple) +- [psp0](https://github.com/psp0) +- [Shoaib Shuja](https://github.com/ShoaibShuja) +- [brunoblaise](https://github.com/brunoblaise) +- [OBLI B VIKRAM](https://github.com/Vikramobli) +- [Nisha Verma](https://github.com/xnisha-verma) +- [Jerold De Pedro](https://github.com/xherby07) +- [Jason Ang](https://github.com/jasonavatarang) +- Sriram Balu +- [Sashin Trout](https://github.com/sashin123) +- [Anish Banda] (https://github.con/anishbanda) +- [Jordy19](https://github.com/Jordy19) +- [cawhite7](https://github.com/cawhite7) +- [Whrisper](https://github.com/SChrisper) +- [vedivero](https://github.com/vedivero) +- [Anemone](https://github.com/anemone-coronaria) +- [Neethu Hari](https://github.com/Neethuharii) +- your username +- [Matheus Ranzani](https://github.com/matheusranzani) +- [Aakash Pandey](https://github.com/gitaakashstack) +- [Matthieu Bonnot](https://github.com/MrMattam) +- [KWYK](https://github.com/stevenchen99) +- [Piero Santisteban](https://github.com/JPSantistebanQ) +- [Gabriel Ripper](https://github.com/gabripper) +- [Thales Winther](https://github.com/thaleswinther) +- Lance Xie +- [Mannaseh Merakanapalli](https://github.com/MannasehM) +- [Chris Bruce](https://github.com/brucec5) +- [Tornike Tsulukidze](https://github.com/TheMechanicalBeing) +- [Alwin Sajan](https://github.com/Alwin-Sajan) +- [Alonso Jimenez](https://github.com/alonsojmnz) +- [Gopal Iyer](https://github.com/geekiyer) +- [Antonio Fábio](https://github.com/zodiecko) +- [Alanto Manu](https://github.com/alantomanu) +- [Shivam Mishra] (https://github.com/29shivam99) +- [Alex Thompson](https://github.com/Alex-Inems) +- [Anand Shende](https://github.com/anandshende) +- [Arisa Abiko](https://github.com/arisaabiko) +- [WHA](https://github.com/wynehtetaung) +- [Captain](https://github.com/CaptainPatel) +- [Jonathan](https://github.com/JonathanCharles2003) +- [Ishita](https://github.com/elekish) -[Shresta](https://github.com/g-shresta) +- [ykeissar](https://github.com/ykeissar) +- [Michael](https://github.com/LucidWinter) +- [Phillip](gttps://github.com/PhillipSom) +- [Nik Zulfauzaan](https://github.com/nickzulfauzaan) +- [Robiya](https://github.com/rhakim24) +- [Kit-Kat31415926](https://github.com/Kit-Kat31415926) +- [Luís Simas](https://github.com/luissimas) +- [Länzlinger Jonas](https://github.com/jonaslanzlinger) +- [Ramis Humayun](https://github.com/Ramis102) +- [Polina Polupan](https://github.com/PolinaPolupan) +- [Vinay Joshi](https://github.com/Anigrl) +- [JakeJeongAiden](https://github.com/JakeJeongAiden/) +- [Fangphire](https://github.com/fangphire) +- [jhc4318](https://github.com/jhc4318) +- [td2thinh](https://github.com/td2thinh) +- [dinesh](https://github.com/dineshv97) +- [sony](https://github.com/sony77697) +- [urkwr](https://github.com/urkwr) +- [Alish-0x](https://github.com/Alish-0x) +- [SWanHK](https://github.com/swanhk) + Saksh +- [Sagar Patel](https://github.com/sagarpatel279) +- [Yogesh Joga యోగేష్ జోగ](https://github.com/yogeshjoga) +- [Rudhram Saraswat](https://github.com/RUDHRAM01) +- [Juho Lee](https://github.com/jxuho) +- [TOK7O](https://github.com/TOK7O) +- [Hossain Rion](https://github.com/best-rion) +- [Daniel Cursi](https://github.com/danielcursi) +- [Giovanna Cortez](https://github.com/annavoigg) +- [janGithub122](https://github.com/janGithub122) +- [Mehfila Parkkulthil](https://github.com/Mehfila123) +- [Hardik Khandal](https://github.com/hardikkhandal) +- [Julius Jones](https://github.com/jlwj22) +- [Dave Friedman](https://github.com/heracliteanflux) +- [Pankaj Monga] (https://github.com/p-monga) +- [Chandan Ravi] (https://github.com/chandanravic) +- [Vicente Guzmán](https://vicenteguzman.com/) +- [Vinit Jahagirdar](https://github.com/Vinit1909) +- [Bam](https://github.com/QBJ08) +- [Tyler Daw](https://github.com/TylerD1105) +- [Minjae Kwon](https://github.com/minjaekwon97) +- [dev-sik](https://github.com/YouD0313) +- [callme-kvj] (https://github.com/kvj-harsha) +- [Brandon Munisur](https://github.com/Brandonmunisur) +- [Rafael Vasconcelos](https://github.com/Rellik7) +- [Jensen Coonradt](https://github.com/CapyBatman) +- [George Udonkwo](https://github.com/Georgeudonkwo) +- [DAKSH](https://github.com/Daksh-codes) +- [Andrew Zhou](https://github.com/AndrewZhouMQ123) +- [Jason Alvarez](https://github.com/jason-alvarez-data) +- [Sylvain L](https://github.com/sylvain-lec) +- [Shubham Dhama](https://github.com/shubhamdhama108) +- [Danyal Ejaz](https://github.com/danyalejaz) +- [Sneha Jain](https://github.com/sj11105) +- [Varun Patel](https://github.com/varunpatel07) +- [Jayadeep Velagapudi](https://github.com/jkvelagapudi) +- [Varsha Gitty](https://github.com/vgg1459) + [Muhammad Abdullah Khan](https://github.com/sapientabdullah) +- [Mukesh Kalikaya](https://github.com/Mukesh-Kalikaya) +- [Elon Aseneka Idiong'o](https://github.com/elonaire) +- [Stephen Ng](https://github.com/snust) +- [Axel Valerio Ertamto](https://github.com/AxelValerioErtamto) +- [Justin](https://github.com/JustinBifeld) +- [Vinicius Alves Amorim](https://github.com/am0rimdev) +- [aseel matta](https://github.com/aseelmatta) +- [Lulu Harvey](https://github.com/luluharvey) +- [ma3ti](https://github.com/ma3ti) +- [J-Kosm](https://github.com/J-Kosm) +- [Areeb Ahmad](https://github.com/AreebAhmad-02) +- [BOUKARI Marfourz](https://github.com/Marfourz) +- [Hillary Nyakundi](https://github.com/HillaryNyakundi) +- [Claudio Jara](https://github.com/claudiojara) +- [Peter Hilbert](https://github.com/pehilbert) +- [.kim](https//github.com/kim8584) +- [Yeressil Taupiyk](https://github.com/BalmundSM) +- [Somssi Pathania](https://github.com/SOMSSI2110) +- [Gabriel Fernandes](https://github.com/gabrielfernandeswebdev) +- [Lakshya Mishra](https://github.com/mishrlaksh) +- [Subin Mariyadas](https://github.com/subin170) +- [Capri Caviedes](https://github.com/caprivm) +- [ccie5013](https://github.com/ccie5013) +- [Leticia suzuki](https://github.com/Leticia567568) +- [Albert Byrone](https://github.com/Albert-Byrone) +- [zurfjereluhmie](https://github.com/zurfjereluhmie) +- [Rishan Thangaraj](https://github.com/rishant3441) +- [Anish Yalavarthi](https://github.com/AnishYalavarthi) +- [Arshadakl](https://www.linkedin.com/in/arshad-akl) +- [Samuel Rudqvist](https://github.com/srudqvist) +- [Lawrence Radburn](https://github.com/LawrenceRadburn) +- [Reuel Terezakis](https://github.com/SeventhDream) +- [Stelios Gee](https://github.com/SteliosGee) +- [Arslanaka](https://github.com/arslanaka) +- [Tarun kumar](https://github.com/krtarun7) +- [Codemanticism](https://github.com/codemanticism) +- [Mohiuddin Hasan](https://github.com/mmhasan07) +- [Flavio Emanuele Cannavò](https://github.com/flaviocnn) +- [Titus James](https://github.com/tj330) +- [Harsh Verma](https://github.com/hv0911) +- [Jaytee Majoni](https://github.com/jayteemajoni) +- [eszanon](https://github.com/eszanon) +- [TejoSaiSwaroop](https://github.com/tejosaiswaroop) +- [Kores Nkoidila](https://github.com/Nkoidila) +- [Ian McManus](https://github.com/ianmcman) +- [PatríciaRamosS](https://github.com/PatriciaRamosS) +- [Michelle Mullane](https://github.com/MichelleMullane) +- [omartrese](https://github.com/omartrese) +- [Guru Balamurugan](https://github.com/guru-apr21) +- [Hu TianHang](https://github.com/HTH24) +- [Patrick Yeung](https://github.com/eampat) +- [Leonardo Lopes](https://github.com/leonardo-lopes-br) +- [Steve Armstrong](https://github.com/W0474997SteveArmstrong) +- [Andres Riaño](https://github.com/afrianodev) +- [Irksomehails](https://github.com/irksomehails) +- Testing purpose +- Kate Rasheed +- [Isabela Magalhães](https://github.com/isarbela) +- [HiParham](https://github.com/hiparham) +- [John Caleb ⚡](https://github.com/thejohncaleb) +- [Rashmi Pai](https://github.com/RashmiRamdasPai) +- [Rey Jao](https://github.com/jao-rey) +- [Wessel Steenkamp](https://github.com/wesse206) +- [Eiheir](https://github.com/ebininin) +- [Maria Carrera](https://github.com/MarieCourse) +- [Aditya Mitra](https://github.com/mitras-git) +- [Anthony Ladon](https://github.com/AnthonyLadon) +- [EbertonKM](https://github.com/EbertonKM) +- [Shayne Geilman](https://github.com/ShayneJG) +- [Silviya Kolchakova] (https://github.com/SilviyaKolchakova) +- [Aiman](https://github.com/PX201) +- [Debapriya sengupta](https://github.com/DebapriyaSengupta28) +- [Samaksh Sethiya](https://github.com/Samaksh22) +- [Hoin Shin](https://github.com/signalman) +- [Rahul Choudhary](https://github.com/RahulCh010) +- [I-Bex](https://github.com/i-Bex) +- [Jon Brennan 🧑🏻‍💻👾🎵](https://github.com/jbshryne) +- [Luciano](https://github.com/luciano44) +- [Gabrielly Castilho](https://github.com/gabscastilho) +- [Muhammad Ans Khan 🧑🏻‍💻](https://github.com/Muhammad-AnasKhan) +- [Jon Compton](https://github.com/joncompton) +- [Yash Goyal](https://github.com/yash-goyal-0910) +- [Shubham kumar](https://github.com/Shubham9384235) +- [Akash Dhamane](https://github.com/explore) +- [Amahisa]() +- [Helen C](https://github.com/hmczap) +- [Shahan](https://github.com/shahan360) +- [ColorCode](https://github.com/benjaAguilar) +- [Aminat A](https://github.com/pejuameenat) +- mertgokbayrak +- [Kiranmai Kalla](https://github.com/KiranmaiKalla) +- [Loyd Ngei](https://github.com/LoydNgei) +- [Suved Ganduri](https://github.com/Sooowayydh) +- [Mariusz Sobczak](https://github.com/SmoQ) +- [Mayank Pratap Singh](https://github.com/04-mayank) +- [Aryan Suvarna](https://github.com/AryanSuvarna) +- [Tunde Suleiman](https://github.com/tsuleiman03) +- [shappp1](https://github.com/shappp1) :) +- [Evgeny Kozelskiy](https://github.com/Der12kl) +- [Elina Zoldnere](https://github.com/ElinaZoldnere) +- [Benjamin Tsoumagas](https://github.com/tsoumagas-benjamin) +- [SURAJ](https://github.com/suRaj-v3) +- Bhavya Singla +- [V1centeJ1menez](https://github.com/V1centeJ1menez) +- Gabriele Agosta +- [Ejorhovi Gift](https://github.com/g1ft-code) +- [Govind Mohan](https://github.com/G0vind04) +- [Kalhara Batangala](https://github.com/KalharaBatangala) +- [Ricardo Gomes](https://github.com/ricardogomes) +- Peter +- [Borsoon](https://github.com/Borsoon) +- [Jon Gumero](https://github.com/jongumero) +- [Thomas Fogarty](https://github.com/Thoss24) +- [Fathalrhman Adam](https://github.com/Fathalrhman267) +- [Ana Luisa Conrado](https://github.com/anaconrado) +- [Alec Morris](https://github.com/alecmarkmorris) +- [Jaimit Patel](https://github.com/Jaimtlearn) +- Rapheal Suber - https://github.com/manyworldss +- [Junior Soares](https://github.com/JuniorWSoares) +- [Fay](https://github.com/notfay) +- [Vinuthna](https://github.com/vinuthna29) +- [Hamza Haider](https://github.com/Hamza-H10) +- [jumari0](https://github.com/jumari0) +- [Atif Abedeen](https://github.com/atifabedeen) +- [Muqeet Mughal](https://github.com/muqeetmughal) +- [Donovan Guard](https://github.com/dlguard) +- [Reddi](https://github.com/12eddi) +- [kiy0315](https://github.com/kiy0315) +- [Feven Seyfu](https://github.com/FevenSeyfu) +- [Kai Hyperion Yun](https://github.com/kaihyperion) +- [Yousof Shahrabi](https://github.com/yousofs) +- [Kevin Zheng](https://github.com/csdoge007) +- [Natnael Hailu](https://github.com/natnaelhailu) +- [Adam Robson](https://github.com/Adam-Robson) 🧶 +- [Thomas Ulrich](https://github.com/TomUlrich) +- [Takuya Yanase](https://github.com/takuyaOOR) +- [Line Kouider](https://github.com/linekdr) +- [jbnation](https://github.com/jbnation) +- [Sarvesh Bachute](https://github.com/sarry8901) +- [Ala Gowtham Siva Kumar](https://github.com/gowtham-2oo5) +- [Swapnilkumar Dwivedi](https://github.com/swappy-2003) +- [Gergely Kántor](https://github.com/kantorge) +- [Antonimo](https://github.com/EAntonioFH) +- [Aaron Tran](https://github.com/BobbyFergerson) + [LiterLite](https://github.com/LiterLite) +- [Tomer Hadar](https://github.com/Tomerki) +- [Aman](https://github.com/AmanWebDev2) +- [Shrey joshi](https://github.com/Shreyyy07) +- [Shrirang Joshi](https://github.com/shriI950) +- [Hikmah](https://github.com/Hikmahx) +- [BALASANTHOSH01](https://github.com/BALASANTHOSH01) +- [Kelvin Kipkoech Chepkwony](https://github.com/kipkoechke) +- [Greg Delgado](https://github.com/grd888) +- [YMM](https://github.com/yemyatmin11) +- [Default](https://github.com/bright100) +- [Deni Andrian Prayoga](https://github.com/deniandriancode) +- [Kicka](https://github.com/kicka42) +- [BrianMuniz](https://github.com/BrianMunizSilveira) +- [Yor-Jihons](https://github.com/Yor-Jihons) +- [tayobaki](https://github.com/tayobaki) +- [Charles Sanders @visionthex](https://github.com/visionthex) +- [Sayan](https://github.com/sayan112207) +- [Edmond Neziraj](https://github.com/EdmondNeziraj) +- [Kaivan Shah](https://github.com/Kaivanshah1) +- [Felix Gomez @felixdavid12](https://github.com/felixdavid12) +- [doudouCodingInGithub](https://github.com/doudouCodingInGithub) +- [Alberto Pe#a](https://github.com/APC9) 🔥 +- [Abhishek Sharma](https://github.com/Abhisheksharmao) +- [Nayana N M](https://github.com/Nayana62) +- [Hemant](https://github.com/hemant187) +- [Pradip Borade](https://github.com/pradipborade911) +- [Sandeep Dewangan](https://github.com/sandy15d) +- [Jess Lane](https://github.com/jesslane94) +- [Osman](https://github.com/Osmansiddiquer) +- [Om Biradar](https://github.com/OmBiradar) +- [Rob Pellegrin](https://github.com/robpellegrin) +- [Muneer Alam](https://github.com/muneer320) +- [Kurumi30](https://github.com/Kurumi30) +- [Pfandflasche91](https://github.com/Pfandflasche91) +- [Shanky17](https://github.com/shanky17) +- [Jay Paun](https://github.com/Jay2704) +- [Cameron Johnson](https://github.com/will-fork-for-food) +- [Ignacio Elìas Rosner](https://github.com/roznerx) +- [annieyii](https://github.com/annieyii/first-contributions) +- [MTHS](https://github.com/MTHS) +- [Aristide Legba](https://github.com/aristidelegba) +- [EvinExiNiTy](https://github.com/Evinexinity) +- [Daley Nyae](https://github.com/nyae44) +- [Martin Flores](https://github.com/Mflore29) +- [Radu Mocanu](https://github.com/radumocanu1) +- [Matthew Z](https://github.com/GitwithAbba) +- [Ayush Rai](https://github.com/Charlie-1-3) +- [Patrick C](https://github.com/patrickcap) +- [Aditya Gupta](https://github.com/Deadlock-exe) +- [Alan Thomas](https://github.com/alntom) +- [Joy A](https://github.com/joyagbo) +- [Shreya Shivratriwar](https://github.com/shreyasico) +- [dev-sik2](https://github.com/devpang20) +- [BABLU](https://github.com/bablu2b) +- [ZarKHasM](https://github.com/ZarKHasM) +- [Pranav Hajare](https://github.com/pranavhajare) +- [Emmanuel](https://github.com/codesmith-emmy) +- [luispunx](https://github.com/luispunx) +- [Thomas McLaughlin](https://github.com/mclaughlin-thomas) +- [maxgmr](https://github.com/maxgmr) +- [Robin Van Persie](https://github.com/rvp20) +- [Siddhartha Verma](https://github.com/SidVer312) <33 +- [Alex Terskin](https://github.com/ATerskin) +- [Bhargav](https://github.com/thotabhargav123) +- [Aakash Preetam](https://github.com/aakashpreetam) +- [Kevin Peng](https://github.com/kpeng66) +- [K G Tint Swe](https://github.com/KG6605) +- [K G Tint Swe](https://github.com/KG6605) +- [Dithi-Fuzzythinker](https://github.com/fuzzythinker) +- [Muhammad-Ghufran-Ali](https://github.com/ghufran2508) +- [Evelyn Xia](https://github.com/Evelyn406) +- [Rohit R](https://github.com/Rohr0) 🔥 +- [17LingShan](https://github.com/17LingShan) +- [Carlos Camacho](https://github.com/ccamacho02) +- [Nihal Baranwal](https://github.com/N-I-H-A-L) +- [Mykyta Kuznietsov](https://github.com/kuznimyk) +- [Essi Akpevwe Praise](https://https://github.com/Akpevwe11) +- [Jivi ~\_~](https://github.com/Jivi-this-side) +- [Subro](https://www.linkedin.com/in/subrojyoti-paul) +- [BrianC](https://github.com/BrianSChase +- [Arthur Almeida](https://github.com/ragnarthur) +- [zeden](https://github.com/snowxx456) +- [Akshat Shah](https://github.com/akshatshah811) +- [Htut Oakkar](https://github.com/htutoakkar) +- [K G Tint Swe](https://github.com/KG6605) +- [Aakash Srivastava](https://github.com/kayasthasky) +- [nilesh sharma](https://github.com/nileshdsharma) +- [Matt Blumenthal](https://github.com/matthewblu421) +- [satyam1024](https://github.com/satyam1024) +- [Harishraj Selvakumar](https://github.com/ByteBender24) +- [stjepanDeveloper](https://github.com/stjepanDeveloper) +- [romvcarlos](https://github.com/romvcarlos) +- [Karsy](https://github.com/karsyz) +- [MatK](https://github.com/mat-kop) +- [Sandesh KV](https://github.com/SandeshAmin) +- [Nikolay Gusev](https://github.com/TankistPro) +- [Abhi Patil](https://github.com/Abhisucks) +- [Xin Xiao](https://github.com/ThetNaingLin7) +- [Onyango Jerry](No link sorry) +- [Ambrose Matata](https://github.com/Masaku12) +- [Trevor Carmack](http://github.com/tscarmack) +- [ruvvan](https://github.com/ruvvan) +- [Jayavardhan gorlamandala](No link sorry) +- [Ashish Kumar](https://github.com/akdevv) +- [Julius Oyovwikigho](https://github.com/ojst60) +- [Abdallah Radfi](https://github.com/AbdallahRdf) 🔥 +- [Mohammed Siddiq Sawani](https://github.com/siddiksawani) +- [Mohammed Sidiq](https://github.com/MohdSiddiq12) +- [BlackSmithOfFire](I won't put my link/Sorry!But thanks) +- [dgdck] +- [etriddle88](https://github.com/etriddle88) +- [ohdy518](https://github.com/ohdy518) +- [Satyajit Patra](https://github.com/SatyajitPatra06) +- [Abishek S R](https://github.com/Abishek0411) +- [massone99](https://github.com/massone99)) -[G yasaswini](https://github.com/gyasaswini10) +- [Kyle O'Leary](https://github.com/kyle-oleary) +- [Muhammed Yaseen Sidhik](https://github.com/Nosawkid) +- [Irfan](https://github.com/0xNafri) +- [Phorian](https://github.com/phorian) +- [Omari Fahd](https://github.com/sarsa2012) +- [sumiyak96](https://github.com/sumiyak96) +- [Robert Judal Regalado](https://github.com/rojre1979) +- [Pratik Thorat](https://github.com/PratikThoratNortheastern) +- [Fuahad](https://github.com/fuahad) +- [Shahmeer malik](https://github.com/shahmeermalik1) +- [Jalithc](https://github.com/Jalithc) +- [Ahd. Kabeer Hadi](https://github.com/Ahd-Kabeer-Hadi) +- [Alejandro Cuan Martinez](https://github.com/acuanm) +- [Daniel Otchere](https://github.com/ascot20) +- [Aviral Swarnkar](https://github.com/aviralnx) +- [Jayesh Bagde](https://github.com/jysh-bgde) +- [Karuppaiah](https://github.com/akdinesh124) +- [Thirupathi Addisherla](https://github.com/Thiru7747) +- [Pedro Santos](https://github.com/pedro-sts) +- [Masch90](https://github.com/Masch90) +- [Chijioke Ugwuanyi](https://github.com/xplorer1) +- [Horatio Hanley](https://github.com/horatioDev) +- [Ahmet Gello](https://github.com/ahmetgello) 😀 +- [Nadav J. Outmezguine](https://github.com/Nadav-out) +- [Gokularaju](https://github.com/gokul78590) +- [Oliver](https://github.com/oliverg13) +- [Banjo Patrick](https:github.com/Super-Savvy) +- [Emmanuel Doji](https://github.com/devopsnormad) +- [Collin Bugash](https://github.com/CollinBugash) +- [Shawluck](https://github.com/Shawluck/) +- [Harsha S](https://github.com/sharsha315) +- [Matthew C](https://github.com/matthew08069) +- [David Wenk](https://github.com/thedavidwenk) +- [Alden Baughman](https://github.com/aldenbaughman) +- [giandab](https://github.com/giandab) +- [Žiga Berlič](https://github.com/zigaberlic) +- [Suneel Reddy](https://github.com/suneelreddysannala) +- [Vikrant](https://github.com/1vikrant) +- [Kazuho](https://github.com/kzhgit) +- [kmkkiii](https://github.com/kmkkiii) 🐢 +- [Kevin Koech](https://github.com/kevinkoech357) +- [Kevin Subbotin](https://github.com/KevinSubbotin) +- [Shoury Singh](https://github.com/shourysingh07) +- [Emmanuel Yegon](https://github.com/emmanuel-yegon) +- [suga5314](https://github.com/sg5314) +- [Rahul S Srivastava](https://github.com/Rahul-Srivastava-21) +- [Bhoomika kaushik](https://github.com/Bhoomikakaushik) +- [Aksh Walia](https://github.com/akshwalia) +- [Akshai Srinivasan](https://github.com/aksrin) + +- [Srishti Agarwal](https://github.com/srishtiagarwall) +- [Rahul Rajput](https://github.com/r2hu1) +- [Rajan Sharma](https://github.com/Immortal-codes) +- [imalightbulb](https://github.com/imalightbulb) +- [mpellouin](https://github.com/mpellouin) ! +- [Hunter Beach](https://github.com/HunterB433) +- [S-H](https://github.com/sholappa) +- [Frank Wang](https://github.com/blobthebuilder) +- [Jameel Ahmed](https://github.com/jameel-webdev) +- [Shanmuga priya](https://github.com/shanmugapriya1203) +- [Mohamed Afraar](https://github.com/Afraar99) +- [Prathwik](https://github.com/Prathwikacharya) +- [Louis Katz](https://github.com/LouisKatz123) +- [Omkar Kulkarni](https://github.com/omkarkulkarnii) +- [Two Spikes](https://github.com/TwoSpikes) +- [Faisal Aduko Wahabu](https://github.com/faisaladuko) +- [Rituraj Hao](https://github.com/rituraj27) +- [Sanay Doshi](https://github.com/sanayd) +- [Naveen Kari](https://github.com/NaveenKari) +- [Abisola Majeed](https://github.com/AbisolaMajeed) +- [Aayushi Sinha](https://github.com/aayushi892) +- [Aditya Joshi](https://github.com/adityajoshi692003) +- [Naim Ahmad](https://github.com/Naim-Ahmad) +- [Arco Kim](https://github.com/ArcoKim) +- archit singh chahuan(https://github.com/archit-8) +- [Aditya](https://github.com/LogiqueClergyman) +- [SohamKore](https://github.com/SohamKore) +- [Israel N Precious](https://github.com/Precious000) +- [Rohit Singh](https://github.com/Rataash99) +- [Palash Chitnavis](https://github.com/PalashChitnavis) +- [abedalavi](https://github.com/abedalavi) +- [StablePeru](https://github.com/StablePeru) +- [Santos Arellano](https://github.com/Santos-Arellano) +- [Tyler B](https://github.com/tycbrown32) +- [Kati Saro](https://github.com/katisaro) +- [Youjin-K](https://github.com/Youjin-K) +- [Delton Hughes](https://github.com/dHughes97) +- [Sixtus Agbo](https://github.com/sixtusagbo) +- [Siddhesh Gawade](https://github.com/sid293)👋 +- [Huzaifa Azim](https://github.com/huzaifaazim0) +- [Joanna McDonald](https://github.com/joannamcd) +- [Tianna Lopes](https://github.com/TiannaLopes) +- [dDevAhmed](https://github.com/dDevAhmed/) +- [WaiyakiDev](https://github.com/MONSURU-rgb) +- [toya33](https://github.com/toya33) +- [Cez](https://github.com/Cezzzzzz) +- [Oluwasemilore Omotade-Michaels](https://github.com/shemigam1) +- [ycvy](https://github.com/ycvy) +- [Fahim Muntasir](https://github.com/fahim-muntasir) +- [Madike Olisa](https://github.com/ChubbyJoe) +- [Sai_Aung_Wann](https://github.com/AungWann) +- [Jovillios](https://github.com/Jovillios) +- [Tanvi Shetty](https://github.com/Shettytan99) +- [Manu Bharadwaj](https://github.com/Manu577228) +- [Sai Tanishq Nannapaneni](https://github.com/saitanishq) +- [Canyon Bryson](https://github.com/canyonbryson) +- [Kevin L](https://github.com/klaig) +- [Itsuki54](https://github.com/Itsuki54) +- [Maitri Dalvi](https://github.com/maitri-dalvi) +- [Ivan Trepakov](https://github.com/liontiger23) +- [Rasika Lande](https://github.com//rasika2303) +- [LucasLuidy](https://github.com/LucasLuidy) +- [Aashish Gupta](https://github.com/AsysGupta) +- [Sachini Sahasra](https://github.com/Sahasra0108) +- [Sinuhe Velazquez](https://github.com/Sinuhe135) +- [Kalash](https://github.com/Kalash-C1) +- [Siyu Fang] (https://github.com/FsyJerryDev) +- [Kavya Yamsani](https://github.com/ykavya5) +- [Ryan Dallimore](https://github.com/rdallim2) +- [Tim the First](https://github.com/tjr214) # Thank you! +- [Aniket Botre](https://github.com/Aniket200-ind) +- [Harsha S](https://github.com/harsha-likes-to-code) ^\_^ +- [Rafal Jasielec](https://github.com/GHrjasielec) +- [Nitin Yadav](https://github.com/nitinya9av) +- [hg1414](https://github.com/hg1414) +- [rbrickmn](https://github.com/rbrickmn) +- [yend724](https://github.com/yend724) +- [Dwiki Kurnia](https://github.com/dwikikurnia) +- [mpousmali](https://github.com/mpousmali) +- [GreenWeegeeCantCode](https://github.com/GreenWeegeeCantCode) +- [mpousmali](https://github.com/mpousmali) +- [Murtaza](https://github.com/Murtaza-001) +- [Angelica Michaca](https://github.com/Angelica-Michaca) +- [vin709](https://github.com/vin709) +- [Chandana Srinivasa Yatisha](https://github.com/chandanasy) +- [Vishwa](https://www.google.com) +- [Praveen R](https://github.com/PRAVEENRP1047) +- [Caio Barbosa](https://github.com/CaioBarbosaAdS) +- [MohanRaj R](https://github.com/Mohanraj7373) +- [Nb](https://github.com/Neeraj6Maths) +- [Greg Finney](https://github.com/GregFJr) +- [Ido Majid] (https://github.com/idomajid) +- [Arthur Griffith](https://github.com/agriffith18) +- [charlesdzadu](https://github.com/charlesdzadu) +- [Benabadji Abdelkader Tarik](https://github.com/tarikko/) +- [Catherine Mokgothu](https://github.com/catherinemokgothu) +- [Nitika Bahl](https://github.com/NitikaBahl) +- [Pranjal Singh](https://github.com/Pranjal0901) +- [Caren Mwaka](https://github.com/Caren-Mwaka) +- [Milind Dhamu](https://github.com/milinddhamu) +- [jorge zabbara](https://github.com/jorgezabbaram) +- [Tony B. Nya](https://github.com/tonybnya) +- [Luca Bersezio](https://github.com/lucabersezio) +- [Mebanteidor M Syiem](https://github.com/teidorS) +- [Sinchana Kumbale](https://github.com/sinchana-kumbale) +- [Yuvraj Singh Wahla](https://github.com/yuvraj-singh08) +- [Adrià Escandell](https://github.com/AdriiE17) +- [Roberto Cárdenas](https://github.com/BrokenRoto) +- [Siddhesh Parate](https://github.com/Siddhesh877) +- [Aayushvyas1](https://github.com/aayushvyas1) +- [Ivine Chebet](https://github.com/Chebet895git) +- [Ronita Patra](https://github.com/Ronita-Patra) +- [Himanshu Garg](https://github.com/himanshu-garg-ds) +- [Abdallah Afifi](https://github.com/Abdallah-Afifi) +- [Atharva Gawas](https://github.com/ATHARVA-GAWAS) +- [Temitope Emokpae](https://github.com/temokpae3) +- [Rizki Ramadandi](https://github.com/rizkiramadandi) +- [Anand Rai](https://github.com/anandrai08) +- [Agneepradeep Verma](https://github.com/agneepradeep) +- [Aurélien Lainé](https://github.com/aurelien81) +- [jashan](https://github.com/JaSHaN-30) -[Syed Zainab](https://gothub.com/SyedZainab) +- [Vishnu Vardan](https://github.com/VV-22) +- [Maruthi Manideep Gorla](https://github.com/manideep3069) +- [Maximilian Ganske](https://github.com/MaxGanske) +- [Omer Diaaeldin](https://github.com/OmerDiaaeldin) +- [Sainul Abid](https://github.com/abidta) +- [Nereya Mantzur](https://github.com/NereyaMantzur) +- [Prathibha Boini](https://github.com/Prathibha-yadav) +- [Firoz Khan aka Codezakifiroz](https://github.com/codezakifiroz) +- [David Preradovic](https://github.com/DavideTheClown) +- [Ankur](https://github.com/Ar7109) +- [toryf](https://github.com/tfernandez2017) +- [Jun Lei](https://github.com/junevision) +- [Lavinia](https://github.com/Lavinia225) +- [Vikas](https://ithub.com/Vikas013) +- [Akshay](https://github.com/akkiii13) +- [Guillermo Nicolas Petcho](https://github.com/guillermopetcho) +- [VaibhavSuryavanshi93](https://github.com/VaibhavSuryavanshi93) +- [FlandersFrybad](https://github.com/flandersfrybad) 🍉 +- [Md Hasinur Rahman](https://github.com/halim4989) +- [Daris Mathew](https://github.com/darismathew92) +- [Harish Kushwah](https://github.com/Harish-Kushwah) ❤️ INDIA +- [Kartik Pawar](https://github.com/kartikpawar10) INDIA +- [Damodhar Munagala](https://github.com/mrdamodhar) +- [Rafael Santos](https://github.com/Blackmagicbox) +- [Krish Sehgal](https://github.com/krish-sehgal) +- [Ionecum](https://github.com/ionecum) +- [Ayush Soni](https://github.com/ayushsoni02) +- [Sidharth Tripathi](https://github.com/sidharthtripathi) +- [AM-Shafin](https://github.com/am-safin) 👊 +- [Bharath Ram S](https://github.com/BharathRam125) +- [Rakeshkandhi](https://github.com/rakeshkandhi) +- [layout SY](https://github.com/layout-SY) +- [iam-jerry](https://github.com/iam-jerry) +- [Renaulter](https://github.com/himanshu-gadia) +- [sambutracy](https://github.com/sambutracy) +- [TH-Raju](https://github.com/TH-Raju) +- [Advait Johari](https://github.com/aadijo) +- [Ron Mordokhovich](https://github.com/RonMordo) +- [John Co](https://github.com/john0ground) +- [DylanCo](https://github.com/DylanCoexel) +- [Saurav Kumar Mishra](https://github.com/sauravkm) +- [André Wlodkovski](https://github.com/andrewlod) +- [Yash Singh](https://github.com/YaSH-sInngH) +- [Kim La](https://github.com/ktla99) +- [Naz0904](https://github.com/Naz0904) +- [George Fam](https://github.com/George-Fam) +- [Jm Delas Alas](https://github.com/letandconst) +- [Eke Francis Okechukwu](https://github.com/Ekefrancisokechukwu) +- [Monopavo](https://github.com/Monopavo) +- [Iliyan Galabov](https://github.com/iliyan-pigeon) +- [Shishir Chulliyil](https://github.com/shishirchulliyil) +- [iriidium](https://github.com/iridiium) +- [Temple Snowden](https://github.com/temple69) +- [Kunal Sharma](https://github.com/Kunal926/Gender_Classification) +- [HarryKim24](https://github.com/HarryKim24) +- [Aaron Nim](https://github.com/aaronnim) +- [jarmac0811](https://github.com/jarmac0811) +- [Виталий Дмитриев](https://github.com/vitaldmit) +- [Giuseppe Desiato](https://github.com/gdesiato) +- [ANJAN672](https://github.com/ANJAN672) +- [Abdullah Kidwai](https://github.com/fauzank339) +- [Alston Antony](https://github.com/alston06) +- [Sulejman Hoxha](https://github.com/sulejmanhoxha) +- [Ali Rahbar](https://github.com/crypto-a) +- [Skin Spectra](https://github.com/mqry) +- [iPig](https://github.com/ipigtw) +- [Kornel Hergert](https://github.com/kornel54) +- [Gypra](https://github.com/42plat0) +- [Sara Tahdi](https://github.com/Sara-Tahdi) +- [Mohammed Hamid](https://github.com/MdHamid06) +- [Leul Adnew](https://github.com/leulad) +- [Fabricio](https://github.com/fabsantana) +- [PancakesForRent](https://github.com/PancakesForRent) +- [SurendharGN](https://github.com/SurendharGN) +- [Yashas-naidu](https://github.com/Yashas-naidu) +- [tejas-mn](https://github.com/tejas-mn) +- [jotavare](https://github.com/jotavare) +- [Spencer Craigie](https://github.com/sscraigie) +- [Reajang](https://github.com/Reajang) +- [Niraj Giri](https://github.com/nirajgiriXD) +- [dev-sik2](https://github.com/devpang20) +- [Onyedikachi Amaechi-Okorie](https://github.com/Honyii) +- [Nitant Makwana](https://github.com/nitverse) +- [Matthew McWilliams](https://github.com/potatoBobRocks) +- [Gabby Greer](https://github.com/gabbygreer) +- Ayush Agarwal +- [@eiramada](https://github.com/eiramada) +- [Elton Armelini](https://github.com/EltonArmelini) +- [Gary Meng](https://github.com/liutongechao) +- [Konstantin Boykov](https://github.com/voidoid999) +- [Himanshu Singh](https://github.com/hswrldwide) +- [Aravind Gunasekaran](https://github.com/AravindGShanthi) +- [Anjali Jaiswal](https://github.com/ajaisw13) +- [Kain](https://github.com/kainosaur) +- [hamza](https://github.com/bouayadhamza) +- [Rounak Kumar Singh](https://github.com/rounakkumarsingh) + Kumar Sanjeev Dutta(https://github.com/sanjeevWeb) +- [Abdul khader](https://github.com/davyjones7321) +- [Rounak Kumar Singh](https://github.com/rounakkumarsingh) +- [David Preradovic](https://github.com/DavideTheClown) +- [ErkanPerkan25](https://github.com/ErkanPerkan25) +- [Qki](https://github.com/Qkyyy) +- [Brayan Gatica](https://github.com/ibrayann) +- [Rounak Kumar Singh](https://github.com/rounakkumarsingh) +- [Pradeep Peethambaram](https://github.com/pradeepblue) +- [VIGNESH BABU](https://github.com/VICKY-0017) +- [Newton Mwasomanya](https://github.com/nmwasomanya) +- [kuephi](https://github.com/kuephi) +- [matilopezz](https://github.com/matilopezz) +- [Siddharth](https://github.com/Siddharth194) +- [Jesus-Rojas](https://github.com/Jesus-Rojas) +- [gmpsankalpa](https://github.com/gmpsankalpa) +- [Heesu Han](https://github.com/han990702) +- [Peterson Moro](https://github.com/PM0R0) +- [Mark Louis Bernardo](https://github.com/marklouisALTER) +- [gjeodnd12165](https://github.com/gjeodnd12165) +- [Bernardo GE](https://github.com/geBernardo) +- [Abdulmajid Mahadi](https://github.com/sheriifMahadi) +- [Mario Arroyo](https://github.com/marioteli96) +- [Dann Gil Rabaya](https://github.com/thisismedg) +- [rivian](https://github.com/rivian96) +- [Anup Kumar Mridha](https://github.com/anupkumarmridha) +- [Ejemudaro Ufuoma Isaac](http://github.com/ufuomaisaac) +- [Guilherme Gomes](https://github.com/oGigaflops) +- [David Nawl Sang Lui](http://github.com/David-Sang96) +- [Sambhav Sharma](https://github.com/Dev-Sambhav) +- [Yuvaraj V](https://github.com/Yuvaraj643) +- [Ikuo Ohba](https://github.com/ohba-ikuo) +- [el amine 404](https://github.com/el-amine-404) +- [Apoorv Saini](https://github.com/Apsain1) +- [Arty S](https://github.com/artimys) +- [Luciano Barros](https://github.com/iBerserker89) +- [Farrukh Ahmed](https://github.com/farrukh-ahmed/) +- [Ankush Tiwari](https://github.com/tiwaribro/) +- [Dibyajyoti Mandal](https://github.com/cookiejar2104) +- [Geoff Jamieson](https://github.com/UnionPAC) +- [Danny Hidayat](https://github.com/dannyhdyt) +- [Anand Raj](https://github.com/anandr07) +- [Nicholas Olds](https://github.com/nicholas-olds) +- [Chandra Kant Bauri](https://github.com/Lynk4) +- [GlitchCake](https://github.com/GlitchCake) +- [Hasya Patel](https://github.com/hasya2107) +- [ChrisB0617](https://github.com/ChrisB0617) +- [removeableox](https://github.com/removeableox) +- Dypa03 +- [vivek vaidya](https://github.com/Vivek-Vaidya) +- [Alay Shah](https://github.com/alay28) +- [yukendhiran](https://github.com/yukendhiran) +- [Kiyah Mitchell](https://github.com/kiyahmitchell) +- [Athul Nambiar](http://github.com/athul-22) +- [Clyde Marindo](https://github.com/Clydie-Juls) +- [Kriti Chapagain](http://github.com/iamkriti) +- [Awais Ahmad](https://github.com/awaisahmad64) +- [Suraj Aute](https://github.com/RNTUNOOB) +- [Sudip Parajuli](https://github.com/Sudip777) +- [Mellon Amutuheire](https://github.com/AMUTUHEIREMELLON) +- [Jason Scott](https://github.com/Scott-Jason) +- [Metti Alinia](https://github.com/mett-E/) +- [Shishir Kr](https://github.com/krshishir1) +- 🐈‍⬛[lonely_caat](https://github.com/lonely-caat)🐈‍⬛ +- [Gatere Kinyanjui](https://github.com/gatere-kinyanjui) +- [Aleksander C](https://github.com/meritant) +- [Saur-av](https://github.com/Saur-av/) # Thanks for help +- [talktoyeet](https://github.com/talktoyeet) +- [iasonotk](https://github.com/iasonotk) +- [Henry Saya](https://github.com/HenrySaya) ##Backend Engineer +- [Bishal Adhikari](https://github.com/ezbishal) +- [Muhammad Ahmod](https://github.com/Muhammad-1990) +- [Alan Francisco Mora González](https://github.com/alanmgg) +- [Deepika Jain](https://github.com/deepika8383) +- [Avadhoot Tavhare](https://github.com/AvadhootT) +- [sus-domesticus](https://github.com/sus-domesticus) +- [sumanthtp](https://github.com/SUMANTHTPs) +- [Daniel Ndirangu](https://github.com/daniel-ndirangu) +- [Gyanavardhan](https://github.com/gyanavardhana) +- [Sourav Sathyan](https://github.com/souravsathyan) +- [tharendra](https://github.com/tharendra) +- [Ananya Sihag](https://github.com/ananyasihag) +- [Aaron Sanchez](https://github.com/aaron-ross-sanchez) +- [FlappyBird](https://github.com/flappybirdcs5) +- [Hasham Taujoo](https://github.com/HashamTaujoo) +- [Muhammad Aliyu Abubakar](https://github.com/mxg-mega) +- [Muhammad Hassaan](https://github.com/Hassaan68) +- [Luís Silva](https://github.com/LuisSilva7) +- [Mohib UL Rehman](https://github.com/Mohib-UL-Rehman) +- [Sachin Kumar](https://github.com/pseudofool) +- [Apoorv ](https://github.com/APOORV7G) +- [sarath033](https://github.com/sarath033) +- [Vlad D](https://github.com/casual-user-asm) +- [Nabil Negadi](https://github.com/Darknab) +- [AniketKumar](https://github.com/aniketkumar7) +- [Aditya Bansal](https://github.com/Adityab1179) +- [Olayinkascott Andee](https://github.com/scottandee) +- [WooJin Hong](https://github.com/woojinhong) +- [Eduardo Xavier](https://github.com/eduardodsxavier) +- [Steven Hedges](https://github.com/StevenH34) +- [Giorgos](https://github.com/geopat24) +- [thourihan](https://github.com/thourihan) +- [k8port](https://github.com/k8port) +- [Anderson F.P. Silva](https://github.com/AndersonFPS) +- [Faith Adewuyi](https://github.com/faithadewuyi) +- [Suraj](https://github.com/SurajKamal24) +- [Satvik](https://github.com/DevSatvik) +- [Alina Wayne](https://github.com/alina-wayne) +- [Soliu Adeosun](https://github.com/sawlew) +- [Martins Olumide](https://github.com/Martins100-Tmd) +- [Racheal Oyebamiji](https://github.com/rachealeniola) +- [FBirdCS](https://github.com/flappybirdcs) +- [Anslem](https://github.com/Anslem1) +- [Nehal Ingole](https://github.com/Ingole712521) +- [Kelvin okumu](https://github.com/kelvinokumu) +- [Eli Lewis](https://github.com/elilewis327) +- [Betsalel Geoffrey GOLO](https://github.com/betsalel44) +- [Toph](https://github.com/IndexChris) +- [Jawahar](https://github.com/juzztjawa) +- [sudo-henryeth](https://github.com/sudo-henryeth) +- [Arun Erram](https://github.com/arunerram) +- [CaioSilva](https://github.com/CaioSilvaCsv) +- [Jeremy Rule](https://github.com/macaw2000) +- [Juan Martinez](https://github.com/juanm18) +- [Alyssa Ortiz](https://github.com/ao994) +- [Dev Aggarwal](https://github.com/devaggarwal-1) +- [Lukmon Adeokun](https://github.com/AdekunleDally/first-contributions) +- [Dibya Shakti Panda](https://github.com/Dibyas98) +- [Navin P](https://github.com/mep1tz) +- [Sagar Betkar](https://github.com/sagarbetkar) +- [Jacob S](https://github.com/JacobSletten) +- [Sebastien Jacquemart](https://github.com/sebastienjacquemart-AI) +- [Ruhinda Roderick Izooba](https://github.com/Ruhinda01/) +- [Gerges Badr](https://github.com/GergesBadr) +- [Shahil Kumar](https://github.com/Shahil9728) +- [Liya K](https://github.com/liyamk) +- [DracoRX16](https://github.com/DracoRX16) +- [Alexander Todorovic](https://github.com/alexandertodorovic) +- Papavero +- kana +- [Ergys Hila](https://github.com/ergys25) +- [Sasmit](https://github.com/mosaicsoft) +- [Caleb Hill](https://github.com/calebhill98) +- [Looki](https://github.com/Looki-fr) +- [Lalit Chugh](https://github.com/Lalitkumar21/) +- [Tobi Stephen](https://github.com/Tobistephenn) +- [ITS MAC](https://github.com/itsmacr8) +- [Kevin Pomer] (https://github.com/kpomer) +- [WG](https://github.com/electro-phys) +- [Corey Kirschner](https://github.com/ckirschner) +- [RoraRaven](https://github.com/RoraRaven) +- [Rohit Roy](https://github.com/Roy009) +- [chief-fei](https://github.com/chief-fei) +- [Sushant](https://github.com/sushxnt) +- [Edward Bordenave](https://github.com/ebordenave) +- [NicoTerabyte](https://github.com/NicoTerabyte) +- [Ojo Tolulope](https://github.com/tolu1123) +- [Mohamed Amine Basdouri](https://github.com/MohamedAmin324) +- [JamZ](https://github.com/JamZYM) +- [Conner](https://github.com/23cmbrown) +- [chandan](https://github.com/chandanyuva) +- [Bhawesh Agrawal](https://github.com/bhawesh-source) +- [Aditya Ghosh](https://github.com/Nanashi-bot) +- [FraI3mega](https://github.com/FraI3mega) +- [Shraddha Nand Shah](https://github.com/shraddha1512) +- [Sourabh Kr. Rajput](https://github.com/Sourabh-Kr-Rajput) +- [Pankaj Singh Koranga](https://github.com/PankajSingh10) +- [Daniel](https://github.com/dddanielliu) +- [Marcelina Maye Abaga Maye](https://github.com/Marmaye) +- [MratWong](https://github.com/MratWong) +- [MarianoJ](https://github.com/marianoj1984) +- [Roman Zvir](https://github.com/roman-zvir) +- [Malone Napier-Jameson](https://github.com/MaloneMKD) +- [Walt Bringenberg](https://github.com/wwaltb) +- [Laul](https://github.com/laulycool) +- [Precious Ojogu](https://github.com/Prevz26) +- [Aman Anand](https://github.com/Amman-Aanand) +- [Ryan Kembrey](https://github.com/ryankembrey) +- [Rohit Kumar](https://github.com/Rohit10701) +- [Fedevcoding](https://github.com/fedevcoding) +- [Abdulsalam Yusuf](https://github.com/hyoukarh) +- [Sanjana](https://github.com/sanjanabharath) +- [Lokesh Kumawat](https://github.com/lokkeshhhhh) +- [Atul](https://github.com/Atuls-git) +- [Victoria](https://github.com/Vhickyy) +- [Jishnu Singh](https://github.com/Siam5ell) +- [Jeevitha D S](https://github.com/Jeevitha1005) +- [Muhammad Yousuf Iqbal Khan](https://github.com/youxufkhan) +- [Babitha Kumari](https://github.com/Babithakumari) +- [Matheus Alencar](https://github.com/MatThHeuss) +- [Unmilan Mukherjee](https://github.com/Missing-Identity) +- [Dimple Jain](https://github.com/dimplehoney) +- [Thawzin](https://github.com/Thawzin229) +- [Alex András Mándrik](https://github.com/alexmandrikdev) +- [MARCEl0 T0RRES](https://github.com/mjtp) +- [Helder Luz](https://github.com/HelderLuz) +- [arsha32 ](https://github.com/arsha32) +- [Tabish Shamim](https://github.com/tabishshamim10) +- [Ritik Agrawal](https://github.com/relar-Ritik) +- [Nnodim Obinna Brian](https://github.com/nnodim) +- [Alessio Bugetti](https://github.com/AlessioBugetti) +- [GwanBin Park](https://github.com/bgb10) +- [Mahesh Chaulagain] +- [Ray Yu](https://github.com/RayYu-ChunleiYu) +- [Yuki Kitayama](https://github.com/yukikitayama) +- [Tal Shaked](https://github.com/talshaked-git) +- [Ron](https://github.com/ronashkenazy) +- [Aryan Mehta](https://github.com/aryan-mehta) +- [Mayank Bhatnagar](https://github.com/maxH4k5s) +- [Sab3ha](https://github.com/Sab3ha) +- [Daksh Sharma](https://github.com/Daksharma19) +- [Emma](https://github.com) +- [Shengjie Ma](https://github.com/bluerose73) +- [HosamEldeen Reda](https://github.com/hosamr) +- [Nishar Miya](https://github.com/miyannishar) +- [Ogunleye](https://github.com/ogunleye0720) +- [Daniel Strong](https://github.com/strongdan) +- [Nafis Nihal](https://github.com/nafisnihal) +- [Yogesh G](https://github.com/yogeshgunasekaran) +- [Abdirashid Mowlid](https://github.com/Abdirashid-dv) +- [Sajeel Ahmed Alvi](https://github.com/sajeelalvi) +- [Priyansh Garg](https://github.com/prynshg) +- [Aravind R](https://github.com/AravindR97) +- [nickf2k](https://github.com/nickf2k) +- [Harish](https://github.com/HarishI123) +- [Edgar Dikenge](https://github.com/edgar3g) +- [Kyle Starrett](https://github.com/kylestarrett1) +- [Osama Ahmad](https://github.com/oahmadgit) +- [Miguel Vela](https://github.com/miguelarian) +- [Guillaume Muller](https://github.com/gmuller-dev) +- [Jules Reego Rufo](https://github.com/julesrufo26) +- [Reiner Balschun](https://github.com/ReinerBalschun) +- Nandini Kashyap +- [arrayMi](https://github.com/arrayMi) +- [Ashish Dochania](https://github.com/AshishDochania) +- [N1krat](https://github.com/N1krat) +- [Nikalas Armstrong](https://github.com/hangonasecond) +- [Duc Dong](https://github.com/ducdongmg) +- [Jessenavas](https://github.com/Jessenavas) +- [AestheticWolfie](https://github.com/AestheticWolfie) +- [Charley Yoshi](https://github.com/charleyoshi) +- [Sai Preetham Reddy](https://github.com/SaiPreethamReddyy) +- [Darko Milicevic](https://github.com/DarkoMilicevic5) +- [Paul Lee](https://github.com/plee30) +- [Daniel Niemann Hjermitslev](https://github.com/dnh33) +- Bianchi + Ayush Kumar +- [Jonathan Jones](https://github.com/devJonathanJones) + Ayush Jariyal +- [Liam Dwyer](https://github.com/ldwy4) +- [Sentinal cell](https://github.com/Sentinal-cell) +- [Penn Junior](https://github.com/Payne680) +- [Rohan Bhautoo](https://github.com/rohan-bhautoo) +- [Jatin Kalra](https://github.com/jatinkalra17) +- [paprykdev](https://github.com/paprykdev) +- [Aditya Shibu](https://github.com/adwii-iii) +- [Monjurul Ahsan](https://github.com/ahsan2001monjurul) +- [Maximilian Sombke](https://github.com/SombkeMaximilian) +- [Walid Rais](https://github.com/walidrais) +- [Drifted Clouds](https://github.com/DriftedClouds) +- [Amna Ahmed](https://github.com/nono5342) +- [Shreyes Gadwalkar](https://github.com/ShreyesGadwalkar) +- emmanuep +- [Wagor Victory](https://github.com/vickywagz) +- [Rithvik Shetty](https://github.com/rithvikshetty) +- [Syed Mehdi](https://github.com/Infamous003) +- [Ethan Don](https://github.com/ethan05d) +- [Balaji Jegadeesh V](https://github.com/Vbj1808/) +- [syurenuko](https://github.com/syurenuko) +- [Collin Hensel](https://github.com/chensel558) +- [Lukas Cihelna](https://github.com/LukasCihelna) +- [Namit Saxena](https://github.com/oddball1123) +- [atomic-soul](https://github.com/atomic-soul) +- [Abhinav](https://github.com/malteezy) +- [Andy Nguyen](https://github.com/AndyVuong201) +- [David Cao](https://github.com/dave-cao) +- [Bat-Hen Sharvit](https://github.com/bat-chen) +- [Matteo Urso](https://github.com/MatteoUrso) +- [David Shandor](https://github.com/DavidShandor) +- [alazyer](https://github.com/alazyer) +- [zjjzyl](https://github.com/zjjzyl) +- [Pawan Kumar](https://github.com/pawan132) +- [David Stephenson](https://github.com/dstephenson8) +- [Vedant Paturkar](https://github.com/Vedx23) +- [Anurag Sisodiya](https://github.com/ANURAGSISODIYAA) +- [Akshay R](https://github.com/akshay-rajan) +- [Ayinde Hassan](https://github.com/ayindeHassan) +- [Birva Sevak](https://github.com/birvasevak) +- [David Ejiro](https://github.com/David-Ejiro) +- [grzegorzkoszczal](https://github.com/grzegorzkoszczal) -[Rahul Guggilam](https://github.com/Rahulguggilam2003) +- [Kingsley Kamkwamba](https://github.com/kamkwamba) +- [Wesley Perrang](https://github.com/Wesley-Perrang) +- [Judah Nii Bonney](https://github.com/JudahNii) +- [Felicia H](https://github.com/coder02603) +- [Dori A](https://github.com/EdoriAtiri) +- [Yangmei J](https://github.com/Apecool) +- [ScriptSchmiddie](https://github.com/ScriptSchmiddie) +- [Ritwick Raj Makhal](https://github.com/ritwickrajmakhal) +- [Theodor Johanson](https://github.com/TheoJoha) +- [Prasad Tajne](https://github.com/Prasad-codes) +- [Pritha Maity](https://github.com/PrithaMaity) +- [Ejaz Khan](https://github.com/ejazkhan172) +- [dhrinch](https://github.com/dhrinch) +- [Ruth Oster](https://github.com/ruttynext) +- [its-TROY](https://github.com/its-TROY) +- [Aditya Shekhar](https://github.com/Aditya-76) +- [A Z Hasnain Kabir](https://github.com/HasnainKabir-repos) +- [donkeeman](https://github.com/donkeeman) +- [adamsocki](https://github.com/adamsocki) +- [Adam Steiger](https://github.com/adamstgr) +- [Gordon Lim](https://github.com/gordonlim02) +- [SoulRvr29](https://github.com/SoulRvr29) +- [Conner Crosby](https://github.com/cavcrosby) +- [DetorlarMubarak](https://github.com/Pious-coder) +- [Christian Feliciano](https://github.com/cfeliciano7792) +- [cvuneeez](https://github.com/cvuneeez) +- [Tom Winfield](https://github.com/TomWinfield) +- [Yatee Singh](https://github.com/yatee-singh) +- [Cristhian Becerra](https://github.com/cbecerrae) +- [Amin Khadjenouri](https://github.com/Aminkowski) +- [Hariharan](https://github.com/Hariharan148) +- [Atharva Pardeshi](https://github.com/SazedWorldbringer) +- [Khai Tran](https://github.com/minhkhai2005) +- [Emmett Fitzharris](https://github.com/emmettirl) +- [Zachary D Liu](https://github.com/ZacharyDLiu) +- [Calen Shirfield](https://github.com/CalenShirfield) +- [nikolacox](https://github.com/nikolacox) +- [Aditya Patel](https://github.com/thepateladitya) +- [Ling Xiao](https://github.com/lingxiao14122) +- [Pongking](https://github.com/Pongking) +- [Sravan K Suresh](https://github.com/SRAVAN-IITB) +- [pvk29](https://github.com/pvk29) +- [Zelimir Stojcevic](https://github.com/ZelimirS) +- [Victor Maia](https://github.com/victooooor) +- [Ibrahim Khan](https://github.com/IbrahimKhanGH) +- [Haneen](https://github.com/han1py) +- [nick-nugat](https://github.com/nick-nugat) +- [Naveen Kurella](https://github.com/KURELLANAVEEN) +- [Abhinav Ujjawal](https://github.com/Abhinav-Ujjawal) +- [Yousef Hadder](https://github.com/hadder94) +- [justkusch](https://github.com/justkusch) +- [joejoeelephant](https://github.com/joejoeelephant) +- [amoghshakya](https://github.com/amoghshakya) +- [Vitor Orsin](https://github.com/YaboiAst) +- [Caio Ueda Sampaio](https://github.com/KY-U) +- [Luiz Fávaro](https://github.com/luizdevfelipe) +- [James Russell](https://github.com/James-blend/) +- [Dastageer HC](https://github.com/dastageer-hc) +- [Serhat Bağlam](https://github.com/Rserhat01) +- [Tim Maingi](https://github.com/Merch7x) +- [Suchkov Denis](https://github.com/SuchkovDenis) +- [BernardoMacedo](https://github.com/bernardo-macedo) +- [Lestan D'Souza](https://github.com/lestan) +- [Harshath M](https://github.com/HarshathM) +- [sabhanaaz Hussain](https://github.com/sabhanaaz) +- [sabhanaaz](https://github.com/sabhanaaz) +- [Gustavo Barbosa](https://github.com/Gustavobsbs) +- [Kennedy Ekanem](https://github.com/KenEkanem) +- [KAANAN](https://github.com/Kaanan2000) +- [Kenneth Kong](https://github.com/kennethkonghk) +- [Douglas Lobato](https://github.com/douglaslobato) +- [Alessandro Cappiello](https://github.com/AleCap747) +- [Kunal05052003](https://github.com/Kunal05052003) +- [inclinated](https://github.com/inclinated) +- [lukasf96](https://github.com/lukasf96) +- [Zelphh](https://github.com/Zelphh) +- [Aakruti Kalia](https://github.com/akku-07) +- [DankGuy](https://github.com/DankGuy) +- [Miloslav77CZ](https://github.com/Miloslav77CZ) +- [oladetohun1](https://github.com/oladetohun1) +- [Juliet Ofoegbu](https://github.com/OmaJuliet) +- [Swetha Madhanmohan](https://github/com/xswex09) +- [Luis Fernando Tenorio Mora](https://github.com/ltenoriom) +- [jaroslaw1](https://github.com/iaroslaw1) +- [marysaley](https://github.com/marysaley) +- [Tim Maingi](https://github.com/Merch7x) +- [Hruthik Anugula](https://github.com/hruthikgithubrit) +- [Taiwo Akerele](https://github.com/TaiwoSoftware) +- [Ravnit Lotay](https://github.com/Ravnit202) +- [MK Saba](https://github.com/mksaba) +- [Garfield](https://github.com/jiafie7) +- [S Yougesh Kumar](https://github.com/Yougesh978) +- [MohammadKad](https://github.com/mohammadkad) +- [Atilola Oyediji](https://github.com/netblaiz) +- [vignshwaransrinivasan](https://github.com/vignesh-04rep) +- [Aniket Negi](https://github.com/theaniketnegi) +- [yunmaoQu](https://github.com/yunmaoQu) +- [Kamari M.](https://github.com/Kamari93) +- [Pablo Zurita Lozano](https://github.com/PZL2004) +- [Sumedha Koranga](https://github.com/sumedhakoranga) +- [Moataz Amr](https://github.com/moataz77716) +- [PeKaStLa](https://github.com/PeKaStLa/) +- **[Diwakar Allu](https://github.com/DiwakarAllu/)** 💘 +- [Sultan Mahmud](https://github.com/kaziiriad) +- [Matt90hz](https://github.com/Matt90hz) +- [Rahul kanyal](https://github.com/Rahulkanyalgith) +- [Baljit Singh](https://baljit998.github.io/Space-portfolio/) +- [Njoli Patrick](https://github.com/njolipatrick/) +- [Prakhar Pandey](https://github.com/Prakhar-Pandey28/) +- [voltagecontrol](https://github.com/voltagecontrol/) +- [Alamin](https://github.com/AlaminPu1007) +- [Merinques](https://github.com/Merinques) +- [Tom Scheers](https://github.com/tomScheers) +- [Irfan Ali](https://github.com/irfanali1995/irfanali1995) +- [Ismael Abdulahi](https://github.com/Ismael-ux1) +- [Unnikrishnan Namboothiri](https://github.com/unnikrishnanNam) +- [freezerbox](https://github.com/freezerbox1) +- [Abdulhaleem Sanuth](https://github.com/Abdulhaleem-6) +- [CaitlinIsShort](https://github.com/caitlinisshort) +- [viswanathr](https://github.com/viswanathr73) +- [Richard Kenneth](https://github.com/richardkenneth10) +- [Daniel Guerra](https://github.com/DakkuaDev) +- [Filippos Gkotsopoulos](https://github.com/fgkotsopoulos) +- [Akashzealzoft](https://github.com/Akashzealzoft) +- [Pritam Das](https://github.com/4ritam) +- [Srijan Biswas](https://github.com/srijanB7) +- [Dinesh Dhanji](https://github.com/DineshDhanji) +- [Ziwen Ming](https://github.com/3miumi) +- [Joise](https://github.com/Hawthorn-1010) +- [Lpouumia](https://github.com/lpouumia) +- [Mtwa Mgimwa](https://github.com/cisCO₂001) +- [Danny Rivas](https://github.com/DannyRivasDev) +- [promax1113](https://github.com/promax1113) +- [darkdevil3610](https://github.com/darkdevil3610) +- [PJha](https://github.com/connectPjha) +- [Xamss](https://github.com/Xamss) +- [riadmmdli](https://github.com/riadmmdli) +- [ganximi](https://github.com/ganximi) +- [Aditya Kumar](https://github.com/ad1tyaaa) +- [Gabriele-Dotcom](https://github.com/Gabriele-Dotcom) +- [Kent Howell](https://github.com/khowellmobile) +- [Kaan](https://github.com/ksayin) +- [KonerDev](https://github.com/KonerDev) +- [MacMatthew](https://github.com/macmatthew) +- [Marius Užemeckas](https://github.com/39015745) +- [Abhishek kar](https://github.com/noob-coder497) +- [Kornél Tomai](https://github.com/korneltomai) +- [OmegaDL2](https://github.com/OmegaDL2) +- [Paran Kabiththanan] (https://github.com/KabiththananParan) +- [Popperda](https://github.com/popperda/) +- [Arslan Khalid](https://github.com/iarslankhalid/) +- [yangchunhua](https://github.com/1250855168/) +- [Keshav_Kanathia](https://github.com/KeshavSharma6) +- [Milad G](https://github.com/MiladGGG) +- [Kundan Kumar](https://github.com/kundank02) +- [Ishraq Ahmad](https://github.com/KarlMagus) +- [SilencioPz](https://github.com/SilencioPz) +- Praveen Neel +- [Samuel Church](https://github.com/samdcchurch) +- [mkeithx](https://github.com/mkeithX) +- [MertKy](https://github.com/MertKy/) +- [Ujaved931](https://github.com/ujaved931/) +- [ArcXeon](https://github.com/ArcXeon/) +- [allaert](https://github.com/allaert/) +- [Tin](https://github.com/Tincando) +- [Wilson](https://github.com/wilwu2168) +- [Krishna](https://github.com/Krishna01work) +- [Anu](Anu-310) +- [Keem Sys](https://github.com/keem-sys) +- [Kamau Mbugua](https://github.com/kk-mbugua) +- [Uriel](https://github.com/urieltfk) +- [Saddam](https://github.com/saddam-sde) +- [Lorraine](https://github.com/WambiruL) +- [MastroChou](https://github.com/MastroChou) +- [Negan Nguyen](https://github.com/nenene1812) +- [Sriram B](https://github.com/Sriram-B-Srivatsa) +- [Chen Jiang](https://github.com/LuluLalaJ) +- [Adwaith M K](https://github.com/a-dwaith) +- [Fabio k](https://github.com/Fabio-k) +- [umair ibrahim](https://github.com/omair1996) +- [Quan Do](https://github.com/dodangquan123) +- [Paerarason](https://github.com/paerarason) +- [Shubham](https://github.com/shubhamparmar1) +- [Shahar](https://github.com/JimnyCoder) +- [Junkai Ji](http://github.com/swampholyten) +- [want2012](https://github.com/want2012) +- [Adilet Baimyrza](https://github.com/AdiletBaimyrza) +- [Rahul Kundu](https://github.com/rahulkundu1209) +- [LionKang](https://github.com/Lion-Kang) +- [Tsveto](https://github.com/Sclipper) +- [salaminipples](https://github.com/salaminipples) +- [bucked404](https://github.com/bucked404) +- [buckmisterfullereno](https://github.com/Buckminsterfullereno) +- [Abhijithmr-403](https://github.com/AbhijithMR-403) +- [RegianaBarbosa](https://github.com/RegianaBarbosa) +- [derronli](https://github.com/derronli) +- [EnesUnlu](https://github.com/enes9103) +- [Dhruv Koli](https://github.com/dask-58) +- [root-Manas](https:/github.com/root-Manas) +- [Izzy](https://github.com/IzzyPrime) +- [Peytonjc](https://github.com/peytonjc) +- [jrTilak](https://github.com/jrTilak) +- [Xianyxu](https://github.com/xianyxu) +- [jerjjj](https://github.com/jerjjj) +- [rakin](https://github.com/raiyen-zayed-rakin) +- [raphaeling](https://github.com/raphaeling) +- [jkasama](https://github.com/jkasama) +- [ljunya](https://github.com/ljy18) +- [Bhawana](https://github.com/bhawanaagarwal) +- [Anaida Siv](https://github.com/Anaidasiv) +- [Naomi Oyerbach](https://github.com/NaomiOyerbach) +- [Vinia Parker](https://github.com/Lavparker) +- [Rithwik S Bharadwaj](https://github.com/rithwiksb) +- [Chandrakanth Kokkiripati](https://github.com/Chandrakanthkokkiripati) +- [James](https://github.com/jwunet) +- [Deependra Chaddha](https://github.com/DeependraChaddha) +- [Ali Sina](https://github.com/alisina97) +- [Samuel Rubens](https://github.com/rubenszinho) +- [Promise Nwankwo](https://github.com/giftedpromise) +- [wissensalt](https://github.com/wissensalt) +- [sprvgt](https://github.com/sprvgt) +- [Mark Porcaro](https://github.com/markporcarojr) +- [FaultyNeko](https://github.com/FaultyNeko) +- [DevSaLLein](https://github.com/DevSaLLein) +- [Anirban-Chakraborty](https://github.com/codewithanirban) +- [Mateus Lucchese](https://github.com/mateuslucch) +- [Zain-Alabdeen](https://github.com/zainalabdeen) +- [AhmadMustafa01](https://github.com/AhmadMustafa01) +- [aromko 👨‍💻](https://github.com/aromko) +- [Vincenzo Schimmenti](https://github.com/Skimmenthal13) +- [jithinphilip](https://github.com/jithinphilip347) +- [Jithin Thankachan](https://github.com/jithin-space) +- [michik0](https://github.com/michik0) +- [TimotheeMarreroMeyer](https://github.com/TimotheeMarreroMeyer) +- [Salmah Lasisi](https://github.com/salmah52) +- [Pulkit Pathak](https://gothub.com/satyyam11) +- [Vince](https://github.com/Perunu) +- [John Octavio](https://github.com/ChocoCodes) +- [Pocolee](https://github.com/pocolee) +- [Ravi Gupta] (https://github.com/ravi7228-gh) +- [gunay-h](https://github.com/gunay-h) +- [Exia](https://github.com/ooexiaoo) +- [niqifan007](https://github.com/niqifan007) +- [jjhen99](https://github.com/jjhen99) +- [AntonGeTUM](https://github.com/AntonGeTUM) +- [ctrlVnt](https://github.com/ctrlVnt) +- [Mayank Verma](https://github.com/mayankverma2003) +- [Anzar Ahmad](https://github.com/AhmadAnzar) +- [Mikael Hans](https://github.com/MikaelHans) +- [Jeff Araujo](https://github.com/jeffara) +- [Jaroshevskii 🝳 ︝”🌈](https://github.com/jaroshevskii) +- [Elena N.J.](https://github.com/h669798) +- [Mohammed Mazhar Aziz](https://github.com/mazhar00786) +- [Catherine Kemigabo](https://github.com/kemigabocatherine) +- [Neeraj Pallikonda](https://github.com/neerajforeal) +- [Raven-July](https://github.com/Raven-July) +- [Ayush Desai](https://github.com/Ayush-desaii) +- [Ali Rasooli](https://github.com/Aliarm79) +- [Nilreboot](https://github.com/NilReboot/) +- [UntoldGam](HTTPS://github.com/UntoldGam) + [zahoorfarooq](https://github.com/zahoorfarooq) +- [bananapretzel](https://github.com/bananapretzel) +- [Tshidiso Mahlos](https://github.com/Hiccupfish) +- [Siddharth Vasu](https://github.com/sidvasu) +- [cweitong](https://github.com/cwt0213) + [Myo Afolabi](https://github.com/myoeverblazin) +- [hawkingwallct](https://github.com/hawkingwallct) +- [Flyaway](https://github.com/kayua27) +- [Eyal-Haimov](htpps://github.com/blindka) +- [Damian Kurkowicz](https://github.com/Kurkov11) +- [Alan](https://github.com/AlanThisis) +- [Malibongwe Gumede](https://github.com/maliByatzes) +- [Flynn](https://github.com/farthaz) +- [Rahul Jindal](https://github.com/rahuljindal1) +- [Art Villareal](https://github.com/Bushido-Art) +- [Caleb Osborn](https://github.com/Chaotechnician) + [Emil Stridell](https://github.com/estridell) +- [Jerry Yip](https://github.com/yhmyhm0910) +- [Jeevan S](https://github.com/JeevanS-777) +- [Michelle X](https://github.com/michelleshx) + [Pramukh S] +- [Shashiraj Walsetwar](https://github.com/ridersw) +- [jsdimig](https://github.com/jsdimig) +- [Danilo Znamerovszkij](https://github.com/danilo-znamerovszkij) +- [Daniel Kaijzer](https://github.com/danielkaijzer) +- [Ephraim Beltran](https://github.com/ephraim-beltran) +- [Patrick Piedad](https://github.com/patrickpiedad) +- [heywhf](https://github.com/heywhf) +- [Pravin Singh](https://github.com/itsmepravin) +- [corvo](https://github.com/Tathagata94) +- [pnambiar24770](https://github.com/pnambiar24770) +- [Hamd Waseem](https://github.com/hamdivazim) +- [Xiteng Yao](https://github.com/xtyao66) +- [Sengphachanh Chanthavong](https://github.com/tyecode) +- [aoi-hiraeth](https://github.com/aoi-hiraeth) +- [OsvaFernandez](https://github.com/osvafernandez) +- [Anu](Anu-310) +- [HarryKim24](https://github.com/HarryKim24) +- [Praveen Pandi](https://github.com/PravinPandi) +- [Abiha Sami](https://github.com/CodingBiyu) +- [Nestor Garcia](https://github.com/nestorjgc) ✔️ +- [Matthew Given](https://github.com/mgiv) +- [Didi Zapryanov](https://github.com/Jibromircho) +- [Emeraldthedev](https://github.com/OriloyeEmerald) +- [BeesyBumbleBee](https://github.com/BeesyBumbleBee) +- [Carry Lee](https://github.com/Nuaza) +- [yuchenlogin](https://github.com/yuchenlogin) +- [Furkan Dogmus](https://github.com/furkandogmus) +- [Saif Alvi](https://github.com/yuusaif) +- [Comet AHC](https://github.com/CometAHC) +- [Yakov Donde](https://github.com/yakovdonde) +- [ducknows](https://github.com/ducknows) +- [TheJobGG](https://github.com/theJobGG) +- [Gabe Cano](https://github.com/gabecano4308) +- [Eray Ates](https://github.com/erayates) +- [Pratyansha Rana](https://github.com/pratyansharana) +- [Paul Danso Asare](https://github.com/colorwhite-git) +- [Hasan Dilshad Husain](https://github.com/Hasan-1-6) +- [Alfonso de Mora Navarro](https://github.com/demora33) +- [Penguintheorem](https://github.com/penguintheorem) Pingu philosophy 🐧🐧🐧 +- [Gaopo Huang](https://github.com/GaopoHuang) +- [Victor Alejandro Contreras Vargas](https://github.com/vc743) Who's gonna carry the boats?💪🔥 +- [Hlan Htet Kyaw](https://github.com/HlanHtetKyaw) The last mile is the least crowded....... +- [titamoto](https://github.com/titamoto) +- [Neal Willis](https://github.com/nealwillis) +- [KiwamiJP](https://github.com/KiwamiJP) +- [Shahbaz Javed Qureshi](https://github.com/shahbazjavedqureshi) And the logs!?!! +- [Samyak Shah](https://github.com/sam10556)They Don't Know Me Son!!!! +- [Srajal Sawner](https://github.com/Srajal16) +- [JusiaDEV](https://github.com/JusiaDev) +- [Jayesh](https://github.com/jayeshrdeotalu) +- [Nehal chaudhary](https://github.com/neh666) +- [Amanda Monteiro](https://github.com/armontei) +- [baba_yaga](https://github.com/Rkbp-099) +- [Archer Chen](https://github.com/chenyongchangg) +- [Iliyan Nedelchev](https://github.com/ilkataa10) +- [Gabriel-Rojas](https://github.com/ga-romu) +- [brandobogar](https://github.com/brandobogar) +- [Maral Yousefi](https://github.com/Marall-Y) +- [Elijah Love](https://elijahlove.xyz) +- [Ksnq](https://github.com/devcembeer) [Website](https://ksnq.me) +- [Ashika Dsilva](https://github.com/ashikadsilva) +- [tenere](https://github.com/000tenere000) +- [Mohamed-Anasse](https://github.com/OuraghiMohamed-Anasse) +- [Abdulmalik-Raji](https://github.com/AbdulmalikRaji) +- [Abijith-Lawrence](https://github.com/abijithlj) +- [Nalin-Parihar](https://github.com/Phoneixlegend7) +- [Temitope Bankole](https://github.com/rareprince/) +- [Dhruvi Patel](https://github.com/dhruvipatel14) +- [Kevin Grammer](https://github.com/kevingrammer) +- DankDuck +- [Emma Barnett](https:/gitHub.com/ka-hels/) +- [batuhankzn](https://github.com/batuhankzn) +- [Sean Cho](https://github.com/seanhoonc) +- [Sinan Balıbey](https://github.com/sinanbalibey) +- [Rob](https://github.com/robbievolker) +- [Taylor Cottrell](https://github.com/tlcottr) +- [FredyGuerrero](https://github.com/manager-gos-sas/) +- [HWu](https://github.com/Aucannot) +- [JJM](https://github.com/Jiaming-Jin) +- [OneSrX](https://github.com/OneSrX) +- [Ifeoluwah](https://github.com/ifeoluwah21) +- [Soumyajit Mohapatra](https://github.com/soumyajitmohapatra) +- [Winston Kinoti](https://github.com/WinTush) +- [Avinash N](https://github.com/AviN27) +- [Dbecausing](https://github.com/dbecausing) +- [Jose Sesena](https://github.com/jsesena/first-contributions) +- [heywhf](https://github.com/heywhf) +- [Jeff Schuman](https://github.com/jschuman) +- [Suhas Harish] (https://github.com/SuhasHareesh) +- [Shiv Dev](https://github.com/Sh1vd3v) +- [Harshal Ingole](https://github.com/Harshalingole) +- [Joana Leoni](https://github.com/joanaleoni) +- [MohmadHabib](https://github.com/mohmadhabib) +- [Matheus Santos](https://github.com/matheussalencarr) +- [João Paulo](https://github.com/joaopaulosg21) +- [Nikos Moutafis](https://github.com/nikos-moutafis) +- [Godwin847](https://github.com/Godwin847) +- [Ritam Chatterjee](https://github.com/regnna) +- [Pramodh Rajapakse](https://github.com/PramodhRajapakse) +- [Shri Chandana](https://github.com/Shri2320) +- [Shri Chandana](https://github.com/Shri2320) + +- [Shreaoskar Roy](https://github.com/roybrains) +- [Muhammad Maarij Zeeshan](https://github.com/muhammad-maarij-zeeshan) +- [Ebrar Altunkaynak](https://github.com/ebrardev) +- [Anochiwa Alfred](https://github.com/AnochiwaAlfred) +- [Dilan Kaya](https://github.com/DilanKaya127) +- [Luke Guyre](https://github.com/Sassycatt) +- [Michael Bacca](https://github.com/Zerolxgic) +- [Matteo Bongiovanni](https://github.com/matteobongio) +- [Timothy Charteris] (https://github.com/timm167) +- [Taha S. ASAN](https://github.com/tahaasann) +- [Safa Osman](https://github.com/swafak) +- [Hamil Dimapanat](https://github.com/hvmil) +- [Suhash G](https://github.com/Suhash-25) +- [Sagar Shelke](https://github.com/seeprogramming) +- [Wilson Chin](https://github.com/shitofshit) +- [Ben Summerill](https://github.com/Bengsumm) +- [Sophie S](https://github.com/ssun00) +- [Harsha Siddalingachar](https://www.github.com/sharsha315) +- [JayeLee17](https://github.com/JayeLee17) +- [Niranjan Khedkar](https://github.com/Niranjan2048) +- [Maurizio Morgano](https://github.com/mmorgano) +- [Dewguy] (https://github.com/Dewguy) +- [Pasquotcho] (https://github.com/Pasquotcho) +- [K S Sai Teja](https://github.com/kssaiteja) +- [Venkatraj](https://github.com/ivenkatraj) +- [Tristan Hyams](https://github.com/tristanhyams) +- [uXTrebla](https://github.com/uxtrebla) +- [Buse Dağıdır](https://github.com/busedagidi) +- [Abhishek Singh](https://github.com/asabhi6776) +- [poojashreeks](https://github.com/poojashreeks) +- [Agunbiade Aishat](https://github.com/yeeshadev) +- [Anonym2137](https://github.com/Anonym2137) +- [Br0wnReculse](https://github.com/br0wnrecluse) +- [A K M Jubaeir Islam](https://github.com/Zubiii333) +- [Sri Ram Gowd Vuppala](https://github.com/velvet-thunder-cmd) +- [Matthew Weigand](https://github.com/MatthewWeigand99) +- [Shreelu Santosh](https://github.com/ShreeluSantosh) +- [A K M Jubaeir Islam](https://github.com/Zubiii333) +- [Abhay Singh](https://github.com/Abhay-Singh-1913) +- [Ian Hart](https://github.com/ianahart) +- [sperbs](https://github.com/sperbs) +- [Van Minh Tran](https://github.com/minhtran5109) +- [Uday Vara](https://github.com/UV26320) +- [Thiago Fraga](https://github.com/thiagoigfraga) +- [Prabel](https://github.com/HiPrabel) +- [Aryan Mahida](https://github.com/aryan083) +- -[tech_savvy78](https://github.com/techsavvy78) +- [Benedict Robinson](https://github.com/benedict-robinson) +- [Vetle HJ](https://github.com/VetleHJ) +- [Niranjan A S](https://github.com/Niranjan-A-S) +- [Gabriel Husain](https://github.com/gabe-husain) +- [Srekaravarshan N K](https://github.com/Srekaravarshan) +- [Avinash Mangalore Suresh](https://github.com/msavinash) +- [Ridhi Priya](https://github.com/Ridhi-priya) +- [Deepak Saini](https://github.com/dipaksaini98) +- [Jason Victor](https://github.com/jason-victor1) +- [Nsikan Patrick Adaowo](https://github.com/NsikanPatrick) +- [Valentyn Chernetskyi](https://github.com/Valik3201) +- [solola David](https://github.com/LetcodeitwithDave) +- [Prajein C K](https://github.com/prajein) +- [Abhiram A R](https://github.com/AbhiramAnanthu) +- [Grace Kim](https://github.com/gracekim1217) +- [Danyal Imtiaz](https://github.com/danyal-imtiaz99) +- [Clementallo](https://github.com/ClementEraud) +- [Sadia Ishtaq](https://github.com/SadiaIshtaq) +- [Rohan Noronha](https://github.com/ro23op) +- [Babouche](https://github.com/babouche03) +- [Nathan Goebel dit Reddacted](https://github.com/Nathan-Goebel-Reddacted) +- [Marta Laveda](https://github.com/MartaLB95) +- [Colin BFH](https://github.com/Colin5734) +- [Venkates Challa](https://github.com/vensablue192) +- [Ridwan Oladapo](https://github.com/theridwanoladapo) +- [Rohail Zubair](https://github.com/Rohail-Zubair) +- [Johnnoe Dom](https://github.com/johnniedom/) +- [Sanchay Jadon](https://github.com/sanchay22/) +- [Sarvesh0955](https://github.com/Sarvesh0955) +- [MichaelSoto95](https://github.com/MichaelSoto95) +- [Jorge M Soto Pena](https:://github.com/jorgemsotopena) +- [Michael](https://github.com/MichaelGrmns) +- [Samuel Pratt](https://github.com/srpratt) +- [jeevan-aj](https://github.com/jeevan-aj) +- [shilinwang](https://github.com/crzwzy) +- [Taufi](https://github.com/Taufi) +- +- [Jack Sighton](https://github.com/JackBerezhnov) +- [Ellis Franklin](https://github.com/ellfran-7) +- [alekhine](https://github.com/Src0p) +- [Mtendekuyokwa19](https://github.com/Mtendekuyokwa19) +- [Oladapo](https://github.com/Dapo-dan) +- [Watpo54](https://github.com/Watpo54) +- [PyaeSone](https://github.com/pyae198022) +- [Atsushi Koyake](https://github.com/devAtsushiKoyake) +- [Narayan Khanal](https://github.com/Nkhanal2002) +- [Marinos33](https://github.com/Marinos33) +- [40tude](https://github.com/40tude) +- [Hadi Purnomo](https://github.com/cephadi) +- [tester-327](https://github.com/tester327) +- [Mk9917](https://github.com/mk9917) +- [alecastaldo] (https://github.com/alecastaldo) +- [Joshua D] (https://github.com/JCD2k4) +- [HannanToprakPia](https://github.com/HannanToprakPia) +- [Rene Kathofer](https://github.com/rkatex) +- [Asfandiyark007](https://github.com/Asfandiyark007) +- [Aakash Sharma](https://github.com/aakashsharma7) +- [Adarsha P C](https://github.com/AdarshaCoding) +- [Sanskriti_Tiwaree](https://github.com/sanskriti0201) +- [Makr-Xie](https://github.com/Makr-Xie) +- [Paul-HenryP](https://github.com/Paul-HenryP) +- [galessi5150](https://github.com/galessi5150) +- [GrizzyUno](https://github.com/GrizzlyUno) +- [omar gamal mohamed](https://github.com/omariscoding1245) +- [Clementallo](https://github.com/ClementEraud) +- [Sadia Ishtaq](https://github.com/SadiaIshtaq) +- [Rohan Noronha](https://github.com/ro23op) +- [Babouche](https://github.com/babouche03) +- [JamesCicada](https://github.com/JamesCicada) +- [Nathan Goebel dit Reddacted](https://github.com/Nathan-Goebel-Reddacted) +- [Emerson Johnson](https://github.com/lbjmsu) +- [Marta Laveda](https://github.com/MartaLB95) +- [shhwangofficial](https://github.com/shhwangofficial) +- [Colin BFH](https://github.com/Colin5734) +- [AnishKarthic](https://github.com/ANISHKARTHIC) +- [anagha](https://github.com/anagha-v-bhat) +- [liuuu2004](https://github.com/liuuu2004) +- [Rohit Nain](https://github.com/rohit141914) +- [Sainaaa](https://github.com/sainaa21) +- [Lumbini Tambat](https://github.com/Alat07) +- [Nihal Mohammed](https://github.com/Nihal-Mohammed-V) +- [Ananya Lokesh](https://github.com/Ananyalokesh01/first-contributions.git) +- [Micah Hack](https://github.com/MicahHack) +- [agergoni](https://github.com/agergoni) +- [Lumbini Tambat](https://github.com/Alat07) +- [Soumya Makkar](https://github.com/soumyamakkar) +- [Burak_Altun](https://github.com/mburakaltun) +- [Edgit G](https://github.com/flame0618) +- [1ndedd](https://github.com/1ndedd) + [alvisha](https://github.com/Alvisha-28) +- [Abhishek Kumar Roy](https://github.com/Abhishek-kroy) +- [Shubham Kumar Subudhi](https://github.com/subhamKS) +- [Luciano-Jeonhyunjun](https://github.com/Luciano-JeonHyunJun) +- [Césaire-Dang](https://github.com/As2pique5) +- [Shivam Maniya](https://github.com/shivam-9999) +- cyber9host +- [Manasa32264](https://github.com/Manasa32264) +- nitewing9000 +- [Roberta Aguilar](https://github.com/robertarfa) +- [Saumya Thakkar](https://github.com/Deathstar1999) +- [woopy](https://github.com/woopy098) +- [PrakruthiPrasad](https://github.com/prakruthiprasad20) +- [Sujan Gowda M](https://github.com/Sujan33632) +- [WeiZh](https://github.com/shizaoa-x) +- [dev-kas](https://github.com/dev-kas) +- [Poorvika](https://github.com/poorvikaa08) + [ Ravikumar S](https://github.com/Ravikumar07-Byte) +- [Bill Law](https://github.com/bill-c-law) +- [YagoBonardi](https://github.com/yagobonardi) +- [BrendanArc](https://github.com/BrendanArc) +- [Richard Olpindo](https://github.com/djricky808) +- [teboho](https://github.com/teboho) +- [upayanmazumder](https://github.com/upayanmazumder) +- [makornobbe](https://github.com/XaNNaN) +- [Manisha](https://github.com/manishapalsam) +- [Manisha](https://github.com/manishapalsam) +- [Mubin Bagwan](https://github.com/mubinB) +- anavillamar +- [Syc](https://github.com/Sycc66) +- rmuzeya +- kizmarco +- [Axel Denouly](https://github.com/AxelDenouly/) +- [Manjiri](https://github.com/manjiri-b) +- [VivoDex](https://github.com/migi15ghost) +- [yuch3nchen](https://github.com/yuch3nchen) +- [antenor013](https://github.com/antenor013) +- [mor3dr3ad](https://github.com/mor3dr3ad) +- [Nicojsuarez2](https://github.com/NicoJSuarez2) +- [yama821](https://github.com/yama821) +- [solizma](https://github.com/solizma) nuthin +- [shreyasTechie](https://github.com/shreyasvg) +- [Abdelrahman Emara](https://github.com/AAEmara) +- [Chandan Ravi](https://github.com/chandanravic) +- [Amit Luhar](https://github.com/dedsec995) +- [Sumit Baranwal](https://github.com/Sumit-22) +- [Amri Reza W.](https://github.com/AmZaDin14) +- [Jikedao_yzc](https://github.com/yzc109) +- [herman-gathege](https://github.com/Herman-Gathege) +- [Paras] +- Paulo +- [rhu121](https://github.com/ThapaRh) +- [maskFox2](https://github.com/maskFox2) +- [Suvesh Pandey](https://github.com/suveshpandey) +- [1355_XCZ](https://github.com/1355-XCZ) +- [Farmeurimmo](https://github.com/Farmeurimmo) +- [DIALLO Elhadj Alhousseiny](https://github.com/Tangama-224) +- [FEI_TENG](My first contribution: https://github.com/FEITENG-0828/) +- [NyKot1ne](https://github.com/NyKot1ne) +- [menachem mintzberg](https://github.com/m-minz) +- [juliencastanier](https://github.com/juliencastanier) +- [kecirimickael](https://github.com/mkg1t) +- [OlivierDenoix](https://github.com/OlivierDenoix) +- [inammar](https://github.com/inammar) +- [jackituning](https://github.com/jackituning) +- [Freebet98](https://github.com/Freebet98) +- LeonJWD +- Polino +- olajideolamide +- [LidaMudota](https://github.com/LidaMudota) +- [Vikkram](https://github.com/vikkramstark) +- [Mihir Tandon](https://github.com/Mihirt2) +- [Akilmohammad](https://github.com/akilmohammad) +- [Ujjwal Reddy](https://github.com/NegativeClamper) +- [Ay0ko](https://github.com/Ay0ko) +- [brav68e](https://github.com/Brav68e) +- [psikyy](https://github.com/Psikyy) +- [Taumeh](https://github.com/taumehh) +- [Nguyen Ngoc](https://github.com/NgocNood) +- [MathieuMvondoMvondo](https://github.com/MathieuMvondoMvondo) +- [nostop10](https//github.com/nostop10) +- [Nguyen Ngoc](https://github.com/NgocNood) +- [nostop10](https//github.com/nostop10) +- [MRCORE]([SCMRCORE (NOBODY)](https://github.com/SCMRCORE)) +- [Royce Andrew](https://github.com/RoyceAndrew) +- [Jatin Parmar](https://github.com/JatinParmar1011) +- SlientHippo +- Aravind-Pramod +- [Vineel Palla](https://github.com/VineelReddy14) +- [staehli97](https://github.com/staehli97) +- [kane17](https://github.com/kane17) +- [amazingfarooqq](https://github.com/amazingfarooqq) +- [mathu](https://github.com/Mathu145) +- [bypythom](https://github.com/Bypythom) +- [KriawqZero](https://github.com/KriawqZero) +- [Phillip-James](https://github.com/Phillip-James) +- [aaronrosema](https://github.com/aaronrosema) + [jonathanc1923](https://github.com/jonathanc1923) +- [NitroXen](https://github.com/NitroXen) +- [MaximusDeimusMeridus](https://github.com/Maximo) +- [arunachalam](https://github.com/arunachalam077/) +- [Fellow-Banana](https://github.com/Fellow-Banana) +- [Yi-An (Shirley) Lin](https://github.com/shirleylin39) +- [AnesioSousa](https://github.com/AnesioSousa) +- [Fábio Alves Gomes](https://github.com/FabioDevGomes) +- [Mohit Srivastava](https://github.com/Mohit-Srivastava-Official) +- [Aswin-04](https://github.com/Aswin-04/) +- [albertolr98](https://github.com/albertolr98/) +- [Ganixx](https://github.com/Ganixx) +- [Shun11111](https://github.com/Shun11111) +- [nebulyu](https://github.com/nebulyu) +- [vivekpm614](https://github.com/vivekpm614) +- [syahmad](https://github.com/syahmad-equinix) +- [mujthaba](https://github.com/mujthabamkdev/) +- [Subham singh](https://github.com/subham-cd) +- [abdo00xdd](https://github.com/abdo00xdd) +- [sanecraft42]() +- [mgroen71](https://github.com/martijngroen1971) +- [anjelica](https://github.com/anjelica0224) +- [Husam_Al-nabeai](https://github.com/HusamAlnabeai) +- [madhavramini](https://github.com/madhavramini) +- [Huisien](https://github.com/kuhuisien) +- [Siddhaswar](https://github.com/siddhaswar-mohanty) +- [yumenewa](https://github.com/yumenewa2525) +- [Chulpyo Kim](https://github.com/chulpyo) +- [CodeWithTaskin](https://github.com/CodeWithTaskin) : My First Contribution, looking forward for more.. +- [Rachel Lin](https://github.com/ItzRae) +- [Kevin](https://github.com/KevinGuo07) +- [Anirban Sen](https://github.com/anirbansen17) +- [Eniafou](https://github.com/eniafou) +- [Zaradacht](https://github.com/zaradacht) +- [Indu Anuga](https://github.com/Induanuga) +- [Rishika Shrinivas Billa](https://github.com/rishikabilla) +- [Bhawish Kumar](https://github.com/BhawishKumarLohana) +- [Hogan Lin](https://github.com/hogan-tech) +- [Biswajit Panda](https://github.com/BiswajitHub) +- [MadeInFck](https://github.com/MadeInFck) +- [Sferratore](https://github.com/Sferratore) +- [Shravya Kudlu](https://github.com/ShravyaKudlu) +- [Wahhlei](https://github.com/Wahhlei) +- [noor zarei](https://github.com/mnz1365) +- [Yaswanth](https://github.com/yaswanthd333) +- [Neha Saleem Desai](https://github.com/nehasaleemdesai) +- [Abhijna](https://github.com/Abhijna11) +- [Cyberforge](https://github.com/cyberforge1) +- [Ron Daniel Manguerra](https://github.com/ronforrestron24) +- [Yashika Khattri](https://github.com/yashika232) +- [Sourabh Rai](https://github.com/fourabh) +- [Davi do Egito](https://github.com/davi-egito) +- [Zuckmantra](https://github.com/Zuckmantra) +- [Md. Rejwar Rahman Rifat](https://github.com/rejwar) +- [Fatih Kucukkara](https://github.com/fkucukkara) +- [Mustafa Chambers](https://github.com/mchamb92) +- [Garv Jhajharia](https://github.com/garvj65) +- [Vedant Patel](https://github.com/Vedant-07) +- [Arun N](https://github.com/arun-357) +- [LiWuyao](https://github.com/LiWuyao) +- [Neil Prabhu](https://github.com/NeilPrabhu) +- [Raghupathi](https://github.com/raghupathi321) +- [Ahmed Wael](https://github.com/ahmed-wael2002) +- [Adit Khandelwal](https://github.com/AditKhandelwal) +- [crun geek](https://github.com/geekk8) +- [Evan Perry](https://github.com/EvanPrograms) +- [crun geek](https://github.com/geekk8) +- [Farzana Chowdhury](https://github.com/ChowdhuryFarzana) +- [Pranay Karvi](https://github.com/pranaykarvi) +- [lemonexee](https://github.com/lemonexee) +- [Alessandro Iannacone](https://github.com/alesiestu) +- [Devesh Bervar](https://github.com/deveshbervar) +- [Jorgy Sandoval](https://github.com/NickToonOver) diff --git a/LICENSE b/LICENSE new file mode 100644 index 00000000..6f3f3099 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ + 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. diff --git a/README.md b/README.md new file mode 100644 index 00000000..c4d7ff80 --- /dev/null +++ b/README.md @@ -0,0 +1,255 @@ +[![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-2vqegkew0-ZuzGM1LO33C6Ts4nZyat1Q) +[![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ñola](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) +[پښتو](docs/translations/README.pus.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.md) +[Қазақша](docs/translations/README.kz.md) +[Bosanski](docs/translations/README.bih.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.et.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) + +# 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 this 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 this 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 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//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. + +create a 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). + +You could join our slack team if you need any help or have any questions. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-2vqegkew0-ZuzGM1LO33C6Ts4nZyat1Q). + +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) | + +

This project is supported by:

+

+ + + +

+ + diff --git a/docs/additional-material/Things a non Programmer can do.es.md b/docs/additional-material/Things a non Programmer can do.es.md new file mode 100644 index 00000000..85074ca4 --- /dev/null +++ b/docs/additional-material/Things a non Programmer can do.es.md @@ -0,0 +1,124 @@ +# 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 . diff --git a/docs/additional-material/Things a non Programmer can do.fr.md b/docs/additional-material/Things a non Programmer can do.fr.md new file mode 100644 index 00000000..66c1b40a --- /dev/null +++ b/docs/additional-material/Things a non Programmer can do.fr.md @@ -0,0 +1,52 @@ +# 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. diff --git a/docs/additional-material/Things a non Programmer can do.md b/docs/additional-material/Things a non Programmer can do.md new file mode 100644 index 00000000..f76181bf --- /dev/null +++ b/docs/additional-material/Things a non Programmer can do.md @@ -0,0 +1,124 @@ +# 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. diff --git a/docs/additional-material/Things a non Programmer can do.ta.md b/docs/additional-material/Things a non Programmer can do.ta.md new file mode 100644 index 00000000..d83a28ac --- /dev/null +++ b/docs/additional-material/Things a non Programmer can do.ta.md @@ -0,0 +1,157 @@ +# புரோகிராமர் அல்லாதவர் செய்யக்கூடிய விஷயங்கள் +## கேட்கத் தொடங்குங்கள் + +திறந்த மூலத்தில் உள்ள அனைத்தும் மற்றவர்களை உள்ளடக்கியது. +நீங்கள் ஒரு குழுவில் சேர விரும்புகிறீர்கள், அதாவது சமூகத்தையும் அது எவ்வாறு செயல்படுகிறது என்பதையும் புரிந்துகொள்வது. +ஒரு ப்ராஜெக்ட்டில் நுழைந்து, "ஹாய், இதோ இந்த ப்ராஜெக்ட் செய்ய வேண்டும் என்று நான் நினைக்கிறேன்" என்று சொல்வது பொதுவாக நல்ல விஷயமாக எடுத்துக்கொள்ளப்படுவதில்லை. +சில திட்டங்கள் அந்த வகையான அணுகுமுறையை வரவேற்கலாம், ஆனால் திட்டம் சிறிது நேரம் இயங்கிக்கொண்டிருந்தால், அந்த அணுகுமுறை ஏற்றுக்கொள்ளப்படுவதற்கான வாய்ப்புகள் சிறியவை. +**திட்டத்திற்கு என்ன தேவை என்பதை அறிய சிறந்த வழி கேட்பது.** + +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. **மற்றவர்களுக்குக் கற்றுக் கொடுங்கள்**: +ஒரு தலைப்பைப் பற்றி மேலும் அறிய சிறந்த வழி அதைக் கற்பிக்க முயற்சிப்பதாகும். +சிக்கலான விஷயங்களை எளிய உதாரணங்களுடன் விளக்கக்கூடியவர் சிறந்த ஆசிரியர். எனவே நீங்கள் சிறந்த கற்பவராகவும் உங்கள் நிரலாக்க உலகில் சிறந்தவராகவும் இருக்க சிறந்த ஆசிரியராக இருக்க முயற்சிக்க வேண்டும். மற்றவர்களுக்குக் கற்பிப்பது உங்களைப் பற்றி நன்றாக உணரவைக்கும், மேலும் உங்கள் தொழிலில் சிறந்த திறன்களையும் அறிவையும் பெற உதவும். நீங்கள் ஒருவரிடமிருந்து உதவியைப் பெற்றால், அதை நீங்களே வைத்துக் கொள்ளாதீர்கள், மற்றவர்களுடன் பகிர்ந்து கொள்ளுங்கள். உலகத்தை வாழ சிறந்த இடமாக மாற்றவும். \ No newline at end of file diff --git a/docs/additional-material/Things a non Programmer can do.th.md b/docs/additional-material/Things a non Programmer can do.th.md new file mode 100644 index 00000000..102ecb3d --- /dev/null +++ b/docs/additional-material/Things a non Programmer can do.th.md @@ -0,0 +1,125 @@ +#สิ่งที่คนที่ไม่ใช่โปรแกรมเมอร์สามารถทำได้ + +## เริ่มฟัง + +ทุกสิ่งในโอเพ่นซอร์สเกี่ยวข้องกับบุคคลอื่น +คุณกำลังมองหาที่จะเข้าร่วมทีม และนั่นหมายถึงการทำความเข้าใจชุมชนและวิธีการทำงาน +การเดินเข้าไปในโปรเจ็กต์แล้วพูดว่า "สวัสดี นี่คือสิ่งที่ฉันคิดว่าโปรเจ็กต์นี้ควรทำ" มักจะไม่ถือเป็นเรื่องดี +บางโครงการอาจยินดีกับแนวทางดังกล่าว แต่หากโครงการดำเนินไประยะหนึ่งแล้ว โอกาสที่ทัศนคตินั้นจะได้รับการยอมรับก็มีน้อย +**การฟังเป็นวิธีที่ดีที่สุดในการรู้ว่าโครงการต้องการอะไร** + +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. **สอนและช่วยเหลือผู้อื่น**: + วิธีที่ดีที่สุดในการเรียนรู้เพิ่มเติมเกี่ยวกับหัวข้อใดหัวข้อหนึ่งคือการพยายามสอนหัวข้อนั้น + ครูที่ดีที่สุดคือผู้ที่สามารถอธิบายเรื่องที่ซับซ้อนด้วยตัวอย่างง่ายๆ ดังนั้นคุณต้องพยายามเป็นครูที่ดีที่สุดเพื่อเป็นผู้เรียนที่ดีที่สุดและดีที่สุดในโลกการเขียนโปรแกรมของคุณ การสอนผู้อื่นจะทำให้คุณรู้สึกดีกับตัวเองมากขึ้น และจะช่วยให้คุณได้รับทักษะและความรู้ในวิชาชีพที่ดีขึ้นด้วย เมื่อคุณได้รับความช่วยเหลือจากใครสักคน อย่าเก็บมันไว้คนเดียว แบ่งปันกับผู้อื่น ทำให้โลกน่าอยู่ยิ่งขึ้น diff --git a/docs/additional-material/git_workflow_scenarios/Useful-links-for-further-learning.md b/docs/additional-material/git_workflow_scenarios/Useful-links-for-further-learning.md new file mode 100644 index 00000000..5088d67d --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/Useful-links-for-further-learning.md @@ -0,0 +1,46 @@ +# 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) +Keep adding more links, that you find helpful. diff --git a/docs/additional-material/git_workflow_scenarios/additional-material.md b/docs/additional-material/git_workflow_scenarios/additional-material.md new file mode 100644 index 00000000..28402a07 --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/additional-material.md @@ -0,0 +1,52 @@ +# 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. diff --git a/docs/additional-material/git_workflow_scenarios/amending-a-commit.md b/docs/additional-material/git_workflow_scenarios/amending-a-commit.md new file mode 100644 index 00000000..e1906151 --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/amending-a-commit.md @@ -0,0 +1,65 @@ +# 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). diff --git a/docs/additional-material/git_workflow_scenarios/check-commit-log.md b/docs/additional-material/git_workflow_scenarios/check-commit-log.md new file mode 100644 index 00000000..5b3f557c --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/check-commit-log.md @@ -0,0 +1,37 @@ +# 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) diff --git a/docs/additional-material/git_workflow_scenarios/configuring-git.md b/docs/additional-material/git_workflow_scenarios/configuring-git.md new file mode 100644 index 00000000..1d0359d8 --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/configuring-git.md @@ -0,0 +1,76 @@ +# 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). diff --git a/docs/additional-material/git_workflow_scenarios/creating-a-gitignore-file.md b/docs/additional-material/git_workflow_scenarios/creating-a-gitignore-file.md new file mode 100644 index 00000000..fbf671f7 --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/creating-a-gitignore-file.md @@ -0,0 +1,73 @@ +# .gitignore + +The .gitignore file is a text file that tells Git which files or folders to ignore in a project. + +A local .gitignore file is usually placed in the root directory of a project. You can also create a global .gitignore file and any entries in that file will be ignored in all of your Git repositories. + +## Why .gitignore +Now you may wonder why would you want git to ignore certain files and folders. Its because you don't want files like build files, cache files, other local configuration files like node modules, compilation files, temporary files IDE's create, etc to be tracked by git. It's usually used to avoid committing transient files from your working directory that aren't useful to other collaborators. + +## Getting started +To create a local .gitignore file, create a text file and name it .gitignore (remember to include the . at the beginning). Then edit this file as needed. Each new line should list an additional file or folder that you want Git to ignore. + +The entries in this file can also follow a matching pattern. + +``` +* is used as a wildcard match +/ is used to ignore path names relative to the .gitignore file +# is used to add comments to a .gitignore file + +This is an example of what the .gitignore file could look like: + +# Ignore Mac system files +.DS_store + +# Ignore node_modules folder +node_modules + +# Ignore all text files +*.txt + +# Ignore files related to API keys +.env + +# Ignore SASS config files +.sass-cache + +``` +To add or change your global .gitignore file, run the following command: + +``` +git config --global core.excludesfile ~/.gitignore_global + +``` +This will create the file ~/.gitignore_global. Now you can edit that file the same way as a local .gitignore file. All of your Git repositories will ignore the files and folders listed in the global .gitignore file. + +## How to Untrack Files Previously Committed from New Gitignore + +To untrack a single file, ie stop tracking the file but not delete it from the system use: + +``` +git rm --cached filename +``` + +To untrack every file in .gitignore: + +First, commit any outstanding code changes, and then run: + +``` +git rm -r --cached +``` + +This removes any changed files from the index(staging area), then run: + +``` +git add . +``` +Commit it: + +``` +git commit -m ".gitignore is now working" +``` + +To undo ```git rm --cached filename```, use ```git add filename``` diff --git a/docs/additional-material/git_workflow_scenarios/delete-branch-locally.md b/docs/additional-material/git_workflow_scenarios/delete-branch-locally.md new file mode 100644 index 00000000..8c16d6ab --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/delete-branch-locally.md @@ -0,0 +1,19 @@ +# 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... \ No newline at end of file diff --git a/docs/additional-material/git_workflow_scenarios/gitflow.md b/docs/additional-material/git_workflow_scenarios/gitflow.md new file mode 100644 index 00000000..98f98eec --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/gitflow.md @@ -0,0 +1,119 @@ +# 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. diff --git a/docs/additional-material/git_workflow_scenarios/installing-git-ubuntu.md b/docs/additional-material/git_workflow_scenarios/installing-git-ubuntu.md new file mode 100644 index 00000000..16e4b85b --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/installing-git-ubuntu.md @@ -0,0 +1,104 @@ +# 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. diff --git a/docs/additional-material/git_workflow_scenarios/keeping-your-fork-synced-with-this-repository.md b/docs/additional-material/git_workflow_scenarios/keeping-your-fork-synced-with-this-repository.md new file mode 100644 index 00000000..67ab0c72 --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/keeping-your-fork-synced-with-this-repository.md @@ -0,0 +1,45 @@ +# 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. diff --git a/docs/additional-material/git_workflow_scenarios/moving-a-commit-to-a-different-branch.md b/docs/additional-material/git_workflow_scenarios/moving-a-commit-to-a-different-branch.md new file mode 100644 index 00000000..40c8173f --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/moving-a-commit-to-a-different-branch.md @@ -0,0 +1,25 @@ +# 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. diff --git a/docs/additional-material/git_workflow_scenarios/removing-a-file.md b/docs/additional-material/git_workflow_scenarios/removing-a-file.md new file mode 100644 index 00000000..b155a06d --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/removing-a-file.md @@ -0,0 +1,23 @@ +# 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` diff --git a/docs/additional-material/git_workflow_scenarios/removing-branch-from-your-repository.md b/docs/additional-material/git_workflow_scenarios/removing-branch-from-your-repository.md new file mode 100644 index 00000000..e65eea7f --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/removing-branch-from-your-repository.md @@ -0,0 +1,31 @@ +# 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) diff --git a/docs/additional-material/git_workflow_scenarios/resetting-a-branch.md b/docs/additional-material/git_workflow_scenarios/resetting-a-branch.md new file mode 100644 index 00000000..65bd6481 --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/resetting-a-branch.md @@ -0,0 +1,18 @@ +# 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. diff --git a/docs/additional-material/git_workflow_scenarios/resetting-a-commit.md b/docs/additional-material/git_workflow_scenarios/resetting-a-commit.md new file mode 100644 index 00000000..c52bcdbb --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/resetting-a-commit.md @@ -0,0 +1,20 @@ +# 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 diff --git a/docs/additional-material/git_workflow_scenarios/resolving-merge-conflicts.md b/docs/additional-material/git_workflow_scenarios/resolving-merge-conflicts.md new file mode 100644 index 00000000..33264630 --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/resolving-merge-conflicts.md @@ -0,0 +1,35 @@ +# What is a merge conflict? + +When you try to merge another branch into your current working branch, you are taking changes from another context and combining them with your current working files. +If two people have changed the same lines in the same file, or if one person decided to delete it while the other person decided to modify it, Git cannot identify which is the correct version. Git will then mark the file as having a conflict - which you'll have to resolve before you can continue your work. + +# How to resolve a merge conflict? + +When faced with a merge conflict, git will mark the problematic area in the file by enclosing it in “<<<<<<<< HEAD” and “>>>>>>>>>>[other branch name]” + +The contents after the first marker originate from your current working branch. After the angle brackets, Git tells us where (from which branch) the changes came from. A line with "=======" separates the two conflicting changes. +Our job is now to clean up these lines: when we're done, the file should look exactly as we want it to look. It is advisable to consult the teammate who wrote the conflicting changes to decide which version should be final. It could be either one of yours - or maybe a mixture between the two. + +e.g. : +``` + <<<<<<< HEAD:mergetest + This is my third line + ======= + This is a fourth line I am adding + >>>>>>> 4e2b407f501b68f8588aa645acafffa0224b9b78:mergetest +``` + +`<<<<<<<`: Indicates the start of the lines that had a merge conflict. The first set of lines are the lines from the file that you were trying to merge the changes into. +`=======`: Indicates the break point used for comparison. Breaks up changes that user has committed (above) to changes coming from merge (below) to visually see the differences. +`>>>>>>>`: Indicates the end of the lines that had a merge conflict. + +You resolve a conflict by editing the file and then manually merging the parts of the file that git had trouble merging. This may mean discarding either your changes or someone else's or going ahead with a mix of the two. You will also need to delete the '<<<<<<<', '=======', and '>>>>>>>' in the file. + + +Once you have resolved the conflict do a `git add`. Do not forget to run the tests, as you have to make sure that you have resolved the conflict. + +You can also download different plugins depending on the IDE you are using for an easier way to resolve merge conflicts. + + +# How to undo a merge? +If you want to undo a merge then you can do `git merge —abort` diff --git a/docs/additional-material/git_workflow_scenarios/reverting-a-commit.md b/docs/additional-material/git_workflow_scenarios/reverting-a-commit.md new file mode 100644 index 00000000..762f73a0 --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/reverting-a-commit.md @@ -0,0 +1,41 @@ +# 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``` diff --git a/docs/additional-material/git_workflow_scenarios/squashing-commits.md b/docs/additional-material/git_workflow_scenarios/squashing-commits.md new file mode 100644 index 00000000..b31cc3b0 --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/squashing-commits.md @@ -0,0 +1,86 @@ +# 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. diff --git a/docs/additional-material/git_workflow_scenarios/stashing-a-file.md b/docs/additional-material/git_workflow_scenarios/stashing-a-file.md new file mode 100644 index 00000000..c3421d73 --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/stashing-a-file.md @@ -0,0 +1,137 @@ +# 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. \ No newline at end of file diff --git a/docs/additional-material/git_workflow_scenarios/storing-credentials.md b/docs/additional-material/git_workflow_scenarios/storing-credentials.md new file mode 100644 index 00000000..e9f3c10e --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/storing-credentials.md @@ -0,0 +1,48 @@ +# 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) \ No newline at end of file diff --git a/docs/additional-material/git_workflow_scenarios/undoing-a-commit.md b/docs/additional-material/git_workflow_scenarios/undoing-a-commit.md new file mode 100644 index 00000000..ba2d363d --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/undoing-a-commit.md @@ -0,0 +1,55 @@ +# 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. diff --git a/docs/additional-material/git_workflow_scenarios/why-using-branches.md b/docs/additional-material/git_workflow_scenarios/why-using-branches.md new file mode 100644 index 00000000..0ee58ea5 --- /dev/null +++ b/docs/additional-material/git_workflow_scenarios/why-using-branches.md @@ -0,0 +1,53 @@ +# WHY USING BRANCHES DURING CONTRIBUTING + +## What are branches. + +Branches are simply pointers to a commit. + +When you branch out, git is essentially making a new state of your current code, upon which you can work, without affecting the important main state of the code (which is in master branch). + +When you are happy with your experiments, and want to merge you experiments in main code, you run git merge + master. +This will tell git, to add in all changes from your experiment branch into master. + +This way, while working in an open source project with a number of contributors, it becomes easy to merge the best suited code without altering the main code or master branch. + +## How it works? + +A branch represents an independent line of development. Branches serve as an abstraction for the edit/stage/commit process. You can think of them as a way to request a brand new working directory, staging area, and project history. New commits are recorded in the history for the current branch, which results in a fork in the history of the project. + +The git branch command lets you create, list, rename, and delete branches. It doesn’t let you switch between branches or put a forked history back together again. For this reason, git branch is tightly integrated with the git checkout and git merge commands. + +## Why to use branches? + +If the question "Why do we use branching in version control like git?" still persists in your mind, here's a quick explanation: + +Let's take a simple example to understand the branching strategy. A production car needs a paint job before its launch. Prior to its official sale, it was decided that the car would come in 'olive green' color as default. But some of the members in the manufacturing team decided to showcase the car in 'red' color. Hence an ambiguous situation arises and to avoid this problem branching was introduced.The red color paint job is like a branch to the master repository 'Car'. Pushing this branch will suggest the red color. If merged with the master repository the car will get the red color otherwise it will continue with olive green. Merging a contributors branch to the master repo of the organization depends on the project head. + +## Example + +Alice is working on Feature A and Bob is working on Feature B. Alice is halfway done with Feature A and has made a few commits in alice. However, Feature A is quite hard to implement so Alice decides that she should rather work on Feature C and makes a few commits onto alice. Bob finished Feature B and decides that he would like to tackle Feature A and so pulls alice into bob. + +After Bob finishes Feature A he would like to merge bob into master. However, bob now contains Feature A, Feature B and parts of Feature C, but Feature C is not ready to be merged! It's easy to see that a workflow like this can lead to many confusing merge conflicts. + +The trick is that instead of having personal branches one should have feature branches. Alice should have a branch for Feature A and Feature C and Bob should have a branch for Feature B and Feature A. That way they both can work on different features without tramping on each other's toes. + +## How to create branches? + +#### Create a branch + +``` +git branch AnyBranchName +``` + +A new branch will be created named AnyBranchName and all the file changes in this branch will not be affected in the main branch. +For detailed explanation refer [How to create branch](https://www.atlassian.com/git/tutorials/using-branches) + +#### Delete the branch + +``` +git branch -d AnyBranchName +``` + +Branch name AnyBranchName will be deleted from the git repository. +Refer to [Removing branch from your repository](https://github.com/jashnimje/first-contributions/blob/7dcae72208e4b42fcf834b4f189fa8ee78238077/additional-material/git_workflow_scenarios/removing-branch-from-your-repository.md) diff --git a/docs/additional-material/translations/Belarusian/Useful-links-for-further-learning.by.md b/docs/additional-material/translations/Belarusian/Useful-links-for-further-learning.by.md new file mode 100644 index 00000000..ea6d697b --- /dev/null +++ b/docs/additional-material/translations/Belarusian/Useful-links-for-further-learning.by.md @@ -0,0 +1,36 @@ +# Карысныя спасылкі + +Гэты дакумент прысвечаны ўсіх сайтаў з парадамі і рэкамендацыямі, паведамленнях у блогах і карысным сайтам, якія палягчаюць наша жыццё. Яны з'яўляюцца выдатным арыенцірам для задавальнення ўсіх нашых патрэбаў, няхай гэта будзе пачатковец або эксперт. Гэтая старонка павінна служыць індэксам ўсіх тых карысных спасылак, якія дапамогуць усім, хто пачатковец у вобласці адкрытага зыходнага кода, ці каму-небудзь, хто хоча даведацца больш. + +## Спіс +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) + +Працягвайце дадаваць больш спасылак, якія вам падаюцца карыснымі. diff --git a/docs/additional-material/translations/Belarusian/additional-material.by.md b/docs/additional-material/translations/Belarusian/additional-material.by.md new file mode 100644 index 00000000..182da734 --- /dev/null +++ b/docs/additional-material/translations/Belarusian/additional-material.by.md @@ -0,0 +1,46 @@ +# Дадатковая інфармацыя + +Тут мы мяркуем, што вы ўжо асвоілі асноўную інструкцыю. Дадатковая інфармацыя змяшчае некаторыя звесткі аб 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, і тым, хто захоча павялічыць свае веды ў гэтай галіне. \ No newline at end of file diff --git a/docs/additional-material/translations/Belarusian/amending-a-commit.by.md b/docs/additional-material/translations/Belarusian/amending-a-commit.by.md new file mode 100644 index 00000000..b8666744 --- /dev/null +++ b/docs/additional-material/translations/Belarusian/amending-a-commit.by.md @@ -0,0 +1,46 @@ +# Выпраўленні ў каміты + +Уявіце, што вы зрабілі 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. \ No newline at end of file diff --git a/docs/additional-material/translations/Belarusian/configuring-git.by.md b/docs/additional-material/translations/Belarusian/configuring-git.by.md new file mode 100644 index 00000000..8cd9fda7 --- /dev/null +++ b/docs/additional-material/translations/Belarusian/configuring-git.by.md @@ -0,0 +1,76 @@ +# Канфігураванне 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). \ No newline at end of file diff --git a/docs/additional-material/translations/Belarusian/keeping-your-fork-synced-with-this-repository.by.md b/docs/additional-material/translations/Belarusian/keeping-your-fork-synced-with-this-repository.by.md new file mode 100644 index 00000000..122b7cfd --- /dev/null +++ b/docs/additional-material/translations/Belarusian/keeping-your-fork-synced-with-this-repository.by.md @@ -0,0 +1,42 @@ +# Сінхранізацыя вашага адгалінаванні з асноўным рэпазітаром + +Па-першае, варта разумець паток для поўнай сінхранізацыі, што важна. У гэтай схеме ёсць 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. \ No newline at end of file diff --git a/docs/additional-material/translations/Belarusian/moving-a-commit-to-a-different-branch.by.md b/docs/additional-material/translations/Belarusian/moving-a-commit-to-a-different-branch.by.md new file mode 100644 index 00000000..69fb4eca --- /dev/null +++ b/docs/additional-material/translations/Belarusian/moving-a-commit-to-a-different-branch.by.md @@ -0,0 +1,25 @@ +# Перамяшчэнне камітаў ў іншую галінку +Што рабіць, калі вы здзяйсняеце змены, а потым разумееце, што вы здзейснілі іншую галіну? +Як вы можаце гэта змяніць? Вось што ахоплівае гэты падручнік. + +## Перамяшчэнне апошніх камітаў ў існуючую галінку +Для такога перамяшчэння, набярыце: + +`` `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, будуць цалкам страчаныя. \ No newline at end of file diff --git a/docs/additional-material/translations/Belarusian/removing-a-file.by.md b/docs/additional-material/translations/Belarusian/removing-a-file.by.md new file mode 100644 index 00000000..6bae5ac2 --- /dev/null +++ b/docs/additional-material/translations/Belarusian/removing-a-file.by.md @@ -0,0 +1,23 @@ +# Выдаленне файла з-пад 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` \ No newline at end of file diff --git a/docs/additional-material/translations/Belarusian/removing-branch-from-your-repository.by.md b/docs/additional-material/translations/Belarusian/removing-branch-from-your-repository.by.md new file mode 100644 index 00000000..ffbb7c81 --- /dev/null +++ b/docs/additional-material/translations/Belarusian/removing-branch-from-your-repository.by.md @@ -0,0 +1,31 @@ +# Выдаленне галінкі з вашага рэпазітара + +Калі вы да гэтага часу выконвалі ўрок, то наша галіна `` скончыла сваё прызначэнне, прыйшоў час выдаліць яго з рэпазітара вашай лакальнай машыны. Гэта не абавязкова, але назва гэтай галіны паказвае сваё даволі спецыяльнае прызначэнне. Яго жыццё можа быць адпаведна кароткім. + +Спачатку давайце аб'яднаем ваша `` з вашым майстрам, каб перайсці да вашай галіны: +``` +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) diff --git a/docs/additional-material/translations/Belarusian/resolving-merge-conflicts.by.md b/docs/additional-material/translations/Belarusian/resolving-merge-conflicts.by.md new file mode 100644 index 00000000..d63fd705 --- /dev/null +++ b/docs/additional-material/translations/Belarusian/resolving-merge-conflicts.by.md @@ -0,0 +1,33 @@ +# Што такое канфлікт зліцця? + +Пры спробе аб'яднаць іншую галінку з вашай бягучай працоўнай галіной, вы ўносіце змены ў іншы кантэкст і аб'ядноўваючы іх з вашымі бягучымі файламі. +Калі два чалавекі змянілі аднолькавыя радкі ў адным файле альбо калі адзін чалавек вырашыў выдаліць яго, а другі вырашыў змяніць яго, 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` diff --git a/docs/additional-material/translations/Belarusian/reverting-a-commit.by.md b/docs/additional-material/translations/Belarusian/reverting-a-commit.by.md new file mode 100644 index 00000000..3bbfc371 --- /dev/null +++ b/docs/additional-material/translations/Belarusian/reverting-a-commit.by.md @@ -0,0 +1,40 @@ +# Вярнуць каміт + +Скасаваць абавязацельства проста азначае стварыць зусім новы дакумент, які адмяняе ўсе +змены, унесеныя ў папярэдні. Гэта як рабіць `` 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`` diff --git a/docs/additional-material/translations/Belarusian/squashing-commits.by.md b/docs/additional-material/translations/Belarusian/squashing-commits.by.md new file mode 100644 index 00000000..d700fee6 --- /dev/null +++ b/docs/additional-material/translations/Belarusian/squashing-commits.by.md @@ -0,0 +1,86 @@ +# Што такое 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 павінен паказаць вам паведамленне аб здзяйсненні, якое вы ўвялі перад выхадам на экран, з абавязацельствамі, аб'яднанымі ў адзін. diff --git a/docs/additional-material/translations/Belarusian/stashing-a-file.by.md b/docs/additional-material/translations/Belarusian/stashing-a-file.by.md new file mode 100644 index 00000000..bec8fc10 --- /dev/null +++ b/docs/additional-material/translations/Belarusian/stashing-a-file.by.md @@ -0,0 +1,137 @@ +# Прыхаваць + +Што рабіць, калі вы працуеце над вялікім кодам і раптам вам трэба пераключыць галіну, з якой вы зараз працуеце, на іншую. Паколькі код не з'яўляецца поўным і без якіх-небудзь тэстаў вы, верагодна, не хочаце яго 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) +``` + +Гэта добры цэтлік, каб лёгка аднавіць схаваную працу і працаваць над ёй у новым аддзяленні. \ No newline at end of file diff --git a/docs/additional-material/translations/Belarusian/undoing-a-commit.by.md b/docs/additional-material/translations/Belarusian/undoing-a-commit.by.md new file mode 100644 index 00000000..9480aade --- /dev/null +++ b/docs/additional-material/translations/Belarusian/undoing-a-commit.by.md @@ -0,0 +1,59 @@ +# Адмяніць мясцовыя каміты + +Каб адмяніць мясцовыя каміты, усё, што вам трэба зрабіць, гэта +``` +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 ў агульнае сховішча, паколькі гэта прывядзе да праблем з усімі рэпазітарамі. diff --git a/docs/additional-material/translations/Bengali/add-file.bn.md b/docs/additional-material/translations/Bengali/add-file.bn.md new file mode 100644 index 00000000..4f723934 --- /dev/null +++ b/docs/additional-material/translations/Bengali/add-file.bn.md @@ -0,0 +1,31 @@ +## একটি নতুন ফাইল সংযুক্ত করার টিউটোরিয়াল + +আপনি যদি নতুন একটি ফাইল আপনার Git রিপোজিটরিতে সংযুক্ত করতে চান, তাহলে এই টিউটোরিয়ালটি আপনার সাহায্য করতে পারে। + +1. **নতুন ফাইল তৈরি করুন**: + - আপনি যে প্রজেক্ট ফোল্ডারে চান, তাতে যান। + - নতুন ফাইল তৈরি করতে আপনি যে টেক্সট সম্পাদক বা IDE ব্যবহার করে যেতে পারেন, বা যদি আপনার কোন আইডি থাকে তাহলে তার মাধ্যমেও ফাইল তৈরি করতে পারেন। + - ফাইলটির একটি নির্দিষ্ট নাম দিন এবং সংরক্ষণ করুন। + +2. **ফাইলটি স্থানান্তর করুন**: + - টার্মিনাল খুলুন এবং রিপোজিটরি ফোল্ডারে চলে যান। + - নতুন ফাইলটি স্থানান্তর করতে আপনি নিম্নলিখিত কমান্ডটি ব্যবহার করুন: + ``` + git add নতুন_ফাইল.এক্সটেনশন + ``` + +3. **কমিট করুন**: + - ফাইলটি স্থানান্তর করার পরে, একটি কমিট তৈরি করুন। + - নিম্নলিখিত কমান্ডটি ব্যবহার করুন: + ``` + git commit -m "নতুন ফাইল সংযুক্ত করা হয়েছে" + ``` + +4. **রিমোট রিপোজিটরিতে পুশ করুন**: + - এখন আপনার ফাইলটি আপনার লোকাল রিপোজিটরিতে রয়েছে। এটি রিমোট রিপোজিটরিতে পাঠাতে হলে নিম্নলিখিত কমান্ডটি ব্যবহার করুন: + ``` + git push দূরস্থ_শাখা + ``` + - এখানে "দূরস্থ_শাখা" তা হলো সে নাম যেখানে আপনি ফাইলটি সংযুক্ত করতে চান। + +এখন আপনি নতুন একটি ফাইলকে আপনার রিপোজিটরিতে সংযুক্ত করেছেন। diff --git a/docs/additional-material/translations/Bengali/additional-material.be.md b/docs/additional-material/translations/Bengali/additional-material.be.md new file mode 100644 index 00000000..1257f3c9 --- /dev/null +++ b/docs/additional-material/translations/Bengali/additional-material.be.md @@ -0,0 +1,52 @@ +# অতিরিক্ত তথ্য + +আমরা ধরে নিচ্ছি যে আপনি এখানে আসার আগে প্রাথমিক টিউটোরিয়ালটি ইতিমধ্যেই শেষ করেছেন। এই নথিটি আপনাকে উন্নত গিট কৌশল সম্পর্কে কিছু অতিরিক্ত তথ্য দেবে। + +### [একটি প্রতিশ্রুতি সংশোধন](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) +এই নথি বর্ণনা করে কীভাবে আপনি আপনার ভণ্ডার জন্য শংসার রক্ষণা করতে পারেন। এটি একটি নিরাপত্তা সম্পর্কিত সময় হতে পারে, তাই আপনি আপনার কাজে/অধ্যয়নের স্থানের নিরাপত্তা নীতিগুলি অনুসরণ করুন। \ No newline at end of file diff --git a/docs/additional-material/translations/Chinese/additional-material.zh-cn.md b/docs/additional-material/translations/Chinese/additional-material.zh-cn.md new file mode 100644 index 00000000..bcb048c9 --- /dev/null +++ b/docs/additional-material/translations/Chinese/additional-material.zh-cn.md @@ -0,0 +1,46 @@ +# 附加资料 + +我们认为你在来到这里之前已经完成基本教学。附加资料会给你关于 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。 diff --git a/docs/additional-material/translations/Chinese/addtional-material.cht.md b/docs/additional-material/translations/Chinese/addtional-material.cht.md new file mode 100644 index 00000000..f5b56d75 --- /dev/null +++ b/docs/additional-material/translations/Chinese/addtional-material.cht.md @@ -0,0 +1,46 @@ +# 附加資料 + +我們認為你在來到這裡以前已經完成基本教學。附加資料會給你關於 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。 diff --git a/docs/additional-material/translations/Farsi/amending-a-commit.fa.md b/docs/additional-material/translations/Farsi/amending-a-commit.fa.md new file mode 100644 index 00000000..3b32d5a3 --- /dev/null +++ b/docs/additional-material/translations/Farsi/amending-a-commit.fa.md @@ -0,0 +1,85 @@ +# اصلاح یک کامیت + +چه کار باید بکنی اگر یک تغییر را روی کامیت کردی ولی بعدا متوجه شدی که پیام کامیت مشکل داشته و یا فراموش کردی یک خط به آخرین کامیتت اضافه کنی. +چجوری میشود این را اصلاح کرد؟ +این موضوعی است که در این آموزش به آن پرداخته میشود. + +## تغییر دادن پیام یک کامیت که اخیرا به گیت هاب ارسال کردی +برای این کار بدون باز کردن فایلی: + +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 <اسم-شاخه> +``` + +تمام شد. الان هر دو تغییر در یک کامیت ثبت شده اند. \ No newline at end of file diff --git a/docs/additional-material/translations/Farsi/delete-branch-locally.fa.md b/docs/additional-material/translations/Farsi/delete-branch-locally.fa.md new file mode 100644 index 00000000..8d70efeb --- /dev/null +++ b/docs/additional-material/translations/Farsi/delete-branch-locally.fa.md @@ -0,0 +1,19 @@ +# حذف کردن شاخه که به صورت محلی ایجاد شده است + +این در زمانی سودمند خواهد بود که شما نام یک شاخه (برنچ) را اشتباه نوشته اید. + +این کار به _3_ روش قابل انجام است + +``` +git branch -D <نام_مخزن> +``` + +``` +git branch --delete --force <نام_مخزن> # Same as -D +``` + +``` +git branch --delete <نام_مخزن> # Error on unmerge +``` + +پرچم `-D` مخفف `delete --force--` است که شاخه را حتی اگر مرج نشده باشد حذف میکند. (حذف اجباری)، ولی شما میتوانید از پرچم `d-` استفاده کنید که مخفف `delete--` است که با توجه با وضعیت مرج شاخه ارور خواهد داد. diff --git a/docs/additional-material/translations/Farsi/moving-a-commit-to-a-different-branch.fa.md b/docs/additional-material/translations/Farsi/moving-a-commit-to-a-different-branch.fa.md new file mode 100644 index 00000000..30ef243f --- /dev/null +++ b/docs/additional-material/translations/Farsi/moving-a-commit-to-a-different-branch.fa.md @@ -0,0 +1,21 @@ +## فراموش کردن رفتن به یک مخزن دیگر + +وقتی که شما تغییراتی روی برنچ فعلی انجام داده ای و فراموش کرده اید آن را روی برنچ جدید انجام بدهید باید + +1- مرحله اول +با دستور + +``` +git commit --amend -m "پیام جدید برای این کامیت" +``` + +را می کنید و وقتی کاملا تغییرات شما کامیت شده باشد + +2- مخزن جدید ایجاد میکنید + +با دستور +git checkout -b <نام_مخزن> + +و می توانید تمام تغییرات را در مخزن جدید داشته باشید و در همان مخزن آن را +push +کنید diff --git a/docs/additional-material/translations/French/additional-material.fr.md b/docs/additional-material/translations/French/additional-material.fr.md new file mode 100644 index 00000000..7447148f --- /dev/null +++ b/docs/additional-material/translations/French/additional-material.fr.md @@ -0,0 +1,49 @@ +# 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. diff --git a/docs/additional-material/translations/French/amending-a-commit.fr.md b/docs/additional-material/translations/French/amending-a-commit.fr.md new file mode 100644 index 00000000..b99167e8 --- /dev/null +++ b/docs/additional-material/translations/French/amending-a-commit.fr.md @@ -0,0 +1,52 @@ +# 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. diff --git a/docs/additional-material/translations/French/check-commit-log.fr.md b/docs/additional-material/translations/French/check-commit-log.fr.md new file mode 100644 index 00000000..a932341d --- /dev/null +++ b/docs/additional-material/translations/French/check-commit-log.fr.md @@ -0,0 +1,20 @@ +# 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) \ No newline at end of file diff --git a/docs/additional-material/translations/Greek/git_workflow_scenarios/additional-material.gr.md b/docs/additional-material/translations/Greek/git_workflow_scenarios/additional-material.gr.md new file mode 100644 index 00000000..46da2bba --- /dev/null +++ b/docs/additional-material/translations/Greek/git_workflow_scenarios/additional-material.gr.md @@ -0,0 +1,52 @@ +# Επιπλέον πληροφορίες + +Υποθέτουμε ότι έχετε ήδη ολοκληρώσει το βασικό μάθημα πριν έρθετε εδώ. Αυτό το έγγραφο θα σας παρέχει πρόσθετες πληροφορίες για προηγμένες τεχνικές του 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) +Αυτό το έγγραφο εξηγεί πώς να αποθηκεύσετε τα διαπιστευτήριά σας για αποθετήρια. Αυτό μπορεί να αποτελεί ανησυχία για την ασφάλεια, για αυτό παρακαλούμε να ακολουθείτε τις πολιτικές ασφαλείας του χώρου εργασίας/μελέτης σας. diff --git a/docs/additional-material/translations/Greek/git_workflow_scenarios/amending-a-commit.gr.md b/docs/additional-material/translations/Greek/git_workflow_scenarios/amending-a-commit.gr.md new file mode 100644 index 00000000..544b9e6f --- /dev/null +++ b/docs/additional-material/translations/Greek/git_workflow_scenarios/amending-a-commit.gr.md @@ -0,0 +1,69 @@ +# Τροποποίηση μιας Καταχώρησης (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, καθώς αποφεύγει την αντικατάσταση των αλλαγών άλλων ατόμων στον απομακρυσμένο κλάδο (εάν δεν το επιθυμείτε). \ No newline at end of file diff --git a/docs/additional-material/translations/Greek/git_workflow_scenarios/check-commit-log.gr.md b/docs/additional-material/translations/Greek/git_workflow_scenarios/check-commit-log.gr.md new file mode 100644 index 00000000..7c258c82 --- /dev/null +++ b/docs/additional-material/translations/Greek/git_workflow_scenarios/check-commit-log.gr.md @@ -0,0 +1,25 @@ +# Έλεγχος καταγραφής αλλαγών (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) diff --git a/docs/additional-material/translations/Greek/git_workflow_scenarios/configuring-git.gr.md b/docs/additional-material/translations/Greek/git_workflow_scenarios/configuring-git.gr.md new file mode 100644 index 00000000..d4d166ee --- /dev/null +++ b/docs/additional-material/translations/Greek/git_workflow_scenarios/configuring-git.gr.md @@ -0,0 +1,78 @@ +# Διαμόρφωση του 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). \ No newline at end of file diff --git a/docs/additional-material/translations/Greek/git_workflow_scenarios/creating-a-gitignore-file.gr.md b/docs/additional-material/translations/Greek/git_workflow_scenarios/creating-a-gitignore-file.gr.md new file mode 100644 index 00000000..9c2555b5 --- /dev/null +++ b/docs/additional-material/translations/Greek/git_workflow_scenarios/creating-a-gitignore-file.gr.md @@ -0,0 +1,76 @@ +# .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```. \ No newline at end of file diff --git a/docs/additional-material/translations/Greek/git_workflow_scenarios/delete-branch-locally.gr.md b/docs/additional-material/translations/Greek/git_workflow_scenarios/delete-branch-locally.gr.md new file mode 100644 index 00000000..91da8c79 --- /dev/null +++ b/docs/additional-material/translations/Greek/git_workflow_scenarios/delete-branch-locally.gr.md @@ -0,0 +1,19 @@ +# Διαγραφή ενός τοπικά δημιουργημένου κλαδιού + +Αυτό θα είναι χρήσιμο όταν κάνετε κατά λάθος λάθος το όνομα ενός κλαδιού. + +Αυτό μπορεί να γίνει με *3* τρόπους + +``` +git branch -D <όνομα_κλαδιού> +``` + +``` +git branch --delete --force <όνομα_κλαδιού> # Ίδιο με το -D +``` + +``` +git branch --delete <όνομα_κλαδιού> # Σφάλμα κατά την ανενοχλησία +``` + +Το -D σημαίνει --delete --force, το οποίο θα διαγράψει το κλαδί ακόμα και αν δεν έχει συγχωνευτεί (αναγκαστική διαγραφή), αλλά μπορείτε επίσης να χρησιμοποιήσετε -d που σημαίνει --delete το οποίο θα εμφανίσει ένα σφάλμα ανάλογα με την κατάσταση συγχώνευσης του κλαδιού... \ No newline at end of file diff --git a/docs/additional-material/translations/Greek/git_workflow_scenarios/gitflow.gr.md b/docs/additional-material/translations/Greek/git_workflow_scenarios/gitflow.gr.md new file mode 100644 index 00000000..7c77adba --- /dev/null +++ b/docs/additional-material/translations/Greek/git_workflow_scenarios/gitflow.gr.md @@ -0,0 +1,125 @@ +# 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. \ No newline at end of file diff --git a/docs/additional-material/translations/Hindi/Amending a Commit b/docs/additional-material/translations/Hindi/Amending a Commit new file mode 100644 index 00000000..5cb72c39 --- /dev/null +++ b/docs/additional-material/translations/Hindi/Amending a Commit @@ -0,0 +1,65 @@ +# कमिट में संशोधन करना + +आपके दूरस्थ संग्रहालय में एक परिवर्तन करते हैं, फिर बाद में पता चलता है कि आपके कमिट संदेश में त्रुटि है या आपने अपने सबसे हाल के कमिट में एक पंक्ति जोड़ना भूल दी है। +आप ऐसा कैसे संपादित करेंगे? इस पर यह ट्यूटोरियल विस्तार से बताता है। + +##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` सुरक्षित विकल्प है जो रिमोट शाखा पर दूसरे लोगों के बदलावों को अधिलेखित करने से बचाता है (यदि ऐसा आपकी इच्छा नहीं है)। diff --git a/docs/additional-material/translations/Hindi/Things a non Programmer can do b/docs/additional-material/translations/Hindi/Things a non Programmer can do new file mode 100644 index 00000000..5e7089ec --- /dev/null +++ b/docs/additional-material/translations/Hindi/Things a non Programmer can do @@ -0,0 +1,128 @@ +# 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+ टिकटों के लिए एक कनवर्टर प्रोग्राम लिखने का समय बिताया, इसलिए हमारी टिकट इतिहास में से कोई भी खोने की समस्या नहीं हुई। यह एक बड़ी सफलता थी। मैंने सहयोग किया, और कोर डेवलपर्स पैरॉट पर काम करने के लिए केंद्रित रहे। + + + + + + + + + + + + + + diff --git a/docs/additional-material/translations/Hindi/Useful-links-for-further-learning.hi.md b/docs/additional-material/translations/Hindi/Useful-links-for-further-learning.hi.md new file mode 100644 index 00000000..50257ca6 --- /dev/null +++ b/docs/additional-material/translations/Hindi/Useful-links-for-further-learning.hi.md @@ -0,0 +1,45 @@ +# उपयोगी लिंक्स + +यह लेख उन सभी युक्तियों और युक्तियों वाली वेबसाइटों, ब्लॉग पोस्टों और सहायक साइटों को समर्पित है जो हमारे जीवन को आसान बनाती हैं। वे हमारी सभी जरूरतों को पूरा करने के लिए एक महान संदर्भ हैं, चाहे वह नौसिखिया हो या विशेषज्ञ। इस पृष्ठ को उन सभी उपयोगी लिंक के सूचकांक के रूप में कार्य करना चाहिए जो ओपन-सोर्स डोमेन में नए लोगों या किसी ऐसे व्यक्ति की मदद करेगा जो अधिक सीखना चाहता है। + +## सूची +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) +और अधिक लिंक जोड़ते रहें, जो आपको उपयोगी लगें। diff --git a/docs/additional-material/translations/Hindi/add-file.hi.md b/docs/additional-material/translations/Hindi/add-file.hi.md new file mode 100644 index 00000000..0fc53e08 --- /dev/null +++ b/docs/additional-material/translations/Hindi/add-file.hi.md @@ -0,0 +1,31 @@ +## एक नई फ़ाइल जोड़ने का ट्यूटोरियल + +यदि आप एक नई फ़ाइल को अपने Git रिपॉज़िटरी में जोड़ना चाहते हैं, तो यह ट्यूटोरियल आपकी मदद करेगा। + +1. **नई फ़ाइल बनाएं**: + - अपने प्रोजेक्ट फ़ोल्डर में जाएं। + - नई फ़ाइल बनाने के लिए अपने पसंदीदा टेक्स्ट संपादक का उपयोग करें या आपका कोई IDE हो तो वहां से नई फ़ाइल बना सकते हैं। + - फ़ाइल को विशेष नाम दें और सहेजें। + +2. **फ़ाइल को स्टेज करें**: + - टर्मिनल खोलें और रिपॉज़िटरी फ़ोल्डर में जाएं। + - नई फ़ाइल को स्टेज करने के लिए निम्नलिखित कमांड का उपयोग करें: + ``` + git add नया_फ़ाइल.एक्शन + ``` + +3. **कमिट करें**: + - फ़ाइल को स्टेज करने के बाद, एक कमिट बनाएं। + - निम्नलिखित कमांड का उपयोग करें: + ``` + git commit -m "नई फ़ाइल जोड़ी गई" + ``` + +4. **रिमोट रिपॉज़िटरी में पुश करें**: + - आपकी फ़ाइल अब आपके लोकल रिपॉज़िटरी में है। अब इसे रिमोट रिपॉज़िटरी में भेजने के लिए निम्नलिखित कमांड का उपयोग करें: + ``` + git push दूरस्थ_शाखा + ``` + - यहाँ "दूरस्थ_शाखा" वह नाम है जिसमें आप फ़ाइल जोड़ना चाहते हैं। + +अब आपने एक नई फ़ाइल अपने रिपॉज़िटरी में जोड़ दी है। diff --git a/docs/additional-material/translations/Hindi/moving-a-commit-to-a-different-branch.hi.md b/docs/additional-material/translations/Hindi/moving-a-commit-to-a-different-branch.hi.md new file mode 100644 index 00000000..2e33904b --- /dev/null +++ b/docs/additional-material/translations/Hindi/moving-a-commit-to-a-different-branch.hi.md @@ -0,0 +1,23 @@ +# एक कमिट शाखा को एक अलग शाखा में ले जाना +क्या होगा यदि आप कोई बदलाव कमिट करते हैं, और फिर महसूस करें कि आप एक अलग शाखा में हैं? +आप इसे कैसे बदल सकते हैं? यह ट्यूटोरियल कवर करता है। + +## सबसे मौजूदा काम को मौजूदा शाखा में ले जाना +इस काम को करने के लिए, निम्नलिखित कदमों का पालन करें: + +``` 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``` - आपके द्वारा बनाई गई शाखा में जाएगा। इसमें सभी कमिट होंगे। + +याद रखें: कोई भी बदलाव कमिट नहीं किया गया होगा तो वह खो जाएगा। \ No newline at end of file diff --git a/docs/additional-material/translations/Hindi/removing-a-file.hi.md b/docs/additional-material/translations/Hindi/removing-a-file.hi.md new file mode 100644 index 00000000..c2a3d2f7 --- /dev/null +++ b/docs/additional-material/translations/Hindi/removing-a-file.hi.md @@ -0,0 +1,22 @@ +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`` \ No newline at end of file diff --git a/docs/additional-material/translations/Hindi/removing-branch-from-your-repository.hi.md b/docs/additional-material/translations/Hindi/removing-branch-from-your-repository.hi.md new file mode 100644 index 00000000..5f80032d --- /dev/null +++ b/docs/additional-material/translations/Hindi/removing-branch-from-your-repository.hi.md @@ -0,0 +1,31 @@ +# अपने रिपॉजिटरी से एक शाखा निकालें + +यदि आपने अब तक ट्यूटोरियल का पालन किया है, तो हमारी `` शाखा ने अपना उद्देश्य पूरा कर लिया है, अब यह आपके स्थानीय मशीन के रेपो से इसे हटाने का समय है। यह आवश्यक नहीं है, लेकिन इस शाखा का नाम इसके बजाय विशेष उद्देश्य दिखाता है। इसका जीवन संगत रूप से छोटा हो सकता है। + +सबसे पहले, अपने मास्टर में अपने `` को मर्ज करें, इसलिए अपनी मास्टर शाखा पर जाएं: +``` +git checkout master +``` + +उसके बाद मास्टर में ``मर्ज करें: +``` +git merge master +``` + +फिर अपने स्थानीय मशीन के रेपो से `` निकालें: +``` +git branch -d +``` + +अब आपने अपनी स्थानीय मशीन की `` शाखा हटा दी है और सब कुछ साफ़ सुथरा लग रहा है। +हालांकि, इस समय, आपके पास अभी भी आपके गिटहब फोर्क में `` शाखा होनी चाहिए। हालांकि, इससे पहले कि आप इसे हटा दें, याद रखें कि आपने इस रिमोट शाखा से अपने रेपो को "पुल रिक्वेस्ट" भेजा है। इसलिए जब तक कि मैं इसे मर्ज नहीं करता हूं, इस शाखा को न हटाएं। + +हालांकि, अगर मैंने आपकी शाखा मर्ज कर ली है और आप रिमोट शाखा को हटाना चाहते हैं, तो इसका उपयोग करें: +``` +git push origin --delete +``` + +अब, आप जानते हैं कि अपनी शाखाओं को कैसे साफ किया जाए। +समय के साथ, मेरे सार्वजनिक रिपो में कई रेपो जोड़े जाएंगे। और आपकी स्थानीय मशीन और आपके गिटहब फर्क की मास्टर शाखाएं अद्यतित नहीं होंगी। तो अपने रेपोसिटोरिएस को मेरे साथ सिंक्रनाइज़ करने के लिए, नीचे दिए गए चरणों का पालन करें। + +#### [अपने फोर्क को रिपॉजिटरी के साथ सिंक रखना] (keeping-your-fork-synced-with-this-repository.md) \ No newline at end of file diff --git a/docs/additional-material/translations/Hindi/resetting-a-branch.hi.md b/docs/additional-material/translations/Hindi/resetting-a-branch.hi.md new file mode 100644 index 00000000..4b09b84d --- /dev/null +++ b/docs/additional-material/translations/Hindi/resetting-a-branch.hi.md @@ -0,0 +1,18 @@ +# एक शाखा रीसेट करें + +```reset``` वह कमांड है जिसका उपयोग तब किया जा सकता है जब हम किसी कमिट या शाखा के संबंध में रिपॉजिटरी को रीसेट करना चाहते हैं। एक रीसेट, जैसा कि नाम से पता चलता है, वर्तमान शाखा पर सब कुछ त्याग देता है और इसे उस शाखा के समान बना देता है जिसके साथ हमने आधार शाखा को रीसेट करना चुना (इसे मूल शाखा भी कहा जाता है)। इसका अनिवार्य रूप से मतलब यह है कि हमारे पास मूल शाखा के नाम के साथ मूल शाखा की एक कॉपी होगी।
+हालाँकि, सवाल यह है कि हम आधार शाखा को क्यों नहीं हटा देते हैं और मूल शाखा से आधार शाखा के नाम से एक नई शाखा क्यों नहीं चेकआउट कर देते हैं। तकनीकी रूप से, इसका प्रभाव रीसेट करने जैसा ही होगा लेकिन कुछ औद्योगिक स्थितियों में हमारे पास किसी शाखा को हटाने की पहुंच नहीं है, या हम किसी शाखा को हटा नहीं सकते हैं क्योंकि यह सीआई/सीडी पाइपलाइन या शायद चल रहे वर्कफ़्लो को बाधित/बाधित कर देगा। इसलिए, ऐसी स्थितियों से बचने के लिए जो डाउनटाइम का कारण बन सकती हैं, हम सुझाव देते हैं कि जब भी हम किसी विशेष शाखा को रीसेट करना चाहते हैं तो `git reset` का उपयोग करें। + +## कम्मांड + +शाखा के लिए गिट रीसेट निष्पादित करना बहुत आसान है। +``` +git reset +``` + +उदाहरण के तौर पर: +``` +git reset stage master --hard +``` +उपरोक्त कमांड `stage` शाखा को `master` के साथ रीसेट कर देगा और इसलिए `stage` को बिल्कुल `master` के समान बना देगा। +आप सोच रहे होंगे कि `--hard` फ्लैग का उपयोग क्यों किया जाता है? इसका उद्देश्य उन सभी परिवर्तनों को अनदेखा करना है जो रीसेट से पहले/बाद में होंगे या होंगे। \ No newline at end of file diff --git a/docs/additional-material/translations/Hindi/resetting-a-commit.hi.md b/docs/additional-material/translations/Hindi/resetting-a-commit.hi.md new file mode 100644 index 00000000..f92d7be8 --- /dev/null +++ b/docs/additional-material/translations/Hindi/resetting-a-commit.hi.md @@ -0,0 +1,19 @@ +# कमिट रीसेट करें + + +```reset``` वह कमांड है जिसका उपयोग तब किया जा सकता है जब हम रिपॉजिटरी को पिछली कमिट में वापस ले जाना चाहते हैं, उस कमिट के बाद किए गए किसी भी बदलाव को छोड़कर।
+किसी कमिट को रीसेट करने और वापस लाने के बीच मुख्य अंतर यह है कि git रीसेट ```फ़ाइल को अनस्टेज करता है और हमारे परिवर्तनों को कार्यशील निर्देशिका में वापस लाता है``` और git revert ```रिमोट रिपॉजिटरी से कमिट्स को हटा देता है```।
+ +```git reset``` निम्नलिखित कमांड का उपयोग करके प्राप्त किया जा सकता है: +- निम्नलिखित कमांड निम्नलिखित दो मापदंडों का उपयोग करके सभी कमिटों का सारांश देगा: + + - कमिट हैश के पहले सात अक्षर - यही वह है जिसे हमें अपने **reset** कमांड में संदर्भित करना होगा। + - प्रतिबद्ध संदेश + + ``` + git log --oneline + ``` + +- कोई निम्नलिखित कमांड का उपयोग करके रिपॉजिटरी को विशिष्ट कमिट पर वापस रीसेट कर सकता है:
+ ```गिट रीसेट कमिटहैश``` + जहां कमिटहैश कमिट हैश के पहले 7 अक्षर हैं जो हमें लॉग में मिले| \ No newline at end of file diff --git a/docs/additional-material/translations/Indonesian/Useful-links-for-further-learning.id.md b/docs/additional-material/translations/Indonesian/Useful-links-for-further-learning.id.md new file mode 100644 index 00000000..3ec4f7f3 --- /dev/null +++ b/docs/additional-material/translations/Indonesian/Useful-links-for-further-learning.id.md @@ -0,0 +1,46 @@ +# 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. \ No newline at end of file diff --git a/docs/additional-material/translations/Indonesian/additional-material.id.md b/docs/additional-material/translations/Indonesian/additional-material.id.md new file mode 100644 index 00000000..5ba423bc --- /dev/null +++ b/docs/additional-material/translations/Indonesian/additional-material.id.md @@ -0,0 +1,67 @@ +# 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. diff --git a/docs/additional-material/translations/Indonesian/removing-a-file.id.md b/docs/additional-material/translations/Indonesian/removing-a-file.id.md new file mode 100644 index 00000000..9842025f --- /dev/null +++ b/docs/additional-material/translations/Indonesian/removing-a-file.id.md @@ -0,0 +1,23 @@ +# 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` diff --git a/docs/additional-material/translations/Indonesian/removing-branch-from-your-repository.id.md b/docs/additional-material/translations/Indonesian/removing-branch-from-your-repository.id.md new file mode 100644 index 00000000..e65eea7f --- /dev/null +++ b/docs/additional-material/translations/Indonesian/removing-branch-from-your-repository.id.md @@ -0,0 +1,31 @@ +# 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) diff --git a/docs/additional-material/translations/Indonesian/resetting-a-commit.id.md b/docs/additional-material/translations/Indonesian/resetting-a-commit.id.md new file mode 100644 index 00000000..1e43aa4e --- /dev/null +++ b/docs/additional-material/translations/Indonesian/resetting-a-commit.id.md @@ -0,0 +1,21 @@ +# 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 diff --git a/docs/additional-material/translations/Italian/removing-a-file.it.md b/docs/additional-material/translations/Italian/removing-a-file.it.md new file mode 100644 index 00000000..dbd42bb6 --- /dev/null +++ b/docs/additional-material/translations/Italian/removing-a-file.it.md @@ -0,0 +1,23 @@ +# 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` diff --git a/docs/additional-material/translations/Italian/reverting-a-commit.it.md b/docs/additional-material/translations/Italian/reverting-a-commit.it.md new file mode 100644 index 00000000..62aeb327 --- /dev/null +++ b/docs/additional-material/translations/Italian/reverting-a-commit.it.md @@ -0,0 +1,40 @@ +# 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``` \ No newline at end of file diff --git a/docs/additional-material/translations/Korean/additional-material.ko.md b/docs/additional-material/translations/Korean/additional-material.ko.md new file mode 100644 index 00000000..74559628 --- /dev/null +++ b/docs/additional-material/translations/Korean/additional-material.ko.md @@ -0,0 +1,52 @@ +# 추가 정보 + +여러분이 여기에 오기 전에 기본실습 과정을 이미 완료했다고 가정합니다. 이 문서는 고급 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) +이 문서는 저장소들의 크리덴셜을 저장하는 방법을 설명합니다. 이는 보안 관련 문제가 될 수 있으므로, 당신의 직장/ 학업 에 알맞은 보안 정책을 따르십시오. \ No newline at end of file diff --git a/docs/additional-material/translations/Korean/amending-a-commit.ko.md b/docs/additional-material/translations/Korean/amending-a-commit.ko.md new file mode 100644 index 00000000..8c609915 --- /dev/null +++ b/docs/additional-material/translations/Korean/amending-a-commit.ko.md @@ -0,0 +1,46 @@ +## 커밋 수정하기 + +만약 커밋 메시지에 오타가 있거나 가장 최근의 커밋에서 몇줄을 빼먹은 걸 나중에 깨닫고 원격 저장소로 커밋을 수정하고자 하는 경우 어떻게 할까요? 이 자습서는 이러한 내용을 다룹니다. + +### 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) diff --git a/docs/additional-material/translations/Korean/delete-branch-locally.ko.md b/docs/additional-material/translations/Korean/delete-branch-locally.ko.md new file mode 100644 index 00000000..7b348f3e --- /dev/null +++ b/docs/additional-material/translations/Korean/delete-branch-locally.ko.md @@ -0,0 +1,19 @@ +# 이 문서는 로컬 저장소에서 브랜치를 삭제하는법을 제공합니다. + +브랜치 이름을 실수로 잘못 입력했을대 유용합니다. + +이것은 *3*가지 방법으로 할 수 있습니다. + +``` +git branch -D <브랜치 이름> +``` + +``` +git branch --delete --force <브랜치 이름> # 위에 -D와 동일합니다. +``` + +``` +git branch --delete <브랜치 이름> # unmerge 에러 +``` + +-D는 --delete --force를 의미하며, 브랜치가 병합(merge)되지 않았더라도 강제로 삭제합니다. 하지만 -d 또는 --delete 옵션을 사용하면 브랜치의 병합(merge) 상태에 따라 오류가 발생할 수 있습니다... \ No newline at end of file diff --git a/docs/additional-material/translations/Korean/keeping-your-fork-synced-with-this-repository.ko.md b/docs/additional-material/translations/Korean/keeping-your-fork-synced-with-this-repository.ko.md new file mode 100644 index 00000000..de4d9a82 --- /dev/null +++ b/docs/additional-material/translations/Korean/keeping-your-fork-synced-with-this-repository.ko.md @@ -0,0 +1,41 @@ +# 여러분이 포크한 저장소와 싱크상태 유지하기 + +먼저, 전체 싱크과정을 이해해야합니다. 본 스키마에는 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 저장소에 커밋이 추가적으로 발생할 때마다 이러한 작업을 해야합니다. + + diff --git a/docs/additional-material/translations/Korean/moving-a-commit-to-a-different-branch.ko.md b/docs/additional-material/translations/Korean/moving-a-commit-to-a-different-branch.ko.md new file mode 100644 index 00000000..0a7d6d0d --- /dev/null +++ b/docs/additional-material/translations/Korean/moving-a-commit-to-a-different-branch.ko.md @@ -0,0 +1,28 @@ +## 커밋을 다른 브랜치로 옮기기 + +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``` - 생성한 브랜치로 이동합니다. 모든 커밋들을 가지고 있을겁니다. + +주의: 커밋하지 않은 변경사항들은 사라집니다. diff --git a/docs/additional-material/translations/Korean/removing-branch-from-your-repository.ko.md b/docs/additional-material/translations/Korean/removing-branch-from-your-repository.ko.md new file mode 100644 index 00000000..b1e51ca2 --- /dev/null +++ b/docs/additional-material/translations/Korean/removing-branch-from-your-repository.ko.md @@ -0,0 +1,30 @@ +## 여러분의 저장소에서 브랜치 삭제하기 + +지금까지의 튜토리얼을 수행했다면, 우리의 `` 브랜치가 목적을 완료했습니다. 이제는 로컬 저장소에서 삭제할 차례입니다. 필수사항은 아니지만 이 브랜치의 이름은 다소 특별한 목적을 나타내므로 이미 병합되었다면 그 수명을 다했다고 할 수 있습니다. +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) diff --git a/docs/additional-material/translations/Korean/resolving-merge-conflicts.ko.md b/docs/additional-material/translations/Korean/resolving-merge-conflicts.ko.md new file mode 100644 index 00000000..a8b103ec --- /dev/null +++ b/docs/additional-material/translations/Korean/resolving-merge-conflicts.ko.md @@ -0,0 +1,43 @@ +# 병합 충돌이 무엇인가요? + +여러분이 또 다른 브랜치에서 현재 작업중인 브랜치로 병합하고자할 때, 또 다른 변경사항들도 같이 반영되어야 하므로 여러분의 현재 작업중인 파일들에 같이 결합이 이루어지게 됩니다. +만일 이때 두 사람이 같은 파일의 똑 같은 라인을 (각자 다르게)변경했거나 다른 사람이 수정 반영한 곳을 삭제하려고 한다면 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` 명령을 실행하세요. diff --git a/docs/additional-material/translations/Korean/reverting-a-commit.ko.md b/docs/additional-material/translations/Korean/reverting-a-commit.ko.md new file mode 100644 index 00000000..c94f408e --- /dev/null +++ b/docs/additional-material/translations/Korean/reverting-a-commit.ko.md @@ -0,0 +1,35 @@ +## 커밋 되돌리기 + +커밋을 되돌리려면 이전 커밋에서 수행 된 모든 변경 사항을 취소하는 새로운 커밋을 만드는 것입니다. 그것은 git에서 ```CTRL + Z ``` 를 실행하는 것과 같습니다. + +원격 저장소에 푸시하는 모든 커밋에는 SHA(Secure Hash Algorithm)라고 하는 고유한 알파벳 키가 있으므로 git에서 되돌리기가 쉬워집니다. 즉, SHA를 사용하는 한 언제든지 커밋을 되돌릴 수 있습니다. 하지만 그렇게 하면, 당신의 저장소가 엉망이 되지 않도록 조심스럽게 순서대로 배열해야 합니다. + +실행 취소하려는 특정 커밋의 SHA를 선택하려면 지금까지 작성한 모든 커밋의 로그가 도움이 될 것입니다. +이를 위해 다음 명령을 실행합니다: +```git log --oneline ``` +```git log``` 명령만 실행하면 SHA(긴 형식)을 얻을 수 있지만 ```--oneline ``` 플래그를 사용하면 보다 가독성이 좋은(한줄) 방식으로 표시할 수 있습니다. + +이 명령을 실행할 때 표시되는 첫번째 7개의 문자는 축약 커밋 해시라고 합니다. + +예를 들어, 이 저장소에서 ```git log --oneline ``` 을 실행하면 다음과 같은 결과를 얻을 수 있습니다: +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 +``` + +따라서 ```git log --oneline``` 을 사용하면 SHA의 처음 7개의 문자와 함께 저장소에서 작성한 모든 커밋 목록을 가져올 수 있습니다. + +이제 "added spacing in title"에 대한 커밋을 취소하고 싶다고 가정하고, 다음 단계를 수행하겠습니다. + +* 커밋의 SHA를 복사합니다. 여기서는 ```389004d``` 입니다. +* 그리고 나서 ```git revert 389004d``` 명령을 싱행합니다. + +이렇게 하면 텍스트 편집기가 열리고 커밋 메시지를 편집하라는 메시지가 표시됩니다. 커밋 메시지를 `Revert` 라는 단어로 시작하는 기본 git 메시지로 남겨두거나 원하는대로 메시지를 작성할 수도 있습니다. + +* 다음으로, 텍스트 편집기를 저장하고 닫습니다. +* 커맨드 라인으로 돌아갑니다. +* ```git push origin ``` 을 실행하여 되돌린 변경사항을 Github에 푸시하십시오. + +그리고 바로 변경사항이 원상태로 돌아갈 것입니다. 이 경우에 저장소가 ```c1b9fc1``` 의 상태로 되돌아갑니다. diff --git a/docs/additional-material/translations/Korean/undoing-a-commit.ko.md b/docs/additional-material/translations/Korean/undoing-a-commit.ko.md new file mode 100644 index 00000000..e7fedb0f --- /dev/null +++ b/docs/additional-material/translations/Korean/undoing-a-commit.ko.md @@ -0,0 +1,59 @@ +## 로컬 커밋 되돌리기 + +로컬에서 커밋을 위해 스테이징 영역에 추가한 작업 내용을 되돌리기 위해서는 다음 명령을 실행합니다. +``` +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``` 명령을 실행할 경우, 해당 저장소를 사용하는 모든 사람들에게 문제를 일으킬 수 있으므로 절대 실행해서는 안됩니다. + diff --git a/docs/additional-material/translations/Malayalam/Things-a-non-programmer-can-do.ml.md b/docs/additional-material/translations/Malayalam/Things-a-non-programmer-can-do.ml.md new file mode 100644 index 00000000..bf020a72 --- /dev/null +++ b/docs/additional-material/translations/Malayalam/Things-a-non-programmer-can-do.ml.md @@ -0,0 +1,123 @@ +# പ്രോഗ്രാമർ അല്ലാത്ത ഒരാൾക്ക് ചെയ്യാൻ കഴിയുന്ന കാര്യങ്ങൾ +## ശ്രദ്ധിക്കാൻ തുടങ്ങുക + +ഓപ്പൺ സോഴ്‌സിലെ എല്ലാം മറ്റുള്ളവരെ ഉൾക്കൊള്ളുന്നു. +നിങ്ങൾ ഒരു ടീമിൽ ചേരാൻ നോക്കുകയാണ്, അതിനർത്ഥം കമ്മ്യൂണിറ്റിയെക്കുറിച്ചും അത് എങ്ങനെ പ്രവർത്തിക്കുന്നുവെന്നും മനസ്സിലാക്കുക എന്നാണ്. +ഒരു പ്രോജക്‌റ്റിലേക്ക് ചെന്ന് "ഹായ്, ഈ പ്രോജക്‌റ്റ് ഇങ്ങനെ പ്രവർത്തിക്കണം എന്നാണു ഞാൻ കരുതുന്നത് " എന്ന് പറയുന്നത് ഒരു നല്ല കാര്യമായി കണക്കാക്കില്ല. +ചില പ്രോജക്‌റ്റുകൾ അത്തരം സമീപനത്തെ സ്വാഗതം ചെയ്‌തേക്കാം, എന്നാൽ പ്രോജക്‌റ്റ് കുറച്ച് കാലമായി പ്രവർത്തിക്കുന്നതാണെങ്കിൽ , അങ്ങനെ ഒരു മനോഭാവം സ്വീകരിക്കാനുള്ള സാധ്യത കുറവാണു . **പ്രോജക്റ്റിന് എന്താണ് വേണ്ടതെന്ന് അറിയാനുള്ള ഏറ്റവും നല്ല മാർഗം ശ്രദ്ധിച്ചു കേൾക്കുക എന്നതാണ് .** + +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. **മറ്റുള്ളവരെ പഠിപ്പിക്കുകയും സഹായിക്കുകയും ചെയ്യുക**: +ഒരു വിഷയത്തെക്കുറിച്ച് കൂടുതലറിയാനുള്ള ഏറ്റവും നല്ല മാർഗം അത് പഠിപ്പിക്കാൻ ശ്രമിക്കുക എന്നതാണ്. +സങ്കീർണ്ണമായ കാര്യങ്ങൾ ലളിതമായ ഉദാഹരണങ്ങളിലൂടെ വിശദീകരിക്കാൻ കഴിയുന്നവനാണ് മികച്ച അധ്യാപകൻ. അതിനാൽ നിങ്ങളുടെ പ്രോഗ്രാമിംഗ് ലോകത്തിലെ ഏറ്റവും മികച്ച പഠിതാവാകാനും മികച്ച അധ്യാപകനാകാനും നിങ്ങൾ ശ്രമിക്കേണ്ടതുണ്ട്. മറ്റുള്ളവരെ പഠിപ്പിക്കുന്നത് നിങ്ങളെക്കുറിച്ച് നിങ്ങൾക്ക് കൂടുതൽ മെച്ചമുണ്ടാക്കും കൂടാതെ നിങ്ങളുടെ തൊഴിലിൽ മികച്ച വൈദഗ്ധ്യവും അറിവും നേടാൻ ഇത് നിങ്ങളെ സഹായിക്കും. നിങ്ങൾക്ക് ഒരാളിൽ നിന്ന് സഹായം ലഭിക്കുമ്പോൾ, അത് സ്വയം സൂക്ഷിക്കരുത്, അത് മറ്റുള്ളവരുമായി പങ്കിടുക. ലോകത്തെ ജീവിക്കാനുള്ള മികച്ച സ്ഥലമാക്കി മാറ്റുക. diff --git a/docs/additional-material/translations/Marathi/Removing-a-file.ma.md b/docs/additional-material/translations/Marathi/Removing-a-file.ma.md new file mode 100644 index 00000000..8ff1be90 --- /dev/null +++ b/docs/additional-material/translations/Marathi/Removing-a-file.ma.md @@ -0,0 +1,20 @@ +# गिटमधून फाइल काढून टाकणे +कधीकधी, आपण कुठलीक फाइल गिटमधून काढून टाकायला इच्छिता, परंतु ती आपल्या संगणकावरून काढून टाकायला इच्छित नाही. आपण खालील आदेशाचा वापर करून ती मिळवू शकता: + +``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`` diff --git a/docs/additional-material/translations/Marathi/additional-material.ma.md b/docs/additional-material/translations/Marathi/additional-material.ma.md new file mode 100644 index 00000000..ceb8a5ce --- /dev/null +++ b/docs/additional-material/translations/Marathi/additional-material.ma.md @@ -0,0 +1,46 @@ +# अतिरिक्त माहिती + +येथे आपण असे गृहीत धरू की आपण आधीच मूलभूत सूचनांमध्ये प्रभुत्व मिळवले आहे. पूरक माहितीमध्ये 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) +या फाइलमध्ये ब्लॉग पोस्ट्स, उपयुक्त वेबसाइट्स, वेबसाइट्सची सूची असलेल्या टिप्स आणि युक्त्या आहेत ज्या अनेकदा आमचे जीवन सुलभ करतात. नवशिक्यांसाठी आणि तज्ञांसाठी, आवश्यकतेनुसार आम्ही त्यांच्याशी संपर्क साधण्याची शिफारस करतो. या फाइलमध्ये उपयुक्त लिंक्सची सूची आहे जी ओपन सोर्समध्ये पहिले पाऊल टाकणाऱ्यांना आणि या क्षेत्रातील त्यांचे ज्ञान वाढवू इच्छिणाऱ्यांना नक्कीच मदत करेल. \ No newline at end of file diff --git a/docs/additional-material/translations/Nepali/additional-material.np.md b/docs/additional-material/translations/Nepali/additional-material.np.md new file mode 100644 index 00000000..eb755c0c --- /dev/null +++ b/docs/additional-material/translations/Nepali/additional-material.np.md @@ -0,0 +1,48 @@ +# थप जानकारी +हामी मान्दछौं कि तपाईंले यहाँ जानु अघि आधारभूत ट्यूटोरियल पढिसक्नुभएको छ। यो कागजातले तपाईंलाई 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 परियोजनाहरूमा प्रयोग गरिन्छ। यसले कमिटहरूमा मात्र आवश्यक फाइलहरू विचार गर्न मद्दत गर्दछ। diff --git a/docs/additional-material/translations/Nepali/amending-a-commit.np.md b/docs/additional-material/translations/Nepali/amending-a-commit.np.md new file mode 100644 index 00000000..d178f18a --- /dev/null +++ b/docs/additional-material/translations/Nepali/amending-a-commit.np.md @@ -0,0 +1,50 @@ +# प्रतिबद्धता सम्पादन गर्नुहोस् + +मानौं कि तपाईंले आफ्नो रिमोट डाइरेक्टरीमा प्रतिबद्धता गर्नुभयो र पछि यो महसुस गर्नुहोस् कमिट सन्देशमा टाइपो छ वा तपाईंले आफ्नो अन्तिम कमिटमा लाइन थप्न बिर्सनुभयो। यो त्रुटि कसरी सच्याउने? यो यस ट्यूटोरियल को विषय हो। + +## 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 ``` सँग पुश गर्नुहोस् + +यसरी दुबै परिवर्तनहरू एउटै कमिटमा छन्। diff --git a/docs/additional-material/translations/Nepali/configuring-git.np.md b/docs/additional-material/translations/Nepali/configuring-git.np.md new file mode 100644 index 00000000..1a55e882 --- /dev/null +++ b/docs/additional-material/translations/Nepali/configuring-git.np.md @@ -0,0 +1,77 @@ +# 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). diff --git a/docs/additional-material/translations/Portugues/Things a non Programmer can do.pt-br.md b/docs/additional-material/translations/Portugues/Things a non Programmer can do.pt-br.md new file mode 100644 index 00000000..3ea6256a --- /dev/null +++ b/docs/additional-material/translations/Portugues/Things a non Programmer can do.pt-br.md @@ -0,0 +1,126 @@ +# 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. diff --git a/docs/additional-material/translations/Portugues/additional-material.pt_br.md b/docs/additional-material/translations/Portugues/additional-material.pt_br.md new file mode 100644 index 00000000..ae3678c0 --- /dev/null +++ b/docs/additional-material/translations/Portugues/additional-material.pt_br.md @@ -0,0 +1,46 @@ +# 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. diff --git a/docs/additional-material/translations/Portugues/amending-a-commit.pt_br.md b/docs/additional-material/translations/Portugues/amending-a-commit.pt_br.md new file mode 100644 index 00000000..1b6d92cd --- /dev/null +++ b/docs/additional-material/translations/Portugues/amending-a-commit.pt_br.md @@ -0,0 +1,52 @@ +# 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. diff --git a/docs/additional-material/translations/Portugues/confinguring-git.pt-br.md b/docs/additional-material/translations/Portugues/confinguring-git.pt-br.md new file mode 100644 index 00000000..2e2c7021 --- /dev/null +++ b/docs/additional-material/translations/Portugues/confinguring-git.pt-br.md @@ -0,0 +1,78 @@ +# 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). \ No newline at end of file diff --git a/docs/additional-material/translations/Portugues/keeping-your-fork-synced-with-this-repository.pt_br.md b/docs/additional-material/translations/Portugues/keeping-your-fork-synced-with-this-repository.pt_br.md new file mode 100644 index 00000000..474a7f44 --- /dev/null +++ b/docs/additional-material/translations/Portugues/keeping-your-fork-synced-with-this-repository.pt_br.md @@ -0,0 +1,40 @@ +## 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. diff --git a/docs/additional-material/translations/Portugues/moving-a-commit-to-a-different-branch.pt_br.md b/docs/additional-material/translations/Portugues/moving-a-commit-to-a-different-branch.pt_br.md new file mode 100644 index 00000000..b96ae5a8 --- /dev/null +++ b/docs/additional-material/translations/Portugues/moving-a-commit-to-a-different-branch.pt_br.md @@ -0,0 +1,25 @@ +# 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. diff --git a/docs/additional-material/translations/Portugues/removing-a-file.pt_br.md b/docs/additional-material/translations/Portugues/removing-a-file.pt_br.md new file mode 100644 index 00000000..237c7698 --- /dev/null +++ b/docs/additional-material/translations/Portugues/removing-a-file.pt_br.md @@ -0,0 +1,24 @@ +# 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` diff --git a/docs/additional-material/translations/Portugues/removing-branch-from-your-repository.pt_br.md b/docs/additional-material/translations/Portugues/removing-branch-from-your-repository.pt_br.md new file mode 100644 index 00000000..663e75d1 --- /dev/null +++ b/docs/additional-material/translations/Portugues/removing-branch-from-your-repository.pt_br.md @@ -0,0 +1,31 @@ +## 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) diff --git a/docs/additional-material/translations/Russian/additional-material.ru.md b/docs/additional-material/translations/Russian/additional-material.ru.md new file mode 100644 index 00000000..522cd41e --- /dev/null +++ b/docs/additional-material/translations/Russian/additional-material.ru.md @@ -0,0 +1,46 @@ +# Дополнительная информация + +Здесь мы предполагаем, что вы уже освоили основную инструкцию. Дополнительная информация содержит некоторые сведения о 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, и тем, кто захочет рассширить свои знания в этой области. \ No newline at end of file diff --git a/docs/additional-material/translations/Russian/amending-a-commit.ru.md b/docs/additional-material/translations/Russian/amending-a-commit.ru.md new file mode 100644 index 00000000..e1416073 --- /dev/null +++ b/docs/additional-material/translations/Russian/amending-a-commit.ru.md @@ -0,0 +1,45 @@ +# Исправления в коммите + +Представьте, что вы сделали коммит в удаленный репозиторий, а потом поняли, что допустили опечатку в комментарии к коммиту или забыли вставить строку в этот последний по времени коммит. Как поступить в такой ситуации? Именно об этом и пойдет речь в этом документе. + +## Как изменить комментарий к недавнему коммиту после того, как он был послан на 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 <имя-ветки>``` + +Таким образом, оба исправления окажутся в одном коммите. diff --git a/docs/additional-material/translations/Russian/configuring-git.ru.md b/docs/additional-material/translations/Russian/configuring-git.ru.md new file mode 100644 index 00000000..769f4fc8 --- /dev/null +++ b/docs/additional-material/translations/Russian/configuring-git.ru.md @@ -0,0 +1,76 @@ +# Конфигурирование 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). \ No newline at end of file diff --git a/docs/additional-material/translations/Russian/moving-a-commit-to-a-different-branch.ru.md b/docs/additional-material/translations/Russian/moving-a-commit-to-a-different-branch.ru.md new file mode 100644 index 00000000..dbf8c5a2 --- /dev/null +++ b/docs/additional-material/translations/Russian/moving-a-commit-to-a-different-branch.ru.md @@ -0,0 +1,25 @@ +# Перемещение коммита в другую ветку +Что если вы сделали коммит, а затем поняли, что изменили неправильную ветку? +Как исправить такую ошибку? На этот вопрос отвечает данная инструкция. + +## Перемещение последних коммитов в существующую ветку +Для такого перемещения, наберите: + +```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``` - Переключается на ветку, которую вы создали. Эта ветка теперь содержит все коммиты. + +Запомните: Любые изменения, которые не были включены в коммит, будут полностью ПОТЕРЯНЫ. diff --git a/docs/additional-material/translations/Russian/removing-a-file.ru.md b/docs/additional-material/translations/Russian/removing-a-file.ru.md new file mode 100644 index 00000000..eabe0f1c --- /dev/null +++ b/docs/additional-material/translations/Russian/removing-a-file.ru.md @@ -0,0 +1,23 @@ +# Удаление файла из-под 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` diff --git a/docs/additional-material/translations/Sinhala/amending-a-commit.md b/docs/additional-material/translations/Sinhala/amending-a-commit.md new file mode 100644 index 00000000..3f992c8c --- /dev/null +++ b/docs/additional-material/translations/Sinhala/amending-a-commit.md @@ -0,0 +1,75 @@ +# 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``` භාවිතා කිරීම දුරස්ථ ශාඛාවේ (ඔබ එසේ කිරීමට අදහස් නොකරන්නේ නම්) වෙනත් පුද්ගලයින්ගේ වෙනස්කම් උඩින් ලිවීම වළක්වන ආරක්ෂිත විකල්පයකි. \ No newline at end of file diff --git a/docs/additional-material/translations/Sinhala/removing-a-file.sin.md b/docs/additional-material/translations/Sinhala/removing-a-file.sin.md new file mode 100644 index 00000000..cefb076c --- /dev/null +++ b/docs/additional-material/translations/Sinhala/removing-a-file.sin.md @@ -0,0 +1,23 @@ +# 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` diff --git a/docs/additional-material/translations/Slovenian/additional-material.sl.md b/docs/additional-material/translations/Slovenian/additional-material.sl.md new file mode 100644 index 00000000..57c1271e --- /dev/null +++ b/docs/additional-material/translations/Slovenian/additional-material.sl.md @@ -0,0 +1,46 @@ +# 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. diff --git a/docs/additional-material/translations/Slovenian/amending-a-commit.sl.md b/docs/additional-material/translations/Slovenian/amending-a-commit.sl.md new file mode 100644 index 00000000..1881495c --- /dev/null +++ b/docs/additional-material/translations/Slovenian/amending-a-commit.sl.md @@ -0,0 +1,48 @@ +# 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. diff --git a/docs/additional-material/translations/Slovenian/configuring-git.sl.md b/docs/additional-material/translations/Slovenian/configuring-git.sl.md new file mode 100644 index 00000000..591bb4c9 --- /dev/null +++ b/docs/additional-material/translations/Slovenian/configuring-git.sl.md @@ -0,0 +1,77 @@ +# 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). diff --git a/docs/additional-material/translations/Slovenian/keeping-your-fork-synced-with-this-repository.sl.md b/docs/additional-material/translations/Slovenian/keeping-your-fork-synced-with-this-repository.sl.md new file mode 100644 index 00000000..7422557b --- /dev/null +++ b/docs/additional-material/translations/Slovenian/keeping-your-fork-synced-with-this-repository.sl.md @@ -0,0 +1,40 @@ +# 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. diff --git a/docs/additional-material/translations/Slovenian/moving-a-commit-to-a-different-branch.sl.md b/docs/additional-material/translations/Slovenian/moving-a-commit-to-a-different-branch.sl.md new file mode 100644 index 00000000..3074388e --- /dev/null +++ b/docs/additional-material/translations/Slovenian/moving-a-commit-to-a-different-branch.sl.md @@ -0,0 +1,24 @@ +# 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! \ No newline at end of file diff --git a/docs/additional-material/translations/Slovenian/removing-a-file.sl.md b/docs/additional-material/translations/Slovenian/removing-a-file.sl.md new file mode 100644 index 00000000..7b75f583 --- /dev/null +++ b/docs/additional-material/translations/Slovenian/removing-a-file.sl.md @@ -0,0 +1,23 @@ +# 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` diff --git a/docs/additional-material/translations/Slovenian/removing-branch-from-your-repository.sl.md b/docs/additional-material/translations/Slovenian/removing-branch-from-your-repository.sl.md new file mode 100644 index 00000000..21be1741 --- /dev/null +++ b/docs/additional-material/translations/Slovenian/removing-branch-from-your-repository.sl.md @@ -0,0 +1,30 @@ +# 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) diff --git a/docs/additional-material/translations/Slovenian/resolving-merge-conflicts.sl.md b/docs/additional-material/translations/Slovenian/resolving-merge-conflicts.sl.md new file mode 100644 index 00000000..1eb3ad26 --- /dev/null +++ b/docs/additional-material/translations/Slovenian/resolving-merge-conflicts.sl.md @@ -0,0 +1,34 @@ +# 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`. diff --git a/docs/additional-material/translations/Slovenian/reverting-a-commit.sl.md b/docs/additional-material/translations/Slovenian/reverting-a-commit.sl.md new file mode 100644 index 00000000..72640795 --- /dev/null +++ b/docs/additional-material/translations/Slovenian/reverting-a-commit.sl.md @@ -0,0 +1,38 @@ +# 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```. \ No newline at end of file diff --git a/docs/additional-material/translations/Slovenian/squashing-commits.sl.md b/docs/additional-material/translations/Slovenian/squashing-commits.sl.md new file mode 100644 index 00000000..2f6a40ba --- /dev/null +++ b/docs/additional-material/translations/Slovenian/squashing-commits.sl.md @@ -0,0 +1,94 @@ +# 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. + diff --git a/docs/additional-material/translations/Slovenian/stashing-a-file.sl.md b/docs/additional-material/translations/Slovenian/stashing-a-file.sl.md new file mode 100644 index 00000000..00248203 --- /dev/null +++ b/docs/additional-material/translations/Slovenian/stashing-a-file.sl.md @@ -0,0 +1,136 @@ +# 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. \ No newline at end of file diff --git a/docs/additional-material/translations/Slovenian/undoing-a-commit.sl.md b/docs/additional-material/translations/Slovenian/undoing-a-commit.sl.md new file mode 100644 index 00000000..232f04c4 --- /dev/null +++ b/docs/additional-material/translations/Slovenian/undoing-a-commit.sl.md @@ -0,0 +1,55 @@ +# 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! diff --git a/docs/additional-material/translations/Spanish/additional-material.es.md b/docs/additional-material/translations/Spanish/additional-material.es.md new file mode 100644 index 00000000..22d3b4c8 --- /dev/null +++ b/docs/additional-material/translations/Spanish/additional-material.es.md @@ -0,0 +1,46 @@ +# 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. diff --git a/docs/additional-material/translations/Spanish/additional-material.sp_mx.md b/docs/additional-material/translations/Spanish/additional-material.sp_mx.md new file mode 100644 index 00000000..634aa6c3 --- /dev/null +++ b/docs/additional-material/translations/Spanish/additional-material.sp_mx.md @@ -0,0 +1,46 @@ +# 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. diff --git a/docs/additional-material/translations/Spanish/amending-a-commit.es.md b/docs/additional-material/translations/Spanish/amending-a-commit.es.md new file mode 100644 index 00000000..19bb3a36 --- /dev/null +++ b/docs/additional-material/translations/Spanish/amending-a-commit.es.md @@ -0,0 +1,44 @@ +# 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. \ No newline at end of file diff --git a/docs/additional-material/translations/Spanish/amending-a-commit.sp_mx.md b/docs/additional-material/translations/Spanish/amending-a-commit.sp_mx.md new file mode 100644 index 00000000..a7138461 --- /dev/null +++ b/docs/additional-material/translations/Spanish/amending-a-commit.sp_mx.md @@ -0,0 +1,52 @@ +# 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. \ No newline at end of file diff --git a/docs/additional-material/translations/Spanish/configuring-git.sp_mx.md b/docs/additional-material/translations/Spanish/configuring-git.sp_mx.md new file mode 100644 index 00000000..63dc0535 --- /dev/null +++ b/docs/additional-material/translations/Spanish/configuring-git.sp_mx.md @@ -0,0 +1,78 @@ +# 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). \ No newline at end of file diff --git a/docs/additional-material/translations/Spanish/creating-a-gitignore-file.md b/docs/additional-material/translations/Spanish/creating-a-gitignore-file.md new file mode 100644 index 00000000..75ee2ff3 --- /dev/null +++ b/docs/additional-material/translations/Spanish/creating-a-gitignore-file.md @@ -0,0 +1,66 @@ +# .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```. diff --git a/docs/additional-material/translations/Spanish/delete-branch-locally.md b/docs/additional-material/translations/Spanish/delete-branch-locally.md new file mode 100644 index 00000000..3c4c5a14 --- /dev/null +++ b/docs/additional-material/translations/Spanish/delete-branch-locally.md @@ -0,0 +1,19 @@ +# 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... \ No newline at end of file diff --git a/docs/additional-material/translations/Tamil/additional-material.ta.md b/docs/additional-material/translations/Tamil/additional-material.ta.md new file mode 100644 index 00000000..4902e26a --- /dev/null +++ b/docs/additional-material/translations/Tamil/additional-material.ta.md @@ -0,0 +1,52 @@ +# கூடுதல் தகவல் + +இங்கு வருவதற்கு முன்பு நீங்கள் ஏற்கனவே அடிப்படை பயிற்சியை முடித்துவிட்டீர்கள் என்று கருதுகிறோம். இந்த ஆவணம் மேம்பட்ட 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 திட்டங்களிலும் பயன்படுத்தப்படுகிறது. இது தேவையான கோப்புகளை மட்டுமே கிட் செய்ய உதவுகிறது. + +**தொழில்நுட்ப ஆவணங்களை எழுதுங்கள்** + ஒரு பயன்பாடு அல்லது மென்பொருள் எவ்வாறு செயல்படுகிறது என்பதைப் பற்றி நீங்கள் எழுத முடிந்தால், அதைப் பற்றிய தொழில்நுட்ப ஆவணங்களை நீங்கள் எழுதலாம். குறிப்பாக ஓப்பன் சோர்ஸ் திட்டங்கள், பொது மக்கள் படிக்கும் வகையில் தொழில்நுட்ப ஆவணங்களை புதுப்பிக்க, புதுப்பிக்க, விரிவாக்க அல்லது உருவாக்க வேண்டும். நீங்கள் சாதாரண ஆங்கிலத்தில் எவ்வளவு அதிகமாக எழுதுகிறீர்களோ, அவ்வளவு சிறந்தது. சிறந்த பகுதி, தொழில்நுட்ப ஆவணங்களை எழுத நீங்கள் ஒரு புரோகிராமராக இருக்க வேண்டியதில்லை. \ No newline at end of file diff --git a/docs/additional-material/translations/Telugu/ప్రోగ్రామింగ్ తెలియని వ్యక్తి చేయగల పనులు.md b/docs/additional-material/translations/Telugu/ప్రోగ్రామింగ్ తెలియని వ్యక్తి చేయగల పనులు.md new file mode 100644 index 00000000..28ebb0e5 --- /dev/null +++ b/docs/additional-material/translations/Telugu/ప్రోగ్రామింగ్ తెలియని వ్యక్తి చేయగల పనులు.md @@ -0,0 +1,85 @@ +# ప్రోగ్రామింగ్ తెలియని వ్యక్తి చేయగల పనులు +## వినడం ప్రారంభించండి + +ఓపెన్ సోర్స్ లో ప్రతిదీ ఇతరులతో అనుసంధానంగా ఉంటుంది. +మీరు ఒక టీమ్ లో చేరాలని చూస్తున్నారు, అంటే ఆ కమ్యూనిటీ మరియు అది ఎలా పనిచేస్తుందో అర్థం చేసుకోవాలి. +ఒక ప్రాజెక్ట్ లోకి వెళ్లి "హాయ్, ఈ ప్రాజెక్ట్ ఇలా చేయాలి అని నేను అనుకుంటున్నాను" అని చెప్పడం సాధారణంగా మంచిదిగా భావించబడదు. +కొన్ని ప్రాజెక్టులు ఆ విధమైన దృష్టికోణాన్ని స్వాగతించవచ్చు, కానీ ప్రాజెక్ట్ కొన్ని కాలంగా నడుస్తూ ఉంటే, ఆ దృష్టికోణాన్ని ఆమోదించే అవకాశం చాలా తక్కువ. +**ప్రాజెక్ట్ కి అవసరమేమిటో తెలుసుకోవడానికి వినడం ఉత్తమ మార్గం.** + +1. **మెయిలింగ్ లిస్ట్ లో చేరండి**: +చాలా ప్రాజెక్టుల కోసం మెయిలింగ్ లిస్ట్ ప్రధాన కమ్యూనికేషన్ పద్ధతి. +పొడవైన ప్రాజెక్టుల్లో ఎన్నో మెయిలింగ్ లిస్ట్ లు ఉంటాయి. +ఉదాహరణకు, PostgreSQL ప్రాజెక్ట్ కు కనీసం 12 యూజర్-ఆధారిత లిస్ట్ లు మరియు 6 డెవలపర్ లిస్ట్ లు ఉన్నాయి. +ముఖ్యమైన యూజర్-ఆధారిత లిస్ట్ మరియు కోర్ డెవలపర్ లిస్ట్ ను ఫాలో కావడం మొదలుపెట్టండి. + +2. **బ్లాగ్ ఫాలో చేయండి**: +కోర్ డెవలపర్లు నిర్వహించే బ్లాగులు భవిష్యత్ అప్డేట్స్ గురించి సమాచారం ఇస్తాయి. +ఒక ప్రాజెక్ట్ కి సంబంధించి పలు మూలాల నుండి వచ్చిన వార్తలను ఒక చోట చేరదీసే ప్లానెట్ సైట్ ఉంటే, అది మొదటి ప్రాధాన్యత. +గూగుల్ లో "ప్లానెట్ <ప్రాజెక్ట్ పేరు>" అని వెతకండి. + +3. **IRC ఛానల్ లో చేరండి**: +చాలా ఓపెన్ సోర్స్ ప్రాజెక్టులకి ప్రత్యేకమైన ఇంటర్నెట్ రీలే చాట్ (IRC) ఛానల్స్ ఉంటాయి. +ఇవి సమస్యలు మరియు డెవలప్మెంట్ గురించి చర్చించడానికి ఉపయోగపడతాయి. +ప్రాజెక్ట్ వెబ్‌సైట్ లోకి వెళ్లి ఆ ఛానల్ పేరు మరియు అది ఏ IRC నెట్వర్క్ పై ఉందో తెలుసుకోండి. + +**టికెట్లతో పని చేయండి** +ఒక ప్రాజెక్ట్ లో కోడ్ తప్పనిసరి అయినప్పటికీ, కోడ్ రాయడం మాత్రమే కాంట్రిబ్యూట్ చేయడం కాదు. +కొత్త ఫీచర్లను సృష్టించడం మరియు బగ్ లను సరిచేయడం కోసం కోడ్ నిర్వహణను మర్చిపోతారు. +ఇలాంటి neglected ప్రాంతాల్లో పని చేయడం ప్రాజెక్ట్ లో చేరడానికి ఉత్తమ మార్గం. + +4. **బగ్ ని డయాగ్నోస్ చేయండి**: +చాలా సందర్భాల్లో బగ్ రిపోర్ట్ చేయడం సరైన విధంగా జరగదు. +మీరు బగ్ ని కొంచెం నిశితంగా విశ్లేషిస్తే, డెవలపర్ల సమయాన్ని ఆదా చేయగలరు. +ఉదాహరణకు, "సాఫ్ట్‌వేర్ పనిచేయడం లేదు" అని రిపోర్ట్ చేస్తే, అది ఎందుకు జరుగుతుందో తెలపడానికి ప్రయత్నించండి. +మీరు కనుగొన్న ప్రతిదాన్ని టికెట్ లో చేరదీసి అందరికి అందుబాటులో ఉంచండి. + +5. **పాత బగ్ లను క్లోజ్ చేయండి**: +బగ్ లను కోడ్ బేస్ లో ఫిక్స్ చేసినప్పటికీ, టికెటింగ్ సిస్టమ్ లో అప్‌డేట్ చేయడం మర్చిపోతారు. +సాఫ్ట్‌వేర్ తాజా వెర్షన్ తో బగ్ పనితీరుని పరీక్షించి, అవసరమైన మార్పులు చేయండి. + +**కోడ్ తో పని చేయండి** +ప్రజలు అనుభవ స్థాయిని పరిగణనలోకి తీసుకోకుండా ప్రాజెక్ట్ కోడ్ లో సహాయపడవచ్చు. + +6. **బీటా వెర్షన్ ని పరీక్షించండి**: +ఒక సాఫ్ట్‌వేర్ విభిన్న ప్లాట్‌ఫారమ్‌లపై ఎలా పనిచేస్తుందో పరిశీలించండి. +కేవలం డౌన్‌లోడ్ చేసి, టెస్ట్ చేయడం ద్వారా ప్రాజెక్ట్ కు విలువైన ఫీడ్బ్యాక్ ఇస్తారు. + +7. **బగ్ ని ఫిక్స్ చేయండి**: +ఇది ప్రారంభించడానికి సరైన మార్గం. +టికెటింగ్ సిస్టమ్ లో ఒక బగ్ ని ఎంచుకుని దాన్ని ఫిక్స్ చేయండి. + +8. **టెస్ట్ రాయండి**: +ప్రాజెక్ట్ టెస్ట్ సూట్ ని మెరుగుపరచండి. + +9. **కంపైలర్ వార్నింగ్ ను సైలెన్స్ చేయండి**: +సాధారణంగా సాఫ్ట్‌వేర్ లో ఉండే చిన్న వార్నింగ్‌లను పరిష్కరించడం ద్వారా డెవలప్ మెంట్ నాణ్యతను మెరుగుపరచండి. + +10. **కామెంట్ జోడించండి**: +కోడ్ లో క్లారిటీ కోసం అవసరమైన చోట కామెంట్స్ జోడించండి. + +**డాక్యుమెంటేషన్ తో పని చేయండి** +డాక్యుమెంటేషన్ పై పని చేయడం ప్రాజెక్ట్ కి చాలా విలువైనది. + +11. **ఉదాహరణలు సృష్టించండి**: +సాఫ్ట్‌వేర్ ఉపయోగాన్ని వివరిస్తూ మంచి ఉదాహరణలు ఇవ్వండి. + +**కమ్యూనిటీ తో పని చేయండి** +ఓపెన్ సోర్స్ లో కమ్యూనిటీ చాలా ముఖ్యమైనది. + +12. **ప్రశ్నకు సమాధానం ఇవ్వండి**: +కొత్తవారికి సహాయం చేయడం ద్వారా కమ్యూనిటీ అభివృద్ధి చెందుతుంది. + +13. **బ్లాగ్ పోస్ట్ రాయండి**: +మీ అనుభవాల గురించి రాయడం ద్వారా ప్రాజెక్ట్‌కు ప్రచారం చేయండి. + +14. **వెబ్‌సైట్ మెరుగుపరచండి**: +వెబ్‌సైట్ డిజైన్ మరియు లేఅవుట్ మెరుగుపరచడం ద్వారా ప్రాజెక్ట్ ఇమేజ్ ని మెరుగుపరచండి. + +15. **టెక్నికల్ డాక్యుమెంటేషన్ రాయండి**: +సాఫ్ట్‌వేర్ పని విధానంపై సులభమైన మరియు స్పష్టమైన డాక్యుమెంటేషన్ ఇవ్వండి. + +16. **మరెవరితోనైనా పంచుకోండి మరియు నేర్పండి**: +ఇది నేర్చుకోవడానికి ఉత్తమ మార్గం మరియు ఇతరులకు సహాయం చేసే పద్ధతి. + +**ముఖ్యమైనది: ఇతరుల మాటలు వినండి మరియు ప్రాజెక్ట్ లో అవసరమేదో గుర్తించండి.** diff --git a/docs/additional-material/translations/Twi/additional-matrial-twi.md b/docs/additional-material/translations/Twi/additional-matrial-twi.md new file mode 100644 index 00000000..b7fd619f --- /dev/null +++ b/docs/additional-material/translations/Twi/additional-matrial-twi.md @@ -0,0 +1,54 @@ +# 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. diff --git a/docs/additional-material/translations/Twi/amending-a-commit-twi.md b/docs/additional-material/translations/Twi/amending-a-commit-twi.md new file mode 100644 index 00000000..e69de29b diff --git a/docs/additional-material/translations/Ukrainian/removing-a-file.ua.md b/docs/additional-material/translations/Ukrainian/removing-a-file.ua.md new file mode 100644 index 00000000..3c8fb5f5 --- /dev/null +++ b/docs/additional-material/translations/Ukrainian/removing-a-file.ua.md @@ -0,0 +1,23 @@ +# Видалення файлу з-під 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` diff --git a/docs/additional-material/translations/Urdu/additional-material.ur.md b/docs/additional-material/translations/Urdu/additional-material.ur.md new file mode 100644 index 00000000..e6f4a8d5 --- /dev/null +++ b/docs/additional-material/translations/Urdu/additional-material.ur.md @@ -0,0 +1,46 @@ +# اضافی معلومات + +ہم سمجھتے ہیں کہ آپ یہاں آنے سے پہلے بنیادی سبق کے ساتھ پہلے ہی ختم ہو چکے ہیں. اضافی معلومات آپ کو اعلی درجے کی گیٹ کی تکنیک کے بارے میں کچھ معلومات دے گی. + +### [ایک ارتکاب ترمیم] (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) +یہ دستاویز تمام بلاگز خطوط، مددگار سائٹس، تجاویز اور چالوں کی ویب سائٹوں کے لئے وقف ہے جو ہماری جانوں کو آسان بنا دیتا ہے. کہ ہم اپنی تمام ضروریات کے لئے حوالہ دیتے ہیں، یہ ایک ابتدائی یا ایک ماہر بنیں. یہ صفحہ ان تمام مفید لنکس کی ایک انڈیکس کے طور پر کام کرنا چاہیے جو ہر فرد کو کھلے منبع ڈومین میں یا کسی کو مزید جاننے کے لئے مدد کرے گا. \ No newline at end of file diff --git a/docs/additional-material/translations/Urdu/amending-a-commit.ur.md b/docs/additional-material/translations/Urdu/amending-a-commit.ur.md new file mode 100644 index 00000000..168fe275 --- /dev/null +++ b/docs/additional-material/translations/Urdu/amending-a-commit.ur.md @@ -0,0 +1,51 @@ +کمانڈر ترمیم # + +اگر آپ اپنے دور دراز ذخیرہ میں تبدیلی کرتے ہیں تو صرف اس کے بعد احساس کرنے کے لۓ آپ کے پاس وعدہ کردہ پیغام میں ٹائپو ہے یا آپ کو اپنے حالیہ حاکموں میں ایک لائن شامل کرنا بھول گیا ہے. +تم اس میں کیسے ترمیم کرتے ہو؟ یہ وہی ہے جو سبق کا احاطہ کرتا ہے. + +## آپ 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 ` `` + +اس طرح، دونوں تبدیلیاں ایک ہی انجام میں ہو گی. \ No newline at end of file diff --git a/docs/additional-material/translations/Vietnamese/moving-a-commit-to-a-different-branch.vi.md b/docs/additional-material/translations/Vietnamese/moving-a-commit-to-a-different-branch.vi.md new file mode 100644 index 00000000..2757b2c4 --- /dev/null +++ b/docs/additional-material/translations/Vietnamese/moving-a-commit-to-a-different-branch.vi.md @@ -0,0 +1,25 @@ +# 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. diff --git a/docs/additional-material/translations/Vietnamese/resolving-merge-conflicts.vi.md b/docs/additional-material/translations/Vietnamese/resolving-merge-conflicts.vi.md new file mode 100644 index 00000000..eb78a21d --- /dev/null +++ b/docs/additional-material/translations/Vietnamese/resolving-merge-conflicts.vi.md @@ -0,0 +1,33 @@ +# 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` diff --git a/docs/cli-tool-tutorials/Marathi/github-cli-tutorial.marathi.md b/docs/cli-tool-tutorials/Marathi/github-cli-tutorial.marathi.md new file mode 100644 index 00000000..e5586dfe --- /dev/null +++ b/docs/cli-tool-tutorials/Marathi/github-cli-tutorial.marathi.md @@ -0,0 +1,104 @@ + +[![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) diff --git a/docs/cli-tool-tutorials/Spanish/github-cli-tutorial.es.md b/docs/cli-tool-tutorials/Spanish/github-cli-tutorial.es.md new file mode 100644 index 00000000..b9c57b9d --- /dev/null +++ b/docs/cli-tool-tutorials/Spanish/github-cli-tutorial.es.md @@ -0,0 +1,101 @@ +[![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) diff --git a/docs/cli-tool-tutorials/git-bash-windows-tutorial.md b/docs/cli-tool-tutorials/git-bash-windows-tutorial.md new file mode 100644 index 00000000..04d4e0e1 --- /dev/null +++ b/docs/cli-tool-tutorials/git-bash-windows-tutorial.md @@ -0,0 +1,140 @@ +[![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 + +| Git Bash | Git Bash 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 Git Bash on your windows machine, [install it](https://git-scm.com/download/win). + +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 copy the string down below. + +copy string + +Open the git bash application you just downloaded. It should look like the image down below if it's on a windows machine. + +open git bash terminal + +Go to the folder that you want to save this project on by using this command + +```bash +cd +``` + +cd into a folder + +Use the string you copied in the step above to clone the repository using this command + +```bash +git clone +``` + +clone the repository + +Go to the directory where the repo is and open it up on vs code to make your changes. + +cd into the newly cloned repo + +## Create a branch + +Now create a branch by using this simple command. This command not only creates a branch for you but also lets you switch to that branch. + +```bash +git checkout -b +``` + +Name your branch ``. For example, "add-james-smith" + +create a branch + +## Make necessary changes and commit those changes + +Now open `Contributors.md` file in a 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 by simply running this command + +```bash +git status +``` + +check the status + +Now commit those changes: + +First add the change you made to the staging area by using + +```bash +git add file-name +``` + +Then write a commit message by sing this command + +```bash +git commit -m "Add your-name to Contributors list" +``` + +Replace `` with your name. + +commit changes + +To see if your commit has been made you can run a simple `git log --oneline` command. + +## Push changes to github + +Once you are done with the above steps you can push your changes by using this command + +```bash +git push origin +``` + +push 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). + +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/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +### [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) diff --git a/docs/cli-tool-tutorials/git-cli-tutorial-kannada.md b/docs/cli-tool-tutorials/git-cli-tutorial-kannada.md new file mode 100644 index 00000000..b7126731 --- /dev/null +++ b/docs/cli-tool-tutorials/git-cli-tutorial-kannada.md @@ -0,0 +1,107 @@ + +--- + +[![ಓಪನ್ ಸೋರ್ಸ್ ಪ್ರೀತಿ](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! \ No newline at end of file diff --git a/docs/cli-tool-tutorials/github-cli-tutorial-Hindi.md b/docs/cli-tool-tutorials/github-cli-tutorial-Hindi.md new file mode 100644 index 00000000..2e6e545b --- /dev/null +++ b/docs/cli-tool-tutorials/github-cli-tutorial-Hindi.md @@ -0,0 +1,128 @@ +[![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) diff --git a/docs/cli-tool-tutorials/github-cli-tutorial-Urdu.md b/docs/cli-tool-tutorials/github-cli-tutorial-Urdu.md new file mode 100644 index 00000000..6c8afcb6 --- /dev/null +++ b/docs/cli-tool-tutorials/github-cli-tutorial-Urdu.md @@ -0,0 +1,104 @@ +[![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) diff --git a/docs/cli-tool-tutorials/github-cli-tutorial-id.md b/docs/cli-tool-tutorials/github-cli-tutorial-id.md new file mode 100644 index 00000000..e1c7e7fb --- /dev/null +++ b/docs/cli-tool-tutorials/github-cli-tutorial-id.md @@ -0,0 +1,108 @@ +[![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) diff --git a/docs/cli-tool-tutorials/github-cli-tutorial-pt-br.md b/docs/cli-tool-tutorials/github-cli-tutorial-pt-br.md new file mode 100644 index 00000000..003d1c92 --- /dev/null +++ b/docs/cli-tool-tutorials/github-cli-tutorial-pt-br.md @@ -0,0 +1,101 @@ +[![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) diff --git a/docs/cli-tool-tutorials/github-cli-tutorial-sinhala.md b/docs/cli-tool-tutorials/github-cli-tutorial-sinhala.md new file mode 100644 index 00000000..ddf99153 --- /dev/null +++ b/docs/cli-tool-tutorials/github-cli-tutorial-sinhala.md @@ -0,0 +1,109 @@ + + + + +[![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) \ No newline at end of file diff --git a/docs/cli-tool-tutorials/github-cli-tutorial-tamil.md b/docs/cli-tool-tutorials/github-cli-tutorial-tamil.md new file mode 100644 index 00000000..400999c5 --- /dev/null +++ b/docs/cli-tool-tutorials/github-cli-tutorial-tamil.md @@ -0,0 +1,108 @@ +[![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` கட்டளையை இயக்கலாம். + +## கிதுப்பில் மாற்றங்களை அழுத்தவும் + +மேலே உள்ள படிகளை நீங்கள் முடித்தவுடன் \ No newline at end of file diff --git a/docs/cli-tool-tutorials/github-cli-tutorial.md b/docs/cli-tool-tutorials/github-cli-tutorial.md new file mode 100644 index 00000000..d3907ebd --- /dev/null +++ b/docs/cli-tool-tutorials/github-cli-tutorial.md @@ -0,0 +1,109 @@ +[![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) | +| ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | + +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). + +You could join our slack team if you need any help or have any questions. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-vchl8cde-S0KstI_jyCcGEEj7rSTQiA). + +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](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) diff --git a/docs/cli-tool-tutorials/github-cli-tutorials-francais.md b/docs/cli-tool-tutorials/github-cli-tutorials-francais.md new file mode 100644 index 00000000..ce090dd8 --- /dev/null +++ b/docs/cli-tool-tutorials/github-cli-tutorials-francais.md @@ -0,0 +1,103 @@ + + +[![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) \ No newline at end of file diff --git a/docs/cli-tool-tutorials/translations/Greek/git-bash-windows-tutorial.gr.md b/docs/cli-tool-tutorials/translations/Greek/git-bash-windows-tutorial.gr.md new file mode 100644 index 00000000..a414a179 --- /dev/null +++ b/docs/cli-tool-tutorials/translations/Greek/git-bash-windows-tutorial.gr.md @@ -0,0 +1,132 @@ +[![Αγάπη Ανοιχτού Κώδικα](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/Άδεια-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). + +Μπορείτε να εγγραφείτε στην ομάδα μας στο 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/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) diff --git a/docs/cli-tool-tutorials/translations/Greek/github-cli-tutorial.gr.md b/docs/cli-tool-tutorials/translations/Greek/github-cli-tutorial.gr.md new file mode 100644 index 00000000..c0ce9c4a --- /dev/null +++ b/docs/cli-tool-tutorials/translations/Greek/github-cli-tutorial.gr.md @@ -0,0 +1,104 @@ +[![Αγάπη για το 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/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM) +[![Άδεια: 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). + +Μπορείτε να εγγραφείτε στην ομάδα μας στο 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) diff --git a/docs/cli-tool-tutorials/translations/Ukrainian/github-cli-tutorial.ua.md b/docs/cli-tool-tutorials/translations/Ukrainian/github-cli-tutorial.ua.md new file mode 100644 index 00000000..f213392a --- /dev/null +++ b/docs/cli-tool-tutorials/translations/Ukrainian/github-cli-tutorial.ua.md @@ -0,0 +1,101 @@ +[![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) diff --git a/docs/cli-tool-tutorials/translations/github-cli-tutorial-malayalam.md b/docs/cli-tool-tutorials/translations/github-cli-tutorial-malayalam.md new file mode 100644 index 00000000..a0c99d3b --- /dev/null +++ b/docs/cli-tool-tutorials/translations/github-cli-tutorial-malayalam.md @@ -0,0 +1,97 @@ +[![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) diff --git a/docs/cli-tool-tutorials/translations/github-cli-tutorial.hi.md b/docs/cli-tool-tutorials/translations/github-cli-tutorial.hi.md new file mode 100644 index 00000000..ee627745 --- /dev/null +++ b/docs/cli-tool-tutorials/translations/github-cli-tutorial.hi.md @@ -0,0 +1,102 @@ +# 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) diff --git a/docs/gui-tool-tutorials/github-desktop-old-version-tutorial.md b/docs/gui-tool-tutorials/github-desktop-old-version-tutorial.md new file mode 100644 index 00000000..19bec585 --- /dev/null +++ b/docs/gui-tool-tutorials/github-desktop-old-version-tutorial.md @@ -0,0 +1,108 @@ +[![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| +|---|---| + +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). + +You could 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/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + + +### [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) diff --git a/docs/gui-tool-tutorials/github-desktop-tutorial.md b/docs/gui-tool-tutorials/github-desktop-tutorial.md new file mode 100644 index 00000000..a5c0e0eb --- /dev/null +++ b/docs/gui-tool-tutorials/github-desktop-tutorial.md @@ -0,0 +1,118 @@ +[![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 | +| ----------------------------------------------------------------------------------------------- | ---------------------- | + +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 "Clone or Download" and then click on "Open in 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" the contents will be downloaded to your computer. + +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 "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). + +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/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +### [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) diff --git a/docs/gui-tool-tutorials/github-windows-intellij-tutorial.md b/docs/gui-tool-tutorials/github-windows-intellij-tutorial.md new file mode 100644 index 00000000..12383e5c --- /dev/null +++ b/docs/gui-tool-tutorials/github-windows-intellij-tutorial.md @@ -0,0 +1,112 @@ +[![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 + +| 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). + +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/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + + +### [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) diff --git a/docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md b/docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md new file mode 100644 index 00000000..07ee8dc5 --- /dev/null +++ b/docs/gui-tool-tutorials/github-windows-vs-code-tutorial.md @@ -0,0 +1,118 @@ +[![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 | +| ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | + + +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 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). + +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/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + + +### [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) diff --git a/docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md b/docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md new file mode 100644 index 00000000..2c6c9104 --- /dev/null +++ b/docs/gui-tool-tutorials/github-windows-vs2017-tutorial.md @@ -0,0 +1,140 @@ +[![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 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). + +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/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + + +### [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) diff --git a/docs/gui-tool-tutorials/gitkraken-tutorial.md b/docs/gui-tool-tutorials/gitkraken-tutorial.md new file mode 100644 index 00000000..fe362377 --- /dev/null +++ b/docs/gui-tool-tutorials/gitkraken-tutorial.md @@ -0,0 +1,123 @@ +[![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 + +|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). + +You could 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/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + + +### [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) diff --git a/docs/gui-tool-tutorials/sourcetree-macos-tutorial.md b/docs/gui-tool-tutorials/sourcetree-macos-tutorial.md new file mode 100644 index 00000000..5d40c3a6 --- /dev/null +++ b/docs/gui-tool-tutorials/sourcetree-macos-tutorial.md @@ -0,0 +1,139 @@ +[![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 + +|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). + +You could 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/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + + +### [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) diff --git a/docs/gui-tool-tutorials/sublime-merge-tutorial.md b/docs/gui-tool-tutorials/sublime-merge-tutorial.md new file mode 100644 index 00000000..38949b2f --- /dev/null +++ b/docs/gui-tool-tutorials/sublime-merge-tutorial.md @@ -0,0 +1,121 @@ +[![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 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). + +You could 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/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + + +### [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) diff --git a/docs/gui-tool-tutorials/translations/Chinese/github-desktop-tutorial.zh-cn.md b/docs/gui-tool-tutorials/translations/Chinese/github-desktop-tutorial.zh-cn.md new file mode 100644 index 00000000..d83c7d1d --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Chinese/github-desktop-tutorial.zh-cn.md @@ -0,0 +1,117 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/Chinese/gitkraken-tutorial-zh-cn.md b/docs/gui-tool-tutorials/translations/Chinese/gitkraken-tutorial-zh-cn.md new file mode 100644 index 00000000..e61a4bda --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Chinese/gitkraken-tutorial-zh-cn.md @@ -0,0 +1,108 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/Greek/github-desktop-old-version-tutorial.gr.md b/docs/gui-tool-tutorials/translations/Greek/github-desktop-old-version-tutorial.gr.md new file mode 100644 index 00000000..00b1ba5e --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Greek/github-desktop-old-version-tutorial.gr.md @@ -0,0 +1,80 @@ +[![Αγάπη για το Ανοικτό Κώδικα](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) + +# Πρώτες Συνεισφορές + +|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). + +Μπορείτε να εγγραφείτε στην ομάδα μας στο Slack αν χρειάζεστε βοήθεια ή έχετε οποιεσδήποτε ερωτήσεις. [Εγγραφή στην ομάδα Slack](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) diff --git a/docs/gui-tool-tutorials/translations/Greek/github-desktop-tutorial.gr.md b/docs/gui-tool-tutorials/translations/Greek/github-desktop-tutorial.gr.md new file mode 100644 index 00000000..7adc3b96 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Greek/github-desktop-tutorial.gr.md @@ -0,0 +1,113 @@ +[![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 | +| ----------------------------------------------------------------------------------------------- | ---------------------- | + +Είναι δύσκολο. Είναι πάντα δύσκολο όταν κάνετε κάτι για πρώτη φορά. Ειδικά όταν συνεργάζεστε, τα λάθη δεν είναι άνετα. Αλλά η ανοικτή πηγή αφορά τη συνεργασία και την εργασία από κοινού. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο νέοι συνεισφέροντες στην ανοικτή πηγή μαθαίνουν και συνεισφέρουν για πρώτη φορά. + +Η ανάγνωση άρθρων και η παρακολούθηση εκπαιδευτικών βίντεο μπορούν να βοηθήσουν, αλλά τίποτα δεν είναι καλύτερο από το να κάνετε τα πράγματα χωρίς να κάνετε κάποιο λάθος. Αυτό το έργο στοχεύει στην παροχή καθοδήγησης και στην απλοποίηση του τρόπου με τον οποίο οι αρχάριοι συνεισφέροντες κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε ότι όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Αν θέλετε να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε απλώς τα απλά βήματα παρακάτω. Σας υποσχόμαστε ότι θα είναι διασκεδαστικό. + +Εάν δεν έχετε το 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). + +Μπορείτε να εγγραφείτε στην ομάδα μας στο 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) diff --git a/docs/gui-tool-tutorials/translations/Greek/github-windows-intellij-tutorial.gr.md b/docs/gui-tool-tutorials/translations/Greek/github-windows-intellij-tutorial.gr.md new file mode 100644 index 00000000..c12d9fa5 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Greek/github-windows-intellij-tutorial.gr.md @@ -0,0 +1,110 @@ +[![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) + +# Πρώτες Συνεισφορές + +| 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). + +Μπορείτε να ενταχθείτε στην ομάδα μας στο 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) \ No newline at end of file diff --git a/docs/gui-tool-tutorials/translations/Greek/github-windows-vs-code-tutorial.gr.md b/docs/gui-tool-tutorials/translations/Greek/github-windows-vs-code-tutorial.gr.md new file mode 100644 index 00000000..3be0f2a1 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Greek/github-windows-vs-code-tutorial.gr.md @@ -0,0 +1,115 @@ +[![Αγάπη για το Ανοιχτό Κώδικα](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) + +# Πρώτες Συνεισφορές + +| 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). + +Μπορείτε να εγγραφείτε στην ομάδα μας στο 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) diff --git a/docs/gui-tool-tutorials/translations/Greek/github-windows-vs2017-tutorial.gr.md b/docs/gui-tool-tutorials/translations/Greek/github-windows-vs2017-tutorial.gr.md new file mode 100644 index 00000000..5040fb05 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Greek/github-windows-vs2017-tutorial.gr.md @@ -0,0 +1,145 @@ +[![Αγάπη για το Ανοιχτό Κώδικα](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) + +# Πρώτες Συνεισφορές + +|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). + +Μπορείτε να εγγραφείτε στην ομάδα μας στο 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) \ No newline at end of file diff --git a/docs/gui-tool-tutorials/translations/Greek/gitkraken-tutorial.gr.md b/docs/gui-tool-tutorials/translations/Greek/gitkraken-tutorial.gr.md new file mode 100644 index 00000000..be4d847a --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Greek/gitkraken-tutorial.gr.md @@ -0,0 +1,107 @@ +[![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| +|---|---| + +Είναι δύσκολο. Είναι πάντα δύσκολο, όταν κάνετε κάτι για πρώτη φορά. Ειδικά όταν συνεργάζεστε, το να κάνεις κάποιο λάθος δεν είναι κάτι άνετο. Αλλά ο ανοιχτός κώδικας αφορά τη συνεργασία και τη συνεργασία. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο νέοι συνεισφέροντες ανοιχτού κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά. + +Η ανάγνωση άρθρων και η παρακολούθηση εκπαιδευτικού υλικού μπορεί να βοηθήσει, αλλά τι είναι καλύτερο από το να κάνετε όντως κάτι χωρίς να χαλάσετε τίποτα. Αυτό το έργο έχει σκοπό να παρέχει καθοδήγηση και να απλοποίησει τον τρόπο με τον οποίο οι νέοι συνεισφέροντες μπορούν να κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε, όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Εάν θέλετε να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε απλά τα απλά βήματα παρακάτω. Σας υποσχόμαστε, θα είναι διασκεδαστικό. + +## 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). + +Μπορείτε να εγγραφείτε στην ομάδα μας στο 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) diff --git a/docs/gui-tool-tutorials/translations/Greek/sourcetree-macos-tutorial.gr.md b/docs/gui-tool-tutorials/translations/Greek/sourcetree-macos-tutorial.gr.md new file mode 100644 index 00000000..9d57725c --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Greek/sourcetree-macos-tutorial.gr.md @@ -0,0 +1,133 @@ +[![Αγάπη Ανοικτού Κώδικα](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) + +# Πρώτες Συνεισφορές + +|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). + +Μπορείτε να ενταχθείτε στην ομάδα μας στο 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) diff --git a/docs/gui-tool-tutorials/translations/Greek/sublime-merge-tutorial.gr.md b/docs/gui-tool-tutorials/translations/Greek/sublime-merge-tutorial.gr.md new file mode 100644 index 00000000..3b017627 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Greek/sublime-merge-tutorial.gr.md @@ -0,0 +1,118 @@ +[![Αγάπη για τον Ανοικτό Κώδικα](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) + +# Πρώτες Συνεισφορές + +|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). + +Μπορείτε επίσης να εγγραφείτε στην ομάδα μας στο Slack αν χρειαστείτε βοήθεια ή έχετε ερωτήσεις. [Εγγραφή στην ομάδα Slack](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) diff --git a/docs/gui-tool-tutorials/translations/Hindi/github-windows-vs-code-tutorial-hi.md b/docs/gui-tool-tutorials/translations/Hindi/github-windows-vs-code-tutorial-hi.md new file mode 100644 index 00000000..c9fa6988 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Hindi/github-windows-vs-code-tutorial-hi.md @@ -0,0 +1,116 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/Indonesian/github-windows-vs-code-tutorial_id.md b/docs/gui-tool-tutorials/translations/Indonesian/github-windows-vs-code-tutorial_id.md new file mode 100644 index 00000000..47452dd6 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Indonesian/github-windows-vs-code-tutorial_id.md @@ -0,0 +1,121 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/Marathi/github-windows-vs-code-tutorial-hi.md b/docs/gui-tool-tutorials/translations/Marathi/github-windows-vs-code-tutorial-hi.md new file mode 100644 index 00000000..c3368ef4 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Marathi/github-windows-vs-code-tutorial-hi.md @@ -0,0 +1,116 @@ +[![मुक्त स्रोत प्रेम](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) \ No newline at end of file diff --git a/docs/gui-tool-tutorials/translations/Persian/github-desktop-tutorial.fa.md b/docs/gui-tool-tutorials/translations/Persian/github-desktop-tutorial.fa.md new file mode 100644 index 00000000..d175b153 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Persian/github-desktop-tutorial.fa.md @@ -0,0 +1,118 @@ +[![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) \ No newline at end of file diff --git a/docs/gui-tool-tutorials/translations/Portuguese/github-desktop-tutorial.pt_br.md b/docs/gui-tool-tutorials/translations/Portuguese/github-desktop-tutorial.pt_br.md new file mode 100644 index 00000000..83062f7e --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Portuguese/github-desktop-tutorial.pt_br.md @@ -0,0 +1,118 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/Portuguese/github-windows-intellij-tutorial.pt_br.md b/docs/gui-tool-tutorials/translations/Portuguese/github-windows-intellij-tutorial.pt_br.md new file mode 100644 index 00000000..8b0aaa98 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Portuguese/github-windows-intellij-tutorial.pt_br.md @@ -0,0 +1,126 @@ +[![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). diff --git a/docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs-code-tutorial.pt_br.md b/docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs-code-tutorial.pt_br.md new file mode 100644 index 00000000..d6bb986d --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs-code-tutorial.pt_br.md @@ -0,0 +1,117 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs-code-tutorial_pt_br.md b/docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs-code-tutorial_pt_br.md new file mode 100644 index 00000000..7a6624b8 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs-code-tutorial_pt_br.md @@ -0,0 +1,124 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs2017-tutorial.pt_br.md b/docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs2017-tutorial.pt_br.md new file mode 100644 index 00000000..69047f36 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Portuguese/github-windows-vs2017-tutorial.pt_br.md @@ -0,0 +1,149 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/Portuguese/gitkraken-tutorial.pt-br.md b/docs/gui-tool-tutorials/translations/Portuguese/gitkraken-tutorial.pt-br.md new file mode 100644 index 00000000..d4e2e3d6 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Portuguese/gitkraken-tutorial.pt-br.md @@ -0,0 +1,126 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/Spanish/gitkraken-tutorial-es.md b/docs/gui-tool-tutorials/translations/Spanish/gitkraken-tutorial-es.md new file mode 100644 index 00000000..39354da8 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Spanish/gitkraken-tutorial-es.md @@ -0,0 +1,116 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/Yoruba/github-desktop-tutorial.ng_yo.md b/docs/gui-tool-tutorials/translations/Yoruba/github-desktop-tutorial.ng_yo.md new file mode 100644 index 00000000..b7280284 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/Yoruba/github-desktop-tutorial.ng_yo.md @@ -0,0 +1,104 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/github-desktop-tutorial-np.md b/docs/gui-tool-tutorials/translations/github-desktop-tutorial-np.md new file mode 100644 index 00000000..9e19ee0c --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-desktop-tutorial-np.md @@ -0,0 +1,121 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/github-desktop-tutorial.cn.md b/docs/gui-tool-tutorials/translations/github-desktop-tutorial.cn.md new file mode 100644 index 00000000..7cf1a3ed --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-desktop-tutorial.cn.md @@ -0,0 +1,126 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/github-desktop-tutorial.ng_yr.md b/docs/gui-tool-tutorials/translations/github-desktop-tutorial.ng_yr.md new file mode 100644 index 00000000..b7280284 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-desktop-tutorial.ng_yr.md @@ -0,0 +1,104 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/github-desktop-tutorial.pt_br.md b/docs/gui-tool-tutorials/translations/github-desktop-tutorial.pt_br.md new file mode 100644 index 00000000..83062f7e --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-desktop-tutorial.pt_br.md @@ -0,0 +1,118 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/github-desktop-tutorial.th.md b/docs/gui-tool-tutorials/translations/github-desktop-tutorial.th.md new file mode 100644 index 00000000..11351921 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-desktop-tutorial.th.md @@ -0,0 +1,121 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/github-desktop-tutorial.vn.md b/docs/gui-tool-tutorials/translations/github-desktop-tutorial.vn.md new file mode 100644 index 00000000..dd7cd6fc --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-desktop-tutorial.vn.md @@ -0,0 +1,134 @@ +_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. \ No newline at end of file diff --git a/docs/gui-tool-tutorials/translations/github-windows-intellij-tutorial.pt_br.md b/docs/gui-tool-tutorials/translations/github-windows-intellij-tutorial.pt_br.md new file mode 100644 index 00000000..22921581 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-windows-intellij-tutorial.pt_br.md @@ -0,0 +1,126 @@ +[![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). diff --git a/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial-hi.md b/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial-hi.md new file mode 100644 index 00000000..c9fa6988 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial-hi.md @@ -0,0 +1,116 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial.ml.md b/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial.ml.md new file mode 100644 index 00000000..63ad0254 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial.ml.md @@ -0,0 +1,115 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial.pt_br.md b/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial.pt_br.md new file mode 100644 index 00000000..d6bb986d --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial.pt_br.md @@ -0,0 +1,117 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial_id.md b/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial_id.md new file mode 100644 index 00000000..47452dd6 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial_id.md @@ -0,0 +1,121 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial_pt_br.md b/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial_pt_br.md new file mode 100644 index 00000000..7a6624b8 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-windows-vs-code-tutorial_pt_br.md @@ -0,0 +1,124 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/github-windows-vs2017-tutorial.pt_br.md b/docs/gui-tool-tutorials/translations/github-windows-vs2017-tutorial.pt_br.md new file mode 100644 index 00000000..69047f36 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/github-windows-vs2017-tutorial.pt_br.md @@ -0,0 +1,149 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/gitkraken-tutorial-es.md b/docs/gui-tool-tutorials/translations/gitkraken-tutorial-es.md new file mode 100644 index 00000000..39354da8 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/gitkraken-tutorial-es.md @@ -0,0 +1,116 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/gitkraken-tutorial-fr.md b/docs/gui-tool-tutorials/translations/gitkraken-tutorial-fr.md new file mode 100644 index 00000000..a39de2a1 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/gitkraken-tutorial-fr.md @@ -0,0 +1,120 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/gitkraken-tutorial.pt-br.md b/docs/gui-tool-tutorials/translations/gitkraken-tutorial.pt-br.md new file mode 100644 index 00000000..d4e2e3d6 --- /dev/null +++ b/docs/gui-tool-tutorials/translations/gitkraken-tutorial.pt-br.md @@ -0,0 +1,126 @@ +[![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) diff --git a/docs/gui-tool-tutorials/translations/malayalam/githiub-desktop-tutorial-ml.md b/docs/gui-tool-tutorials/translations/malayalam/githiub-desktop-tutorial-ml.md new file mode 100644 index 00000000..bd18853f --- /dev/null +++ b/docs/gui-tool-tutorials/translations/malayalam/githiub-desktop-tutorial-ml.md @@ -0,0 +1,128 @@ +[![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) diff --git a/docs/translations/README.afk.md b/docs/translations/README.afk.md new file mode 100644 index 00000000..d9ed6467 --- /dev/null +++ b/docs/translations/README.afk.md @@ -0,0 +1,129 @@ +[![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) + + +# 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 )* + + +fork this repository + +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 + +clone this repository + +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: + +``` +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. + +copy URL to clipboard + +Byvoorbeeld: + +``` +git clone https://github.com/this-is-you/first-contributions.git +``` + +waar `this-is-youis` jou GitHub gebruikersnaam 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): + +``` +cd first-contributions +``` + +Skep nou 'n tak met die git `checkout` opdrag: + +``` +git checkout -b +``` + +Byvoorbeeld: + +``` +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: + +``` +git add Contributors.md +``` + +Doen nou die veranderinge deur die `git commit` opdrag te gebruik: + +``` +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`: + +``` +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. + +create a pull request + +Dien nou die trekversoek in. + +submit pull request + +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 . + +U kan by ons span aansluit indien u enige hulp nodig het of enige vrae het. [Sluit aan by 'n slapende span](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.al.md b/docs/translations/README.al.md new file mode 100644 index 00000000..3838a728 --- /dev/null +++ b/docs/translations/README.al.md @@ -0,0 +1,127 @@ +[![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) + +# 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ë. + +#### _Nëse ende nuk ndjehesh komod me command line, [këtu ke tutoriale që përdorin veglat e GUI](#Tutoriale-duke-përdorur-vegla-tjera)_ + +fork this repository + +Nëse nuk ke Git të instaluar në pajisjen tënde, [instaloje](https://help.github.com/articles/set-up-git/). + +## Bëje fork këtë repozitor + +Për të bërë fork këtë repozitor kliko butonin fork në majë të kësaj faqeje. Kjo do të krijojë një kopje të ketij repozitori në llogarinë tënde. + +## Klonoje këtë repozitor + +clone this repository + +Tani klonoje në pajisjen tënde repozitorin që bëre fork. Shko te llogaria e GitHub, hap forked repository, kliko butonin Code dhe pastaj kliko ikonën _copy to clipboard_. + +Hap terminalin dhe bëje run git komandën në vazhdim: + +``` +git clone "url që sapo ke kopjuar" +``` + +ku "url që sapo ke kopjuar" (pa thonjëzat) është url e këtij repozitori (repozitori që bëre fork). Shiko hapat e mëparshëm për të marrë url-në. + +copy URL to clipboard + +Për shembull: + +``` +git clone https://github.com/ky-je-ti/first-contributions.git +``` + +ku `ky-je-ti` është emri jot në GitHub. Këtu ti e kopjon përmbajtjen e repozitorit first-contributions në GitHub te kompjuteri jot. + +## Krijo një degë (branch) + +Ndryshoje lokacionin te repozitori në kompjuterin tënd (nëse nuk je në lokacionin e duhur): + +``` +cd first-contributions +``` + +Tani krijo një degë duke përdorur komandën `git checkout`: + +``` +git checkout -b +``` + +Për shembull: + +``` +git checkout -b add-filan-fisteku +``` + +(Emri i degës nuk është i nevojshëm të ketë fjalën _add_ në të, por është e arsyeshme të përfshihet pasi që qëllimi i kësaj dege është të shtojë emrin tënd në një listë.) + +## Bëji ndryshimet e nevojshme dhe bëji commit + +Tani hap dosjën `Contributors.md` në një program për editim të tekstit dhe shto emrin tënd. Mos e shto në fillim ose në fund. Shtoje ku të duash në mes. Tani, ruaj dosjën. + +git status + +Nëse shkon te lokacioni i projektit dhe e ekzekuton komandën `git status`, do shohësh se ka ndryshime. + +Shtoji këto ndryshime te dega që sapo krijove duke përdorur komandën `git add`: + +``` +git add Contributors.md +``` + +Tani bëji commit këto ndryshime duke përdorur komandën `git commit`: + +``` +git commit -m "Add to Contributors list" +``` + +zëvendëso `` me emrin tënd. + +## Bëji push (shtyji) ndryshimet në GitHub + +Bëji push ndryshimet duke përdorur komandën `git push`: + +``` +git push origin +``` + +zëvendëso `` me emrin e degës që krijove më herët. + +## Paraçiti ndryshimet për shqyrtim + +Nëse shkon te repozitori jot në GitHub, do të shohësh një buton `Compare & pull request`. Klikoje. + +create a pull request + +Tani paraqisni këtë kërkesë tërheqjeje. + +submit pull request + +Së shpejti do të bashkoj (bëj merge) të gjitha ndryshimet te dega master e këtij projekti. Ti do të njoftohesh me email kur të bëhen ndryshimet. + +## Ku të shkosh nga këtu? + +Urime! Ti sapo ke kompletuar procesin _fork -> clone -> edit -> PR_ që do ta hasësh shpesh si kontributor! + +Festoje kontributin tënd dhe ndaje me shokët dhe ndjekësit duke shkuar te [web aplikacioni](https://firstcontributions.github.io/#social-share). + +Ti mund të bashkohesh në ekipin tonë në slack nëse të duhet ndihmë ose nëse ke ndonjë pyetje. [Bashkohu ekipit në slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +Tani të të ndihmojmë që të kontribuosh në projekte tjera. Ne kemi krijuar një listë projektesh me probleme të lehta tek të cilat mund të fillosh. Shiko [listën e projekteve në web apliacion](https://firstcontributions.github.io/#project-list). + +### [Materiale shtesë](additional-material/git_workflow_scenarios/additional-material.md) + +## Tutoriale duke përdorur vegla 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) | diff --git a/docs/translations/README.am.md b/docs/translations/README.am.md new file mode 100644 index 00000000..af18eb6a --- /dev/null +++ b/docs/translations/README.am.md @@ -0,0 +1,124 @@ +[![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) + + +# የመጀመሪያ አስተዋጽዖዎች + +ይህ ፕሮጀክት ጀማሪዎች የመጀመሪያ አስተዋጾ የሚያደርጉበትን መንገድ ለማቅለል እና ለመምራት ያለመ ነው። የመጀመሪያዎን አስተዋፅዖ ለማድረግ ከፈለጉ ከታች ያሉትን ደረጃዎች ይከተሉ + + +#### command line ካልተመቸህ, [GUI መሳሪያዎችን በመጠቀም አጋዥ ስልጠናዎች አሉ።.](#Tutorials-Usin'-Other-Tools) + +fork this repository + +በማሽንዎ ላይ git ከሌለዎት, [ይጫኑት](https://help.github.com/articles/set-up-git/). + +## Fork this repository + +በዚህ ገጽ ላይኛው ክፍል ላይ ያለውን fork ቁልፍን ጠቅ በማድረግ ይህንን ይጫኑት። +ይህ በአንተ መለያ ውስጥ የዚህን repository ቅጂ ይፈጥራል። + +## Clone the repository + +clone this repository + +አሁን Fork ይህን repository ወደ ማሽንዎ. ወደ GitHub መለያዎ ይሂዱ, የእርሶን repository ይክፈቱ. የኮድ ምልክቱን ጠቅ ያድርጉ እና ከዚያ ቅጂውን ምልክቱን ጠቅ ያድርጉ ለመቅዳት. + +``` +git clone "የቀዱትን url' ያስገቡ" +``` +"የቀዱትን url' ያስገቡ" (ያለ ጥቅስ ምልክቶች) ይህ የዚህ repository url ነው(የእርሶ ቅጂ ፕሮጀክት). url ለማግኘት የቀደመውን ደረጃዎች ይመልከቱ. + +copy URL to clipboard + +ለምሳሌ: + +``` +git clone https://github.com/this-is-you/first-contributions.git +``` + +where `this-is-you` የእርስዎ GitHub መለያ ስም ነው።. እዚህ በ GitHub ላይ ያለውን የመጀመሪያ አስተዋፅዖ repository ይዘቶችን ወደ ኮምፒውተርዎ እየገለበጡ ነው። + +## Create a branch(ቅርንጫፍ ይፍጠሩ) + +በኮምፒተርዎ ላይ ያለውን repository ማውጫ ይቀይሩ (እዚያ ከሌለዎት): + +``` +cd first-contributions +``` + +አሁን የ `git checkout` ትዕዛዝን በመጠቀም ቅርንጫፍ ይፍጠሩ: + +``` +git checkout -b +``` + +ለምሳሌ: + +``` +git checkout -b github-ethiopia +``` + +## አስፈላጊ ለውጦችን ያድርጉ እና ለውጦችን commit ያድርጉ + +አሁን የ Contributors.md ፋይልን በጽሑፍ አርታኢ(editor) ውስጥ ይክፈቱ፣ ስምዎን በእሱ ላይ ያክሉ። በፋይሉ መጀመሪያ ወይም መጨረሻ ላይ አይጨምሩት። በመካከል የትኛውም ቦታ ላይ ያስቀምጡት. አሁን, ፋይሉን ያስቀምጡ(save). + +git status + +ወደ የፕሮጀክት ማውጫው ሄደው የ git status ከፈጸሙ ለውጦች እንዳሉ ያያሉ። + +የ `git add` ትእዛዝን በመጠቀም እነዚያን ለውጦች አሁን በፈጠሩት ቅርንጫፍ ላይ አክል፡ + +``` +git add Contributors.md +``` + +አሁን የ `git commit` ትዕዛዝ በመጠቀም እነዚህን ለውጦች ያድርጉ፡ + +``` +git commit -m "Add <የእርስዎ-ስም> to Contributors list" +``` + +<የእርስዎ-ስም> ፋንታ የራስዎትን ስም ይጻፉ. + +## ለውጦችን ወደ GitHub ይጫኑ + +`git push` የሚለውን ትዕዛዝ በመጠቀም ለውጦችዎን ይጫኑ + +``` +git push origin <የእርስዎ-branch-name> +``` + +`<የእርስዎ-branch-name>` ፋንታ የራስዎትን branch ስም ያስገቡ + +## ለውጦችዎን ለግምገማ ያስገቡ + +በ GitHub ላይ ወደ repository ከሄዱ፣ `Compare & pull request` ጥያቄን ያያሉ። በዚያ ቁልፍ ላይ ጠቅ ያድርጉ። + +create a pull request + +አሁን pull request ጥያቄውን ያስገቡ + +submit pull request + +በቅርቡ ሁሉንም ለውጦችዎን ወደ የዚህ ፕሮጀክት ዋና ቅርንጫፍ አዋህዳለሁ. ለውጦቹ ከተዋሃዱ በኋላ የማሳወቂያ ኢሜይል ይደርስዎታል። + +## ከዚህ ወዴት መሄድ አለብዎት ? + +እንኳን ደስ ያለህ! አሁን መደበኛ fork -> clone -> edit -> pull request ሂደትን ጨርሰዋል. እንደ አስተዋጽዖ አበርካች ብዙ ጊዜ ይህ ሂደት ያጋትሞታል + +አስተዋጾዎን ያክብሩ እና ለጓደኞችዎ እና ተከታዮችዎ ያካፍሉ ወደ [ዲህረ ገጾ በመሄድ](https://firstcontributions.github.io/#social-share). + +ማንኛውም እርዳታ ከፈለጉ ወይም ማንኛውም ጥያቄ ካለዎት የእኛን [Slack ቡድን](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY) መቀላቀል ይችላሉ. + +አሁን ለሌሎች ፕሮጀክቶች በማበርከት እንጀምር. እርስዎ ሊጀምሩባቸው የሚችሉ ቀላል ጉዳዮች ያላቸውን የፕሮጀክቶች ዝርዝር አዘጋጅተናል።. [እኚህን ማስፈተሪያ ይከተሉ](https://firstcontributions.github.io/#project-list). + +### [ተጨማሪ ቁሳቁስ](../additional-material/git_workflow_scenarios/additional-material.md) + +## ሌሎች መሳሪያዎችን በመጠቀም አጋዥ ስልጠናዎች + +|GitHub Desktop|Visual Studio 2017|GitKraken| +|---|---|---| +|[GitHub Desktop](../github-desktop-tutorial.md)|[Visual Studio 2017](../github-windows-vs2017-tutorial.md)|[GitKraken](../gitkraken-tutorial.md)| diff --git a/docs/translations/README.amh.md b/docs/translations/README.amh.md new file mode 100644 index 00000000..72a3c5a7 --- /dev/null +++ b/docs/translations/README.amh.md @@ -0,0 +1,146 @@ +## የመጀመሪያ አስተዋፅኦዎች + +ይህ ፕሮጀክት ጀማሪዎች የመጀመሪያ አስተዋጾ የሚያደርጉበትን መንገድ ለማቅለል እና ለመምራት ያለመ ነው። የመጀመሪያዎን አስተዋፅዖ ለማድረግ ከፈለጉ ከታች ያሉትን ደረጃዎች ይከተሉ። + +***በcommand line(ተርሚናል) ካልተመቸዎት፣ [የGUI መሳሪያዎችን ለመጠቀም አጋዥ ስልጠናዎች እዚህ ያገኛሉ።](#tutorials-using-other-tools)*** + +fork this repository + +### በማሽንዎ ላይ ጊት(git) ከሌለዎት ፤ [ይጫኑት](https://docs.github.com/en/get-started/quickstart/set-up-git) ። + +## ይህንን ማከማቻ **fork** ያድርጉ + +በዚህ ገጽ ላይኛው ክፍል ላይ ያለውን የfork button ጠቅ በማድረግ ይህንን ማከማቻ fork ያድርጉት። +ይህ በአንተ account ውስጥ የዚህን repository ቅጂ ይፈጥራል። + +## የማከማቻውን ተመሳሳይ ይፍጠሩ + +clone this repository + +አሁን fork የተደረገውን ማከማቻ (repository) ቅጂ በማሽንዎ(በኮምፒውተርዎ) ይፍጥሩ። ወደ GitHub (account)መለያዎ ይሂዱ፤ fork የተደረገውን ማከማቻ ይክፈቱ፤ ኮድ የሚለውን button ጠቅ ያድርጉ እና ከዚያ *ወደ clipboard ቅዳ* የሚለውን ጠቅ ያድርጉ:: + +ተርሚናል ይክፈቱ እና የሚከተለውን የgit ትዕዛዝ run + +```bash +git clone "የቀዱትን url" + +``` + +"አሁን የገለበጡት url" (ያለ ጥቅስ ምልክቶቹ) የማከማቻው (የዚህ ፕሮጀክት fork) url ነው። urlን ለማግኘት የቀደመውን ደረጃዎች ይመልከቱ። + +copy URL to clipboard + +ለምሳሌ:- + +```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 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. + +
+ +## ለውጦችዎን ለግምገማ ያስገቡ + +በ GitHub ላይ ወደ ማከማቻዎ ከሄዱ፣ ‘compare & pull request' የሚለውን ቁልፍ ያያሉ። በዚያ ቁልፍ ላይ ጠቅ ያድርጉ። + +create a pull request + +አሁን pull request ያስገቡ። + +submit pull request + +በቅርቡ ሁሉንም ለውጦችዎን ወደ የዚህ ፕሮጀክት ዋና ቅርንጫፍ አዋህዳቸዋለሁ። ለውጦቹ ከተዋሃዱ በኋላ የማሳወቂያ ኢሜይል ይደርስዎታል። + +## ከዚህስ ወዴት ልሂድ? + +እንኳን ደስ ያሎዎት! ልክ እንደ አስተዋጽዖ አበርካች የሚያጋጥሙትን መደበኛ _fork -> clone -> አርትዕ -> የመሳብ ጥያቄ_ የስራ ፍሰትን አጠናቀዋል! + +አስተዋጾዎን ያጣጣጥሙ እና ወደ ድር በመሄድ ለጓደኞችዎ እና ተከታዮችዎ ያካፍሉ።(https://firstcontributions.github.io/#social-share). + +ማንኛውም እርዳታ ከፈለጉ ወይም ማንኛውም ጥያቄ ካለዎት የእኛን 'slack' ቡድን መቀላቀል ይችላሉ::(https://join.slack.com/t/firstcontributors/shared_invite/zt-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w). + +አሁን ለሌሎች ፕሮጀክቶች በማበርከት እንጀምር። እርስዎ ሊጀምሩባቸው የሚችሉ ቀላል ጉዳዮች ያላቸውን የፕሮጀክቶች ዝርዝር አዘጋጅተናል። በድር መተግበሪያ ውስጥ ያሉትን የፕሮጀክቶች ዝርዝር ይመልከቱ(https://firstcontributions.github.io/#project-list). + +## [ተጨማሪ ቁሳቁስ](https://www.notion.so/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) | + +

ይህ ፕሮጀክት የሚደገፈው በ:

+

+ + + +

diff --git a/docs/translations/README.ar.md b/docs/translations/README.ar.md new file mode 100644 index 00000000..61359b77 --- /dev/null +++ b/docs/translations/README.ar.md @@ -0,0 +1,176 @@ +[![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 على الجهاز الخاص بك،قم بتثبيته من هنا +
+ +##
افرق هذا المشروع - Fork this Repository
+ +fork this repository +
+افرق هذا المشروع بالضغط على زر Fork في أعلى هذه الصفحة. +من خلال ذلك ستنشأ نسخة من هذا المشروع على حسابك الخاص. +
+ +##
استنسخ هذا المشروع - Clone the repository
+ +clone this repository + +
+استنسخ هذا المشروع على جهازك. +انقر على زر Clone ثم انقر على أيقونة Copy to clipboard +
+copy URL to clipboard +
+افتح terminal واكتُب الأمر التالي: +
+ +``` +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" +``` + +
اسمك بدل add-your-name
+ +
على سبيل المثال:
+ +``` +git checkout -b "add-alonzo-church" +``` + +
+ +##
قم بإجراء التعديلات المطلوبة وأتممها
+ +
+الآن قم بفتح الملف "Contributors.md" في محرر النصوص المفضل لديك وأضف اسمك ثم احفظ الملف. +بعد ذلك اذهب إلى terminal واكتب الأمر git status. هذا الأمر سيظهر لك التغييرات التي حدثت في المشروع. +لإضافة هذه التغييرات قم بإضافتها عن طريق هذا الأمر git add. +
+ +``` +git add Contributors.md +``` + +
الآن قم بإتمام التغييرات باستخدام الأمر git commit.
+ +``` +git commit -m "Add to Contributors list" +``` + +
استبدل <your-name> باسمك.
+
+ +##
ارفع التغييرات إلى Push changes to Github - Github
+ +
ارفع التغييرات عن طريق الأمر git push
+ +``` +git push origin "add-your-name" +``` + +
استبدل <add-your-name> باسم الفرع الذي أنشأته من قبل.
+ +
+

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

+ +
في صفحة المشروع الخاصة بك يوجد زر Compare & pull request. اضغط على هذا الزر.
+ +create a pull request + +
والآن سلم طلبك لتتم مراجعته
+ +submit pull request + +
بعد المراجعة سوف أقوم بدمج تغييراتك إلى الفرع الرئيسي في المشروع. سيتم تنبيهك عن طريق البريد الإلكتروني بذلك.
+ +
الفرع الرئيسي الخاص بك لن يحتوي على هذه التغييرات. عليك مزامنته مع الفرع الرئيسي عن طريق الخطوات التالية.
+ +##
مزامنة نسختك مع المشروع الرئيسي
+ +
الخطوة الأولى، انتقل إلى الفرع الرئيسي.
+ +``` +git checkout master +``` + +
ثانياً، أضف رابط مشروعي كـupstream remote url.
+ +``` +git remote add upstream https://github.com/Roshanjossey/first-contributions +``` + +
بهذه الطريقة نخبر git أن هناك نسخة أخرى من هذا المشروع في هذا الرابط ونسميها upstream. +بعد أن أوافق على تغييراتك، قم بسحب النسخة الجديدة من المشروع عن طريق الأمر التالي: +
+ +``` +git fetch upstream +``` + +
هنا سنقوم بسحب جميع التغييرات من (upstream remote). والآن، عليك أن تدمج التحديثات الجديدة من فرعي إلى فرعك الرئيسي.
+ +``` +git rebase upstream/master +``` + +
وهنا تطبق التغييرات إلى الفرع الرئيسي. إذا رفعت التغييرات لفرعك الرئيسي سيتم تحديث مشروعك
+ +``` +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) | diff --git a/docs/translations/README.arm.md b/docs/translations/README.arm.md new file mode 100644 index 00000000..72c37831 --- /dev/null +++ b/docs/translations/README.arm.md @@ -0,0 +1,142 @@ +[![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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w) +[![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-ը clipboard-ում + +Օրինակ: + +```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 status + +Եթե ​​գնաք նախագծի գրացուցակ և կատարեք `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` կոճակը: Սեղմեք այդ կոճակի վրա. + +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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w). + +Հիմա եկեք սկսենք ձեր ներդրումն ունենալ այլ նախագծերում: Մենք կազմել ենք հեշտ խնդիրներ ունեցող նախագծերի ցանկ, որոնցից կարող եք սկսել: Ստուգեք [վեբ հավելվածի նախագծերի ցանկը](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) | + +

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

+

+ + + +

diff --git a/docs/translations/README.assamese.md b/docs/translations/README.assamese.md new file mode 100644 index 00000000..f1c6f8e2 --- /dev/null +++ b/docs/translations/README.assamese.md @@ -0,0 +1,166 @@ +[![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-2vqegkew0-ZuzGM1LO33C6Ts4nZyat1Q) +[![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 ব্যৱহাৰ কৰি ইয়াত tutorial আছে। + +fork this repository + +যদি আপোনাৰ মেচিনত git নাই, ইনষ্টল কৰক [install it](https://docs.github.com/en/get-started/quickstart/set-up-git). + +## এই ৰেপ'জিট'ৰিটো Fork কৰক +এই পৃষ্ঠাৰ ওপৰত থকা fork বুটামত ক্লিক কৰি এই ৰেপ'জিট'ৰিটো Fork কৰক। এইটো আপোনাৰ একাউণ্টত এই ৰেপ'জিট'ৰিটোৰ এটা কপি সৃষ্টি কৰিব। + +## ৰেপ'জিট'ৰিটো ক্লোন কৰক + +clone this repository + +এতিয়া fork কৰা ৰেপ'জিট'ৰিটো আপোনাৰ মেচিনত ক্লোন কৰক। আপোনাৰ GitHub একাউণ্টত যাওক, fork কৰা ৰেপ'জিট'ৰিটো খোলক, code বুটামত ক্লিক কৰক আৰু তাৰপিছত copy to clipboard আইকনটোত ক্লিক কৰক। + +টাৰ্মিনেল খোলক আৰু নিম্নলিখিত git কমাণ্ডটো চলাওক: + +```bash +git clone "url you just copied" +``` + +য'ত "url you just copied" (নাম উদ্ধৃতিহীন) হৈছে এই ৰেপ'জিট'ৰিটোৰ url (এই প্ৰকল্পৰ আপোনাৰ fork)। url পোৱা আগৰ পদক্ষেপসমূহ চাওক। + +copy URL to clipboard + +উদাহৰণ স্বৰূপে + +```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 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` বুটামটো দেখিব। এই বুটামটোত ক্লিক কৰক। + +create a pull request + +Pull Request জমা দিয়ক + +submit pull request + +আপোনাৰ পৰিবৰ্তনসমূহ তাড়তে প্ৰকল্পৰ মুখ্য শাখাত মিলাই দিম। পৰিবৰ্তনসমূহ মিলোৱা হ'লে আপুনি এটা অৱগতিমূলক ইমেইল লাভ কৰিব। + +## য়াৰ পৰা ক’লৈ যাব? +অভিনন্দন! আপুনি কেৱল সম্পূৰ্ণ কৰিলে 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-2vqegkew0-ZuzGM1LO33C6Ts4nZyat1Q). + +এতিয়া আপোনাক আন প্ৰকল্পত অৱদান কৰিবলৈ আৰম্ভ কৰা যাক। আমি সহজ সমস্যাসমূহ সহ কিছু প্ৰকল্পৰ তালিকা সংকলন কৰিছো যাৰ সহায়ত আপুনি আৰম্ভ কৰিব পাৰে। [ৱেব এপত প্ৰকল্পসমূহৰ তালিকা পৰীক্ষা কৰক](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) | + +

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

+

+ + + +

+ + diff --git a/docs/translations/README.aze.md b/docs/translations/README.aze.md new file mode 100644 index 00000000..971e7432 --- /dev/null +++ b/docs/translations/README.aze.md @@ -0,0 +1,116 @@ +[![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) + +# İ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)_ + +fork this repository + +#### 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 + +clone this repository + +İ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: + +``` +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. + +copy URL to clipboard + +Misal üçün: +``` +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ə): + +``` +cd first-contributions +``` +`git checkout` əmrini istifadə edərək bir Budaq (Branch) yaradın: +``` +git checkout -b +``` + +Misal üçün: +``` +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 status + +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: + +``` +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: + + +``` +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. + +create a pull request + +İndi çəkmə tələbini (pull request) göndərin. + +submit pull request + +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. + +Hər hansı bir köməyə ehtiyacınız və ya suallarınız olarsa, [Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) komandamıza qoşula bilərsiniz. + +İ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) | diff --git a/docs/translations/README.bg.md b/docs/translations/README.bg.md new file mode 100644 index 00000000..b0115c15 --- /dev/null +++ b/docs/translations/README.bg.md @@ -0,0 +1,124 @@ +[![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) + + +# Първи стъпки + +Трудно е. Когато правиш нещо за пръв път винаги е трудно. Още повече, когато се работи съвместно с други хора. Затова решихме да опростим процеса на учене за новобранците в допринасянето към отворен софтуер. + +Четенето на статии и гледането на видео уроци помага, но има ли по-добър учител от практиката в защитена среда? Целта на този проект е да напътства и опрости първите стъпки на новобранците в участието и приноса към отворен софтуер. Ако искате да направите първата си контрибуция и да станете част от обществото на отворен софтуер, следвайте стъпките по-долу. + +#### *Ако не се чувствате комфортно използвайки command line (терминал), [ето и уроци за използването на програми с графичен интерфейс](#Уроци-за-иползването-на-други-приложения)* + + +fork this repository + +Ако нямате git на вашия компютър, [инсталирайте го]( https://help.github.com/articles/set-up-git/). + +## Направете Разклонение (Fork) на това хранилище (repository) + +Направете разклонение на хранилището като натиснете бутона "Fork" в горната част на тази страница. +Това ще направи копие на това хранилище във вашия GitHub профил. + +## Клонирайте това хранилище + +clone this repository + +Сега клонирайте локално на вашия компютър разклоненото хранилище. Отидете във вашия GitHub профил, отворете разклоненото хранилище, +кликнете на бутона 'Clone' и копирайте линка или натиснете иконката 'copy to clipboard' (копирай в клипборда). + +Отворете терминал и въведете следната команда + +``` +git clone "линка който току-що копирахте" +``` +като на мястото на "URL-а който току-що копирахте" (без кавичките) поставете линка към това хранилище (Вашето Разклонение на този проект). Вижте +предните стъпки за това как да се сдобиете с линка. +copy URL to clipboard + +Например: +``` +git clone https://github.com/this-is-you/first-contributions.git +``` +Като на мястото на `this-is-you` се намира вашето потребителско име. В тази стъпка вие направихте копие на съдържанието на GitHub хванилището на 'first contributions' във вашия компютър. + +## Създайте клон (branch) + +Стигнете до местоположението във вашия компютър, където копирахте хранилището (ако вече не се намирате там): + +``` +cd first-contributions +``` +Сега създайте клон използвайки командата `git switch -c`: +``` +git switch -c +``` + +Например: +``` +git switch -c add-alonzo-church +``` +(Името на клона не е задължително да съдържа думата *add*, но е препоръчително, защото целта на този клон е да добавите името си към списък.) + +## Направете нужните промени и ги commit-нете + +Сега отворете файла `Contributors.md` в текстов редактор и добавете името си в него. Не го добавяйте в началото или края на файла. Поставете го някъде посредата. Сега запазете промените. + +git status + + +Ако навигирате през терминала до директорията на проекта и въведете командата `git status`, ще видите че има променени файлове. + + +ДОбавете тези промени към клона, който създадохте, използвайки командата `git add`: + +``` +git add Contributors.md +``` + +Сега commit-нете тези промени с командата `git commit`: +``` +git commit -m "Add to Contributors list" +``` +като смените `` с вашето име. + +## Качете (Push) промените в GitHub + +Качете вашите промени като въведете командата `git push`: +``` +git push origin +``` +сменяйки `` с името на клона, който създадохте по-рано. + +## Предайте вашите промени за рецензия + +Ако отидете във вашето хранилище в GitHub, ще видите бутона `Compare & pull request`. Натиснете го. + +create a pull request + +Сега предайте вашите промени за рецензия. + +submit pull request + +Скоро аз ще слея (merge) всички ваши промени в главния клон (мастер branch) на този проект. Вие ще бъдете уведомени по електронната поща когато това се случи. + +## От тук накъде? + +Поздравления! Вие току що изпълнихте стандарните _fork -> clone -> edit -> PR_ операции, които ще срещнете като сътрудник! + +Отпразнувайте вашия принос и го споделете с приятели и последователи като посетите [уеб приложението](https://firstcontributions.github.io/#social-share). + +Можете да се присъедините към нашия slack team в случай, че имате допълнителни въпроси или нужда от помощ [Присъединете се към slack team](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 | 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) | diff --git a/docs/translations/README.bih.md b/docs/translations/README.bih.md new file mode 100644 index 00000000..ff0b44b3 --- /dev/null +++ b/docs/translations/README.bih.md @@ -0,0 +1,124 @@ +[![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) + +# 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 + +clone this repository + +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) +``` + +copy URL to clipboard + +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. + +git status + +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. + +create a pull request + +a potom pošaljite zahtjev klikom na dugme _Create pull request_. + +submit pull request + +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). + +Pridružite se i našem Slack timu u slučaju da vam je potrebna ikakva pomoć ili imate bilo kakvih pitanja. [Slack tim](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.bn.md b/docs/translations/README.bn.md new file mode 100644 index 00000000..c5a73ce3 --- /dev/null +++ b/docs/translations/README.bn.md @@ -0,0 +1,135 @@ +[![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) + +# প্রথম অবদানসমূহ + +এই প্রকল্পের উদ্দেশ্য হলো নতুন ডেভেলপারদের তাদের প্রথম অবদানটি সহজ করা এবং নির্দেশনা দেওয়া। যদি আপনি আপনার প্রথম অবদান করতে চান, তবে নীচের ধাপগুলি অনুসরণ করুন। + +প্রবন্ধ পড়ে এবং টিউটোরিয়াল দেখে অনেক কিছুই শেখা যায়, কিন্তু ব্যবহারিক পদ্ধতিতে কাজ করার চেয়ে উপযোগী কিছু হতে পারে না। এই প্রজেক্টের লক্ষ্য হচ্ছে নবীনদের দিকনির্দেশনা দেওয়া আর সেই সাথে তাদের প্রথম অবদান রাখার কাজটি সহজ করে তোলা। আপনি যদি ওপেন সোর্সে আপনার প্রথম অবদান রাখতে চান, তাহলে নিচের সহজ ধাপগুলো অনুসরণ করুন। কথা দিচ্ছি, এই প্রক্রিয়াটি অত্যন্ত মজার ও আনন্দদায়ক। + +#### _যদি কমান্ড লাইনে সমস্যা হয়, [তবে নীচে একটি GUI টুল ব্যবহার করে টিউটোরিয়াল দেওয়া হয়েছে।](#অন্যান্য-টুল-ব্যবহারের-টিউটোরিয়াল)_ + + +fork this repository + +আপনার কম্পিউটারে গিট না থাকলে, [ ইনস্টল করুন ](https://help.github.com/articles/set-up-git/)। + +## এই রিপোজিটরি ফর্ক করুন + +এই রিপোজিটরি ফর্ক করতে 'ক্লিক এর মাধ্যমে' এই পৃষ্ঠার উপরে ফর্ক বাটনে ক্লিক করুন। +এটি আপনার অ্যাকাউন্টে এই রিপোজিটরির একটি কপি তৈরি করবে। + +## রিপোজিটরি ক্লোন করুন + +clone this repository + +এখন এই রিপোজিটরিটি আপনার কম্পিউটারে ক্লোন করুন। এজন্যে প্রথমে ক্লোন(Clone) বাটনে ক্লিক করুন। এরপর ক্লিক করুন _ক্লিপবোর্ডে কপি করুন(copy to clipboard)_ আইকনটিতে। + +আপনার টার্মিনাল (উইন্ডোজের ক্ষেত্রে কমান্ড প্রম্পট (CMD)) চালু করুন এবং নিচের কমান্ড রান করুন : + +``` +git clone "url you just copied" +``` + +যেখানে "url you just copied" (উদ্ধৃতি চিহ্ন ব্যতীত) হচ্ছে এই রিপোজিটরির ইউআরএল যা আপনি পূর্বের ধাপেই পেয়েছেন। + +copy URL to clipboard + +যেমন: + +``` +git clone https://github.com/this-is-you/first-contributions.git +``` + +এখানে `this-is-you` হচ্ছে আপনার গিটহাব ইউজারনেম। এই কমান্ডটির মাধ্যমে আপনার কম্পিউটারে গিটহাবে অবস্থিত first-contributions রিপোজিটরির একটি কপি তৈরি হবে। + +## একটি ব্রাঞ্চ তৈরি করুন + +আপনার কম্পিউটারে রিপোজিটরির ডিরেক্টরিতে যান (যদি এখনো অন্য ডিরেক্টরিতে থাকেন) : + +``` +cd first-contributions +``` + +এখন `git switch` কমান্ডের মাধ্যমে একটি ব্রাঞ্চ তৈরি করুন : + +``` +git switch -c +``` + +যেমন : + +``` +git switch -c add-alonzo-church +``` + +(ব্রাঞ্চের নামে _add_ শব্দটি যুক্ত থাকা জরুরী নয়। তবে এই ব্রাঞ্চের উদ্দেশ্য যেহেতু আপনার নাম তালিকাভুক্ত করা, সেহেতু _add_ শব্দটি যুক্ত থাকাই কাম্য।) + +## প্রয়োজনীয় পরিবর্তন করুন ও পরিবর্তনগুলো কমিট করুন + +এখন যে কোন টেক্সট এডিটরে `Contributors.md` ফাইলটি খুলুন, এতে আপনার নাম যুক্ত করুন, অতঃপর ফাইলটি সেভ করুন। এবার প্রজেক্ট ডিরেক্টরি থেকে `git status` কমান্ড রান করলে আপনি পরিবর্তনগুলো দেখতে পাবেন। `git add` কমান্ড দ্বারা এই পরিবর্তনগুলো আপনার তৈরি ব্রাঞ্চে যুক্ত করুন : + +``` +git add Contributors.md +``` + +এরপর `git commit` কমান্ড ব্যবহার করে এই পরিবর্তনগুলো কমিট করুন : + +``` +git commit -m "Add to Contributors list" +``` + +``-এর বদলে আপনার নাম লিখতে ভুলবেন না। + +## পরিবর্তনগুলো গিটহাবে পুশ করা + +`git push` কমান্ড ব্যবহার করে পরিবর্তনগুলো পুশ করুন : + +``` +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` বাটনে ক্লিক করুন। + +create a pull request + +এখন _পুল রিকোয়েস্ট_ সাবমিট করুন। + +submit pull request + +শীঘ্রই আমি এই প্রজেক্টের মাস্টার ব্রাঞ্চে আপনার সমস্ত পরিবর্তন গুলো মার্জ করব। পরিবর্তনগুলি একত্রিত হয়ে গেলে আপনি একটি নিশ্চিতকরণ ই-মেইল পাবেন৷ + +## এরপর কী করব? + +আপনার অবদানের আনন্দ উপভোগ করুন এবং [ওয়েব অ্যাপ](https://firstcontributions.github.io/#social-share)-এর মাধ্যমে বন্ধু ও অনুসরণকারীদের সাথে শেয়ার করুন। + +কোনো সহায়তার প্রয়োজন হলে বা আপনার কোনো প্রশ্ন থাকলে আপনি আমাদের স্ল্যাক টিমে যুক্ত হতে পারেন। [স্ল্যাক টিমে যোগ দিন](https://firstcontributions.herokuapp.com) + +এখন আপনি অন্যান্য প্রজেক্টগুলোতেও অবদান রাখতে পারেন। আপনার সুবিধার্থে আমরা সহজ সমস্যা সম্বলিত প্রজেক্টগুলোর একটি তালিকা তৈরি করেছি। ওয়েব অ্যাপে [প্রজেক্টগুলোর তালিকা](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) | diff --git a/docs/translations/README.by.md b/docs/translations/README.by.md new file mode 100644 index 00000000..ab624d83 --- /dev/null +++ b/docs/translations/README.by.md @@ -0,0 +1,151 @@ +[![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) + +# Першы ўклад у праект + +Складана. Заўсёды складана пачынаць нешта з самага пачатку. Даволі непрыемна рабіць памылкі, асабліва калі вы працуеце ў камандзе. Увесь open source складаецца з супрацоўніцтва і сумеснай працы. Мы хочам аблегчыць першыя крокі ў навучанні і супрацоўніцтве пачаткоўцам распрацоўнікам. + +Чытанне артыкулаў і падручнікаў можа дапамагчы, але што можа быць лепш, чым сапраўдны практычны вопыт, без рызыкі што-небудзь сапсаваць. Мэта гэтага праекта - належным чынам накіраваць маладых навабранцаў, а таксама даць ім магчымасць зрабіць іх першы ўклад. Памятаеце: чым менш вы напружаныя, тым лепш вы вучыцеся. Калі вы шукаеце магчымасць ажыццявіць свой першы ўклад, проста прытрымлівайцеся простым крокам, размешчаным ніжэй. Абяцаем, будзе цікава. + +fork this repository + + +Калі ў вас не ўсталяваны git на кампутары, [ ўсталюйце яго ]( https://help.github.com/articles/set-up-git/ ) + +## Стварыце асобную галінку + +Стварыце асобную галінку, націснуўшы на кнопку `fork` зверху гэтай старонкі. Такім чынам вы створыце копію гэтага рэпазітара ў сваім запісе. + +## Капіюйце рэпазітар + +clone this repository + +Цяпер каб скапіяваць ваш рэпазітар на персанальны кампутар. Націсніце на кнопку `clone`, а затым на абразок `copy to clipboard`, каб скапіяваць спасылку. + +Адкрыйце тэрмінал і запусціце наступную git каманду: + +``` +git clone "url you just copied" +``` +Дзе "url you just copied" (без двукоссяў) гэта спасылка на ваш рэпазітар. Паглядзіце папярэднія крокі, каб атрымаць гэтую спасылку. + +copy URL to clipboard + +Напрыклад: +``` +git clone https://github.com/this-is-you/first-contributions.git +``` +Дзе `this-is-you` ваш лагін на github. Такім чынам вы капіруеце рэпазітар 'first-contributions' з GitHub на ваш персанальны кампутар. + +## Стварыце галінку + +Перайдзіце ў каталог рэпазітара на вашым кампутары, калі вы яшчэ не там. + +``` +cd first-contributions +``` +Цяпер стварыце галінку, з дапамогай `каманды git checkout` + +``` +git checkout -b +``` + +Напрыклад: +``` +git checkout -b add-alonzo-church +``` +(Сінтаксічную не патрабуецца, каб назва галіны ўтрымлівала слова * add *, але гэта апраўдана, паколькі падкрэслівае прызначэнне гэтай галіны - дадаць ваша імя ў спісы.) + +## Занясіце неабходныя змены і стварыце commit + +Цяпер адкрыйце файл `Contributors.md` ў вашым тэкставым рэдактары, запішыце ваша імя і захавайце файл. Калі вы пяройдзеце ў дырэкторыю праекта і выканайце `git status`, вы ўбачыце змены. Дадайце гэтыя змены з дапамогай каманды `git add`. + +``` +git add Contributors.md +``` + +Цяпер занясіце дадзеныя змены з дапамогай каманды `git commit`. +``` +git commit -m "Add to Contributors list" +``` +Зменіце `` на ваша імя + +## Занясіце дадзеныя змены на github + +Занясіце вашыя змены з дапамогай каманды `git push` +``` +git push origin +``` +Зменіце `` на імя галіны, якую вы стварылі раней. + +## Пацвердзіце змены для праверкі вашага кода + +Калі вы зойдзеце ў свой рэпазітар на GitHub, вы ўбачыце кнопку `Compare & pull request`. Націсніце на яе. + +create a pull request + +Цяпер пацвердзіце pull-request. + +submit pull request + +Хутка я ўчыню аб'яднанне ўсіх вашых змяненняў з асноўнай галіной гэтага праекта. Вы атрымаеце паведамленне па электроннай пошце, калі змены будуць прынятыя (ўнесены ў галоўную галіну). + +Асноўная галіна вашага рэпазітара не будзе зменена. Для сінхранізацыі выканайце крокі, размешчаныя ніжэй. + +## Сінхранізуецца ваша адгалінаванне з дадзеным рэпазітаром + +Перш за ўсё перайдзіце ў асноўную галіну: +``` +git checkout master +``` +Затым дадайце url майго рэпазітара ў полі `upstream remote url`: +``` +git remote add upstream https://github.com/Roshanjossey/first-contributions +``` +Такім чынам мы паведамім git, што існуе іншая версія дадзенага праекта па пэўнай спасылцы, і мы яе лічым майстрам. Як толькі змены смержены, падгрузіць новую версію майго рэпазітара. +``` +git fetch upstream +``` + +Такім чынам мы забралі ўсе змены ў маім адгалінаванні (upstream remote). Пасля, вам трэба зліць новую версію майго рэпазітара з вашай майстар-галіной. +``` +git rebase upstream/master +``` +Так вы ўжываеце ўсе змены, якія вы падцягнулі да вашай майстар-галіны. Калі вы запушите зараз майстар-галіна, ваша адгалінаванне таксама будзе ўтрымліваць змены. +``` +git push origin master +``` +Звярніце ўвагу, што вы робіце push ў выдаленай рэпазітар origin. + +На гэтым этапе я аб'яднаў вашу галіну `` са сваёй майстар-галіной, а вы аб'ядналі сваю майстар-галіна з маёй. Ваша галіна больш не патрэбна, вы можаце выдаліць яе: +``` +git branch -d +``` +Таксама можаце выдаліць яе версію ў аддаленым рэпазітары: +``` +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) | diff --git a/docs/translations/README.ca.md b/docs/translations/README.ca.md new file mode 100644 index 00000000..94a928f9 --- /dev/null +++ b/docs/translations/README.ca.md @@ -0,0 +1,122 @@ +[![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) + + +# Primeres Contribucions + +És difícil. Sempre es 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: + +``` +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: +``` +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): + +``` +cd first-contributions +``` +Crea una nova branca (*branch*) utilitzant el comandament `git checkout`: +``` +git checkout -b +``` + +Per exemple: +``` +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. + +git status + + +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`: + +``` +git add Contributors.md +``` + +Confirma (*commit*) els canvis utilitzant el comandament `git init`: +``` +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`: +``` +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 respositori a GitHub, veuràs un botó `Compare & pull request` (Compara i fes una solicitud d'incorporació). Fes clic en aquest botó. + +crear una pull request + +Envia la solicitud 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). + +Podeu unir-vos al nostre equip d'*slack* en cas de que necessiteu ajuda o tingueu alguna pregunta. [Unir-se a l'equip d'slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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 + +| 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](https://www.jetbrains.com/idea/download/#section=windows) | diff --git a/docs/translations/README.col.md b/docs/translations/README.col.md new file mode 100644 index 00000000..290d5f61 --- /dev/null +++ b/docs/translations/README.col.md @@ -0,0 +1,129 @@ +[![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: + +``` +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: + +``` +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í). + +``` +cd first-contributions +``` + +Ahora crea una rama (_branch_) usando el comando `git checkout`: + +``` +git checkout -b +``` + +Por ejemplo: + +``` +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. + +git status + +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`: + +``` +git add Contributors.md +``` + +Ahora hacele un _commit_ a esos cambios ejecutando el comando `git commit`: + +``` +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`: + +``` +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) | diff --git a/docs/translations/README.cs.md b/docs/translations/README.cs.md new file mode 100644 index 00000000..294ec6ad --- /dev/null +++ b/docs/translations/README.cs.md @@ -0,0 +1,127 @@ +[![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) + + +# 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: + +``` +git clone "url které jste právě zkopírovali" + +``` + +zkopírujte adresu do schránky + +Například: + +``` +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) + +``` +cd first-contributions +``` + +Nyní vytvořte novou větev (anglicky *branch*) za použití příkazu `git checkout`: + +``` +git checkout -b +``` + +Například: +``` +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`: + +``` +git add Contributors.md +``` + +Zbývá už jen potvrdit (anglicky *commit*) změny příkazem `git commit`: + +``` +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`: + +``` +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). + +V případě, že byste měli jakékoliv otázky nebo potřebovali pomoct, můžete se [přidat k našemu Slack teamu](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.da.md b/docs/translations/README.da.md new file mode 100644 index 00000000..5e942c62 --- /dev/null +++ b/docs/translations/README.da.md @@ -0,0 +1,123 @@ +[![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) + + +# 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)* + + +fork this 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 this 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: + +``` +git clone "din url" +``` + +hvor "din url" skal erstattes med den URL du kopieret i forrige trin. + +copy URL to clipboard + +Eksempel: +``` +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): + +``` +cd first-contributions +``` +Derefter opretter du en branch med kommandoen `git checkout`: +``` +git checkout -b +``` + +Eksempel: +``` +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`: +``` +git add Contributors.md +``` + +Derefter commit ændringerne med kommandoen `git commit`: +``` +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`: +``` +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. + +create a pull request + +Indgiv nu din pull request. + +submit 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 er velkommen til at kigge forbi vores Slack hvis du mangler hjælp, eller har spørgsmål. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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 | 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) | diff --git a/docs/translations/README.de.md b/docs/translations/README.de.md new file mode 100644 index 00000000..6000ec3c --- /dev/null +++ b/docs/translations/README.de.md @@ -0,0 +1,122 @@ +[![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 + +Repository forken + +Aller Anfang ist schwer. Gerade dann, wenn wir gemeinsam an etwas arbeiten, will niemand etwas Falsches tun. Aber Open Source dreht sich um Kooperation und lebt von den Beiträgen vieler Freiwilliger. Deshalb haben wir es uns zur Aufgabe gemacht, neuen Mitgliedern in der Open-Source-Gemeinde ihre ersten Schritte so einfach wie möglich zu machen. + +Natürlich helfen die vorhandenen Artikel und Videoanleitungen. Aber was kann besser sein, als es einfach einmal auszuprobieren mit dem Wissen, dass man nichts kaputt machen kann? Dieses Projekt will Anfängern zeigen, wie sie möglichst einfach ihren ersten Beitrag leisten. Bedenke: Je entspannter du bist, desto besser lernst du. Wenn du deinen ersten Beitrag leisten möchtest, folge diesen einfachen Schritten. Wir versprechen dir, es wird Spaß machen. + +Wenn du Git noch nicht installiert hast, [installiere es](https://help.github.com/articles/set-up-git/) + +## Repository forken + +Forke das Repository durch das Anklicken der Schaltfläche "Fork". Dadurch erhältst du deine eigene Version des Projektes in deinem Profil. + +## Repository klonen + +Repository klonen + +Klone das Repository auf deinen Computer. Klicke auf die Schaltfläche "Clone or download" und anschließend auf das "copy to clipboard"-Symbol. + +Öffne eine Kommandozeile und gib den folgenden git-Befehl ein: + +``` +git clone "Deine kopierte URL" +``` + +Statt 'Deine kopierte URL' (ohne Anführungszeichen) füge die Repository-URL aus dem vorherigen Schritt ein. + +URL kopieren + +Beispiel: + +``` +git clone https://github.com/dein-Name/first-contributions.git +``` + +An der Stelle 'dein-Name' muss dein GitHub-Nutzername stehen. Mit diesem Befehl kopierst du den Inhalt deines first-contributions-Repository von GitHub auf deinen Computer. + +## Erstelle einen Branch + +Wechsle zum Repository-Verzeichnis auf deinem Computer (falls du es nicht schon getan hast). + +``` +cd first-contributions +``` + +Erstelle nun einen Branch mit dem Befehl `git checkout`: + +``` +git checkout -b +``` + +Beispiel: + +``` +git checkout -b add-max-mustermann +``` + +(Der Name des Branches muss nicht unbedingt das Wort _add_ beinhalten aber hier ist es sinnvoll, denn der Zweck deines Branches ist es ja, deinen Namen zur Liste hinzuzufügen.) + +## Mache die nötigen Änderungen und committe sie + +Öffne `Contributors.md` in einem Text-Editor und füge deine Namen hinzu. Beachte, dass du den Namen nicht am Anfang oder am Ende der Datei hinzufügst. Speichere die Datei anschließend. + +Gibst du in der Kommandozeile nun `git status` ein, siehst du die Änderungen. + +Füge die Änderungen mit dem Befehl `git add` zu deinem eben erstellten Branch hinzu: + +``` +git add Contributors.md +``` + +Nun committest du deine Änderungen mit `git commit`: + +``` +git commit -m "Add to Contributors list" +``` + +Ersetze `` mit deinem Namen. + +## Pushe die Änderung zu GitHub + +Pushe die Änderungen mit `git push`: + +``` +git push origin +``` + +Ersetze `` mit dem Namen des Branches, den du zuvor erstellt hast. + +## Sende deine Änderungen zum Review + +Wenn du jetzt zu deinem Repository auf GitHub gehst, siehst du einen Knopf `Compare & pull request`. Klicke darauf. + +Erstelle einen pull request + +Erstelle einen Pull Request indem du auf die Schaltfläche `Create pull request` klickst. + +Pull Request senden + +Roshan Jossey wird nun deine Änderungen in den Master Branch dieses Projekts mergen. Du erhältst eine E-Mail, sobald dies geschehen ist. + +## Wie geht es weiter? + +Glückwunsch! Du hast so eben den Standard-Workflow _Fork -> Clone -> Edit -> Pull Request_ beendet, der dir als Mitwirkender häufig begegnen wird. + +Feiere deinen Beitrag zum Projekt und teile ihn mit deinen Freunden und Followern über unsere [Web-App](https://firstcontributions.github.io/#social-share). + +Wenn du weitere Fragen hast, kannst du Mitglied in unserem Slack-Team werden. [Werde Teil des Teams auf Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +Falls du jetzt zu anderen Projekten beitragen möchtest, dann haben wir für dich eine Liste von einfachen, ersten Issues zusammengestellt, an denen du arbeiten kannst. Diese Projekt-Liste findest du [in unserer Web-App](https://firstcontributions.github.io/#project-list). + +## Tutorials mit anderen 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) | diff --git a/docs/translations/README.dz.md b/docs/translations/README.dz.md new file mode 100644 index 00000000..b523d9cd --- /dev/null +++ b/docs/translations/README.dz.md @@ -0,0 +1,143 @@ +[![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 : + +``` +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 : +``` +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) + +``` +cd first-contributions +``` + +Dourka ecréyé far3e be la commande `git checkout` : + +``` +git checkout -b +``` + +Mithale : +``` +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` : +``` +git add Contributors.md +``` + +Dourka, kemel commité hadouk étaghyérates be la commande `git commit`: + +``` +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` : +``` +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. + +create a pull request + +Dourka présenter el talebe diyalek lel fahsse. + +submit 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 + ``` + git checkout main + ``` + + Zide l'url ta3 el garage ta3ek ki `upstream remote url` : +``` +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 : +``` +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 : +``` +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 : +``` +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 : + +``` +git branch -d +``` +wa aydan te9dere tenihi la version ta3ou fel far3e el be3ide tani : +``` +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) | diff --git a/docs/translations/README.ec.md b/docs/translations/README.ec.md new file mode 100644 index 00000000..924af662 --- /dev/null +++ b/docs/translations/README.ec.md @@ -0,0 +1,120 @@ +[![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 + +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 eres un neófit@ con la linea de comandos, [](#Tutoriales-usando-otras-herramientas)* + +fork de este repositorio + +En caso de no tener instalado Git en tu equipo, te dejo una para [guia]( https://git-scm.com/book/es/v2/Inicio---Sobre-el-Control-de-Versiones-Instalaci%C3%B3n-de-Git) para instalarlo. + +## Has 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. + +## Has 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 `clone or download` y luego has clic en el ícono para `copy`. + +Abre tu 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 se veria algo asi `https://github.com//first-contributions.git`(tu *fork* a este proyecto). + +copiar URL al portapapeles + +Por ejemplo: +``` +git clone https://github.com//first-contributions.git +``` +Donde `` es tu usuario de GitHub. Con este comando estas copiando loslos 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`: +``` +git checkout -b +``` + +Por ejemplo: +``` +git checkout -b add-julio-jaramillo +``` + +## 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. Guarda el archivo. + +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 + +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. + +crea 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 [web app](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 Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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)| diff --git a/docs/translations/README.eg.md b/docs/translations/README.eg.md new file mode 100644 index 00000000..17f2b585 --- /dev/null +++ b/docs/translations/README.eg.md @@ -0,0 +1,154 @@ +[![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 على جهازك حمله من هنا. +
+ +##
أفصل المشروع دة - Fork this Repository
+fork this repository +
+خد نسخة من المشروع دة (أو افصله) عن طريق انك تدوس على Fork في أعلى الصفحة. +لو عملت كدة فأنت اخدت نسخة من الفولدر دة فى حسابك على github. +
+ +##
إنسخ المشروع دة - Clone the repository
+ +clone this repository + +
+انسخ المشروع دة لجهازك. +دوس على Clone بعدين دوس على أيقونة Copy to clipboard +
+copy URL 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> بإسم الفرع اللي انت لسة عامله .
+ + +
+

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

+ + +
في صفحة المشروع بتاعك على صفحتك الشخصية على github دوس على زرار Compare & pull request. هو ماكنش ظاهر قبل كدة.
+ +create a pull request + +
دلوقتي هتسلم طلبك لصاحب المشروع الأساسي عشان يراجع عليه، في الحالة دي الطلب بتاعك هيوصلي.
+ +submit pull request + +
بعد المراجعة هدمج تغيرراتك للفرع الرئيسي في المشروع. وهيتم تنبيهك عن طريق البريد الإلكتروني بدة.
+ +
لما يحصل وأقبل طلبك هتلاقي ان المشروع المنسوخ على حسابك مفيهوش التغيررات. فلازم تزامن المشروع الرئيسي باللي على حسابك بالخطوات دي:
+ + +##
طب اعمل ايه بعد كدة؟
+ +
+ احتفل بأول مساهمة ليك، أعمل شير مع صحابك ومتابعينك عن طريق زيارة الموقع دة. +
+ +
ممكن تنضم للفريق على Slack لو حابب تساعد او عندك أسئلة. إنضم للفريق على Slack
+ +
+ +
يلا نخليك تبدأ تساهم في مشاريع بجد؟ عملنا قائمة بمشاريع بمشاكل بسيطة ممكن تبدأ بيها النهاردة.
+ + +## + +##
لو هتستخدم ادوات تانية ممكن تتعلم من هنا
+ +| 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) | diff --git a/docs/translations/README.en-pirate.md b/docs/translations/README.en-pirate.md new file mode 100644 index 00000000..06e48bac --- /dev/null +++ b/docs/translations/README.en-pirate.md @@ -0,0 +1,130 @@ +[![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 + +'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)* + +fork this repository + +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 + +clone this repository + +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: + +``` +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. + +copy URL to clipboard + +Fer example: + +``` +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): + +``` +cd first-contributions +``` + +Now create a branch usin' th' `git checkout` command: + +``` +git checkout -b +``` + +Fer example: + +``` +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. + +git status + +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: + +``` +git add Contributors.md +``` + +Now commit those changes usin' th' `git commit` command: + +``` +git commit -m "Add to Contributors list" +``` + +replacing `` with your name. + +## Push changes t' GitHub + +Push yer changes usin' th' command `git push`: + +``` +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. + +create a pull request + +Now submit th' pull request. + +submit pull request + +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). + +Ye could join our slack crew in case ye needs any help or 'ave any riddles. [Join our slack crew](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.eo.md b/docs/translations/README.eo.md new file mode 100644 index 00000000..dda4aa3b --- /dev/null +++ b/docs/translations/README.eo.md @@ -0,0 +1,133 @@ +[![Amo al Malferma Kodo](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) +[![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)* + +fork de este repositorio + +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 status + +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). + +Vi ankaŭ povas aliĝi al nia Slack-teamo se vi bezonas helpon aŭ havas demandojn. [Aliĝu al nia Slack-teamo](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.es.md b/docs/translations/README.es.md new file mode 100644 index 00000000..56cbc176 --- /dev/null +++ b/docs/translations/README.es.md @@ -0,0 +1,125 @@ +[![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 + +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)* + +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: + +``` +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 URL al portapapeles + +Por ejemplo: +``` +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). + +``` +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-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. + +git status + +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`: + +``` +git add Contributors.md +``` + +Ahora haz un *commit* sobre estos cambios ejecutando el comando `git commit`: +``` +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`: +``` +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. + +crea 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). + +También podrías unirte a nuestro *equipo* de Slack en caso de que necesites ayuda o tengas alguna pregunta. [Únete a nuestro Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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 + +| 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) | diff --git a/docs/translations/README.et.md b/docs/translations/README.et.md new file mode 100644 index 00000000..e0a5a6c2 --- /dev/null +++ b/docs/translations/README.et.md @@ -0,0 +1,131 @@ +# የመጀመሪያ አስተዋጽዖዎች + +ይህ ፕሮጀክት ጀማሪዎች የመጀመሪያ አስተዋፅዖቸውን እንዲያደርጉ መንገዱን ለማቅለል እና ለመምራት ያለመ ነው። የመጀመሪያውን አስተዋፅዖ ማድረግ ከፈለጉ ከታች ያሉትን ደረጃዎች ይከተሉ። + +_በትእዛዝ መስመሩ ካልተመቻችሁ [የጂአይ መሳሪያዎችን በመጠቀም መማሪያ ይኸውና](#መማሪያዎች-ሌሎች-መሳሪያዎችን-በመጠቀም)_ + + +fork this repository + +#### በማሽንዎ ላይ git ከሌለዎት፣ [ጫን](https://docs.github.com/en/get-started/quickstart/set-up-git)። + +## ይህንን ማከማቻ ሹካ ያድርጉ + +በዚህ ገጽ ላይኛው ክፍል ላይ ያለውን የሹካ ቁልፍ ጠቅ በማድረግ ይህንን ማከማቻ ሹካ ያድርጉት። +ይህ በአንተ መለያ ውስጥ የዚህን ማከማቻ ቅጂ ይፈጥራል። + +## ማከማቻውን መዝጋት + +clone this repository + +አሁን የሹካውን መያዣ ወደ ማሽንዎ ያያይዙት. ወደ GitHub መለያዎ ይሂዱ፣ የሹካ ማከማቻውን ይክፈቱ፣ የኮድ አዝራሩን ጠቅ ያድርጉ እና ከዚያ _copy to clipboard_ አዶን ጠቅ ያድርጉ። + +ተርሚናል ይክፈቱ እና የሚከተለውን የgit ትዕዛዝ ያሂዱ፡- + +``` +git clone "ዩአርኤሉን አሁን ቀድተሃል።" +``` + +"ዩአርኤል አሁን የገለበጡት" (ያለ ጥቅሶች) ወደዚህ ማከማቻ ዩአርኤል (የዚህ ፕሮጀክት ሹካ) የሆነበት። ዩአርኤሉን ለማግኘት የቀደመውን ደረጃዎች ይመልከቱ። + +ዩአርኤልን ወደ ክሊፕቦርድ ቅዳ + +ለምሳሌ: + +``` +git clone https://github.com/ይህ አንተ ነህ።/first-contributions.git +``` + +የ GitHub ተጠቃሚ ስምህ የት `ይህ አንተ ነህ።' እዚህ በ GitHub ላይ ያለውን የመጀመሪያ አስተዋፅዖ ማከማቻ ይዘቶችን ወደ ኮምፒውተርዎ እየገለበጡ ነው። + +#ቅርንጫፍ ፍጠር + +በኮምፒውተርዎ ላይ ወዳለው የማከማቻ ማውጫ ይቀይሩ (እዚያ ከሌለዎት)፡- + +``` +cd first-contributions +``` + +አሁን የ`git switch` ትዕዛዝን በመጠቀም ቅርንጫፍ ይፍጠሩ፡ + +``` +git switch -c የእርስዎ-አዲሱ-ቅርንጫፍ-ስም +``` + +ለምሳሌ: + +``` +git switch -c add-alonzo-church +``` + +## አስፈላጊ ለውጦችን ያድርጉ እና ለውጦችን ያድርጉ + +አሁን የ`Contributors.md` ፋይልን በጽሑፍ አርታኢ ውስጥ ይክፈቱ፣ ስምዎን በእሱ ላይ ያክሉ። በፋይሉ መጀመሪያ ወይም መጨረሻ ላይ አይጨምሩት። በመካከል የትኛውም ቦታ ላይ ያስቀምጡት. አሁን, ፋይሉን ያስቀምጡ. + +git status + +ወደ የፕሮጀክት ማውጫው ሄደው ትዕዛዙን `git status` ከፈጸሙ፣ ለውጦች እንዳሉ ያያሉ። + +የ `git add` ትዕዛዙን በመጠቀም እነዚያን ለውጦች ወደ ፈጠሩት ቅርንጫፍ ያክሉ። + +``` +git add Contributors.md +``` +አሁን የ‹git› ትዕዛዙን በመጠቀም እነዚህን ለውጦች ያድርጉ፡ + +``` +git commit -m "ስሜን ወደ አስተዋጽዖ አበርካቾች ዝርዝር ጨምር" +``` + +'ስሜን' በስምህ በመተካት። + +## ለውጦችን ወደ GitHub ይግፉ + +የ `git push` ትዕዛዝን በመጠቀም ለውጦችዎን ይግፉ፡- + +``` +git push -u origin የእርስዎ-ቅርንጫፍ-ስም +``` + +replacing `የእርስዎ-ቅርንጫፍ-ስም` with the name of the branch you created earlier. + +
+ በመግፋት ላይ ማንኛውም ስህተት ካጋጠመህ እዚህ ጠቅ አድርግ፡- + +- ### የማረጋገጫ ስህተት + 
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) ይሂዱ የኤስኤስኤች ቁልፍን ወደ መለያዎ ማመንጨት እና ማዋቀር። + +
+ +## ለውጦችዎን ለግምገማ ያስገቡ + +በ GitHub ላይ ወደ ማከማቻዎ ከሄዱ፣ `Compare and Pull Request` የሚለውን ቁልፍ ያያሉ። በዚያ ቁልፍ ላይ ጠቅ ያድርጉ። + +የመጎተት ጥያቄ ፍጠር + +አሁን የመሳብ ጥያቄውን ያስገቡ። + +ጥያቄን ጎትት + +በቅርቡ ሁሉንም ለውጦችዎን ወደ የዚህ ፕሮጀክት ዋና ቅርንጫፍ አዋህዳለሁ። ለውጦቹ ከተዋሃዱ በኋላ የማሳወቂያ ኢሜይል ይደርስዎታል። + +## ከዚህ ወዴት ልሂድ? + +እንኳን ደስ ያለህ! ልክ እንደ አስተዋጽዖ አበርካች የሚያጋጥሙትን መደበኛ _fork -> clone -> አርትዕ -> የመሳብ ጥያቄ_ የስራ ፍሰትን አጠናቀዋል! + +አስተዋፅኦዎን ያክብሩ እና ወደ [ድር መተግበሪያ](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 | 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) | diff --git a/docs/translations/README.ewe.md b/docs/translations/README.ewe.md new file mode 100644 index 00000000..4f28afd7 --- /dev/null +++ b/docs/translations/README.ewe.md @@ -0,0 +1,141 @@ +[![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/) +[](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) + + +# 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. + +ŋe asi ɖe nu sia ŋu + +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 + +Wɔ numekugbalẽvi sia ƒe kɔpi + +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 : + +``` +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. + +copier l'URL dans le presse-papier + +Le kpɔɖeŋu me : +``` +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): + +``` +cd first-contributions +``` +Azɔ wɔ alɔdze aɖe kple sededea `git checkout` : +``` +git checkout -b +``` + +Le kpɔɖeŋu me : +``` +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. 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` : +``` +git add Contributors.md +``` + +Azɔ wɔ tɔtrɔ siawo kple sededea `git commit`: +``` +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` : +``` +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. + +create a pull request + +Azɔ tsɔ hehe ƒe biabiaa ɖo ɖa. + +submit pull request + +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) + ``` + git checkout main + ``` + + Eye nàtsɔ nye nyatakakadzraɖoƒe ƒe ka akpee be `upstream remote url` : +``` +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: +``` +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: +``` +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: +``` +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: +``` +git branch -d +``` +eye àte ŋu atutu eƒe tɔtrɔ le adzɔge ʋĩ ƒe nyatakakadzraɖoƒe hã: +``` +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) diff --git a/docs/translations/README.fa.md b/docs/translations/README.fa.md new file mode 100644 index 00000000..c1209ccf --- /dev/null +++ b/docs/translations/README.fa.md @@ -0,0 +1,130 @@ +[![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) + +

+ +# اولین مشارکت + +این پروژه قصد دارد تا مسیر مشارکت در پروژه‌های متن‌باز را برای تازه‌کارها آسان نماید. اگر شما نیز به دنبال راهی برای ثبت اولین مشارکت خود هستید، این اقدامات را دنبال کنید. + +_اگر با محیط کامندی (CLI) احساس راحتی نمی‌کنید، [راهنمای استفاده از ابزارهای گرافیکی (GUI) را مشاهده کنید](#آموزش-انجام-مشارکت-در-دیگر-ابزارها)._ + +fork this repository + +#### اگر نرم‌افزار git را آماده ندارید، [از اینجا نصب کنید](https://help.github.com/articles/set-up-git/). + +## مخزن را فورک کنید + +با کلیک کردن بر روی دکمه Fork، از مخزن مورد نظر یک انشعاب بگیرید. این عملیات یک نسخه کپی از مخزن را بر روی حساب کاربری شما ایجاد می‌کند. + +## مخزن را کلون (شبیه) کنید + +clone this repository + +حال، از مخزن فورک شده، یک کلون روی سیستم کاربری خود ایجاد کنید. وارد حساب کاربری خود شده و مخزن فورک شده را باز کنید. دکمه Code را فشرده و نماد copy to clipboard را انتخاب کنید. + +سپس یک ترمینال باز کنید و دستور گیت زیر را اجرا نمایید: + +```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` برابر با نام حساب کاربری گیت‌هاب شما باشد. با این اقدام، تمام محتوای مورد نیاز جهت مشارکت را بر روی سیستم خود آماده می‌سازید. + +### یک شاخه ایجاد کنید + +اگر در مسیر مخزن کلون شده قرار ندارید، با دستور زیر وارد مسیر مخزن شوید: + +```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 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` مشاهده خواهید کرد. آن گزینه را انتخاب کنید. + +create a pull request + +در این مرحله، درخواست (Pull request) خود را ثبت کنید. + +submit pull request + +نهایتا، من تغییرات شما را به برنچ master پروژه اضافه (merge) خواهم کرد. بلافاصله پس از مرج شدن درخواست شما، یک ایمیل مبنی بر همین موضوع برای شما ارسال خواهد شد. + +## اقدامات بعدی + +تبریک! شما مراحل فورک کردن، کلون کردن، ایجاد تغییرات و پول رکوئست را به خوبی پشت سر گذاشتید. + +مشارکت خود روی این پروژه را [از اینجا](https://firstcontributions.github.io/#social-share) با دیگر دوستان و دنبال‌کنندگان خود جشن بگیرید. + +همچنین شما می‌توانید [از اینجا](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)، وارد تیم Slack ما شوید و سوالات خود را مطرح نمایید. + +حال، شما می‌توانید مشارکت خود را روی دیگر پروژه‌ها آغاز نمایید. ما یک لیست از پروژه‌ها با مشکلات ساده ایجاد کردیم که گزینه خوبی برای شروع می‌باشد. لیست پروژه‌ها را [از این اینجا](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) | + +

diff --git a/docs/translations/README.fi.md b/docs/translations/README.fi.md new file mode 100644 index 00000000..9ddd935a --- /dev/null +++ b/docs/translations/README.fi.md @@ -0,0 +1,129 @@ +[![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) + + +# 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)* + +fork this repository + +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 + +clone this repository + +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: + +``` +git clone "Juuri kopioimasi URL" +``` + +"Juuri kopioimasi URL"-tekstin sijasta (ilman lainausmerkkejä) pastea repositorion URL äskeisestä vaiheesta. + +copy URL to clipboard + +Esimerkiksi: + +``` +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ä). + +``` +cd first-contributions +``` + +Seuraavaksi luo branch komennolla `git checkout`: + +``` +git checkout -b +``` + +Esimerkiksi: + +``` +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 + +Jos menet projektin kansioon ja syötät komennon `git status`, näet muutokset. + +Lisää nuo muutokset branchiin `git add` komennolla: + +``` +git add Contributors.md +``` + +Seuraavaksi committoi muutokset `git commit` komennolla: + +``` +git commit -m "Add to Contributors list" +``` + +Korvaamalla `` nimelläsi. + +## Muutosten pushaaminen GitHubiin + +Pushaa muutoksesi komennolla `git push`: + +``` +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. + +create a pull request + +Seuraavaksi suorita pull request. + +submit 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). + +Voit liittyä Slack tiimiimme jos sinulla on kysyttävää. [Liity Slack tiimiin](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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 | 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) | diff --git a/docs/translations/README.fil.md b/docs/translations/README.fil.md new file mode 100644 index 00000000..e4b18c7b --- /dev/null +++ b/docs/translations/README.fil.md @@ -0,0 +1,136 @@ +[![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) + + +# Mga Unang Kontribusyon + +Nilalayon ng proyektong ito na gawing simple at gabayan ang paraan ng paggawa ng mga nagsisimula sa kanilang unang kontribusyon. Kung gusto mong gawin ang iyong unang kontribusyon, sundin ang mga hakbang sa ibaba. + +_Kung hindi ka komportable sa command line, [narito ang mga tutorial gamit ang GUI tool.](#tutorials-using-other-tools)_ + +fork this repository + +#### Kung wala kang git sa iyong makina, [i-install ito](https://docs.github.com/en/get-started/quickstart/set-up-git). + +## I-fork ang repositoryong ito + +I-fork ang repository na ito sa pamamagitan ng pag-click sa fork button sa tuktok ng page na ito. +Gagawa ito ng kopya ng repositoryong ito sa iyong account. + +## I-clone ang repositoryo + +clone this repository + +Ngayon i-clone ang forked repository sa iyong makina. 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: + +``` +git clone "url na kinopya mo lang" +``` + +kung saan ang "url na kinopya mo lang" (nang walang mga panipi) ay ang url sa repositoryong ito (ang iyong tinidor ng proyektong ito). Tingnan ang mga nakaraang hakbang para makuha ang url. + +copy URL to clipboard + +Halimbawa: + +``` +git clone https://github.com/this-is-you/first-contributions.git +``` + +kung saan ang `this-is-you` ay ang iyong GitHub username. Dito mo kinokopya ang mga nilalaman ng repositoryo ng mga unang kontribusyon sa GitHub sa iyong computer. + +## Gumawa ng sangay + +Baguhin sa direktoryo ng repositoryo sa iyong computer (kung wala ka pa roon): + +``` +cd first-contributions +``` + +Ngayon lumikha ng isang sangay gamit ang utos na `git switch`: + +``` +git switch -c your-new-branch-name +``` + +Halimbawa: + +``` +git switch -c add-alonzo-church +``` + +## Gumawa ng mga kinakailangang pagbabago at gawin ang mga pagbabagong iyon + +Ngayon buksan ang `Contributors.md` file sa isang text editor, idagdag ang iyong pangalan dito. Huwag idagdag ito sa simula o dulo ng file. Ilagay ito kahit saan sa pagitan. Ngayon, i-save ang file. + +git status + +Kung pupunta ka sa direktoryo ng proyekto at isagawa ang command na `git status`, makikita mong may mga pagbabago. + +Idagdag ang mga pagbabagong iyon sa sangay na nilikha mo lamang gamit ang utos na `git add`: + +``` +git add Contributors.md +``` + +Ngayon gawin ang mga pagbabagong iyon gamit ang utos na `git commit`: + +``` +git commit -m "Add your-name to Contributors list" +``` + +Ngayon gawin ang mga pagbabagong iyon gamit ang utos na `git commit`: + +## I-push ang mga pagbabago sa GitHub + +Itulak ang iyong mga pagbabago gamit ang command na `git push`: + +``` +git push -u origin your-branch-name +``` + +pinapalitan ang `your-branch-name` ng pangalan ng branch na ginawa mo kanina. + +
+ Kung nakakakuha ka ng anumang mga error habang nagtutulak, mag-click dito: + +- ### Error sa Pagpapatunay + 
remote: Inalis ang suporta para sa pagpapatotoo ng password noong Agosto 13, 2021. Mangyaring gumamit na lang ng personal na access token.
+  remote: Pakitingnan ang https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ para sa karagdagang impormasyon.
+  nakamamatay: Nabigo ang pagpapatotoo para sa '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 pagbuo at pag-configure ng SSH key sa iyong account. +
+ +## Isumite ang iyong mga pagbabago para sa pagsusuri + +Kung pupunta ka sa iyong repository sa GitHub, makakakita ka ng button na `Ihambing at hilahin ang kahilingan. I-click ang button na iyon. + +create a pull request + +Ngayon isumite ang kahilingan sa paghila. + +submit pull request + +Sa lalong madaling panahon, pagsasamahin ko ang lahat ng iyong mga pagbabago sa pangunahing sangay ng proyektong ito. Makakatanggap ka ng email ng notification kapag napagsama na ang mga pagbabago. + +## Saan pupunta mula dito? + +Congrats! Nakumpleto mo lang ang karaniwang _fork -> clone -> edit -> pull request_ workflow na madalas mong makaharap bilang isang contributor! + +Ipagdiwang ang iyong kontribusyon at ibahagi ito sa iyong mga kaibigan at tagasubaybay sa pamamagitan ng pagpunta sa [web app](https://firstcontributions.github.io/#social-share). + +Maaari kang sumali sa aming slack team kung kailangan mo ng anumang tulong o may anumang mga katanungan. [Sumali sa slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +Ngayon simulan na natin ang pag-aambag sa iba pang mga proyekto. Nag-compile kami ng isang listahan ng mga proyekto na may mga madaling isyu na maaari mong simulan. 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) | \ No newline at end of file diff --git a/docs/translations/README.fr.md b/docs/translations/README.fr.md new file mode 100644 index 00000000..a46ebcc7 --- /dev/null +++ b/docs/translations/README.fr.md @@ -0,0 +1,141 @@ +[![L'amour du logiciel libre](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è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. + +embrancher ce repertoire + +Si vous n'avez pas git sur votre ordinateur, [ installez-le ]( https://help.github.com/articles/set-up-git/ ). + +## Embranchez ce répertoire (aussi appelé un Fork) + +Embranchez ce répertoire en cliquant sur le bouton de fork en haut de la page. +Cela va créer une copie du répertoire sur votre compte. + +## Clonez ce répertoire + +clonez ce répertoire + +Maintenant, clonez ce répertoire sur votre ordinateur. Cliquez sur le bouton clone puis cliquez sur l'icône *copier dans le presse-papier*. + +Ouvrez une invite de commande (si vous êtes sous Windows) ou un terminal (si vous êtes sous MacOS ou Linux) et exécutez les commandes git suivantes : + +``` +git clone "l'url que vous venez de copier" +``` +où "l'url que vous venez de copier" (sans les guillemets) est l'url du répertoire. Voir la section précédente afin d'obtenir l'url. + +copier l'URL dans le presse-papier + +Par exemple : +``` +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 répertoire `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) : + +``` +cd first-contributions +``` +Maintenant créez une branche avec la commande `git checkout` : +``` +git checkout -b +``` + +Par exemple : +``` +git checkout -b add-koffi-sani +``` +(Le nom de la branche n'a pas besoin de contenir le terme *add*, mais c'est raisonnable de l'inclure parce que l'objectif de cette branche est d'ajouter votre nom à une liste.) + +## Effectuez les modifications nécessaires et engagez-les + +Maintenant, ouvrez le fichier `Contributors.md` dans un éditeur de texte, ajoutez-y votre nom, et enregistrez-le. Si vous ouvrez l'invite de commande et 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` : +``` +git add Contributors.md +``` + +Maintenant engagez ces modifications avec la commande `git commit`: +``` +git commit -m "Add to Contributors list" +``` +en remplaçant `` par votre nom. + +## Poussez les modifications vers GitHub + +Poussez vos modifications avec la commande `git push` : +``` +git push origin +``` +en remplaçant `` avec le nom de la branche précédemment créée. + +## Soumettez vos changements pour révision + +Si vous visitez votre répertoire sur Github, vous verrez un bouton `Compare & pull request`. Cliquez sur ce bouton. + +create a pull request + +Maintenant soumettez la demande de tirage. + +submit pull request + +Sous peu j'aurai fusionné toutes vos modifications avec la branche main de ce projet. Vous recevrez un mail de notification dès que la fusion sera effectuée. + +La branche main de votre embranchement ne subira pas de modification à cet instant. Pour que votre embranchement soit synchronisé avec le mien, suivez les étapes suivantes. + +## Gardez votre embranchement synchronisé avec ce répertoire + + D'abord, basculez sur la branche main + ``` + git checkout main + ``` + + Et ajouter l'url de mon répertoire comme `upstream remote url` : +``` +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 : +``` +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 : +``` +git rebase upstream/main +``` +Ici nous appliquons toutes les modifications que vous avez cherché à la branche main. Si vous poussez la branche main maintenant, votre embranchement aussi aura les modifications : +``` +git push origin main +``` +Avertissement: Cette fois, vous poussez au répertoire distant appelé origin. + +A ce niveau 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 : +``` +git branch -d +``` +et vous pouvez supprimer sa version dans le répertoire distant aussi : +``` +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 ? + +Vous pouvez aussi rejoindre notre équipe sur Slack au cas où vous auriez besoin d'aide ou auriez des questions. [Rejoindre l'équipe sur Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) diff --git a/docs/translations/README.ga.md b/docs/translations/README.ga.md new file mode 100644 index 00000000..fff5e61c --- /dev/null +++ b/docs/translations/README.ga.md @@ -0,0 +1,152 @@ +[![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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w) +[![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)_ + + +fork this repository + +#### 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 + +clone this repository + +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: + +``` +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. + +copy URL to clipboard + +Mar shampla: + +``` +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): + +``` +cd first-contributions +``` + +nois cruthaigh snáth ag baint úsáide as an comhad `git switch`: + +``` +git switch -c your-new-branch-name +``` + +Mar shampla: + +``` +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. + + +git status + +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`: + +``` +git add Contributors.md +``` + +Ansin déan comhaireamh orthu leis an gcnaipe `git commit`: + +``` +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`: + +``` +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. + + +create a pull request + +Ansin cuir isteach an iarratas athbhreithnithe. + +submit pull request + +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). + +D'fhéadfá dul inár bhfoireann Slack má tá cabhair uait nó ceisteanna agat. [Ghabh le foireann Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w). + +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 + +| 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) | + +

Tugann tacaíocht don tionscadal seo::

+

+ + + +

diff --git a/docs/translations/README.ge.md b/docs/translations/README.ge.md new file mode 100644 index 00000000..84d738d7 --- /dev/null +++ b/docs/translations/README.ge.md @@ -0,0 +1,123 @@ +[![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_ზე ათვირთო მაშინ მიყევი ქვემოთ მოცემულ ინსტრუქციას. + +კი, სტატიების წაკითხვა და ვიდეოების ყურება კარგია, მაგრამ, პრაქტიკას არც ერთი შეედრება. ეს პროექტიც ზუსტად იმისთვისაა, რომ გაგიმარტივოს გზა პირველ კონტრიბუციამდე, რომელსაც ქვემოთ ჩამოთვლილი რამდენიმე ნაბიჯი გაშორებს.\ + + +#### *თუ ტერმინალთან დიდად არ მეგობრობ, [აქ ნახავ რამდენიმე პროგრამას, რომელიც ტერმინალის გამოყენებას აგარიდებს თავიდან]( #ტუტორიალები-სხვა-პროგრამების-გამოყენებით )* + +fork this repository + +თუ კომპიუტერში გითი არ გაქვს ჩაწერილი, [მიჰყევი ლინკს]( https://help.github.com/articles/set-up-git/). + +## დაფორკე ეს რეპოზიტორია + +რეპოზიტორიის დაფორკვისთვის, ამ გვერდის მარჯვენა ზედა კუთხეში დააჭირე "Fork" ღილაკს, რომელიც მის ასლს შეგიქმნის. + +## რეპოზიტორიის დაკლონვა + +clone this repository + +ახლა, დაფორკილი რეპოზიტორია შენს კომპიუტერზე უნდა გადმოიტანო. ამისთვის შედი შენს გითჰაბის პროფილზე, გახსენი რეპოზიტორია და დააჭირე "Clone or download"-ს, შემდეგ კი *"copy to clipboard"*-ის სურათს. + +ახლა გახსენი ტერმინალი და გაუშვი შემდეგი ბრძანება: + +``` +git clone "url you just copied" +``` +სადაც "url you just copied" (ბრჭყალების გარეშე) არის შენ მიერ დაკოპირებული რეპოზიტორიის ლინკი. (თუ ეს ლინკი არ გაქვს, წინა ნაბიჯი თავიდან გაიარე). + +copy URL to clipboard + +მაგალითად: +``` +git clone https://github.com/this-is-you/first-contributions.git +``` +სადაც `this-is-you` ნაწილი, შენი გითჰაბის სახელია. ამითი რეპოზიტორიის ყველა ფაილი შენს კომპიუტერში გადმოვა. + +## შექმენი ბრენჩი + +შენი კომპიუტერით შედი რეპოზიტორიის ფოლდერში (თუ უკვე იქ არ ხარ): + +``` +cd first-contributions +``` +ახლა შექმენი ახალი ბრენჩი `git checkout` ბრძანების გამოყენებით: +``` +git checkout -b +``` + +მაგალითად: +``` +git checkout -b add-alonzo-church +``` +(ბრენჩის სახელის დასაწყისში *add*-ის მიწერა სავალდებულო არაა, თუმცა მიზანშეწონილია, რადგანაც მისი მთავარი მიზანია თქვენი სახელი დაამატოს კონტრიბუტორთა სიაში.) + +## საჭირო ფაილების შეცვლა და ატვირთვა + +ახლა რომელიმე პროგრამით (სასურველია ტექსტ ედიტორით) გახსენი ფაილი, სახელად `Contributors.md` და დაამატე შენი სახელი. ოღონდ გაითვალისწინე, რომ ის სხვების სახელებს შორის უნდა ჩაწერო და არა ფაილის დასაწყისში, ან ბოლოში. შეინახე ცვლილებები. + +git status + + +თუ პროექტის ფოლდერში გადახვალ და გაუშვებ ბრძანება: `git status`. ტერმინალი გაჩვენებს რა ფაილებში მოხდა ცვლილებები. + + +`git add`-ით დაამატე ცვლილებები შენ მიერ შექმნილ ახალ ბრენჩს: + +``` +git add Contributors.md +``` + +ახლა შეინახე ისინი `git commit`-ის გამოყენებით: +``` +git commit -m "Add to Contributors list" +``` +აქაც, `` უნდა შეცვალო შენი პროფილის სახელით. + +## ცვლილებების ატვირთვა გითჰაბზე + +ატვირთე შენი ნამუშევარი `git push`-ის მეშვეობით: +``` +git push origin +``` +`` აქ შენ მიერ შექმნილი ბრენჩის სახელით უნდა ჩაანაცვლო. + +## განხილვის მოთხოვნა + +გითჰაბზე, შენს რეპოზიტორიაში როცა გადახვალ, დაინახავ `Compare & pull request` ღილაკს. დააჭირე. + +create a pull request + +ახლა შენ მოითხოვ ცვლილებების განხილვას. + +submit 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). + +### [დამატებითი მასალა](../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) | \ No newline at end of file diff --git a/docs/translations/README.gh.md b/docs/translations/README.gh.md new file mode 100644 index 00000000..d6a08050 --- /dev/null +++ b/docs/translations/README.gh.md @@ -0,0 +1,142 @@ +[![Love for 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) + +# 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ɛ. + +fork this repository + +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 + +clone this repository + +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: + +``` +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. + +copy URL to clipboard + +Nhwɛsoɔ: +``` +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): + +``` +cd first-contributions +``` +Afei fa `git checkout` ahyɛdeɛ no yɛ baa dwumadibea: +``` +git checkout -b +``` + +Nhwɛsoɔ: +``` +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: +``` +git add Contributors.md +``` + +Afei fa `git commit` ahyɛdeɛ no yɛ nsakraeɛ yi: +``` +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: +``` +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. + +create a pull request + +Afei fa twetwe adesrɛ no kɔma. + +submit pull request + +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: +``` +git checkout main +``` + +Na fa me akoraeɛ URL no ka ho sɛ `upstream akyirikyiri url`: +``` +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: +``` +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: +``` +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: + +``` +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: +``` +git branch -d +``` +na wubetumi nso apopa ne akyirikyiri nkyerɛase no: +``` +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) | + +## Nea Ɛdi Akyi? + +You can also join our team on Slack in case you need help or have any questions. [Join the team on Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) \ No newline at end of file diff --git a/docs/translations/README.gl.md b/docs/translations/README.gl.md new file mode 100644 index 00000000..de340a1d --- /dev/null +++ b/docs/translations/README.gl.md @@ -0,0 +1,112 @@ +[![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 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: +``` +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). + +``` +cd first-contributions +``` + +Agora crea unha branch (póla) usando o comando `git checkout` + +``` +git checkout -b +``` + +Por exemplo +``` +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: + +``` +git add Contributors.md +``` + +Agora podes facer commit sobre os cambios co comando `git commit` +``` +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` +``` +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í? + +Tamén poderías unirte á nosa *equipa* en Slack no caso de que necesites axuda ou teñas algunha pregunta. [Únete ó noso Slack](https://firstcontributors.slack.com/join/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY) diff --git a/docs/translations/README.gr.md b/docs/translations/README.gr.md new file mode 100644 index 00000000..f9efdcbd --- /dev/null +++ b/docs/translations/README.gr.md @@ -0,0 +1,139 @@ +[![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) + +# Πρώτες Συνεισφορές + +Αυτό το έργο έχει σκοπό να απλοποιήσει και να καθοδηγήσει τον τρόπο με τον οποίο οι αρχάριοι κάνουν την πρώτη τους συνεισφορά. Αν σκοπεύετε να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε τα παρακάτω βήματα. + +Αν δεν είστε εξοικειωμένοι με τη γραμμή εντολών, [εδώ υπάρχουν σεμινάρια που χρησιμοποιούν γραφικά εργαλεία](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) + +fork this repository + +Εάν δεν έχετε εγκατεστημένο το git στον υπολογιστή σας, [εγκαταστήστε το](https://help.github.com/articles/set-up-git/) + +## Αντιγράψτε το αποθετήριο (fork) + +Αντιγράψτε το αποθετήριο πατώντας το κουμπί με τίτλο `Fork` στην κορυφή αυτής της σελίδας. Με αυτό τον τρόπο ένα ακριβές αντίγραφο του αποθετηρίου θα δημιουργηθεί στο λογαριασμό σας. + +## Αποθηκεύστε τοπικά το αποθετήριο (clone) + +clone this repository + +Τώρα αντιγράψτε το αποθετήριο στον υπολογιστή σας. Κάντε κλικ στο κουμπί `Clone or download` και μετά στο εικονίδιο δεξιά από το σύνδεσμο για αντιγραφή στο πρόχειρο. + +Ανοίξτε ένα παράθυρο τερματικού και τρέξτε την ακόλουθη git εντολή: + +``` +git clone "σύνδεσμος που μόλις αντιγράψατε" +``` + +Όπου "σύνδεσμος αποθετηρίου" (χωρίς τα εισαγωγικά) είναι ο σύνδεσμος για αυτό το αποθετήριο. Ανατρέξτε στα προηγούμενα βήματα για να βρείτε αυτόν τον σύνδεσμο. + +copy URL to clipboard + +Για παράδειγμα: + +``` +git clone https://github.com/this-is-you/first-contributions.git +``` + +Όπου 'this-is-you' είναι το όνομα χρήστη που έχετε στο github. Από εδώ αντιγράφετε τα περιεχόμενα του αποθετηρίου `first-contributions` απο το github στον υπολογιστή σας. + +## Δημιουργήστε ένα νέο παρακλάδι (branch) + +Πηγαίνετε στο φάκελο του αποθετηρίου στον υπολογιστή σας εάν δεν είστε ήδη εκεί. + +``` +cd first-contributions +``` + +Τώρα δημιουργείστε ένα νέο παρακλάδι χρησιμοποιώντας την εντολή `git switch` : + +``` +git switch -c your-new-branch-name +``` + +Για παράδειγμα: + +``` +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:` + +``` +- [Το-όνομα-σας](https://github.com/Your-username) +``` + +Για παράδειγμα: + +``` +- [John Doe](https://github.com/johndoe) +``` + +Σιγουρευτείτε ότι δεν υπάρχει κενό ανάμεσα στα `](` . Αποθηκεύστε το αρχείο και κλείστε το. + +git status + +Εάν πάτε στο φάκελο του αποθετηρίου και γράψετε την εντολή `git status`, θα δείτε ότι υπάρχουν κάποιες αλλαγές. Προσθέστε αυτές τις αλλαγές χρησιμοποιώντας την εντολή `git add`. + +``` +git add Contributors.md +``` + +Τώρα σώστε αυτές τις αλλαγές χρησιμοποιώντας την παρακάτω `git commit` εντολή. + +``` +git commit -m "Add to Contributors list" +``` + +όπου `` αντικαταστήστε με το όνομα σας + +## Αποθηκεύστε τις αλλαγές σας στο github (push) + +Αποθηκεύστε τις αλλαγές σας χρησιμοποιώντας την εντολή `git push` + +``` +git push origin +``` + +όπου `` αντικαταστήστε με το όνομα του παρακλαδιού(branch) που δημιουργήσατε προηγουμένως + +## Υποβάλλετε τις αλλαγές σας για έλεγχο + +Εάν πάτε στο αποθετήριο (repository) στο github θα δείτε ένα κουμπί με τίτλο `Compare & pull request`. Κάντε κλικ σε αυτό το κουμπί. + +create a pull request + +Τώρα υποβάλλετε το pull request. + +submit pull request + +Σύντομα θα ενσωματώσω όλες τις αλλαγές σας στο master branch του προγράμματος. Θα ειδοποιηθείτε με email όταν οι αλλαγές που κάνατε ενσωματωθούν. + +## Τι να κάνετε τώρα; + +Συγχαρητήρια! Μόλις ολοκληρώσατε την τυπική ροή εργασιών _fork -> clone -> edit -> pull request_ που θα συναντήσετε συχνά ως συνεργάτης! + +Γιορτάστε και μοιραστείτε την συνεισφορά σας με τους φίλους και τους ακόλουθους σας πηγαίνοντας στο [web app](https://firstcontributions.github.io/#social-share). + +Μπορείτε να συμμετέχετε στην ομάδα μας στο slack σε περίπτωση που θέλετε κάποια βοήθεια ή έχετε κάποια ερώτηση. +[Η ομάδα μας στο slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +Τώρα μπορείτε να ξεκινήσετε να συνεισφέρετε και σε άλλα project. Έχουμε φτιάξει μια λίστα από project με εύκολα προβλήματα για να ξεκινήσετε. Δείτε εδώ [τη λίστα με τα project](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) | diff --git a/docs/translations/README.guj.md b/docs/translations/README.guj.md new file mode 100644 index 00000000..fe690de7 --- /dev/null +++ b/docs/translations/README.guj.md @@ -0,0 +1,143 @@ +[![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) +# પ્રથમ યોગદાન + +પ્રથમ વખત કંઈક કરવું થોડું મુશ્કેલ છે. ખાસ કરીને જ્યારે તમે જુથ સાથે મળીને કામ કરી રહ્યા હોવ, ત્યારે ભૂલો કરવી એ સારી વાત નથી. પરંતુ એકબીજા સાથે મળીને અને એક જ સાથે કામ કરવું એ જ તો ઓપેન સોર્સ છે. અમે તમારું પ્રથમ ઓપન સોર્સ કોન્ટ્રિબ્યુશન / યોગદાન સરળ બનાવાનો પ્રયત્ન કરીશુ. + +ઓનલાઇન આર્ટિકલ્સ વાંચન અને ઓનલાઇન ટ્યુટોરિયલ્સ મદદ કરી શકે છે, પરંતુ પોતે જ તે કામ કરવાથી સારું શું હોઇ શકે? આ પ્રોજેક્ટ તમને તમારી પ્રથમ કોન્ટ્રિબ્યુશન માટે દિશા નિર્દેશ આપશે. જો તમે તમારું પ્રથમ કોન્ટ્રીબ્યુશન કરવા માંગો છો તો આગળ આપેલા પગલાઓ અનુસરો. + +જો તમે કમાન્ડ લાઇન સાથે આરામદાયક ન હોવ, તો અહીં [ GUI ટૂલ્સનો ઉપયોગ કરવાના ટ્યુટોરિયલ્સ ](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) આપેલ છે. + +fork this repository + +જો તમારા કમ્પ્યુટર પર Git ઇન્સ્ટોલ નથી, [ તો Git ઈન્સ્ટોલ કરો](https://help.github.com/articles/set-up-git/) + + +## રિપોઝીટરીને ફોર્ક કરો + +ફોર્ક(કાંટા) બટન પર ક્લિક કરવાથી આ રિપોઝીટરી ફોર્ક થાય છે, આ તમારા GitHub એકાઉન્ટમાં આ રિપોઝીટરીની એક નકલ (કોપી) બનાવશે. + + +## રિપોઝીટરી ક્લોન કરો + +clone this repository + + +હવે તમે આ રેપો તમારા કમ્પ્યુટરમાં ક્લોન કરો (અર્થાત ડાઉનલોડ કરો). તમારા GitHub એકાઉન્ટ પર જાવ, ક્લોન બટન પર ક્લિક કરો અને પછી `copy to clipboard` આઇકોન પર ક્લિક કરો. આનાથી એ રેપોજીટરીનો યુઆરએલ કોપી થશે. + + +તમારા કમ્પ્યુટર પર એક ટર્મિનલ / કમાંડ પ્રોમ્પ્ટ ખોલો અને નીચે દર્શાવ્યા મુજબ git આદેશ ચલાવો: + +``` +git clone "યુઆરએલ જે તમે હમણાં જ નકલ(ક્લોન) કરી" +``` + + +જ્યાં "યુઆરએલ જે તમે હમણાં જ કોપી કર્યું છે" (અવતરણ ચિહ્નો સિવાય) એ આ રિપોઝીટરી(આ પ્રોજેક્ટનો તમારો ફૉર્ક) ની URL ના સંગ્રહ માટે છે. તેની URL ને મેળવવા માટે પાછલા પગલાં જુઓ. તેમને કોપી કરેલ યુઆરએલ સાથે બદલી કાઢો. + +ઉદાહરણ તરીકે: + +``` +git clone https://github.com/આ-તમે-છો/first-contributions.git +``` + +copy URL to clipboard + + +'આ-તમે-છો' તમારા GitHub એકાઉન્ટનું `username` છે. અહીં તમે તમારા કમ્પ્યુટરમાં GitHub થી first-contributions રિપોને કોપી કરી રહ્યા છો અથવા તેના એક સ્થાનિક / લોકલ કોપી બનાવી રહ્યા છે. + +## એક બ્રાંચ બનાવો + +તમારા કમ્પ્યુટર પર બનાવેલ રિપોઝીટરીની કોપીનાં ફોલ્ડર / ડિરેક્ટરીમાં જાવ (જો હજુ સુધી તમે ત્યાં ન હોવ તો નીચે આપેલ Command(આદેશ) ચલાવો) + + +``` +cd first-contributions +``` + + +હવે 'git checkout' command(આદેશ) નો ઉપયોગ કરીને એક નવી શાખા(Branch) બનાવો. નવી શાખા(Branch) બનાવવા માટે -b વિકલ્પનો ઉપયોગ થાય છે. + +``` +git checkout -b <તમારી-શાખા-નામ-ઉમેરો> +``` + +ઉદાહરણ તરીકે: + +``` +git checkout -b add-alonzo-church +``` + + +(શાખા(Branch)ના નામમાં 'add' ઉમેરવાની જરૂર નથી, પરંતુ તેમાં શામેલ કરવું યોગ્ય છે કારણ કે શાખા(Branch)નો હેતુ એક નામ છે, જે નામ ઉમેરવાનું છે.) + +## આવશ્યક ફેરફારો કરો અને તે ફેરફારોને કમીટ કરો- + + +હવે 'Contributors.md` ફાઇલને એક ટેક્સ્ટ એડિટરમાં ખોલો અને તેમા તમારુ નામ લખો. ફાઇલની શરૂઆત અથવા અંતે ઉમેરવાને બદલે, તેને મધ્યમાં ગમે ત્યાં રાખો. હવે, ફાઇલને સેવ કરો. + +git status + + +જો તમે પ્રોજેક્ટની ડાઈરેક્ટરીમા જશો અને કમાન્ડ પ્રોમ્પ્ટમાં `git status` નિર્દેશ ચલાવશો, તો તમે કરેલા પરિવર્તન જોઈ શક્શો. તે પરિવર્તન બનાવવામાં આવેલ શાખા(Branch)માં ઉમેરવા માટે 'git add` કમાન્ડ વાપરો. + + +``` +git add Contributors.md +``` + + +હવે તમારા પોતાના ફેરફારોને 'git commit' આદેશનો ઉપયોગ કરી કમીટ કરો. + +``` +git commit -m "Add <તમારુ-નામ> to Contributors list" +``` + +<તમારુ નામ> ની જગ્યાએ તમારું નામ દાખલ કરો + + +## +તમારા ફેરફારો ને Github માં પુશ કરો (ધકેલો). + +`git push` ઉપયોગ કરીને તમારા પરિવર્તન ને પુશ કરો + +``` +git push origin <તમારી-શાખા-નામ-ઉમેરો> +``` + +`<તમારી-શાખા-નામ-ઉમેરો>` ની જગ્યાએ તમારી શાખા(Branch)નુ નામ ઉમેરો. + +## તમારા ફેરફારોના રીવ્યુ માટે સબમિટ કરો + + +જો તમે તમારા github એકાઉન્ટ પર તમારી રિપો માં જાવ તો Compare & pull request નો ઓપ્શન હશે. તેને દબાવો. + +create a pull request + +હવે તમારી pull request સબમિટ કરો. + +submit pull request +ટૂંક સમયમાં હું તમારા ફેરફારો માટે આ પ્રોજેક્ટની માસ્ટર શાખામાં મર્જ ક્રી દઇશ. તમને એક મેલ આવશે જ્યારે તમારા ફેરફારો મર્જ થશે. + + +## હવે, અહીંથી ક્યાં જવું ? + +અભિનંદન!:tada: તમે હમણાં જ સ્ટાન્ડર્ડ `fork -> clone -> edit -> pull request` વર્કફ્લો પૂર્ણ કર્યો છે. જેનો તમે વારંવાર સહયોગકર્તા (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) | diff --git a/docs/translations/README.hau.md b/docs/translations/README.hau.md new file mode 100644 index 00000000..71fa8e28 --- /dev/null +++ b/docs/translations/README.hau.md @@ -0,0 +1,133 @@ +[![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) + +# 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)* + +fork this repository + +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 + +clone this repository + +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: + +``` +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. + +copy URL to clipboard + +Misali: + +``` +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): + +``` +cd na farko-gudunmawar +``` + +Yanzu, ƙirƙiri reshe ta amfani da umarnin 'git checkout': + +``` +git checkout -b <ƙara-sabon-reshe-name> +``` + +Misali: + +``` +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. + +git status + +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': + +``` +git ƙara Masu ba da gudummawa.md +``` + +Yanzu aiwatar da canje-canje ta amfani da umarnin 'git Committee': + +``` +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': + +``` +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. + +create a pull request + +Yanzu, yi buƙatar. + +submit pull request + +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) | diff --git a/docs/translations/README.hb.md b/docs/translations/README.hb.md new file mode 100644 index 00000000..0702e61d --- /dev/null +++ b/docs/translations/README.hb.md @@ -0,0 +1,216 @@ +
+ Open Source Helpers + License: MIT + Open Source Love + +
+ +
+

תרומות ראשונות

+
+ +
+מטרת פרויקט זה היא לפשט ולהדריך מתחילים בדרכם אל תרומתם הראשונה לקוד פתוח. + אם אתם מחפשים דרך לבצע תרומה ראשונית, עקבו אחר ההוראות הבאות. +
+ +
+

אם אינכם חשים בנוח להשתמש בשורת פקודה, ניתן להשתמש +בכלים גרפיים.

+
+ +
+

כמו כן, ניתן לקרוא את המאמר +בשפות אחרות.

+
+ + + +
+fork this repository +
+ +
+

בצעו FORK למאגר זה

+
+ +
+כדי לבצע FORK למאגר זה, ניתן ללחוץ על כפתור ה – FORK בתחילת העמוד. פעולה זה תיצור עותק של מאגר זה בחשבון שלכם. +
+ + +
+

שכפול המאגר

+
+ +
+ clone this repository +
+ +
+ +כעת, שכפלו את המאגר הזה למחשב שלכם. לכו לדף ה-GitHub שלכם, לחצו על כפתור השכפול ואז לחצו על הצלמית `copy to clipboard`. + +פתחו טרמינל והריצו את הפקודה הבאה: +
+ +``` +git clone "url you just copied" +``` +
+ +כאשר הביטוי `"url you just copied"` (ללא סימני הגרשיים) הוא הקישור למאגר זה שביצעתם עליו FORK קודם לכן. ראו את הצעדים הקודמים כדי להשיג את הקישור. +
+ +copy URL to clipboard + +
+לדוגמא: +
+ +``` +git clone https://github.com/this-is-you/first-contributions.git +``` +
+ +כאשר `this-is-you` הוא שם המשתמש שלכם ב-GitHub. לכאן אתם מעתיקים את התוכן של מאגר first-contributions ב-GitHub לתוך המחשב שלכם. +
+ +
+

יצירת ענף

+
+ +
+החליפו לתיקיית המאגר בתוך המחשב שלכם (באם טרם נכנסתם לתיקייה זו): +
+ +``` +cd first-contributions +``` +
+ +כעת, צרו ענף (branch) בשימוש הפעולה `git checkout`: +
+ +``` +git checkout -b your-new-branch-name +``` +
+ לדוגמא: +
+ +``` +git checkout -b add-alonzo-church +``` + +
+(שם הענף לא חייב להכיל את המילה add בתוכו, אבל זה הגיוני להוסיף אותה מכיוון שמטרת הענף היא להוסיף את שמכם לרשימה.) +
+ +
+

ערכו שינויים הכרחיים ובצעו להם commit

+
+ +
+ +כעת פתחו את הקובץ `Contributors.md` בתוכנת עריכת טקסט והוסיפו את השם שלכם אליו. אל תוסיפו את השם בתחילת הקובץ או בסופו. הוסיפו אותו באמצע. לאחר שסיימתם, שמרו את הקובץ. + + +אם תנווטו לתיקיית הפרויקט ותבצעו את הפעולה `git status`, תוכלו לראות את השינויים שביצעתם שם. +הוסיפו את השינויים האלו לענף שיצרתם תוך שימוש בפקודה `git add`: +
+ +``` +git add Contributors.md +``` +
+ +עכשיו, בצעו commit לשינויים הללו תוך שימוש בפקודת `git commit`: +
+ +``` +git commit -m "Add to Contributors list" +``` +
+ +החליפו את הביטוי `` עם השם שלכם. +
+ +
+

לדחוף את השינויים ל-GitHub

+
+ +
+ +דחפו את השינויים תוך שימוש בפקודה `git push`: +
+ +``` +git push origin +``` +
+ +החליפו את `` עם השם של הענף שיצרתם מוקדם יותר. +
+ +
+

הגישו את השינויים שלכם לסקירה

+
+ +
+ +אם תלכו למאגר שלכם ב-GitHub, תוכלו לראות כפתור עם הכיתוב `Compare & pull request`. לחצו על כפתור זה. + +create a pull request + +כעת, הגישו את בקשת הדחיפה (pull request): + +submit pull request + +בקרוב, אצרף את כל השינויים לתוך הענף הראשי של פרויקט זה. אתם תקבלו עדכון במייל ברגע שהשינויים ימוזגו. +
+ +
+

מחקו את הענף שלכם אחרי שבקשת הדחיפה אושרה

+
+ +
+

מה לעשות מכאן?

+
+ +
+כל הכבוד! כרגע סיימתם את מעגל הזרימה הסטנדרטי של Fork->Clone->Edit->PR שאתם תפגשו באופן שכיח כתורמים! +תחגגו את התרומתכם ושתפו אותה עם החברים והעוקבים שלכם בכך שתלכו ל-web app. +
+אתם יכולים להצטרף לצוות הסלאק שלנו אם אתם צריכים עזרה או אם יש לכם שאלות. +הצטרפו לקבוצת סלאק. + +עכשיו אפשר להתחיל לתרום לפרוייקטים אחרים. הכנו רשימה של פרוייקטים על נושאים קלים שאתם יכולים להתחיל לעבוד עליהם. + +רשימה של פרוייקטים ב-web app. +
+ + + +
+

הדרכות בשימוש כלים אחרים

+
+ + diff --git a/docs/translations/README.hi.md b/docs/translations/README.hi.md new file mode 100644 index 00000000..9fef1919 --- /dev/null +++ b/docs/translations/README.hi.md @@ -0,0 +1,125 @@ +[![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) +# प्रथम योगदान + +इस परियोजना का उद्देश्य शुरुआती लोगों द्वारा अपना पहला योगदान करने की प्रक्रिया को सरल और मार्गदर्शित करना है। यदि आप योगदान देना चाहते हैं, तो नीचे दिए गए चरणों का पालन करें। + +आर्टिकल्स पढ़ना और ऑनलाइन ट्यूटोरियल्स देखना मददगार साबित हो सकते हैं, लेकिन बिना कुछ गलती करके खुद काम करने से अच्छा हो सकता है। इस प्रोजेक्ट आपको अपने पहले योगदान के लिए दिशा निर्देशित करेगा। याद रखें - जितने तनाव मुक्त होकर आप सीखेंगे, उतना ही बेहतर सीख पाएंगे। नीचे दिए गए निर्देशों का पालन करें। + +fork this repository + +यदि आपके कंप्यूटर पर Git नहीं है तो, [इसे स्थापित करें](https://help.github.com/articles/set-up-git/) । + +_यदि आप कमांड लाइन के साथ सहज नहीं हैं, [तो यहाँ ग्राफिकल इंटरफेस (GUI) टूल्स का उपयोग करने वाले ट्यूटोरियल हैं] (#अन्य-टूल-का-उपयोग-करके-ट्यूटोरियल) ।_ + +## रिपॉज़िटरी को फोर्क करना + +काँटा (फोर्क) बटन पर क्लिक करके इस रिपॉज़िटरी को फोर्क कर सकते हैं। यह आपके GitHub खाते (अकाउंट) में इस रिपॉज़िटरी की एक प्रति (कॉपी) बना देगा जो केवल आपके लिए उपलब्ध होगी। + +## रिपॉज़िटरी को क्लोन करना + +clone this repository + +अब इस रिपॉज़िटरी को अपने कंप्यूटर पर क्लोन (यानी डाउनलोड) करें। अपने GitHub अकाउंट पर जाएँ, फोर्क की गई रिपॉज़िटरी खोलें, 'Code/कोड' बटन पर क्लिक करें, और फिर 'Copy to Clipboard' आइकॉन पर क्लिक करें। + +अपने कंप्यूटर पर एक टर्मिनल/कमांड प्रांप्ट खोलें और निम्न git आदेश (कमांड) चलाएँ: + +``` +git clone "यूआरएल जिसे आपने अभी कॉपी किया" +``` + +जहाँ "यूआरएल जिसे आपने अभी कॉपी किया" (उद्धरण चिह्नों के बिना) इस रिपॉज़िटरी के लिए यूआरएल है (इस परियोजना का आपका फोर्क) । यूआरएल प्राप्त करने के लिए पिछले निर्देश देखें । + +उदाहरण के लिए: + +``` +git clone https://github.com/यह-आप-हैं/first-contributions.git +``` + +copy URL to clipboard + +`यह-आप-हैं` आपके GitHub अकाउंट का नाम है। यहाँ आप अपने कंप्यूटर में GitHub से first-contributions रिपॉज़िटरी को कॉपी कर रहे हैं अथवा उसकी एक लोकल/स्थानीय कॉपी बना रहे हैं । + +## एक शाखा (ब्राँच) बनाएँ + +अपने कंप्यूटर पर बनाई गई रिपॉज़िटरी की कॉपी के फोल्डर/डायरेक्टरी में जाएँ (यदि अभी तक नहीं की है तो निम्न आदेश चलाएँ) + +``` +cd first-contributions +``` + +अब एक नई शाखा बनाएँ `git switch` कमांड का उपयोग करके । +नई शाखा बनाने के लिए -c ऑप्शन का उपयोग होता है । + +``` +git switch -c <अपनी-शाखा-का-नाम-जोड़ें> +``` + +उदाहरण के लिए: + +``` +git switch -c add-alonzo-church +``` + +( शाखा के नाम में `add` जोड़ने की आवश्यकता नहीं है, लेकिन इसमें शामिल होना जरूरी है क्योंकि इस शाखा का उद्देश्य एक सूची में अपना नाम जोड़ना है। ) + +## आवश्यक परिवर्तन करें और उन परिवर्तनों को कमिट करें- + +अब `Contributors.md` फ़ाइल को एक टेक्स्ट एडिटर में खोलकर इसमें अपना नाम जोड़ दें। फ़ाइल की शुरुआत या अंत में इसे न जोड़ें। इसे बीच में कहीं भी रखें । + +git status + + +आप यदि `git status` कमांड चलाएंगे , तो आपको अपने द्वारा किये गए परिवर्तन देखेंगे। + +उन परिवर्तनों को बनाई गई शाखा में जोड़ने के लिए `git add` कमांड का उपयोग करें । + +``` +git add Contributors.md +``` + +अब अपने किये गए बदलावों को `git commit` कमांड का उपयोग करके कमिट करें । + +``` +git commit -m "Add <आपका-नाम> to Contributors list" +``` + +<आपका-नाम> की जगह अपना नाम लिखें । + +## अपने बदलावों को Github में पुश करें । + +`git push` का उपयोग कर अपने परिवर्तन को पुश करें । + +``` +git push origin <अपनी-शाखा-का-नाम-जोड़ें> +``` + +`<अपनी-शाखा-का-नाम-जोड़ें>` की जगह अपनी शाखा का नाम लिखें । + +## अपने बदलावों को रिव्यु के लिए सबमिट करें । + +यदि आप अपने 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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w) + +अब आप अन्य प्रोजेक्ट्स पर योगदान कर सकते हैं, तो चलिए शुरू करते हैं! हमने आपके लिए एक प्रोजेक्ट्स की सूचि तैयार की है जहाँ सरल इश्यूज हैं । आप चाहें तो वहाँ से आरम्भ कर सकते हैं । [प्रोजेक्ट्स कि लिस्ट](https://firstcontributions.github.io/#project-list) + +## शिक्षण अन्य साधनो का उपयोग करने के लिए + +|GitHub Desktop|Visual Studio 2017|GitKraken|VS Code|Sourcetree App| +|---|---|---|---|---| +|[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)| diff --git a/docs/translations/README.hne.md b/docs/translations/README.hne.md new file mode 100644 index 00000000..5fcb04c2 --- /dev/null +++ b/docs/translations/README.hne.md @@ -0,0 +1,123 @@ +[![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) +# प्रथम योगदान + +पहली बार कुछू करे बर कठिन होथे| ख़ास तौर पर जब आपमन मिलकर काम करथव तब गलतियां करना बने बात नहीं आय | मगर आपस म मिलना अउ एक जुट होकर काम करे ल ही त ओपन सोर्स कइथे| हमन आप मन के पहला ओपन सोर्स कॉन्ट्रिब्यूशन/योगदान आसान बनाए बर आपमन की मदद करबो | + +आर्टिकल्स पढ़े अउ ऑनलाइन ट्यूटोरियल देखके मदद मिल सकत हे मगर बिना कुछू गलत करे अउ खुद वो काम करे ले बने अउ का हो सकत हे ? यह प्रोजेक्ट आपमन के पहले कॉन्ट्रिब्यूशन बर दिशा निर्देशन करे बर बने मदद करहि | याद रखौ - जतका तनाव मुक्त होकर आप मन सिखहु ततका आपमन बने सीख पाबौ | अगर आप मन अपन पहली कॉन्ट्रिब्यूशन करना चाहत हो त आगे दिए तरीका ल बने फॉलो करौ | + +fork this repository + +आपमन के कंप्यूटर म Git नहीं हे त, [एला स्थापित करौ](https://help.github.com/articles/set-up-git/) + +## रिपॉज़िटरी ल फॉर्क करे बर + +कांटा (फॉर्क) बटन म क्लिक करके ए रिपॉज़िटरी ल फॉर्क कर सकत हो| ए ह आपमन के GitHub खाते म इही रिपॉज़िटरी के एकठन प्रति (कॉपी) बना दिहि। + +## रिपोजिटरी क्लोन + +clone this repository + +अब आपमन ए रेपो ल अपन कंप्यूटर म क्लोन (डाउनलोड) करव| अपन GitHub खाते म जाकर क्लोन बटन म क्लिक करव अउ फिर कॉपी टू क्लिपबोर्ड आइकॉन म क्लिक करव | + +अपन कंप्यूटर म एक ठन टर्मिनल/कमांड प्रांप्ट खोलव अउ निम्न git आदेश चलावव: + +``` +git clone "यूआरएल जैला आपमन कॉपी करे हावव " +``` + +जेती "यूआरएल जैला आपमन कॉपी करे हावव" (उद्धरण चिह्नों के बिना) ए भंडार बर यूआरएल हे । यूआरएल प्राप्त करे बर पिछला चरण देखव । + +उदाहरण बर: + +``` +git clone https://github.com/यह-तै-हावस/first-contributions.git +``` + +copy URL to clipboard + +यह-तै-हावस आपमन के GitHub अकाउंट के नाम हावै। एती आपमन अपन कंप्यूटर न GitHub ले फर्स्ट-कंट्रिब्यूशंज़ रेपो ल कॉपी करथव अउ ओखर एक लोकल/स्थानीय कॉपी बनावथस| + +## एक ब्राँच बनाए बर + +अपन कंप्यूटर म बनाये गए रिपॉजिटरी के कॉपी के फोल्डर/डायरेक्टरी म जावव (अगर अब तक नहीं करे हावस त निम्न आदेश चलावव) + +``` +cd first-contributions +``` + +अब एक ठी नवा शाखा बनवाव `git checkout` कमांड के उपयोग करके | +नवा शाखा बनाए बर -b ऑप्शन के उपयोग होथे। + +``` +git checkout -b <अपन-शाखा-के-नाम-जोड़ें> +``` + +उदाहरण बर: + +``` +git checkout -b add-alonzo-church +``` + +( शाखा के नाम म `add` जोड़ने के आवश्यकता नहीं हावए, लेकिन एमा जोड़ना चल जाहि काबर की ए शाखा के उद्देश्य एक सूची म अपन नाम ल जोड़े बर हे। ) + +## आवश्यक परिवर्तन करे बर अउ उन परिवर्तनों ल कमिट करे बर- + +अब `Contributors.md` फ़ाइल ल एक टेक्स्ट एडिटर म खोलकर एमा अपन नाम लिखव। फ़ाइल के शुरुआत या अंत म एला झन जोड़बे। एला बीच म कही तिरिया देहु आपमन | + +git status + + +आपमन अगर `git status` निर्देश चलाहु , त आपमन ल किये गए परिवर्तन दिखहि। + +उन परिवर्तनों ल बनाए गए शाखा म जोड़े बर `git add` कमान्ड के उपयोग करव | + +``` +git add Contributors.md +``` + +अब अपन करे गए बदलाव ल कमिट करे बर `git commit` आदेश के उपयोग करव | + +``` +git commit -m "Add <अपन-नाम> to Contributors list" +``` + +<अपन-नाम> के जगह अपन नाम डालव| + +## अपन करे बदलाव ल Github म पुश करव| + +`git push` के उपयोग कर अपन परिवर्तन ल पुश करव| + +``` +git push origin <अपन-शाखा-के-नाम-जोड़व> +``` + +`<अपन-शाखा-के-नाम-जोड़व>` के जगह अपन शाखा के नाम डालव| + +## अपन बदलाव ल रिव्यु करे बर सबमिट करव| + +आपमन अपन 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_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) | diff --git a/docs/translations/README.hr.md b/docs/translations/README.hr.md new file mode 100644 index 00000000..68a0eea6 --- /dev/null +++ b/docs/translations/README.hr.md @@ -0,0 +1,124 @@ +[![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) + +# Prvi doprinosi + +Cilj ovog projekta je da pruži jednostavne korake za početnike da naprave svoje prve doprinose. Ukoliko tražite da napravite prvi doprinos pratite sljedeće korake ispod. + +#### _Ukoliko niste baš sigurni u vaš rad sa naredbnom linijom/terminalom, [ovdje možete pronaći tutorijale za GUI alate.](#Uputstva-za-druge-alate)_ + +Napravite fork repozitorijuma + +Ukoliko nemate git instaliran na vašom 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 + +clone this repository + +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: + +``` +git clone "url koji ste sada kopirali" +``` + +gdje je "url koji ste sada kopirali" (bez navodnika) url na ovaj repozitorij (vaš fork ovog projekta). Pogledajte prethodne korake kako dohvatiti url. + +copy URL to clipboard + +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. Ovime kopirate sadržaj repozitorija _first-contributions_ na vaše računalo. + +## Pravljenje grane _branch_ + +Prebacite se u radni direktorij na vašem računalu (ukoliko već niste tamo): + +``` +cd first-contributions +``` + +Pa zatim napravite novu granu _branch_ koristeći `git switch` comandu: + +``` +git switch -c add-svoje-ime +``` + +Na primjer: + +``` +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 sačuvajte datoteku. + +git status + +Ukoliko odete u radni direktorij i izvršite naredbu `git status`, primijetiti ćete da postoje promjene. + +Dodajte ove promjene u granu koju ste gore napravili koristeći `git add` naredbu: + +``` +git add Contributors.md +``` + +Sada potvrdite ove promjene koristeći `git commit` naredbu: + +``` +git commit -m "Add tvoje-ime to Contributors list" +``` + +Gdje umjesto `tvoje-ime` upisujete svoje ime. + +## Pushajte promjene na GitHub + +Pošaljite promjene u repozitorij na GitHub-u koristeći naredbu `git push`: + +``` +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. + +create a pull request + +a zatim pošaljite zahtjev klikom na dugme _Create pull request_. + +submit 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 vaš doprinos sa prijateljima i pratiocima otvaranjem [stranice](https://firstcontributions.github.io/#social-share). + +Pridružite se i našem Slack timu u slučaju da vam je potrebna ikakva pomoć ili imate bilo kakvih pitanja. [Slack tim](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +A 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) + +## 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) | diff --git a/docs/translations/README.hu.md b/docs/translations/README.hu.md new file mode 100644 index 00000000..89fb1cb3 --- /dev/null +++ b/docs/translations/README.hu.md @@ -0,0 +1,124 @@ +[![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) + + +# 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)* + +forkold ezt a repó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: + +``` +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: +``` +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): + +``` +cd first-contributions +``` + +Most készítsünk egy ágat `git checkout` parancs használatával: + +``` +git switch -c +``` + +Például: +``` +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 status + + +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: + +``` +git add Contributors.md +``` + +Commitoljuk a módosításokat a `git commit` paranccsal: +``` +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: +``` +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á! + +pull request készítése + +Sikeresen elküldted a pull requested. + +pull request beküldése + +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) | diff --git a/docs/translations/README.hy.md b/docs/translations/README.hy.md new file mode 100644 index 00000000..e44f16ff --- /dev/null +++ b/docs/translations/README.hy.md @@ -0,0 +1,136 @@ +[![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) + +Այս նախագիծը նպատակ ունի պարզեցնել և առաջնորդել սկսնակներին իրենց առաջին ներդրման ճանապարհին: Եթե ցանկանում եք կատարել ձեր առաջին ներդրումը, հետևեք ստորև նշված քայլերին: + +_Եթե հրամանի պատուհանը (command line) ձեզ հարմար չէ, [ահա ուղեցույցներ գրաֆիկական ինտերֆեյսի (GUI) կիրառմամբ.](#Ուղեցույցներ-այլ-գործիքների-կիրառմամբ)_ + +fork this repository + +#### Եթե դուք չունեք git ձեր մեքենայի վրա, [տեղադրեք այն](https://help.github.com/articles/set-up-git/) + +## Ճյուղավորեք (fork) այս պահոցը (repository) + +Ստեղծեք ձեր սեփական պատճենը՝ սեղմելով այս էջի վերևում գտնվող `fork` կոճակը: +Դա կստեղծի այս պահոցի պատճենը ձեր պրոֆիլում: + +## Կլոնավորեք պահոցը + +clone this repository + +Հիմա կլոնավորեք պահոցը ձեր համակարգչում: Հղումը պատճենելու համար սեղմեք `clone` կոճակը, այնուհետև `copy to clipboard` կոճակը: + +Բացեք տերմինալը և գործարկեք հետևյալ git հրամանը. + +``` +git clone "url you just copied" +``` + +Որտեղ "url you just copied"-ը (առանց չակերտների) ձեր պահոցի հղումն է (այս նախագծի ձեր ճյուղավորումը). Հետևեք քայլերին, որպեսզի ստանաք հղումը. + +copy URL to clipboard + +Օրինակ՝ + +``` +git clone https://github.com/this-is-you/first-contributions.git +``` + +Որտեղ `this-is-you`-ն github-ի ձեր մուտքանունն է. Այսպիսով դուք պատճենում եք first-contributions պահոցը՝ GitHub-ից, ձեր համակարգչի վրա: + +## Ստեղծեք ճյուղ + +Մուտք գործեք ձեր համակարգչում գտնվող պահոցը, եթե արդեն այնտեղ չեք։ + +``` +cd first-contributions +``` + +Հիմա ստեղծեք նոր ճյուղ՝ օգտագործելով `git checkout` հրամանը․ + +``` +git checkout -b +``` + +Օրինակ՝ + +``` +git checkout -b add-alonzo-church +``` + +## Կատարեք անհրաժեշտ փոփոխությունները և կատարեք ձեր ներդրումը (commit) + +Հիմա բացեք `Contributors.md` ֆայլը ձեր տեքստային խմբագրիչում, գրեք ձեր անունը և պահպանեք ֆայլը։ Մի ավելացրեք այն ֆայլի սկզբում կամ վերջում: Տեղադրեք այն որևէ տեղ մեջտեղում: Այժմ պահպանեք ֆայլը: + +git status + +Եթե գնաք նախագծի պանակ և կատարեք `git status` հրամանը, կտեսնեք, որ փոփոխություններ կան: + +Ավելացրեք այդ փոփոխությունները այն ճյուղին, որը հենց նոր ստեղծեցիք՝ օգտագործելով `git add` հրամանը. + +``` +git add Contributors.md +``` + +Այժմ գործադրեք այս փոփոխությունները `git commit` հրամանով. + +``` +git commit -m "Add to Contributors list" +``` + +Փոփոքեք ``-ը ձեր անունով + +## Push արեք փոփոխությունները github + +Push արեք ձեր փոփոխությունները `git push` հրամանով․ + +``` +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` կոճակը։ Սեղմեք այդ կոճակը։ + +create a pull request + +Ապա հաստատեք pull հարցումը: + +submit pull request + +Շուտով ես կմիավորեմ ձեր բոլոր փոփոխությունները այս նախագծի գլխավոր մասնաճյուղի մեջ: Փոփոխությունները միաձուլվելուց հետո դուք կստանաք ծանուցող նամակ: + +## Ու՞ր գնալ այստեղից + +Շնորհավորանքնե՛րս, դուք հենց նոր ավարտեցիք ստանդարտ _fork -> clone -> edit -> pull request_ աշխատակարգը, որը հաճախ կհանդիպեք որպես ներդրող: + +Նշեք ձեր ներդրումը և կիսվեք այն ձեր ընկերների և հետևորդների հետ՝ այցելելով [web app](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). + +### [Լրացուցիչ նյութեր](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) | diff --git a/docs/translations/README.id.md b/docs/translations/README.id.md new file mode 100644 index 00000000..7e9871e2 --- /dev/null +++ b/docs/translations/README.id.md @@ -0,0 +1,135 @@ +[![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) + +# Kontribusi Pertama + +Proyek ini bertujuan untuk menyederhanakan dan membimbing perjalanan seorang pemula berkontribusi di Github untuk pertama kali. Pertahatikan 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 this repository + +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 + +clone this repository + +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 disalin" +``` + +bagian "url yang telah disalin" (tanpa tanda petik) adalah url ke repositori ini (proyek yang telah Anda _fork_ ini). Lihat langkah sebelumnya untuk mendapatkan url. + +copy URL to clipboard + +Sebagai contoh: + +``` +git clone https://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 +``` + +Sebagai contoh: + +``` +git checkout -b add-alonzo-church +``` + +## 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. + +git status + +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. + +
+ +## Kirim Perubahan Untuk Diperiksa + +Jika Anda membuka repositori Anda di GitHub, Anda akan melihat sebuah tombol `Compare & pull request`. Tekan tombol tersebut. + +create a pull request + +Sekarang kirimkan _Pull Request_ + +submit 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). + +Anda dapat bergabung dengan tim Slack kami jika Anda membutuhkan bantuan atau memiliki pertanyaan. [Bergabung dengan tim Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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 + +| 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) | diff --git a/docs/translations/README.igb.md b/docs/translations/README.igb.md new file mode 100644 index 00000000..31838e80 --- /dev/null +++ b/docs/translations/README.igb.md @@ -0,0 +1,128 @@ +[![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) + +# 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 this repository + +Ọ 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 + +clone this repository + +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. + +copy URL to clipboard + +Ọ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ụ. + +create a pull request + +Ugbu a, rịọ arịrịọ ahụ. + +submit pull request + +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). + +Ị nwere ike isonyere ndị ọrụ anyị na-adịghị mma na ikpe ịchọrọ enyemaka ọ bụla ma ọ bụ nwee ajụjụ ọ bụla. [Jikọọ slack otu](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.it.md b/docs/translations/README.it.md new file mode 100644 index 00000000..286247a3 --- /dev/null +++ b/docs/translations/README.it.md @@ -0,0 +1,128 @@ +[![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) + +# 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. + +fork this 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 + +clone this 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. + +copy URL to clipboard + +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. + +create a pull request + +Ora invia la pull request. + +submit pull request + +Presto avrò incorporato (*merge*) tutti i tuoi cambiamenti nel master branch di questo progetto. Ti arriverà 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) | diff --git a/docs/translations/README.ja.md b/docs/translations/README.ja.md new file mode 100644 index 00000000..87298acd --- /dev/null +++ b/docs/translations/README.ja.md @@ -0,0 +1,115 @@ +[![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 + +初めてのことは何でも大変なものです。特に他人と協力する時に、間違うのは気持ちの良いことではありません。しかし、オープンソースにおける活動では協力することが全てです。私たちは初めてオープンソースへの貢献を行う人たちが簡単に貢献する方法を学べるようにしたいと考えています。 + +記事を読んだりチュートリアルをやってみることはためになりますが、実際にやってみる方が良いでしょう。このプロジェクトはそのガイダンスを行い、初心者が最初のオープンソースへの貢献を簡単に行えるようにするためのものです。
+初めてのオープンソースへの貢献を行いたい場合、以下の簡単なステップに従ってください。 + +#### *コマンドラインでの操作に慣れていない場合、[グラフィカルなツールでもチュートリアルを行えます。]( #その他のツールを使用したチュートリアル )* + +fork this repository + +まだGitをインストールしていない場合は、[ここ](https://help.github.com/articles/set-up-git/)からインストールしてください + +## リポジトリをフォーク + +Forkボタンをクリックしてこのリポジトリをフォークしてください。 +この作業はあなたのアカウントにこのリポジトリのコピーを作ります。 + +## リポジトリをクローン + +clone this repository + +次にフォークしたリポジトリをクローンします。あなたのリポジトリに移動してフォークしたリポジトリを開き*Code*ボタンをクリックした後に*Copy to clipboard*アイコンをクリックしてください。 + +ターミナルを開いて以下のgitコマンドを実行してください： + +``` +git clone "コピーしたURL" +``` +"コピーしたURL" (ダブルクオーテーションは除いてください) は先ほどコピーしたリポジトリのURLと置き換えてください。 + +copy URL to clipboard + +例： +``` +git clone https://github.com/＜あなたのユーザー名＞/first-contributions.git +``` +`あなたのユーザー名` はご自身のGitHubユーザー名に置き換えてください。この作業でGitHub のリポジトリの内容はあなたのコンピュータに保存されました。 + +## ブランチを作成 + +もしリポジトリのディレクトリにいなければそこまで移動してください。 + +``` +cd first-contributions +``` +`git switch` コマンドを使用してブランチを作成します： +``` +git switch -c +``` + +例: +``` +git switch -c add-alonzo-church +``` +(ブランチの名前には必ずしも*add*が含まれていなければならないわけではありませんが、このブランチの目的があなたの名前をリストに加えることであることを考慮すれば含むのが適切です。) + +## コードを変更してその変更をコミット + +テキストエディタで`Contributors.md`ファイルを開いてあなたの名前を追加してください。ただし、ファイルの先頭または最後に追加しないようにしましょう。名前リストの間のどこか好きな場所に、あなたの名前を追加するようにしてください。あなたの名前をファイルに加えたら、ファイルを保存します。 + +git status + +プロジェクトディレクトリに移動して`git status`を実行すると、変更がなされたことが確認できると思います。`git add`コマンドを使ってそれらの変更を適用してください。 +``` +git add Contributors.md +``` + +次に`git commit`コマンドを使ってこれらの変更をコミットします。 +``` +git commit -m "Add <あなたの名前> to Contributors list" +``` +`<あなたの名前>`をご自身の名前に置き換えてください。 + +## GitHubに変更をpushする + +`git push`コマンドを使って変更をpushしてください。 +``` +git push origin <ブランチ名> +``` +`<ブランチ名>`には先ほど作成したブランチ名を入れてください。 + +## レビューのためにプルリクエストを送る + +GitHub上であなたのリポジトリに行くと、`Compare & pull request`ボタンが表示されます。そのボタンをクリックしてください。 + +create a pull request + +プルリクエストを作ってください。 + +submit pull request + +すぐに変更がこのプロジェクトのmainブランチにマージされます。マージが終了した際にはその旨のメールが送られます。 + +## 次に何をするべきか + +おめでとうございます！ コントリビューターとして重要な _フォーク -> クローン -> 編集 -> プルリクエスト_　の基本的なワークフローが完了しました。 + +初めてのオープンソースへの貢献を祝って友達やフォロワーに[このウェブアプリ](https://firstcontributions.github.io/#social-share)を使ってシェアしましょう。 + +もし何かしら質問があるようでしたら[私たちのSlack team](https://firstcontributors.slack.com/join/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY)に入ってください。 + +他のプロジェクトへの貢献を始めましょう。簡単なイシューが立てられているプロジェクトのリストを作りました。ウェブアプリで[プロジェクトリスト](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) | diff --git a/docs/translations/README.ka.md b/docs/translations/README.ka.md new file mode 100644 index 00000000..bfdd7426 --- /dev/null +++ b/docs/translations/README.ka.md @@ -0,0 +1,89 @@ +[![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) + + +# ಮೊದಲ ಕೊಡುಗೆಗಳು + +ಈ ಯೋಜನೆಯು ಆರಂಭಿಕರು ತಮ್ಮ ಮೊದಲ ಕೊಡುಗೆಯನ್ನು ನೀಡುವ ವಿಧಾನವನ್ನು ಸರಳಗೊಳಿಸುವ ಮತ್ತು ಮಾರ್ಗದರ್ಶನ ಮಾಡುವ ಗುರಿಯನ್ನು ಹೊಂದಿದೆ. ನಿಮ್ಮ ಮೊದಲ ಕೊಡುಗೆಯನ್ನು ನೀಡಲು ನೀವು ಬಯಸಿದರೆ, ಕೆಳಗಿನ ಹಂತಗಳನ್ನು ಅನುಸರಿಸಿ. + +_ನೀವು ಆಜ್ಞಾ ಸಾಲಿನೊಂದಿಗೆ ಆರಾಮದಾಯಕವಲ್ಲದಿದ್ದರೆ,[GUI ಉಪಕರಣಗಳನ್ನು ಬಳಸುವ ಟ್ಯುಟೋರಿಯಲ್‌ಗಳು ಇಲ್ಲಿವೆ.](#tutorials-using-other-tools)_ + +fork this repository + +ನಿಮ್ಮ ಯಂತ್ರದಲ್ಲಿ ನೀವು ಜಿಟ್ ಹೊಂದಿಲ್ಲದಿದ್ದರೆ,[ಅದನ್ನು ಸ್ಥಾಪಿಸಿ](https://help.github.com/articles/set-up-git/) + +## ಈ ರೀಪಾಜ಼ಟೊರೀ ಫೋರ್ಕ್ ಮಾಡಿ + +ಈ ಪುಟದ ಮೇಲ್ಭಾಗದಲ್ಲಿರುವ ಫೋರ್ಕ್ ಬಟನ್ ಅನ್ನು ಕ್ಲಿಕ್ ಮಾಡುವ ಮೂಲಕ ಈ ರೆಪೊಸಿಟರಿಯನ್ನು ಫೋರ್ಕ್ ಮಾಡಿ. +ಇದು ನಿಮ್ಮ ಖಾತೆಯಲ್ಲಿ ಈ ರೆಪೊಸಿಟರಿಯ ನಕಲನ್ನು ರಚಿಸುತ್ತದೆ. + +## ರೆಪೊಸಿಟರಿ ಕ್ಲೋನ್ + +clone this repository + +ಈಗ ನಿಮ್ಮ ಯಂತ್ರಕ್ಕೆ ಫೋರ್ಕ್ಡ್ ರೆಪೊಸಿಟರಿಯನ್ನು ಕ್ಲೋನ್ ಮಾಡಿ. ನಿಮ್ಮ GitHub ಖಾತೆಗೆ ಹೋಗಿ, ಫೋರ್ಕ್ ಮಾಡಿದ ರೆಪೊಸಿಟರಿಯನ್ನು ತೆರೆಯಿರಿ, ಕೋಡ್ ಬಟನ್ ಅನ್ನು ಕ್ಲಿಕ್ ಮಾಡಿ ಮತ್ತು ನಂತರ _copy to clipboard_ ಐಕಾನ್ ಅನ್ನು ಕ್ಲಿಕ್ ಮಾಡಿ. + +ಟರ್ಮಿನಲ್ ತೆರೆಯಿರಿ ಮತ್ತು ಕೆಳಗಿನ git ಆಜ್ಞೆಯನ್ನು ಚಲಾಯಿಸಿ: + +``` +git clone "url ನೀವು ಇದೀಗ ನಕಲಿಸಿದ್ದೀರಿ" +``` +ಎಲ್ಲಿ "url ನೀವು ಇದೀಗ ನಕಲಿಸಿದ್ದೀರಿ" (ಉದ್ಧರಣ ಚಿಹ್ನೆಗಳಿಲ್ಲದೆ) ಈ ಭಂಡಾರಕ್ಕೆ url ಆಗಿದೆ (ಈ ಯೋಜನೆಯ ನಿಮ್ಮ ಫೋರ್ಕ್). Url ಪಡೆಯಲು ಹಿಂದಿನ ಹಂತಗಳನ್ನು ನೋಡಿ. + +copy URL to clipboard + +ಉದಾಹರಣೆಗೆ: +``` +git clone https://github.com/this-is-you/first-contributions.git +``` +ಅಲ್ಲಿ `ಇದು-ನೀವು 'ನಿಮ್ಮ ಗಿಟ್‌ಹಬ್ ಬಳಕೆದಾರಹೆಸರು. ಇಲ್ಲಿ ನೀವು ನಿಮ್ಮ ಕಂಪ್ಯೂಟರ್‌ಗೆ ಗಿಟ್‌ಹಬ್‌ನಲ್ಲಿನ ಮೊದಲ ಕೊಡುಗೆಗಳ ಭಂಡಾರದ ವಿಷಯಗಳನ್ನು ನಕಲಿಸುತ್ತಿದ್ದೀರಿ. +## ಒಂದು ಶಾಖೆಯನ್ನು ರಚಿಸಿ +ನಿಮ್ಮ ಕಂಪ್ಯೂಟರ್‌ನಲ್ಲಿ ರೆಪೊಸಿಟರಿ ಡೈರೆಕ್ಟರಿಗೆ ಬದಲಾಯಿಸಿ (ನೀವು ಈಗಾಗಲೇ ಇಲ್ಲದಿದ್ದರೆ): +``` +cd first-contributions +``` +ಈಗ `git checkout` ಆಜ್ಞೆಯನ್ನು ಬಳಸಿಕೊಂಡು ಒಂದು ಶಾಖೆಯನ್ನು ರಚಿಸಿ: +``` +git checkout -b <ನಿಮ್ಮ ಹೊಸ-ಶಾಖೆ-ಹೆಸರನ್ನು ಸೇರಿಸಿ> +``` +ಉದಾಹರಣೆಗೆ: +``` +git checkout -b add-alonzo-church +``` +(ಶಾಖೆಯ ಹೆಸರಿನಲ್ಲಿ `add` ಎಂಬ ಪದವನ್ನು ಹೊಂದುವ ಅಗತ್ಯವಿಲ್ಲ, ಆದರೆ ಇದನ್ನು ಸೇರಿಸುವುದು ಸಮಂಜಸವಾದ ವಿಷಯ ಏಕೆಂದರೆ ಈ ಶಾಖೆಯ ಉದ್ದೇಶವು ನಿಮ್ಮ ಹೆಸರನ್ನು ಪಟ್ಟಿಗೆ ಸೇರಿಸುವುದು.) +## ಅಗತ್ಯ ಬದಲಾವಣೆಗಳನ್ನು ಮಾಡಿ ಮತ್ತು ಆ ಬದಲಾವಣೆಗಳನ್ನು ಮಾಡಿ +ಈಗ ಪಠ್ಯ ಸಂಪಾದಕದಲ್ಲಿ `Contributor.md` ಫೈಲ್ ಅನ್ನು ತೆರೆಯಿರಿ, ಅದಕ್ಕೆ ನಿಮ್ಮ ಹೆಸರನ್ನು ಸೇರಿಸಿ. ಅದನ್ನು ಫೈಲ್‌ನ ಪ್ರಾರಂಭ ಅಥವಾ ಕೊನೆಯಲ್ಲಿ ಸೇರಿಸಬೇಡಿ. ನಡುವೆ ಎಲ್ಲಿಯಾದರೂ ಇರಿಸಿ. ಈಗ, ಫೈಲ್ ಅನ್ನು ಉಳಿಸಿ. +git status +ನೀವು ಪ್ರಾಜೆಕ್ಟ್ ಡೈರೆಕ್ಟರಿಗೆ ಹೋಗಿ `git status` ಆಜ್ಞೆಯನ್ನು ಕಾರ್ಯಗತಗೊಳಿಸಿದರೆ, ಬದಲಾವಣೆಗಳಿವೆ ಎಂದು ನೀವು ನೋಡುತ್ತೀರಿ. +Add those changes to the branch you just created using the `git add` command: +``` +git add Contributors.md +``` +ಈಗ `git commit` ಆಜ್ಞೆಯನ್ನು ಬಳಸಿಕೊಂಡು ಆ ಬದಲಾವಣೆಗಳನ್ನು ಮಾಡಿ: +``` +git commit -m "ಕೊಡುಗೆದಾರರ ಪಟ್ಟಿಗೆ <ನಿಮ್ಮ- ಹೆಸರು> ಸೇರಿಸಿ" +``` +ನಿಮ್ಮ ಹೆಸರಿನೊಂದಿಗೆ `<ನಿಮ್ಮ- ಹೆಸರು>` ಅನ್ನು ಬದಲಾಯಿಸುತ್ತದೆ. +## ಬದಲಾವಣೆಗಳನ್ನು ಗಿಟ್‌ಹಬ್‌ಗೆ ಪುಶ್ ಮಾಡಿ +`Git push` ಆಜ್ಞೆಯನ್ನು ಬಳಸಿಕೊಂಡು ನಿಮ್ಮ ಬದಲಾವಣೆಗಳನ್ನು ಒತ್ತಿರಿ: +``` +git push origin <ನಿಮ್ಮ ಶಾಖೆಯ ಹೆಸರನ್ನು ಸೇರಿಸಿ> +``` +`` ಅನ್ನು ನೀವು ಮೊದಲು ರಚಿಸಿದ ಶಾಖೆಯ ಹೆಸರಿನೊಂದಿಗೆ ಬದಲಾಯಿಸುತ್ತದೆ. +## ನಿಮ್ಮ ಬದಲಾವಣೆಗಳನ್ನು ವಿಮರ್ಶೆಗಾಗಿ ಸಲ್ಲಿಸಿ +ನೀವು ಗಿಟ್‌ಹಬ್‌ನಲ್ಲಿರುವ ನಿಮ್ಮ ಭಂಡಾರಕ್ಕೆ ಹೋದರೆ, ನೀವು `Compare & pull request` ಬಟನ್ ನೋಡುತ್ತೀರಿ. ಆ ಗುಂಡಿಯನ್ನು ಕ್ಲಿಕ್ ಮಾಡಿ. +create a pull request +ಈಗ ಪುಲ್ ವಿನಂತಿಯನ್ನು ಸಲ್ಲಿಸಿ. +submit pull request +ಶೀಘ್ರದಲ್ಲೇ ನಾನು ನಿಮ್ಮ ಎಲ್ಲಾ ಬದಲಾವಣೆಗಳನ್ನು ಈ ಯೋಜನೆಯ ಮಾಸ್ಟರ್ ಶಾಖೆಯಲ್ಲಿ ವಿಲೀನಗೊಳಿಸುತ್ತೇನೆ. ಬದಲಾವಣೆಗಳನ್ನು ವಿಲೀನಗೊಳಿಸಿದ ನಂತರ ನೀವು ಅಧಿಸೂಚನೆ ಇಮೇಲ್ ಅನ್ನು ಪಡೆಯುತ್ತೀರಿ. +## ಇಂದಿನಿಂದ ಏನು? +ಅಭಿನಂದನೆಗಳು! ನೀವು ಕೊಡುಗೆದಾರರಾಗಿ ಆಗಾಗ್ಗೆ ಎದುರಾಗುವ ಪ್ರಮಾಣಿತ _fork -> clone -> edit -> PR_ ವರ್ಕ್‌ಫ್ಲೋ ಅನ್ನು ನೀವು ಇದೀಗ ಪೂರ್ಣಗೊಳಿಸಿದ್ದೀರಿ! +ನಿಮ್ಮ ಕೊಡುಗೆಯನ್ನು ಆಚರಿಸಿ ಮತ್ತು ಅದನ್ನು ನಿಮ್ಮ ಸ್ನೇಹಿತರು ಮತ್ತು ಅನುಯಾಯಿಗಳೊಂದಿಗೆ ಹಂಚಿಕೊಳ್ಳಿ [ವೆಬ್ ಅಪ್ಲಿಕೇಶನ್](https://firstcontributions.github.io/#social-share). +ನಿಮಗೆ ಯಾವುದೇ ಸಹಾಯ ಬೇಕಾದರೆ ಅಥವಾ ಯಾವುದೇ ಪ್ರಶ್ನೆಗಳಿದ್ದಲ್ಲಿ ನೀವು ನಮ್ಮ slack team ಸೇರಬಹುದು. [Slack team ಸೇರಿ](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) | diff --git a/docs/translations/README.kh.md b/docs/translations/README.kh.md new file mode 100644 index 00000000..762ed300 --- /dev/null +++ b/docs/translations/README.kh.md @@ -0,0 +1,222 @@ +[![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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w) +[![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.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)_ + +fork this repository + +#### ប្រសិនបើអ្នកមិនមាន git នៅលើម៉ាស៊ីនរបស់អ្នក [សូមដំឡើង](https://docs.github.com/en/get-started/quickstart/set-up-git). + +## ស៊ាំសាខានេះ (Fork this repository) + +សូមស៊ាំសាខានេះដោយចុចលើប៊ូតុង Fork ដែលនៅផ្នែកខាងលើនៃទំព័រនេះ។ +វានឹងបង្កើតច្បាប់ចម្លងនៃសាខានេះក្នុងគណនីរបស់អ្នក។ + +## ចម្លងសាខានេះ (Clone the repository) + +clone this repository + +ឥឡូវនេះ ចម្លងសាខាដែលអ្នកបានស៊ាំទៅកាន់កុំព្យូទ័ររបស់អ្នក។ ចូលទៅគណនី GitHub របស់អ្នក បើកសាខាដែលបានស៊ាំ ចុចលើប៊ូតុង Code ហើយចុចលើរូបតំណាង​​ _copy to clipboard_។ + +បើក terminal ហើយដំណើរការពាក្យបញ្ជា git ខាងក្រោម៖ + +```bash +git clone "url you just copied" +``` + +កន្លែងដែល "url ដែលអ្នកទើបតែចម្លង" (ដោយគ្មានសញ្ញាសម្រង់) គឺជា url ទៅកាន់ឃ្លាំងនេះ (ចំនុចប្រសព្វរបស់អ្នកនៃគម្រោងនេះ)។ សូមមើលជំហានមុនដើម្បីទទួលបាន url ។ + +copy URL to clipboard + +ឧទាហរណ៍៖ + +```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 status + +ប្រសិនបើអ្នកចូលទៅកាន់ថតគម្រោង ហើយប្រតិបត្តិពាក្យបញ្ជា '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' ។ ចុចលើប៊ូតុងនោះ។ + +create a pull request + +ឥឡូវនេះដាក់សំណើទាញ។ + +submit 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) | + +

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

+

+ + + +

diff --git a/docs/translations/README.ko.md b/docs/translations/README.ko.md new file mode 100644 index 00000000..99f24392 --- /dev/null +++ b/docs/translations/README.ko.md @@ -0,0 +1,144 @@ +[![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) + +# 첫 기여 + +이 프로젝트는 초보자가 처음으로 오픈소스에 기여할 수 있도록 쉽게 안내하는 것을 목표로 합니다. 첫 번째 기여를 하고 싶다면, 아래의 설명을 따라주세요. + +_만약 명령어 인터페이스에 익숙하지 않다면, [여기에서 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 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)을 통해 공유해보세요. + +도움이 필요하거나 질문이 있다면 저희 slack 팀에 참여할 수 있습니다. → [slack 팀 참여하기](https://firstcontributors.slack.com/join/shared_invite/zt-29qhyr9lt-Bi7WLbgGIFqV7aCEG_grvg#/shared-invite/email) + +이제 다른 프로젝트에도 기여해보세요! 지금 바로 시작할 수 있는 난이도가 낮은 이슈들로 가득찬 목록이 있습니다. [웹앱의 프로젝트 목록](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:

+

+ + + +

diff --git a/docs/translations/README.kr.md b/docs/translations/README.kr.md new file mode 100644 index 00000000..9868bac1 --- /dev/null +++ b/docs/translations/README.kr.md @@ -0,0 +1,222 @@ +[![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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w) +[![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.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. + +git status + +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). + +Heke we hewceyî alîkariyê heye an jî pirsên we hene hûn dikarin beşdarî tîma me ya slack bibin. [Beşdarî tîma slack bibin](https://firstcontributors.slack.com/join/shared_invite/zt-29qhyr9lt-Bi7WLbgGIFqV7aCEG_grvg#/shared-invite/email). + +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:

+

+ + + +

| diff --git a/docs/translations/README.kws.md b/docs/translations/README.kws.md new file mode 100644 index 00000000..51013ea2 --- /dev/null +++ b/docs/translations/README.kws.md @@ -0,0 +1,134 @@ +[![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. 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)* + + +fork this repository + + +## 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 + +clone this repository + +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. + +copy URL to clipboard + +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. + +git status + +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. + +create a pull request + +Sasa weka ombi la kuvuta. + +submit pull request + +Hivi karibuni nitakuwa kuunganisha 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! + +Sherehe mchango wako na uwashiriki na marafiki zako na wafuasi kwa kwenda 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) | diff --git a/docs/translations/README.kz.md b/docs/translations/README.kz.md new file mode 100644 index 00000000..4b6dfd52 --- /dev/null +++ b/docs/translations/README.kz.md @@ -0,0 +1,108 @@ +[![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) + +# Жобаға алғаш рет үлес қосу + +Оңай іс емес, жалпы кез-келген істе алғашқы қадам қиын келеді. Қателіктер жасау өте жағымсыз, әсіресе топтық жұмыс істесеңіз. Барлық open source проекттер ынтымақтастық пен бірегей жұмыстан тұрады. Біз бастаушы әзірлеушілер үшін үлес қосу және бірлесіп жұмыс істеудегі алғашқы қадамдарды жеңілдеткіміз келеді. + +Егер сіз өзіңіздің алғашқы үлесіңізді жасау мүмкіндігін іздесеңіз, төмендегі қарапайым қадамдарды орындаңыз. +fork this repository + + +Егерде сіздің компьютеріңізде git қосылмаған болса, [ оны қосыңыз ]( https://help.github.com/articles/set-up-git/ ) + +## Тармақты (fork) жасаңыз + +Өзіңіздің тармағыңызды жасау үшін, беттің үстіңгі жағындағы `fork` түймесін басыңыз. Осылай сіз осы репозиторийдің өзіңіздің аккаутыңызда копиясын жасайсыз. + +## Репозиторийді клондаңыз + +clone this repository + +Енді бұл репозиторийді өз дербес компьютеріңізге клодаңыз. Сілтемені көшіру үшін `clone` батырмасын басыңыз, содан кейін `copy to clipboard` белгішесіне басыңыз. + +Терминалды ашып, келесі git пәрмендіні іске қосыңыз: + +``` +git clone "url you just copied" +``` +Бұл жерде "url you just copied" (тырнақшасыз) сіздің репозиторийңізге сілтеме. Бұл сілтемені алу үшін алдыңғы қадамдарды қараңыз. + +copy URL to clipboard + +Мысалы: +``` +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 status` орындасаңыз, өзгертулерді көресіз. Бұл өзгертулерді `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` батырмасын көресіз. Оны басыңыз. + +create a pull request + +Енді пулл-реквестті растаңыз. + +submit 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) | + diff --git a/docs/translations/README.la.md b/docs/translations/README.la.md new file mode 100644 index 00000000..1edc9414 --- /dev/null +++ b/docs/translations/README.la.md @@ -0,0 +1,119 @@ +[![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) + +# "Contribute" ຜົນງານໃນ GitHub ຮ່ວມກັບຄົນອື່ນເປັນຄັ້ງທຳອິດແມ່ນບໍ່? + +ມັນເປັນເລື່ອງທີ່ຂ້ອງຂ້າງຍາກໜ້ອຍໜຶ່ງ, ແຕ່ກ້າວທຳອິດໃນການເລີ່ມຕົ້ນເຮັດຫຍັງບາງຢ່າງມັນກໍ່ຈະຍາກແບບນີ້ສະເໝີ ໂດຍສະເພາະເວລາທີ່ຕ້ອງຮ່ວມງານກັບຄົນອື່ນ ເພາະເມື່ອເຮົາໄດ້ເຮັດຫຍັງຜິດພາດມັນກໍ່ມັກຈະເຮັດໃຫ້ເຮົາບໍ່ສະບາຍໃຈ, ແຕ່ວ່າໃນໂລກຂອງໂອເພັນຊອສ (open source) ຄືໂລກທີ່ເຮົາຕ້ອງໄດ້ເຮັດວຽກຮ່ວມກັນ! ເຮົາຈຶ່ງຢາກໃຫ້ຜູ້ທີ່ເຂົ້າມາໃໝ່ໄດ້ຮຽນຮູ້ວິທີການ "ຄອນທຣິບິ້ວ" ຜົນງານຮ່ວມກັບຄົນອື່ນໃນ GitHub ແບບງ່າຍໆ. + +ການອ່ານບົດຄວາມ ແລະ ການທີ່ໄດ້ທົດລອງເຮັດຕົວຢ່າງຕ່າງໆກໍ່ອາດຈະຊ່ວຍໄດ້, ແຕ່ເຖິງຢ່າງໃດກໍ່ຕາມ ຄົງຈະບໍ່ມີສິ່ງໃດເໜືອໄປກວ່າການທີ່ເຮົາໄດ້ລົງມືເຮັດດ້ວຍຕົນເອງ!. ໃນໂປຣເຈັກນີ້ຈະສອນໃຫ້ມືໃໝ່ຮູ້ຈັກການສົ່ງ "contribution" ທຳອິດໄດ້ຢ່າງງ່າຍໆ. + +ໃຫ້ຈື່ໄວ້ວ່າ: ຄວາມພະຍາຍາມຢູ່ທີ່ໃດ ຄວາມພະຍາຍາມກໍ່ຢູ່ທີ່ນັ້ນເຊັ່ນກັນ! + +ຖ້າພ້ອມແລ້ວເຮົາມາລອງສົ່ງ contibution ທຳອິດກັນໄດ້ພຽງບໍ່ເທົ່າໃດຂັ້ນຕອນດ້ານລຸ່ມໄປພ້ອມໆກັນເລີຍ, ບອກເລີຍວ່າງ່າຍກວ່າປອກກ້ວຍ. + +fork this repository + +ຫາກໃຜຍັງບໍ່ໄດ້ຕິດຕັ້ງ git ລົງໃນເຄື່ອງ, ທ່ານສາມາດກົດລິ້ງ[ຕິດຕັ້ງໄດ້ທີ່ນີ້]( https://help.github.com/articles/set-up-git/ ) + +## ກົດ "Fork" ໂປຣເຈັກນີ້ + +ໂປຣເຈັກຫຼັກນີ້ມັກຈະເອີ້ນວ່າ ໂປຣເຈັກຕົ້ນນ້ຳ, ທ່ານສາມາດ fork ໂປຣເຈັກຕົ້ນນ້ຳນີ້ໄປຍັງ repo ຂອງ account ຂອງທ່ານເອງໄດ້ໂດຍການກົດປຸ່ມ "Fork" ທີ່ດ້ານເທິງຂອງໜ້ານີ້. + +ແລ້ວໂປຣເຈັກນີ້ກໍ່ຈະຖືກຄັດລອກໄປທີ່ account ຂອງທ່ານ. + +## ກົດປຸ່ມ "Clone" ໂປຣເຈັກນີ້ + +clone this repository + +ມາຮອດຂັ້ນຕອນນີ້ເຮົາກໍ່ Clone ໂປຣເຈັກລົງມາທີ່ຄອມພິວເຕີຂອງເຮົາໂດຍການກົດທີ່ປຸ່ມ "Clone" ແລ້ວເລືອກ *Copy to clipboard* (ຄຳສັ່ງຄັດລອກ) + +ເປີດ terminal ຂຶ້ນມາ (ຕົວຢ່າງ Terminal ໃນ MacOS ຫຼື cmd ໃນ Windows) ແລ້ວພິມຄຳສັ່ງ git ຕໍ່ໄປນີ້: + +``` +git clone "url ທີ່ຄັດລອກໄວ້" +``` +"url ທີ່ຄັດລອກໄວ້" (ບໍ່ຕ້ອງໃສ່ " ") ຄື url ຂອງໂປຣເຈັກຂອງທ່ານ ທ່ານສາມາດກັບໄປເບິ່ງວິທີການຄັດລອກ url ໄດ້ຈາກຫົວຂໍ້ກ່ອນໜ້ານີ້ + +copy URL to clipboard + +ຕົວຢ່າງ: +``` +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 ເພີ່ມຊື່ຂອງທ່ານລົງໄປ ຈາກນັ້ນບັນທຶກໄຟລ໌ + +git status + +ໃນ 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` + +create a pull request + +ຕອນນີ້ກໍ່ສົ່ງ Pull Request ໄປທີ່ໂປຣເຈັກຫຼັກ ຫຼື ໂປຣເຈັກຕົ້ນນ້ຳໄດ້ເລີຍ + +submit pull request + +ເຮົາຈະທຳການ "Merge" ຫຼື ລວມຜົນງານທີ່ທ່ານໄດ້ປ່ຽນແປງ code ມາທີ່ master branch ຂອງໂປຣເຈັກນີ້, ທ່ານຈະໄດ້ຮັບອີເມວເມື່ອເຮົາໄດ້ທຳການ Merge ຜົນງານຂອງທ່ານສຳເລັດແລ້ວ. + +## ຈະເຮັດຫຍັງຕໍ່ຫຼັງຈາກນີ້? +ຍິນດີນຳ, ທ່ານໄດ້ປະຕິບັດຂັ້ນຕອນຂອງການເຮັດ contribute ຄື fork -> clone -> edit -> pull request ເຊິ່ງຂັ້ນຕອນຕ່າງໆເຫຼົ່ານີ້ເປັນສິ່ງທີ່ທ່ານຕອງໄດ້ພົບເມື່ອທ່ານເປັນ contributor +ສະເຫຼີມສະຫຼອງໃຫ້ແກ່ການມີສ່ວນຮ່ວມຂອງທ່ານ, ຢ່າລືມແບ່ງປະສົບການທີ່ທ່ານໄດ້ຮັບໃຫ້ແກ່ໝູ່ເພື່ອນຂອງທ່ານ ໂດຍໄປທີ່ [ເວັບໄຊນີ້](https://firstcontributions.github.io/#social-share) + +ຫຼືຈະມີສ່ວນຮ່ວມກັບເຮົາຜ່ານ Slack ໃນກໍລະນີທີ່ທ່ານຕ້ອງການຄວາມຊ່ວຍເຫຼືອ ຫຼື ມີຂໍ້ສົງໄສໃດໆ [ເຂົ້າຮ່ວມ slack ກັບພວກເຮົາ](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) + +ຈາກນີ້ທ່ານສາມາດ 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)| + diff --git a/docs/translations/README.lt.md b/docs/translations/README.lt.md new file mode 100644 index 00000000..f7a75434 --- /dev/null +++ b/docs/translations/README.lt.md @@ -0,0 +1,109 @@ +[![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) + + +# 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 daro pirmąjį indėlį. Prisiminkite: kuo labiau esate atsipalaidavęs, tuo geriau mokotės. Jei norite atlikti pirmąjį indėlį, atlikite toliau pateiktus paprastus veiksmus. Mes pažadame, tai bus smagu. + +fork this repository + +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ą + +clone this repository + +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 "kopijuota nuoroda" +``` +kur "kopijuota nuoroda" (be citatos ženklų) yra url nuoroda jūsų saugyklai. Peržiūrėkite ankstesnius veiksmus, kad gautumėte url nuorodą. + +copy URL to clipboard + +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 checkout`: +``` +git checkout -b +``` + +Pavyzdžiui: +``` +git checkout -b add-vardenis-pavardenis +``` +(Saugyklos pavadinime neturi būti žodžio *add*, bet tai yra reikalinga, kadangi šios šakos (branch) paskirtis yra įtraukti savo vardą į sąrašą.) + +## Atlikite reikiamus pakeitimus ir pridėkite (commit) šiuos pakeitimus + +Dabar atidarykite failą `Contributors.md` teksto redaktoriuje, pridėkite prie jo savo vardą ir 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. + +## Pateikite pakeitimus peržiūrai + +Eikite į savo saugyklą GitHub. Pamatysite mygtuką `Compare & pull request` (palyginti ir įtraukti užklausą). Spustelėkite šį mygtuką. + +create a pull request + +Dabar pateikite įtraukimo į pradinę saugyklą (pull) užklausą. + +submit pull request + +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). + +Prisijunkite prie mūsų "slack" komandos, jei jums reikia pagalbos ar turite klausimų. [Prisijungti prie slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.lug.md b/docs/translations/README.lug.md new file mode 100644 index 00000000..a21a9018 --- /dev/null +++ b/docs/translations/README.lug.md @@ -0,0 +1,125 @@ +[![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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w) +[![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)_ + +fork this 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 + +clone this 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. + +copy URL to 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. + +git status + +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. + +create a pull request + +Kati weereza pull request. + +submit 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). + +Osobola okuyingira ku team ya slack bw'oba oyagala obuyambi obulala oba olina ebibuuzo. [Yingira team ya slack.](https://firstcontributors.slack.com/join/shared_invite/zt-29qhyr9lt-Bi7WLbgGIFqV7aCEG_grvg#/shared-invite/email). + +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) | + diff --git a/docs/translations/README.lv.md b/docs/translations/README.lv.md new file mode 100644 index 00000000..66f86b2f --- /dev/null +++ b/docs/translations/README.lv.md @@ -0,0 +1,123 @@ +[![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) + + +# 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 )* + + +fork this repository + +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 + +clone this repository + +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: + +``` +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. + +copy URL to clipboard + +Piemēram: +``` +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ā): + +``` +cd first-contributions +``` +Tagad izveido zaru ar `git checkout` komandu: +``` +git checkout -b +``` + +Piemēram: +``` +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: + +``` +git add Contributors.md +``` + +Tagad iesūti šīs izmaiņas ar `git commit` komandu: +``` +git commit -m "Add to Contributors list" +``` +aizvietojot `` ar savu vārdu. + +## Pievieno izmaiņas GitHub + +Pievieno savas izmaiņas ar komandu `git push`: +``` +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. + +create a pull request + +Tagad iesniedz pievienotās izmaiņas. + +submit 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). + +Tu vari pievienoties arī mūsu slack komandai, ja tev nepieciešama palīdzība vai ir kādi jautājumi. [Pievienojies slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.ma.md b/docs/translations/README.ma.md new file mode 100644 index 00000000..f4c0d0d8 --- /dev/null +++ b/docs/translations/README.ma.md @@ -0,0 +1,141 @@ +[![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 : + +``` +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 : +``` +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 ) : + +``` +cd first-contributions +``` +Daba ha kifach ghatswb branch dyalk `git checkout` : +``` +git checkout -b "smya_dlbranch" +``` + +Par exemple : +``` +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` : +``` +git add Contributors.md +``` + +Sauvegardeha b `git commit`: +``` +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` : +``` +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 + ``` + git checkout main + ``` + +zid lien d repo as `upstream remote url` : +``` +git remote add upstream https://github.com/smytk_d_github/first-contributions +``` +Ghi dik changes ydaro , 5ssk moraha tjbd version jdida dyal repo dyalk: +``` +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) : +``` +git rebase upstream/main +``` +Daba ga3 tghyirat kaynin fl main. ila pushiti modifications aydaro ta f fork dyalk : +``` +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 : +``` +git branch -d +``` +w ymklk t7yda ta mn repo li b3ida : +``` +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) + diff --git a/docs/translations/README.me.md b/docs/translations/README.me.md new file mode 100644 index 00000000..71405b8c --- /dev/null +++ b/docs/translations/README.me.md @@ -0,0 +1,129 @@ +[![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) + +# 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 komadu `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). + +Ukoliko vam je potrebna pomoć ili imate neka pitanja, možete da se priključite našem [Slack timu](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.mg.md b/docs/translations/README.mg.md new file mode 100644 index 00000000..2cb9a192 --- /dev/null +++ b/docs/translations/README.mg.md @@ -0,0 +1,145 @@ +[![L'amour du logiciel libre](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) + + +# 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) + diff --git a/docs/translations/README.mk.md b/docs/translations/README.mk.md new file mode 100644 index 00000000..09edeefd --- /dev/null +++ b/docs/translations/README.mk.md @@ -0,0 +1,124 @@ +[![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) + + +# Први чекори + +Тешко е. Секогаш е тешко кога нешто се прави за прв пат. Кога соработуваме со други луѓе, правењето грешки е непријатно. Затоа сакавме да го поедноставиме начинот на кој новите соработници на отворен код учат и допринесуваат за прв пат. + +Читањето на статии и гледањето на видеа помага до некаде, но нема подобар начин за учење од вежбањето. Целта на овој проект е да се обезбеди вежба и да се поедностави начинот по кој почетниците допринесуваат отворен код. Ако сакате да го направите својот прв придонес, тогаш следете ги долунаведените чекори. + +#### *Ако не сакате да користите command line (терминал), [овде имате упатства за GUI](#Вежби-за-користење-на-други-програми)* + + +fork this repository + +Ако немате git на вашиот компјутер, [инсталирајте го]( https://help.github.com/articles/set-up-git/). + +## Направете Разгранување (Fork) на ова складиште (repository) + +Направете разгранување на складиштето со притискање на копчето "Fork" кое се наоѓа на горниот дел на оваа страница. +Вака ќе направите копија на складиштето во вашиот GitHub профил. + +## Клонирајте го овоа складиште + +clone this repository + +Сега треба да го клонирате складиштето во вашиот компјутер. Отидете во вашиот GitHub профил, отворете го разгранетото складиште, +кликнете на копчето "Clone" и копирајте го линкот. Исто така може да притиснете на иконата за копирање (Copy to clipboard) + +Отворете го терминалот и воведете ја следната команда: + +``` +git clone "линкот кој го копиравте" +``` +На местото на "линкот кој го копиравте" (без наводници) поставете го линкот на складиштето (Вашето Разгранување на овој проект). Погледнете ги претходните чекори за да видете како да го добиете линкот. + +copy URL to clipboard + +На пример: +``` +git clone https://github.com/vashiot-username/first-contributions.git +``` +со преименување на `vashiot-username` во вашето корисничко име. Во овој чекор правите копија на складиштето first-contributions од GitHub кон вашиот компјутер. + +## Создавање на гранка (branch) + +Променете ја локацијата на складиштето во вашиот компјутер (Ако сеуште не сте ја промениле): + +``` +cd first-contributions +``` +Сега создајте гранка со помош на командата `git checkout`: +``` +git checkout -b +``` + +На пример: +``` +git checkout -b add-alonzo-church +``` +(Името на гранката не мора да го содржи зборот *add*, но се препорачува, затоа што целта на оваа гранка е да го додадете вашето име во списокот.) + +## Направете ги потребните промени и извршете (commit) ги + +Сега отворете го фајлот `Contributors.md` во уредник за текст и додадете го вашето име. Не додавајте го на почетокот или крајот на фајлот. Поставете го некаде на средината. Зачувајте ги промените. + +git status + + +Ако ја извршете командата `git status` во директоријата на складиштето, ќе забележите дека има промени. + + +Зачувајте ги промените на создадената гранката со помош на командата `git add`: + +``` +git add Contributors.md +``` + +Сега извршете ги промените со командата `git commit`: +``` +git commit -m "Add to Contributors list" +``` +со промена на `` со вашето име. + +## Поставете (Push) ги промените во GitHub + +Поставете ги вашите промени со командата `git push`: +``` +git push origin +``` +со промена на `` во името на вашата гранка, која ја создадовте претходно. + +## Поднесете ги вашите промени за преглед. + +Ако отидете во вашето складиште во GitHub, ќе го забележите копчето `Compare & pull request`. Притиснете го. + +create a pull request + +Сега поднесете ги вашите промени за преглед. + +submit pull request + +Наскоро ќе ги спојам (merge) сите ваши промени во главната гранка (мастер branch) на овој проект. Ќе бидете известени по пат на електронска пошта за спојот на вашите промени. + +## Што е следно? + +Честитки! Само што ги завршивте _fork -> clone -> edit -> PR_ операции, со кои ќе се соочувате често како соработник! + +Прославете ги вашите придонеси и споделете ги со пријатели и следители со посета на [веб-апликацијата](https://firstcontributions.github.io/#social-share). + +Можете да станете дел од нашиот slack team ако ви треба помош или имате прашања [Стани дел](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 | 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) | diff --git a/docs/translations/README.ml.md b/docs/translations/README.ml.md new file mode 100644 index 00000000..0568b4af --- /dev/null +++ b/docs/translations/README.ml.md @@ -0,0 +1,137 @@ +[![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) + +ആദ്യമായി ഒരു കാര്യം ചെയ്യുക എന്നുള്ളത് വളരെ ബുദ്ധിമുട്ടാണ്. പ്രത്യേകിച്ച്, മറ്റു പലരുടെയും ഒപ്പം ജോലി ചെയ്യുമ്പോൾ തെറ്റ് വരുന്നത് അത്ര സുഖകരമായ കാര്യം അല്ല. സ്വതന്ത്ര സോഫ്റ്റ്‌വെയറിലേക്ക് ആദ്യമായി സംഭാവന ചെയ്യുന്നവർക്ക് അതിനെ പറ്റി പഠിക്കാനും പങ്കാളി ആകുവാനും വേണ്ടി കുറച്ച്‌ കൂടെ എളുപ്പമായ എന്തെങ്കിലും ഉണ്ടാക്കണമെന്നായിരുന്നു ഞങ്ങളുടെ ആഗ്രഹം. +ലേഖനങ്ങൾ വായിക്കുന്നതും വീഡിയോ കാണുന്നതും ഒക്കെ സഹായകരമാണ്. പക്ഷേ ചെയ്ത് തന്നെ പഠിക്കുന്നതാണ് ഏറ്റവും നല്ലത്. + + +ഈ പ്രൊജക്റ്റ് ഇതിനെ പറ്റി പരിചയം ഇല്ലാത്ത ഒരാൾക്ക് ആദ്യത്തെ സംഭാവന നല്കാൻ ഉള്ള ഒരു വഴികാട്ടി ആണ്. + + +നിങ്ങളും നിങ്ങളുടെ ആദ്യ സംഭാവന നൽകാൻ ആഗ്രഹിക്കുന്നു എങ്കിൽ താഴെ പറയുന്നത് പോലെ ചെയ്യുക. + + +#### *താങ്കൾക്ക് കമാൻഡ് ലൈൻ ഉപയോഗിച്ച്‌ പരിചയം ഇല്ലെങ്കിൽ, [GUI ഉപയോഗിച്ച് ചെയ്യാൻ ഉള്ള നിർദേശങ്ങൾ ഇവിടെ ലഭ്യമാണ്](#മറ്റു-ഉപകരണങ്ങൾ-ഉപയോഗിച്ച്-ചെയ്യുന്നതിനെ-പറ്റിയുള്ള-ലേഖനങ്ങൾ)*. + +fork this repository + +താങ്കളുടെ കമ്പ്യൂട്ടറിൽ ഗിറ്റ് (git) ഇല്ലെങ്കിൽ, [ഇൻസ്റ്റാൾ ചെയ്യുക](https://help.github.com/articles/set-up-git/). + +## ഈ റെപ്പോസിറ്ററി ഫോർക്ക് (fork) ചെയ്യുക + +ഈ പേജിന്റെ ഏറ്റവും മുകളിൽ ഉള്ള ഫോർക്ക് ബട്ടൺ ഉപയോഗിച്ച് ഈ റെപ്പോസിറ്ററി ഫോർക്ക് ചെയ്യുക. ഇങ്ങനെ ചെയ്യുമ്പോൾ നിങ്ങളുടെ അക്കൗണ്ടിൽ ഈ റെപ്പോസിറ്ററിയുടെ ഒരു പകർപ്പ് സൃഷ്ടിക്കപ്പെടുന്നു. + +## ഈ റെപ്പോസിറ്ററി ക്ലോൺ (clone) ചെയ്യുക + +clone this repository + +ഇനി ഫോർക്ക് ചെയ്ത റെപ്പോസിറ്ററി നിങ്ങളുടെ കമ്പ്യൂട്ടറിലേക്ക് ക്ലോൺ ചെയ്യുക. നിങ്ങളുടെ ഗിറ്റ്ഹബ് (GitHub) അക്കൗണ്ട് എടുത്ത് അതിൽ ഫോർക്ക് ചെയ്ത റെപ്പോസിറ്ററി തുറക്കുക. എന്നിട്ട് മുകളിൽ ക്ലോൺ ബട്ടണിലെ *കോപ്പി ടു ക്ലിപ്പ് ബോർഡ് (Copy to clipboard)* എന്ന ഐക്കൺ ക്ലിക്ക് ചെയ്യുക. + +എന്നിട്ട് ഒരു ടെർമിനൽ എടുത്ത് താഴെ പറയുന്ന ഗിറ്റ് കമാൻഡ് റൺ ചെയ്യുക: + +``` +git clone <നിങ്ങളുടെ-ലിങ്ക്> +``` + +ഇതിൽ `<നിങ്ങളുടെ-ലിങ്ക്>` എന്ന് പറയുന്നത് താങ്കളുടെ (ഫോർക്ക് ചെയ്ത) റെപ്പോസിറ്ററി ലിങ്ക് ആണ്. ലിങ്ക് എങ്ങനെ കോപ്പി ചെയ്യാം എന്നറിയാൻ ഇതിനു മുൻപ് ഉള്ള നിർദേശം നോക്കുക. + +copy URL to clipboard + +ഉദാഹരണം: + +``` +git clone https://github.com/<താങ്കൾ>/first-contributions.git +``` + +ഇതിൽ `<താങ്കൾ>` എന്നതിന് പകരം നിങ്ങളുടെ ഗിറ്റ്ഹബ് യൂസർനെയിം കൊടുക്കുക. ഇപ്പോൾ നിങ്ങൾ ചെയ്യുന്നത് നിങ്ങളുടെ ഗിറ്റ്ഹബിലെ ഫസ്റ്റ്-കോണ്ട്രിബൂഷൻസ് (first-contributions) റെപ്പോസിറ്ററിയിൽ ഉള്ളവ നിങ്ങളുടെ കമ്പ്യൂട്ടറിലേക്ക് കോപ്പി ചെയ്യുകയാണ്. + +## ഒരു ശാഖ (ബ്രാഞ്ച്, Branch) ഉണ്ടാക്കുക + +നിങ്ങളുടെ റെപ്പോസിറ്ററിയിലേക്ക് കടക്കുക: + +``` +cd first-contributions +``` + +എന്നിട്ട് `git checkout` എന്ന കമാൻഡ് ഉപയോഗിച്ച് ഒരു ബ്രാഞ്ച് ഉണ്ടാക്കുക: + +``` +git switch -c <നിങ്ങളുടെ-പുതിയ-ബ്രാഞ്ചിന്റെ-പേര്> +``` + +ഉദാഹരണം: + +``` +git switch -c add-alonzo-church +``` + +(ബ്രാഞ്ചിന്റെ പേരിൽ add എന്ന് ഉണ്ടാകണം എന്ന് നിർബന്ധം ഇല്ല. പക്ഷെ നിങ്ങളുടെ ഉദ്ദേശം നിങ്ങളുടെ പേര് ഇതിൽ ഉൾപ്പെടുത്തണം എന്നത് ആണെന്നതിനാൽ അത് കൊടുക്കുന്നതാണ് നല്ലത്.) + +## ആവശ്യത്തിനുള്ള വ്യത്യാസങ്ങൾ വരുത്തി അവ കമ്മിറ്റ് (commit) ചെയ്യുക + +ഇനി `Contributors.md` എന്ന ഫയൽ ഒരു എഡിറ്റർ ഉപയോഗിച്ച് തുറന്നതിനു ശേഷം താങ്കളുടെ പേര് അതിൽ ഉൾപ്പെടുത്തുക. അങ്ങനെ ചെയ്യുമ്പോൾ തുടക്കത്തിലോ അവസാനത്തിലോ അല്ലാതെ ഇടയിൽ എവിടെയെങ്കിലും ഉൾപെടുത്തുക. എന്നിട്ട് ആ ഫയൽ സേവ് ചെയ്യുക. + +git status + +താങ്കളുടെ പ്രൊജക്റ്റ് ഡയറക്ടറിയിൽ ചെന്ന് `git status` എന്ന കമാൻഡ് അടിച്ചു നോക്കിയാൽ താങ്കൾ വരുത്തിയ വ്യത്യാസങ്ങൾ കാണാൻ സാധിക്കും. + +ഈ വ്യത്യാസങ്ങൾ `git add` കമാൻഡ് ഉപയോഗിച്ച്‌ നിങ്ങളുടെ ബ്രാഞ്ചിലേക്ക് ചേർക്കുക: + +``` +git add Contributors.md +``` + +ഇനി നിങ്ങൾ ഉണ്ടാക്കിയ വ്യത്യാസങ്ങൾ `git commit` കമാൻഡ് ഉപയോഗിച്ച് കമ്മിറ്റ് ചെയ്യുക: + +``` +git commit -m "Add <താങ്കളുടെ-പേര്> to Contributors list" +``` + +ഇതിൽ `<താങ്കളുടെ-പേര്>` എന്ന സ്ഥാനത്ത് താങ്കളുടെ ശരിയായ പേര് കൊടുക്കുക. + +## വ്യത്യാസങ്ങൾ ഗിറ്റ്ഹബിലേക്ക് ചേർക്കുക (push) + +`git push` കമാൻഡ് ഉപയോഗിച്ച് വ്യത്യാസങ്ങൾ ഗിറ്റ്ഹബിലേക്ക് പുഷ് ചെയ്യുക: + + +``` +git push origin <താങ്കളുടെ-ബ്രാഞ്ചിന്റെ-പേര്> +``` + +ഇതിൽ <താങ്കളുടെ-ബ്രാഞ്ചിന്റെ-പേര്> എന്നതിന് പകരം താങ്കൾ നേരത്തെ ഉണ്ടാക്കിയ ബ്രാഞ്ചിന്റെ പേര് കൊടുക്കുക. + +## നിങ്ങളുടെ വ്യത്യാസങ്ങൾ പരിശോധനക്കായി (review) സമർപ്പിക്കുക + +നിങ്ങൾ ഇപ്പോൾ നിങ്ങളുടെ ഗിറ്റ്ഹബ് റെപ്പോസിറ്ററിയിൽ പോയി നോക്കിയാൽ അവിടെ `Compare & pull request` എന്ന ഒരു ബട്ടൺ കാണാം. അതിൽ അമർത്തുക. + +create a pull request + +ഇനി പുൾ റിക്വസ്റ്റ് (pull request) കൊടുക്കുക. + +submit pull request + +വൈകാതെ തന്നെ ഞാൻ താങ്കളുടെ വ്യത്യാസങ്ങൾ പ്രധാന ബ്രാഞ്ചിലേക്ക് ചേർക്കുന്നതായിരിക്കും. അപ്പോൾ താങ്കൾക്ക് ഒരു ഇമെയിൽ അറിയിപ്പ് ലഭിക്കും. + +## ഇവിടെ നിന്ന് ഇനി എങ്ങോട്ട്? + +അഭിനന്ദനങ്ങൾ! താങ്കൾ താങ്കളുടെ ആദ്യത്തെ _fork -> clone -> edit -> PR_ പടികൾ വിജയകരമായി പൂർത്തിയാക്കിയിരുന്നു. ഒരു സംഭാവകൻ/സംഭാവിക എന്ന നിലക്ക് ഇത് താങ്കൾക്ക് ഇടയ്ക്കിടെ ചെയ്യേണ്ടി വരുന്ന ഒരു കാര്യം ആണ്! + +താങ്കളുടെ സംഭാവന സുഹൃത്തുക്കളും പിൻഗാമികളുമായി (followers) പങ്കിട്ട് ആഘോഷിക്കുവാനായി ഈ [വെബ് ആപ്പ് ഉപയോഗിക്കുക](https://firstcontributions.github.io/#social-share). + +താങ്കൾക്ക് എന്തെങ്കിലും സഹായം വേണമെങ്കിൽ, അല്ലെങ്കിൽ എന്തെങ്കിലും ചോദ്യങ്ങൾ ഉണ്ടെങ്കിൽ ഞങ്ങളുടെ [slack team-ൽ ചേരുവാനായി റിക്വസ്റ്റ് അയക്കുക](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +ഇനി താങ്കൾക്ക് മറ്റുള്ള പ്രൊജെക്ടുകളിൽ സംഭാവന ചെയ്യുവാൻ സാധിക്കും. താങ്കൾക്ക് വേഗം തുടങ്ങുവാൻ വേണ്ടി ഞങ്ങൾ എളുപ്പത്തിൽ തീർക്കാവുന്ന പ്രശ്നങ്ങൾ (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) | diff --git a/docs/translations/README.mli.md b/docs/translations/README.mli.md new file mode 100644 index 00000000..73194853 --- /dev/null +++ b/docs/translations/README.mli.md @@ -0,0 +1,139 @@ +[![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 ye i kopi kɛ sisan" +``` +wali "URL min ye i kopi kɛ 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/votre-nom-d-utilisateur/first-contributions.git +``` +yɔrɔ min na `i-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/Roshanjossey/fɔlɔ-dɛmɛ +``` +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) diff --git a/docs/translations/README.mm_unicode.md b/docs/translations/README.mm_unicode.md new file mode 100644 index 00000000..f8574413 --- /dev/null +++ b/docs/translations/README.mm_unicode.md @@ -0,0 +1,130 @@ +[![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) + + +# ပထမအကြိမ် ကူညီထောက်ပံ့ခြင်း + +ဘယ်အရာမဆို ပထမဦးဆုံးလုပ်ဆောင်အခါ အခက်အခဲတွေ့ကြုံရပါတယ်။ အထူးသဖြင့် လူအများနဲ့ ပေါင်းသင်းလုပ်ကိုင်ကြတဲ့ အခါ မထင်မှတ်ထားတဲ့ အမှားများတွေ့ရတတ်ပြီး အဆင်မပြေတာတွေဖြစ်တတ်ပါတယ်။ Open source software များကတော့ လူအများနဲ့ ပေါင်းသင်းဆက်ဆံလုပ်ကိုင် ကြရတာပါ။ ဒါကြောင့်မို့ ပထမဦးဆုံးအကြိမ် open-source project များကို ပါဝင် ကူညီထောက်ပံ့သူများကို ပထမဆုံးအကြိမ် ကူညီထောက်ပံ့နိုင်ဖို့နဲ့ လွယ်ကူ ရိုးရှင်းတဲ့ လေ့လာနည်းဖြစ်ဖို့ ရည်ရွယ်ပါတယ်။ + +လေ့ကျင်ခန်း စာစောင်တွေနဲ့ ဗီဒီယိုတွေက အကူအညီရနိုင်သော်လဲ တကယ်လက်တွေ့လုပ်ဆောင်တာထက် ပိုကောင်းတာမရှိပါဘူး။ ဒီ project က ပထမဆုံးအကြိမ် ကူညီထောက်ပံ့ပေးမဲ့ သူတွေအတွက် လွယ်ကူ ရှိးရှင်းပြီး အကူအညီအထောက်ပံ့ဖြစ်စေဖို့ ရည်ရွယ်ပါတယ်။ **မှတ်ထားပါ** : သင်ကသက်တောင်သက်သာရှိလေလေ သင်ကပိုကောင်းကောင်းသင်ယူနိုင်လေ ဖြစ်ပါတယ်။ သင်သာ အောက်မှာရှိတဲ့ အဆင့်တိုင်းလုပ်သွားလျှင် သင့်ရဲ့ ပထမဆုံး ကူညီထောက်ပံခြင်းမှာ အဆင်ပြေစွာ ပြီးမြောက်သွားမှာဆိုတာ အာမခံပါတယ်။ + +_command line (သို့) terminal အသုံးပြုရတာ အဆင်မပြေပါက [GUI tools အသုံးပြုပုံများကို ဒီမှာကြည့်ရန်](#အခြား-Tools-များ-အသုံးပြုသည့်-tutorial)_ + +fork this repository + +#### သင့်ကွန်ပျူတာထဲမှာ Git မသွင်းရသေးလျှင် [ဒီမှာ သွင်းနည်းကြည့်ရန်](https://help.github.com/articles/set-up-git/). + +## ဒီ repository ကို fork လုပ်ပါ + +Fork လုပ်ဖို့အတွက် စာမျက်နှာအပေါ်နားမှရှိတဲ့ fork ခလုတ် ကိုနှိပ်ပါ။ +ဒီ repository က သင့် အကောင့်ကို ပုံစံတူပွားအနေနဲ့ ရောက်လာပါမယ်။ + +## ဒီ repository ကို clone လုပ်ပါ + +clone this repository + +ခုနက 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) ရဲ့ လင့်ခ်ပဲ ဖြစ်ပါတယ်။ ဒီနေရာမှာ အဆင်မပြေဖြစ်ခဲ့ရင် အပေါ်က အဆင့်များကို ပြန်လုပ်ပါ။ + +copy URL to 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 + +ပြီးရင် ဒီ 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` ဆိုတဲ့ ခလုတ်မြင်နေရမှာပါ။ အဲ့ဒီ ခလုတ်ကို နှိပ်လိုက်ပါ။ + +create a pull request + +အခု pull request ကို submit လုပ်လိုက်ပါ။ + +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) | diff --git a/docs/translations/README.mr.md b/docs/translations/README.mr.md new file mode 100644 index 00000000..7087531b --- /dev/null +++ b/docs/translations/README.mr.md @@ -0,0 +1,131 @@ +[![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) + + +# प्रथम योगदान + +सुरुवातीला कुठलीही गोष्ट करणे कठीण असते. विशेषत: आपण एकत्र काम करत असताना चुका होणे स्वाभाविक आहे. परंतु एकमेकांसोबत भेटणे आणि एकत्र कार्य करणे हेच तर मुक्त स्त्रोत (Open Source) चे गमक आहे. आम्ही आपले प्रथम मुक्त स्त्रोत योगदान (Contribution) सुलभ करण्यास मदत करू. + +लेख वाचणे आणि ट्यूटोरियल पाहण्याने आपणास मदत होऊ शकते परंतु प्रत्यक्षात सराव करण्यापेक्षा काय चांगले आहे? या प्रकल्पाचा हेतू नवशिक्यांना आपले प्रथम योगदान देण्यासंदर्भात सोप्या स्वरुपात मार्गदर्शन प्रदान करण्याचा आहे. आपण आपले प्रथम योगदान देत असल्यास, खालील पायऱ्यांचे अनुसरण करा. + +#### *जर आपल्याला कमांड लाईन (CLI) सोयीस्कर वाटत नसेल तर [GUI टूल्स वापरण्यासंदर्भात ट्यूटोरियल येथे आहेत.](#इतर-साधने-वापरण्याबाबतीत-ट्युटोरियल)* + + +[](translations/README.en-pirate.md) + +fork this repository + +आपण आपल्या मशीनवर Git नसेल तर, [येथुन इन्स्टॉल करा](https://help.github.com/articles/set-up-git/). + +## रिपॉझिटरी (Repository) ला फोर्क (Fork) करणे + +फोर्क बटण क्लिक करून या रिपोला फोर्क करा. +हे आपल्या खात्यात या रिपॉझिटरीची प्रत (कॉपी) तयार करेल. + +## रिपॉझिटरी (Repository) ला क्लोन (Clone) करणे + +clone this repository + +आता फोर्क केलेला रिपो आपल्या संगणकावर क्लोन (Clone) करा. यासाठी आपण आपल्या गिटहब (GitHub) खात्यावर जा. जो रिपो आपण फोर्क केलेला आहे, त्याला उघडा. उघडलेल्या रिपोत उजव्या बाजुला वर `Clone or download` बटण दिसेल, त्यावर क्लिक करा. नंतर तेथील `Copy to clipboard` या आयकॉनवर क्लिक करा. याद्वारे प्रस्तुत रिपोची लिंक (URL) कॉपी झालेली असेल. + +आता आपले टर्मिनल (Terminal) उघडा व त्यात खालील git आदेश (Command) चालवा. + +``` +git clone <कॉपी-केलेली-लिंक> +``` + +copy URL to clipboard + +येथे `<कॉपी-केलेली-लिंक>` (त्रिकोणी कंस वगळता) यास आपण आताच कॉपी केलेली URL लिंक असे ग्राह्य धरण्यात यावे. ही URL लिंक मिळवण्याकरता याआधीच्या पायरीचे अवलोकन करावे. + +उदाहरणार्थ: + +``` +git clone https://github.com/तुमचे-युझर-नाव/first-contributions.git +``` + +येथे `तुमचे-युझर-नाव` याचा अर्थ आहे, आपल्या गिटहब खात्याचे नाव (Username). + +आता एंटर (Enter/Return) बटण दाबा. याद्वारे प्रस्तुत रिपो `first-contributions` आपल्या संगणकावर कॉपी होईल. + +## ब्रांच (Branch) बनवणे. + +आपल्या टर्मिनल वरुन आपली रिपो फोल्डर/डायरेक्टरी (Folder/Directory) बदला (जर आपण अद्याप बदलले नसेल तर). + +``` +cd first-contributions +``` + +आता `git checkout` ही कमांड वापरुन नवीन ब्रांच तयार करा. + +``` +git checkout -b <आपल्या-ब्रांचचे-नाव-येथे-टाका> +``` + +उदा: + +``` +git checkout -b add-rahul-thakare +``` + +(प्रत्येक ब्रांचच्या नावात `add` हा शब्द असणे आवश्यक नाही, परंतु वरील उदाहरणात त्याचा समावेश असणे ही एक वाजवी गोष्ट आहे कारण ईथे आपले नाव सूचीमध्ये जोडणे हा या शाखेचा उद्देश आहे.) + +## आवश्यक बदल करणे आणि ते बदल कमिट (Commit) करणे. + +आता मजकूर संपादक मध्ये `Contributors.md` फाइल उघडा, व त्यात आपले नाव जोडा. फाइलच्या सुरवातीस किंवा समाप्तीमध्ये जोडू नका. त्यामध्ये कुठेही ठेवा. आता फाईल सेव्ह (Save) करा. + +git status +आता तुम्ही पुन्हा टर्मिनल कडे जाल आणि `git status` ही कमांड चालवाल तर तुम्हाला त्यात काही बदल झालेले दिसतील. + +`git add` कमांड वापरुन आपण तयार केलेल्या शाखेत ते बदल जोडा + +``` +git add Contributors.md +``` + +आता `git commit` ही कमांड वापरुन आपले बदल कमिट/सुरक्षित करा. + +``` +git commit -m "Add <तुमचे-नाव> to Contributors list" +``` + +`<तुमचे-नाव>` च्याऐवजी आपले नाव टाका. + +## गिटहब मध्ये आपले बदल पुश करणे. + +`git push` वापरून आपले बदल पुश करा + +``` +git push origin <आपल्या-शाखेचे-नाव> +``` + +`<आपल्या-शाखेचे-नाव>` च्या जागी आपल्या ब्रांचचे नाव टाका. + +## पुनरावलोकनासाठी आपले बदल सबमिट करणे. + +आपण आपल्या गिटहब प्रोफाइलवर आपल्या रिपो वर गेल्यास, आपल्याला `Compare & pull request` पाठविण्याचा पर्याय दिसेल, ते दाबा. +create a pull request + +आता आपल्या `Pull request` सबमिट करा. + +submit 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) | diff --git a/docs/translations/README.mx.md b/docs/translations/README.mx.md new file mode 100644 index 00000000..df61d92f --- /dev/null +++ b/docs/translations/README.mx.md @@ -0,0 +1,124 @@ +[![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 + +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)* + + +fork de este repositorio + +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 + +clonar este repositorio + +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*. + +copiar 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. + +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. + + +## 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. + +crea 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 [web app](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 Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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)| diff --git a/docs/translations/README.my.md b/docs/translations/README.my.md new file mode 100644 index 00000000..a2288cd0 --- /dev/null +++ b/docs/translations/README.my.md @@ -0,0 +1,119 @@ +[![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) + + +# 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 this repository + +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 + +clone this repository + +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: + +``` +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. + +copy URL to clipboard + +Contoh: +``` +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): + +``` +cd first-contributions +``` +Sila buat branch menggunakan arahan `git switch`: +``` +git switch -c add-your-name +``` + +Contoh: +``` +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`: + +``` +git add Contributors.md +``` + +Selepas itu, komit perubahan tersebut menggunakan arahan `git commit`: +``` +git commit -m "Add to Contributors list" +``` +menggantikan `` dengan nama anda. + +## Push perubahan ke dalam GitHub + +Tolak perubahan anda menggunakan arahan `git push`: +``` +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. + +create a pull request + +Hantar 'pull request' tersebut. + +submit 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). + +Anda boleh menyertai pasukan 'Slack' kami sekiranya anda memerlukan bantuan atau mempunyai sebarang pertanyaan. [Sertai pasukan Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.ng-pidgin.md b/docs/translations/README.ng-pidgin.md new file mode 100644 index 00000000..2f22681e --- /dev/null +++ b/docs/translations/README.ng-pidgin.md @@ -0,0 +1,120 @@ +[![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 this repository + +#### 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 this repository + +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 URL to clipboard + +For example: + +``` +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): + +``` +cd first-contributions + +``` + +Now create a branch using the git switch command: + +``` +git switch -c your-new-branch-name + +``` + +For example: + +``` +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: + +``` +git add Contributors.md + +``` +Now commit those changes using the git commit command: + +``` +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: + +``` +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 a 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! \ No newline at end of file diff --git a/docs/translations/README.nl.md b/docs/translations/README.nl.md new file mode 100644 index 00000000..ab7f3c27 --- /dev/null +++ b/docs/translations/README.nl.md @@ -0,0 +1,142 @@ +[![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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w) +[![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. + +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). + +Mocht je nog vragen of hulp nodig hebben dan kun je je aanmelden voor ons [Slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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:

+

+ + + +

diff --git a/docs/translations/README.no.md b/docs/translations/README.no.md new file mode 100644 index 00000000..70fd119f --- /dev/null +++ b/docs/translations/README.no.md @@ -0,0 +1,158 @@ +[![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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w) +[![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 this repository + +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 + +clone this repository + +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. + +copy URL to clipboard + +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. + +create a pull request + +Send inn din pull request når du er klar. + +submit 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). + +Behøver du hjelp eller vil stille spørsmål så kan du bli med i vår slack-gruppe. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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:

+

+ + + +

\ No newline at end of file diff --git a/docs/translations/README.np.md b/docs/translations/README.np.md new file mode 100644 index 00000000..12b4d4df --- /dev/null +++ b/docs/translations/README.np.md @@ -0,0 +1,221 @@ +[![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) + +#### _अन्य [भाषाहरूमा](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.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 गर्नुहोस्। + +clone this repository + +अब ` Fork ` गरेको repository लाई आफ्नो कम्प्युटरमा ` Clone ` गर्नको लागी तपाइको GitHub account मा जानुहोस् र Fork गरिएको Repository खोल्नुहोस्। अब ` Code ` बटनमा क्लिक गर्नुहोस् र त्यसपछि *copy to clipboard* आइकनमा क्लिक गर्नुहोस्। + +टर्मिनल खोल्नुहोस् र निम्न git कमाण्ड चलाउनुहोस्: + +``` +git clone "तपाइले copy गरेको URL" +``` + +जहाँ `"तपाइले copy गरेको URL"` छ, त्यो तपाईले fork गरेको repository को url हो । ( Url प्राप्त गर्न clone गर्ने चित्रहरुमा हेर्नुहोस्। ) + +URL लाई क्लिपबोर्डमा प्रतिलिपि बनाउनुहोस् + +उदाहरणका लागि: + +``` +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 लाई खोल्नुहोस् (यदि तपाईं पहिले नै हुनुहुन्न भने): + +``` +cd first-contributions +``` + +अब `git switch` कमाण्ड प्रयोग गरेर एउटा branch बनाउनुहोस् : + +``` +git switch -c ब्रन्चको-नाम +``` + +उदाहरणको लागि: + +``` +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` कमाण्ड प्रयोग गरी तिनी परिवर्तनहरू थप्नुहोस्: + +``` +git add Contributors.md +``` + +अब `git commit` कमाण्ड प्रयोग गरेर तिनी परिवर्तनहरू कमिट (commit) गर्नुहोस्: + +``` +git commit -m "Add to Contributors list" +``` + +`` को साटोमा तपाईंको आफ्नो नाम लेख्नुहोला। + +## GitHub मा परिवर्तनहरुलाई push गर्नुहोस। + +`git push` कमाण्डको प्रयोग गरेर आफ्नो परिवर्तनहरु पुश (push) गर्नुहोस्: + +``` +git push -u origin +``` + +`` को सट्टामा तपाईले पहिले बनाएको branch को नामको लेख्नुहोस्। + +उदाहरणको लागि: + +``` +git push -u origin add-ram-regmi +``` + +
+ यदि 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'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 पेश गर्नुहोस्। + +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 हरु + +| 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) | + +

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

+

+ + + +

diff --git a/docs/translations/README.od.md b/docs/translations/README.od.md new file mode 100644 index 00000000..5bc1b7b3 --- /dev/null +++ b/docs/translations/README.od.md @@ -0,0 +1,136 @@ +[![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) + +# ପ୍ରଥମ ଅବଦାନ + +ଏହି ପ୍ରୋଜେକ୍ଟଟି ଆରମ୍ଭକାରୀମାନଙ୍କୁ ସେମାନଙ୍କର ପ୍ରଥମ ଅବଦାନକୁ ସରଳ ଏବଂ ମାର୍ଗଦର୍ଶନ କରିବାକୁ ଲକ୍ଷ୍ୟ ରଖିଛି | ଯଦି ତୁମେ ତୁମର ପ୍ରଥମ ଅବଦାନ ଦେବାକୁ ଚାହୁଁଛ, ନିମ୍ନରେ ଥିବା ପଦକ୍ଷେପଗୁଡ଼ିକୁ ଅନୁସରଣ କର | + +_ଯଦି ଆପଣ କମାଣ୍ଡ୍ ଲାଇନ୍ ସହିତ ଆରାମଦାୟକ ନୁହଁନ୍ତି, [ଏଠାରେ 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 ନିର୍ଦ୍ଦେଶକୁ ଚଲାନ୍ତୁ: + +`` +git clone "url ତୁମେ କେବଳ କପି କରିଛ" +`` + +ଯେଉଁଠାରେ "url ତୁମେ କେବଳ କପି କରିଛ" (କୋଟେସନ୍ ମାର୍କ ବିନା) ଏହି ସଂଗ୍ରହାଳୟର url (ଏହି ପ୍ରୋଜେକ୍ଟର ଫଙ୍କ୍) | Url ପାଇବା ପାଇଁ ପୂର୍ବ ପଦକ୍ଷେପଗୁଡିକ ଦେଖନ୍ତୁ | + +କ୍ଲିପବୋର୍ଡକୁ URL କପି କରନ୍ତୁ + +ଉଦାହରଣ ସ୍ଵରୁପ: + +`` +git clone https://github.com/this-is-you/first-contributions.git +`` + +ଯେଉଁଠାରେ "ଏହା-ତୁମେ" ତୁମର GitHub ଉପଯୋଗକର୍ତ୍ତା ନାମ | ଏଠାରେ ଆପଣ GitHub ରେ ପ୍ରଥମ-ଅବଦାନ ସଂଗ୍ରହାଳୟର ବିଷୟବସ୍ତୁକୁ ଆପଣଙ୍କ କମ୍ପ୍ୟୁଟରରେ କପି କରୁଛନ୍ତି | + +## ଏକ ଶାଖା ସୃଷ୍ଟି କରନ୍ତୁ | + +ଆପଣଙ୍କ କମ୍ପ୍ୟୁଟରରେ ରେପୋଜିଟୋରୀ ଡିରେକ୍ଟୋରୀକୁ ପରିବର୍ତ୍ତନ କରନ୍ତୁ (ଯଦି ଆପଣ ପୂର୍ବରୁ ନାହାଁନ୍ତି): + +`` +cd first-contributions +`` + +ବର୍ତ୍ତମାନ `git switch` କମାଣ୍ଡ ବ୍ୟବହାର କରି ଏକ ଶାଖା ସୃଷ୍ଟି କରନ୍ତୁ: + +`` +git switch -c <ତୁମର-ନୂତନ-ଶାଖା-ନାମ> +`` + +ଉଦାହରଣ ସ୍ଵରୁପ: + +`` +git switch -c add-alonzo-church +`` + +## ଆବଶ୍ୟକ ପରିବର୍ତ୍ତନ କର ଏବଂ ସେହି ପରିବର୍ତ୍ତନଗୁଡିକ କର | + +ବର୍ତ୍ତମାନ ଟେକ୍ସଟ୍ ଏଡିଟର୍ ରେ `Contributors.md` ଫାଇଲ୍ ଖୋଲ, ଏଥିରେ ତୁମର ନାମ ଯୋଡ | ଫାଇଲ୍ ର ଆରମ୍ଭ କିମ୍ବା ଶେଷରେ ଏହାକୁ ଯୋଡନ୍ତୁ ନାହିଁ | ଏହାକୁ ଯେକ ଣସି ସ୍ଥାନରେ ରଖନ୍ତୁ | ବର୍ତ୍ତମାନ, ଫାଇଲ୍ ସେଭ୍ କରନ୍ତୁ | + +git status + +ଯଦି ଆପଣ ପ୍ରୋଜେକ୍ଟ ଡିରେକ୍ଟୋରୀକୁ ଯାଆନ୍ତି ଏବଂ `git status` କମାଣ୍ଡ୍ ଏକଜେକ୍ୟୁଟ୍ କରନ୍ତି, ଆପଣ ଦେଖିବେ ସେଠାରେ କିଛି ପରିବର୍ତ୍ତନ ଅଛି | + +ସେହି ପରିବର୍ତ୍ତନଗୁଡ଼ିକୁ ଆପଣ `git add` କମାଣ୍ଡ ବ୍ୟବହାର କରି ସୃଷ୍ଟି କରିଥିବା ଶାଖାରେ ଯୋଡନ୍ତୁ: + +`` +git add Contributors.md +`` +ବର୍ତ୍ତମାନ `git commit` କମାଣ୍ଡ ବ୍ୟବହାର କରି ସେହି ପରିବର୍ତ୍ତନଗୁଡ଼ିକୁ କର: + +`` +git commit -m "Add <ତୁମର ନାମ> to Contributors list" +`` + +<ତୁମର ନାମ> ସହିତ ତୁମର ନାମ ବଦଳାଇବା | + +## GitHub କୁ ପରିବର୍ତ୍ତନ କର | + +`git push` 'କମାଣ୍ଡ ବ୍ୟବହାର କରି ତୁମର ପରିବର୍ତ୍ତନକୁ ଠେଲିଦିଅ: + +`` +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) | diff --git a/docs/translations/README.pb.md b/docs/translations/README.pb.md new file mode 100644 index 00000000..d53d6107 --- /dev/null +++ b/docs/translations/README.pb.md @@ -0,0 +1,117 @@ +[![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) + +# ਪਹਿਲਾ ਯੋਗਦਾਨ + +ਇਸ ਪ੍ਰੋਜੈਕਟ ਦਾ ਉਦੇਸ਼ ਸ਼ੁਰੂਆਤੀ ਲੋਕਾਂ ਦਾ ਆਪਣਾ ਪਹਿਲਾ ਯੋਗਦਾਨ ਪਾਉਣ ਦੇ ਕਮ ਨੂੰ ਸਰਲ ਬਣਾਉਣ ਅਤੇ ਮਾਰਗਦਰਸ਼ਨ ਕਰਨਾ ਹੈ। ਜੇ ਤੁਸੀਂ ਆਪਣਾ ਪਹਿਲਾ ਯੋਗਦਾਨ ਪਾਉਣ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰ ਰਹੇ ਹੋ, ਤਾਂ ਹੇਠਾਂ ਦਿੱਤੇ ਕਦਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ। +ਜੇ ਤੁਸੀਂ ਕਮਾਂਡ ਲਾਈਨ ਨਾਲ ਸੁਖੀ ਨਹੀਂ ਹੋ, [ਇੱਥੇ ਜੀ.ਯੁ.ਆੀ ਟੂਲਸ ਦੀ ਵਰਤੋਂ ਕਰਨ ਦਿਆਂ ਟੁਟੋਰਿਅਲਸ ਹਨ.](#ਹੋਰ-ਟੂਲਜ-ਦੀ-ਵਰਤੋਂ-ਕਰਦਿਆਂ-ਟੁਟੋਰਿਅਲ) + +fork this repository + +#### ਜੇ ਤੁਹਾਡੀ ਮਸ਼ੀਨ ਤੇ ਗਿੱਟ ਨਹੀਂ ਹੈ, [ਇਸ ਨੂੰ ਇੰਸਟਾਲ ਕਰੋ](https://help.github.com/articles/set-up-git/)। + +## ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਫੋਰਕ ਕਰੋ +ਇਸ ਪੰਨੇ ਦੇ ਸਿਖਰ ਤੇ 'ਫੋਰਕ ਬਟਨ' ਤੇ ਕਲਿੱਕ ਕਰਕੇ ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਫੋਰਕ ਕਰੋ. ਇਹ ਤੁਹਾਡੇ ਖਾਤੇ ਵਿੱਚ ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਦੀ ਇੱਕ ਕਾਪੀ ਬਣਾਏਗਾ. + +## ਰਿਪੋਜ਼ਟਰੀ ਨੂੰ ਕਲੋਨ ਕਰੋ +clone this repository + +ਹੁਣ ਆਪਣੀ ਮਸ਼ੀਨ ਤੇ ਫੋਰਕਡ ਰਿਪੋਜ਼ਟਰੀ ਦਾ ਕਲੋਨ ਕਰੋ। ਆਪਣੇ ਗਿਟ-ਹਬ ਅਕਾਉਂਟ ਤੇ ਜਾਓ, ਫੋਰਕਡ ਰਿਪੋਜ਼ਟਰੀ ਖੋਲ੍ਹੋ, ਕੋਡ ਬਟਨ ਤੇ ਕਲਿਕ ਕਰੋ ਅਤੇ ਫਿਰ ਕਲਿੱਪਬੋਰਡ ਆਈਕਨ ਤੇ ਕਾਪੀ ਕਲਿੱਕ ਕਰੋ. +ਇੱਕ ਟਰਮੀਨਲ ਖੋਲ੍ਹੋ ਅਤੇ ਹੇਠਲੀ ਗਿਟ ਕਮਾਂਡ ਚਲਾਓ: + +``` +git clone "ਯੂ.ਆਰ.ਐਲ ਜੇੈਕਰ ਤੁਸੀਂ ਹੁਣੇ ਨਕਲ ਕੀਤੀ" +``` + +ਜਿੱਥੇ “ਯੂ.ਆਰ.ਐਲ ਜੇੈਕਰ ਤੁਸੀਂ ਹੁਣੇ ਨਕਲ ਕੀਤੀ” (ਹਵਾਲਾ ਨਿਸ਼ਾਨਾਂ ਤੋਂ ਬਿਨਾਂ) ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਦਾ ਯੂ.ਆਰ.ਐਲ ਹੈ (ਇਸ ਪ੍ਰੋਜੈਕਟ ਦਾ ਤੁਹਾਡਾ ਫੋਰਕ)। ਯੂ.ਆਰ.ਐਲ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ ਪਿਛਲੇ ਕਦਮ ਵੇਖੋ। +copy URL to clipboard + +ਉਦਾਹਰਣ ਲਈ: +``` +git clone https://github.com/this-is-you/first-contributions.git +``` + +ਜਿੱਥੇ `this-is-you` ਤੁਹਾਡਾ ਗਿਟ-ਹਬ ਉਪਯੋਗਕਰਤਾ ਨਾਮ ਹੈ। ਇੱਥੇ ਤੁਸੀਂ ਆਪਣੇ ਕੰਪਿਊਟਰ ਤੇ ਗਿਟ-ਹਬ ਉੱਤੇ ਪਹਿਲੇ-ਯੋਗਦਾਨ ਰਿਪੋਜ਼ਟਰੀ ਦੇ ਭਾਗਾਂ ਦੀ ਨਕਲ ਕਰ ਰਹੇ ਹੋ. + +## ਇੱਕ ਸ਼ਾਖਾ ਬਣਾਓ +ਆਪਣੇ ਕੰਪਿਊਟਰ ਉੱਤੇ ਰਿਪੋਜ਼ਟਰੀ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਬਦਲੋ (ਜੇ ਤੁਸੀਂ ਪਹਿਲਾਂ ਤੋਂ ਨਹੀਂ ਹੋ): + +``` +cd first-contributions +``` + +ਹੁਣ `git checkout` ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਸ਼ਾਖਾ ਬਣਾਓ: + +``` +git checkout -b ਤੁਹਾਡਾ-ਨਵੀਂ-ਸ਼ਾਖਾ-ਦਾ-ਨਾਮ +``` + +ਉਦਾਹਰਣ ਲਈ: + +``` +git checkout -b add-alonzo-church +``` + +(ਸ਼ਾਖਾ ਦੇ ਨਾਮ ਨੂੰ ਇਸ ਵਿਚ _add_ ਸ਼ਬਦ ਦੀ ਜ਼ਰੂਰਤ ਨਹੀਂ ਹੈ, ਪਰ ਇਹ ਸ਼ਾਮਲ ਕਰਨਾ ਇਕ ਵਾਜਬ ਚੀਜ਼ ਹੈ ਕਿਉਂਕਿ ਇਸ ਸ਼ਾਖਾ ਦਾ ਉਦੇਸ਼ ਤੁਹਾਡੇ ਨਾਮ ਨੂੰ ਇਕ ਸੂਚੀ ਵਿਚ ਸ਼ਾਮਲ ਕਰਨਾ ਹੈ.) + +## ਜ਼ਰੂਰੀ ਤਬਦੀਲੀਆਂ ਕਰੋ ਅਤੇ ਉਨ੍ਹਾਂ ਬਦਲਾਵਾਂ ਨੂੰ ਪ੍ਰਤੀਬੱਧ ਕਰੋ +ਹੁਣ ਟੈਕਸਟ ਐਡੀਟਰ ਵਿੱਚ `Contributors.md` ਫਾਈਲ ਖੋਲ੍ਹੋ, ਇਸ ਵਿੱਚ ਆਪਣਾ ਨਾਮ ਸ਼ਾਮਲ ਕਰੋ. ਇਸ ਨੂੰ ਫਾਈਲ ਦੇ ਸ਼ੁਰੂ ਜਾਂ ਅੰਤ 'ਤੇ ਨਾ ਸ਼ਾਮਲ ਕਰੋ. ਇਸ ਨੂੰ ਕਿਤੇ ਵੀ ਵਿਚਕਾਰ ਰੱਖੋ। ਹੁਣ, ਫਾਈਲ ਸੇਵ ਕਰੋ। + +git status + +ਜੇ ਤੁਸੀਂ ਪ੍ਰੋਜੈਕਟ ਡਾਇਰੈਕਟਰੀ ਤੇ ਜਾਂਦੇ ਹੋ ਅਤੇ `git status` ਕਮਾਂਡ ਚਲਾਉਂਦੇ ਹੋ, ਤਾਂ ਤੁਸੀਂ ਦੇਖੋਗੇ ਕਿ ਬਦਲਾਅ ਹਨ। + +ਸ਼ਾਖਾ ਵਿੱਚ ਉਹ ਬਦਲਾਵ ਸ਼ਾਮਲ ਕਰੋ ਜੋ ਤੁਸੀਂ ਹੁਣੇ ਬਣਾਇਆ `git add` ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਬਣਾਈ ਹੈ: + +``` +git add Contributors.md +``` + +ਹੁਣ ਉਹ ਤਬਦੀਲੀਆਂ `git ਕਮਿ`` ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਨਾਲ ਕਰੋ: + +``` +git commit -m "Add to Contributors list" +``` + +ਤੁਹਾਡੇ ਨਾਮ ਨਾਲ `<ਤੁਹਾਡੇ ਆਪਣੇ ਨਾਮ> rep ਨੂੰ ਬਦਲਣਾ. + +## GitHub ਵਿੱਚ ਬਦਲੋ ਧੱਕੋ + +ਕਮਾਂਡ `git push` ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਆਪਣੀਆਂ ਤਬਦੀਲੀਆਂ ਧੱਕੋ: + +``` +git push origin +``` + +ਉਸ ਬ੍ਰਾਂਚ ਦੇ ਨਾਮ ਨਾਲ ` la ਨੂੰ ਬਦਲਣਾ ਜੋ ਤੁਸੀਂ ਪਹਿਲਾਂ ਬਣਾਈ ਸੀ. + +## ਆਪਣੀਆਂ ਤਬਦੀਲੀਆਂ ਨੂੰ ਸਮੀਖਿਆ ਲਈ ਦਰਜ ਕਰੋ + +ਜੇ ਤੁਸੀਂ ਗਿੱਟਹੱਬ 'ਤੇ ਆਪਣੀ ਰਿਪੋਜ਼ਟਰੀ' ਤੇ ਜਾਂਦੇ ਹੋ, ਤਾਂ ਤੁਸੀਂ `ਤੁਲਨਾ ਕਰੋ ਅਤੇ ਖਿੱਚੋ ਬੇਨਤੀ` ਬਟਨ ਨੂੰ ਵੇਖੋਗੇ. ਉਸ ਬਟਨ 'ਤੇ ਕਲਿੱਕ ਕਰੋ. + +create a pull request + +ਹੁਣ ਪੁਲੀ ਬੇਨਤੀ ਨੂੰ ਜਮ੍ਹਾ ਕਰੋ. + +submit pull request + +ਜਲਦੀ ਹੀ ਮੈਂ ਤੁਹਾਡੀਆਂ ਸਾਰੀਆਂ ਤਬਦੀਲੀਆਂ ਨੂੰ ਇਸ ਪ੍ਰੋਜੈਕਟ ਦੀ ਮਾਸਟਰ ਬ੍ਰਾਂਚ ਵਿੱਚ ਮਿਲਾ ਦੇਵਾਂਗਾ. ਇਕ ਵਾਰ ਤਬਦੀਲੀਆਂ ਨੂੰ ਮਿਲਾਉਣ ਤੋਂ ਬਾਅਦ ਤੁਹਾਨੂੰ ਇਕ ਸੂਚਨਾ ਈਮੇਲ ਮਿਲੇਗੀ. + +## ਇਥੋਂ ਕਿੱਥੇ ਜਾਣਾ ਹੈ? + +ਵਧਾਈਆਂ! ਤੁਸੀਂ ਹੁਣੇ ਹੀ ਸਟੈਂਡਰਡ _ਫੋਰਕ -> ਕਲੋਨ -> ਐਡਿਟ -> ਖਿੱਚ ਬੇਨਤੀ_ ਵਰਕਫਲੋ ਪੂਰਾ ਕੀਤਾ ਹੈ ਜਿਸਦਾ ਤੁਸੀਂ ਅਕਸਰ ਇੱਕ ਯੋਗਦਾਨ ਪਾਉਣ ਵਾਲੇ ਦੇ ਰੂਪ ਵਿੱਚ ਸਾਹਮਣਾ ਕਰੋਗੇ! + +ਆਪਣੇ ਯੋਗਦਾਨ ਦਾ ਜਸ਼ਨ ਮਨਾਓ ਅਤੇ ਜਾ ਕੇ ਇਸ ਨੂੰ ਆਪਣੇ ਦੋਸਤਾਂ ਅਤੇ ਪੈਰੋਕਾਰਾਂ ਨਾਲ ਸਾਂਝਾ ਕਰੋ। [ਵੈੱਬ ਐਪ](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 | 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) | diff --git a/docs/translations/README.pl.md b/docs/translations/README.pl.md new file mode 100644 index 00000000..39b58641 --- /dev/null +++ b/docs/translations/README.pl.md @@ -0,0 +1,138 @@ +[![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) + +# 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. + +fork this repository + +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`) + +clone this repository + +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: + +``` +git clone +``` + +Gdzie `` to adres tego repozytorium (twojej kopii tego projektu). Zobacz poprzedni krok aby skopiować adres. + +copy URL to clipboard + +Przykład: + +``` +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ś): + +``` +cd first-contributions +``` + +Teraz utwórz nową gałąź wykonując polecenie `git switch`: + +``` +git switch -c +``` + +Przykład + +``` +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`: + +``` +git add Contributors.md +``` + +Teraz zapisz te zmiany wykonując komendę `git commit`: + +``` +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`: + +``` +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. + +create a pull request + +Teraz wyślij prośbę o scalenie. + +submit pull request + +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 dołączyć do naszego kanału slack w przypadku kiedy będziesz potrzebował pomocy albo miał jakieś pytania. Dołącz do slacka. + +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) | diff --git a/docs/translations/README.ps.md b/docs/translations/README.ps.md new file mode 100644 index 00000000..38f280b1 --- /dev/null +++ b/docs/translations/README.ps.md @@ -0,0 +1,142 @@ +
+Open Source Love Open Source Helpers +
+ +#
لومړی ګډون
+*** +
+د دې پروژې موخه دا ده ترڅو نویو پېل کوونکو ته په خلاصو سرچینو پروژو (Open Source Projects) کې د ګډون لاره وښئ که چېرې تاسو غواړی خپل لومړی ګډون پیل کړئ لاندې قدمونه پر مخ یوسئ. + +که د کمانډ لاین سره راحت نه یاست [ کولای شی تصویر بڼه دلته پرمخ یوسئ](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools) + +که چېرې مو git نه وي انسټال کړی [له دغه ځایه یې درښکته او انسټال یې کړئ](https://help.github.com/articles/set-up-git/) + +
+ +fork this repository + +###
دا ذخیره (repository) فورک کړئ:
+*** +

+د دې پاڼې په سر کې د فورک تڼئ پر کلیک سره تاسو کولای شئ دا repository فورک کړئ، فورک به د دې repository یوه کاپي ستاسو د کیټ هب په اکونټ کې جوړه کړي. +

+ +###
دا ذخیره (repository) کلون کړئ:
+*** +clone this repository + +

اوس فورک کړل شوې ریپوزیټوري کلون یعنې ښکته کړئ د دې کار د ترسره کولو لپاره خپل اکونټ ته لاړ شی د کوډ پر تڼۍ کلیک وکړئ او د ریپوزیټوري لینک کاپي کړئ.

+ +

ترمینل یا CMD خلاص کړئ او لاندې د کیټ کمنډ رن کړئ

+```git +git clone "د ریپوزیټوري کاپي کړل شوی لینک" +``` +

د بیلکې په توګه

+ +```git +git clone https://github.com/MasihKarimi/first-contributions.git +``` +

په پورته لینک کې د MasihKarimi پرځای باید ستاسو د کیټ هب د اکونټ نوم وي

+ +

د پورته قدمونو په اخیستلو سره تاسو د “first-contributions” ذخیره یا ریپوزیټوري خپل کمپیوټر ته ښکته کوۍ.

+ +###
نوې څانګه یا برانچ جوړ کړئ:
+*** +

‌اوس د first-contributions پروژه په خپل کوډ ایډیټر کې پرانيزی او په ترمینل کې د لاندې کیټ کمنډ په رن کولو سره نوی برانچ یا څانګه جوړه کړئ.

+ +```git +git switch -c د څانګې نوم +``` +

د بیلکې په توګه

+```git +git switch -c add-Masih-Karimi +``` + +

add-Masih-Karimi زما د څانګې نوم دی تاسو کولائ شئ خپل نوم غوره کړئ

+ +###
اړین بدلونونه راوړئ او دا بدلونونه ترسره یا commit کړئ:
+*** + +

اوس د contributors.md فایل راخلاص کړئ او خپل نوم مو وراضافه کړئ نوم مو د فایل په شروغ یا اخر کې مه اضافه کوئ په منځ کې یې اضافه کړئ او فایل ذخیره کړئ

+ +git status +

اوس که چېرې ټرمینل ته ولاړ شئ او د git status کمنډ رن کړئ تاسو کولائ شئ وګورئ چې په کوم فایل کې مو بدلونونه راوستي دي

+ +

په دې برخه کې د git add کمنډ په مرسته خپل بدلونونه خپل نوي جوړې کړل شوې څانګې ته اضافه کړئ:

+ +```git +git add contributors.md +``` +

اوس اضافه کړل شوي بدلونونه د لاندې کمنډ په مرسته ترسره یا commit کړئ:

+ +```git +git commit -m “Add Masih Karimi to Contributors List” +``` +

د Masih Karimi پر ځای مو خپل نوم ولیکئ

+ +###
بدلونونه کیټ هب ته پورته یا push کړئ:
+*** +

په دې برخه کې د git push کمنډ په مرسته خپل بدلونونه کیټ هب ته پورته کړئ

+

د بېلګې په توګه

+ +```git +git push origin -u add-Masih-Karimi +``` +

هېر نه کړئ چې د add-Masih-Karimi پر ځای د خپلې څانګې نوم ورکړئ

+ +
+ که چېرې په دې لړ کې د کومې ستونزې سره مخ شوئ دا ځاې کېکاږئ + +- ### د تصدیق کولو تېروتنه + 
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) + +
+ + + +###
خپل بدلونونه د بیاکتنې لپاره وسپارئ
+*** + +

اوس که چېرې دې ریپوزیټوري ته په خپل کیټ هب اکونټ کې ورشئ تاسو به یو یوه تنۍ د Compare & pull request متن سره ووینۍ. دا تنۍ کیکاږئ

+create a pull request + +

اوس د pull غوښتنه وسپارئ

+ +submit pull request + +

له دې ورسته به زه ستاسو راوستي بدلونه د اصلي یا main څانګې سره یوځای کړم او ستاسو نوم به د ګډون کوونکو لیست ته اضافه کړل شي.

+ +###
له دې ځایه وروسته چېرته ولاړ شئ:
+*** +

+

+بریا!! !! تاسو په بریالیتوب سره د فورک، کلون ، ایډټ او پول غوښتنې چارې ترسره کړې ، د دې چارو سره به مو د یو ګډون کوونکي په توګه همیش سر او کار وي. +

+ +

+خپل لومړئ ګډون مو ولمانځئ او له خپلو ملګرو سره یې شریک کړئ + +

+ +

که چېرې کومه ستونزه او پوښتنه لرئ کولائ شئ زموږ د سلک slack ټیم سره یوځائ شئ

+ +

+اوس راځئ په نورو پروژو کې ګډون وکړئ موږ د هغو پروژو لیست جمتو کړئ دئ چې تاسو کولائ شئ په آسانی ګډون پکې وکړئ د پروژو لیست دلته وګورئ + +

+ + + +### + + +###
د نورو وسیلو په کارولو سره درسونه
+*** + +| 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) | \ No newline at end of file diff --git a/docs/translations/README.pt-ao.md b/docs/translations/README.pt-ao.md new file mode 100644 index 00000000..be96f72b --- /dev/null +++ b/docs/translations/README.pt-ao.md @@ -0,0 +1,97 @@ +[![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 +fork deste repositorio + +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: +``` +git clone +``` + Para que fique assim: + +> 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`: +``` +git checkout -b +``` + +Por exemplo: +``` +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`: +``` +git add Contributors.md +``` +Agora faz um Commit dessas alterações utilizando o comando `git commit`: +``` +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`: +``` +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. + +## 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) | diff --git a/docs/translations/README.pt-pt.md b/docs/translations/README.pt-pt.md new file mode 100644 index 00000000..e32be7e4 --- /dev/null +++ b/docs/translations/README.pt-pt.md @@ -0,0 +1,104 @@ +[![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 + +É 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 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: +``` +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: +``` +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á): +``` +cd first-contributions +``` + +Agora crie um novo Branch usando o comando `git checkout`: +``` +git checkout -b +``` + +Por exemplo: +``` +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`: +``` +git add Contributors.md +``` +Agora faz um Commit dessas alterações utilizando o comando `git commit`: +``` +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`: +``` +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). + + 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 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) | diff --git a/docs/translations/README.pt_br.md b/docs/translations/README.pt_br.md new file mode 100644 index 00000000..d68d6cad --- /dev/null +++ b/docs/translations/README.pt_br.md @@ -0,0 +1,124 @@ +[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) +[Junte-se à nós no Slack](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 + +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: + +``` +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: + +``` +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): + +``` +cd first-contributions +``` + +Agora crie um _Branch_ usando o comando `git switch`: + +``` +git switch -c +``` + +Por exemplo: + +``` +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`: + +``` +git add Contributors.md +``` + +Agora, confirme essas alterações usando o comando git commit `git commit`: + +``` +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`: + +``` +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). + +Você também pode se juntar à nossa equipe no _Slack_ caso precise de alguma ajuda ou tenha alguma dúvida. [Junte-se à nossa equipe no Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.pus.md b/docs/translations/README.pus.md new file mode 100644 index 00000000..d8b8e6bd --- /dev/null +++ b/docs/translations/README.pus.md @@ -0,0 +1,107 @@ +[![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-vchl8cde-S0KstI_jyCcGEEj7rSTQiA) +[![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 وسیلو کارولو څرنګوالی](#د-نورو-وسیلو-کارولو-لارښوونې)._ + +fork this repository + +#### که تاسو git نصب نلرئ [له دې ځایه نصب کړئ](https://help.github.com/articles/set-up-git/). + +## د دې ریپوزیتوری فورک کړئ +د دې پاڼې په سر کې د Fork تڼۍ په کلیک کولو سره دا ذخیره فورک کړئ. +دا به ستاسو په حساب کې د دې ذخیره کاپي رامینځته کړي. + +## فورک شوی ریپازیتوری کلون Clone کړئ + +clone this repository + +اوس خپل ماشین ته د فورک شوي ذخیره کلون کړئ. خپل GitHub حساب ته لاړ شئ، د فورک شوي ریپازیتوری خلاص کړئ، د Code تڼۍ باندې کلیک وکړئ او بیا د کلپ بورډ ته د Copy To Clipboard باندې کلیک وکړئ. + +بیا یو ټرمینل خلاص کړئ او لاندې کمانډ چل کړئ: +``` +git clone "url you just copied" +``` +چیرته چې "url you just copied" (پرته د نرخ نښه) د دې ریپازیتوری url دی (ستاسو د دې پروژې فورک). د url ترلاسه کولو لپاره مخکیني ګامونه وګورئ. + +copy URL to clipboard + +د مثال په توګه: +``` +git clone https://github.com/this-is-you/first-contributions.git +``` +چیرته چې 'this-is-you' ستاسو د GitHub کاربری نوم دی. دلته تاسو خپل کمپیوټر ته په GitHub کې د لومړۍ مرستې ذخیره مینځپانګې کاپي کوئ. + +### یوه څانګه جوړه کړئ +په خپل کمپیوټر کې د ریپوزیتوری لارښود ته بدل کړئ (که تاسو دمخه نه لرئ): +``` +cd first-contributions +``` +اوس د `git switch` کمانډ په کارولو سره څانګه جوړه کړئ: +``` +git checkout -b your-new-branch-name +``` +د مثال په توګه: +``` +git checkout -b add-alonzo-church +``` + +### اړین بدلونونه وکړئ او دا بدلونونه Commit کړئ +اوس د `Contributors.md` فایل په متن ایډیټر کې خلاص کړئ، خپل نوم پکې اضافه کړئ. دا د فایل په پیل یا پای کې مه اضافه کړئ. په منځ کې هر ځای کېږدئ. اوس، فایل ذخیره کړئ. + +git status + +که تاسو د پروژې موقعیت ته لاړ شئ او د `git status` کمانډ اجرا کړئ ، نو تاسو به وګورئ چې بدلونونه شتون لري. + +د `git add` کمانډ په کارولو سره دا بدلونونه په هغه څانګه کې اضافه کړئ چې تاسو یې رامینځته کړی: +``` +git add Contributors.md +``` + +اوس دا بدلونونه د `git commit` کمانډ په کارولو سره ترسره کړئ: +``` +git commit -m "Add to Contributors list" +``` + د خپل نوم سره بدل کړئ. + +## GitHub ته بدلونونه فشار (Push) وکړئ +د 'git push' کمانډ په کارولو سره خپل بدلونونه فشار (Push) وکړئ: +``` +git push origin +``` +د `your-branch-name` بدلول د هغه څانګې نوم سره چې تاسو مخکې جوړ کړی: + +## خپل بدلونونه د بیاکتنې لپاره وسپارئ +که تاسو په GitHub کې خپل ریپازیتوری ته لاړ شئ، نو تاسو به د `Compare & pull request` تڼۍ وګورئ. په هغه تڼۍ کلیک وکړئ. + +create a pull request + +اوس د پلولو غوښتنه (Pull Request) وسپارئ. + +submit pull request + +ډیر ژر به زه ستاسو ټول بدلونونه د دې پروژې په اصلي څانګه کې یوځای کړم. تاسو به د خبرتیا بریښنالیک ترلاسه کړئ کله چې بدلونونه یوځای شي. + +## راتلونکی څه شی دی +مبارک شه! تاسو یوازې د معیاري فورک(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) + +## د-نورو-وسیلو-کارولو-لارښوونې +| 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) | +| | | | | | | +

diff --git a/docs/translations/README.ro.md b/docs/translations/README.ro.md new file mode 100644 index 00000000..af112c56 --- /dev/null +++ b/docs/translations/README.ro.md @@ -0,0 +1,143 @@ +[![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). + +Puteți să vă alăturați echipei noastre Slack dacă aveți nevoie de ajutor sau aveți întrebări. [Alăturați-vă echipei Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w). + +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:

+

+ + + +

diff --git a/docs/translations/README.ru.md b/docs/translations/README.ru.md new file mode 100644 index 00000000..04297a97 --- /dev/null +++ b/docs/translations/README.ru.md @@ -0,0 +1,174 @@ +[![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) + +# Первый вклад в проект + +Сложно. Всегда сложно начинать что-то с самого начала. Довольно неприятно совершать ошибки, особенно если вы работаете в команде. Весь open source состоит из сотрудничества и совместной работы. Мы хотим облегчить первые шаги в обучении и сотрудничестве начинающим разработчикам. + +Чтение статей и учебников может помочь, но что может быть лучше, чем настоящий практический опыт, без риска что-либо испортить? Цель этого проекта - должным образом направить молодых новобранцев, а также предоставить им возможность сделать их первый вклад. Помните: чем меньше вы напряжены, тем лучше вы учитесь. Если вы ищете возможность осуществить свой первый вклад, просто следуйте простым шагам, расположенным ниже. Обещаем, будет интересно. + +Если вам нужна помощь с командной строкой, [это руководство использует инструменты графической операционной системы (GUI).](#Использование-других-инструментов) + +сделать ветку + +Если у вас не установлен git на компьютере, [ установите его. ](https://help.github.com/articles/set-up-git/) + +## Создайте ветку + +Создайте собственную ветку, нажав на кнопку `fork` сверху этой страницы. Таким образом, вы создадите копию этого репозитория в своем аккаунте. + +## Клонируйте репозиторий + +клонировать репозиторий + +Теперь клонируйте ваш репозиторий на ПК. Нажмите на кнопку `clone`, а затем на иконку `copy to clipboard`, чтобы скопировать ссылку. + +Откройте терминал и запустите следующую git команду: + +``` +git clone "ссылка на репозиторий" +``` + +Где "ссылка на репозиторий" (без кавычек) - это ссылка на ваш репозиторий. Посмотрите предыдущие шаги, чтобы получить эту ссылку. + +скопируйте ссылку в буфер обмена + +Например: + +``` +git clone https://github.com/ваш-логин/first-contributions.git +``` + +Где `ваш логин` ваш логин на github'e. Таким образом вы копируете репозиторий 'first-contributions' с GitHub на ваш ПК. + +## Создайте ветку + +Перейдите в каталог репозитория на вашем компьютере, если вы еще не там. + +``` +cd first-contributions +``` + +Теперь создайте ветку с помощью команды `git checkout` + +``` +git checkout -b +``` + +Например: + +``` +git checkout -b add-alonzo-church +``` + +(Синтаксически не требуется, чтобы название ветки содержало слово _add_, но это оправдано, поскольку подчеркивает назначение этой ветки: добавить ваше имя в список.) + +## Внесите необходимые изменения и создайте коммит + +Теперь откройте файл `Contributors.md` в вашем текстовом редакторе, впишите ваше имя и сохраните файл. Если вы перейдёте в директорию проекта и выполните `git status`, вы увидите изменения. Добавьте эти изменения с помощью команды `git add`. + +``` +git add Contributors.md +``` + +Теперь закоммитьте данные изменения с помощью команды `git commit`. + +``` +git commit -m "Add to Contributors list" +``` + +Измените `` на ваше имя + +## Запушьте изменения на github + +Запушьте ваши изменения с помощью `git push` + +``` +git push origin +``` + +Измените `` на имя ветки, которую вы создали ранее. + +## Подтвердите изменения для ревью + +Если вы зайдете в свой репозиторий на GitHub, вы увидите кнопку `Compare & pull request`. Нажмите на нее. + +create a pull request + +Теперь подтвердите пулл-реквест. + +submit pull request + +Скоро я произведу объединение всех ваших изменений с основной веткой данного проекта. Вы получите сообщение по электронной почте, когда изменения будут приняты (смержены). + +Основная ветка вашего репозитория не будет изменена. Для синхронизации выполните шаги, расположенные ниже. + +## Синхронизируйте вашу ветку с данным репозиторием + +Прежде всего перейдите в основную ветку: + +``` +git checkout main +``` + +Затем добавьте url моего репозитория в поле `upstream remote url`: + +``` +git remote add upstream https://github.com/Roshanjossey/first-contributions +``` + +Таким образом мы сообщим git'у, что существует другая версия данного проекта по определенной ссылке, и мы ее считаем мастером. Как только изменения смержены, подгрузите новую версию моего репозитория. + +``` +git fetch upstream +``` + +Таким образом мы забрали все изменения в моём ответвлении (upstream remote). После, вам нужно смержить новую версию моего репозитория с вашей мастер-веткой. + +``` +git rebase upstream/main +``` + +Так вы применяете все изменения, которые вы подтянули к вашей мастер-ветке. Если вы запушите сейчас мастер-ветку, ваше ответвление тоже будет содержать изменения. + +``` +git push origin main +``` + +Обратите внимание, что вы пушите в удаленный репозиторий origin. + +На этом этапе я объединил вашу ветку `` со своей мастер-веткой, а вы объединили свою мастер-ветку с моей. Ваша ветка больше не нужна, вы можете удалить её: + +``` +git branch -d +``` + +Так же можете удалить её версию в удалённом репозитории: + +``` +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) | diff --git a/docs/translations/README.se.md b/docs/translations/README.se.md new file mode 100644 index 00000000..2d1bb805 --- /dev/null +++ b/docs/translations/README.se.md @@ -0,0 +1,123 @@ +[![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 + +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)* + + +fork this 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 + +clone this 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: + +``` +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. + +copy URL to clipboard + +Till exempel: +``` +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): + +``` +cd first-contributions +``` + +Nu skapar du en branch genom att använda `git checkout`-kommandot: +``` +git checkout -b +``` + +Till exempel: +``` +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. + +git status + +Ge kommando `git status` i projektkatalogen för att se de ändringar du gjort. + + +Lägg till dina ändringar genom att använda kommando `git add -A`: + +``` +git add Contributors.md +``` + +Commita dina ändringar genom att använda `git commit`: +``` +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`: +``` +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. + +create a pull request + +Skicka iväg din s.k. pull request. + +submit 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 ställa frågor så kan du gå med i vår slack-grupp. [Gå med i slack-gruppen](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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 | 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) | diff --git a/docs/translations/README.si.md b/docs/translations/README.si.md new file mode 100644 index 00000000..ba24b530 --- /dev/null +++ b/docs/translations/README.si.md @@ -0,0 +1,129 @@ +[![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) + +# පළමු දායකත්වය + +ආරම්භකයින්ගේ පළමු දායකත්වය ලබා දෙන ආකාරය සරල කිරීම සහ මඟ පෙන්වීම මෙම ව්‍යාපෘතියේ අරමුණයි. ඔබ ඔබේ පළමු දායකත්වය ලබා දීමට බලාපොරොත්තු වන්නේ නම්, පහත පියවර අනුගමනය කරන්න. + +#### *ඔබ විධාන රේඛාව (command line) සමඟ අපහසු නම්, [GUI මෙවලම් භාවිතා කරන නිබන්ධන මෙන්න.](#tutorials-using-other-tools)* + +මෙම ගබඩාව fork කරන්න + +ඔබේ පරිගණකයේ git නොමැති නම්, [ස්ථාපනය කරන්න](https://help.github.com/articles/set-up-git/). + +## මෙම ගබඩාව fork කිරීම + +පිටුවේ ඉහළින් ඇති fork බොත්තම ක්ලික් කිරීමෙන් මෙය කළ හැකිය. මෙය ඔබගේ ගිණුමේ +පිටපතක් සාදනු ඇත. + +## මෙම ගබඩාව clone කරන්න + +මෙම ගබඩාව clone කරන්න + +දැන් ඔබේ පරිගණකට fork කරපු repository ය ක්ලෝන කරන්න. ඔබට ඔබගේ GitHub ගිණුමට ගොස් fork කරපු repository විවෘත කර clone බොත්තම ක්ලික් කර එය පසුරු පුවරුවට (clipboard) පිටපත් කිරීමෙන් මෙය කළ හැක. + +*terminal* හෝ *command prompt* විවෘත කර පහත git විධානය ක්‍රියාත්මක කරන්න: + +``` +git clone "ඔබ පිටපත් කළ url එක" +``` + +මෙහි "ඔබ පිටපත් කළ url එක" (උපුටා දැක්වීම් ලකුණු නොමැතිව) මෙම ගබඩාවේ url එක වේ (මෙම ව්යාපෘතියේ ඔබේ දෙබල (fork) ). url එක ලබා ගැනීමට පෙර පියවර බලන්න. + +copy URL to clipboard + + +උදාහරණ වශයෙන්: + +``` +git clone https://github.com/මෙය-ඔබයි/first-contributions.git +``` + +මෙහි `මෙය ඔබයි` යනු GitHub පරිශීලක නාමයයි. මෙය ඔබගේ GitHub ගිණුමේ first-contributions repository පිටපතක් සෑදීමට ඔබට ඉඩ සලසයි. + +## ශාඛාවක් නිර්මාණය කිරීම + +ඔබේ පරිගණකයේ ගබඩා නාමාවලියට වෙනස් කරන්න (ඔබ දැනටමත් එහි නොමැති නම්): + +``` +cd first-contributions +``` + + +දැන් `git checkout` විධානය භාවිතා කරමින් ශාඛාවක් සාදන්න: + +``` +git checkout -b <ඔබගේ-නව-ශාඛාවේ-නම> +``` + +උදාහරණ වශයෙන්: + +``` +git checkout -b add-luke-oliff +``` + +(ශාඛාවේ නමට *add* එකතු කිරීම අවශ්‍ය නොවේ, නමුත් එය සාධාරණ දෙයකි, මන්ද මෙම ශාඛාවේ අරමුණ ඔබේ නම ලැයිස්තුවකට එකතු කිරීමයි.) + +## අවශ්‍ය වෙනස්කම් සිදු කර commit කරන්න + +දැන් Contributors.md ගොනුව පෙළ සංස්කාරකයක විවෘත කරන්න, එයට ඔබේ නම එක් කරන්න. ගොනුවේ ආරම්භයේ හෝ අවසානයේ එය එකතු නොකරන්න. එය අතර මැද ඕනෑම තැනකට එකතු කරන්න. දැන්, ගොනුව save කරන්න. + +git status + +ඔබ ව්‍යාපෘති නාමාවලිය වෙත ගොස් git status විධානය ක්‍රියාත්මක කළහොත්, වෙනස්කම් ඇති බව ඔබට පෙනෙනු ඇත. + +`git add` විධානය භාවිතයෙන් ඔබ දැන් නිර්මාණය කළ ශාඛාවට එම වෙනස්කම් එක් කරන්න: + +``` +git add Contributors.md +``` + +දැන් `git commit` විධානය භාවිතා කර එම වෙනස්කම් සිදු කරන්න: + +``` +git commit -m "Add <ඔයාගේ_නම> to Contributors list" +``` + +`<ඔබේ_නම>` වෙනුවට ඔබේ නම ඇතුල් කරන්න. + +## GitHub වෙත වෙනස්කම් තල්ලු කරන්න + +`git push` විධානය භාවිතයෙන් ඔබගේ වෙනස්කම් තල්ලු කරන්න: +``` +git push origin -u <ඔබගේ-නව-ශාඛාවේ-නම> +``` + +`<ඔබගේ-නව-ශාඛාවේ-නම>` ඔබ කලින් නිර්මාණය කළ නම සමඟ ශාඛාව ප්රතිස්ථාපනය කරන්න. + +## සමාලෝචනය සඳහා ඔබේ වෙනස්කම් ඉදිරිපත් කරන්න + + +ඔබ GitHub හි ඔබගේ ගබඩාවට ගියහොත්, ඔබට `Compare & pull request` බොත්තමක් පෙනෙනු ඇත. එම බොත්තම මත ක්ලික් කරන්න. + +create a pull request + +දැන් pull request ඉදිරිපත් කරන්න. + +submit pull request + +මම ළඟදීම ඔබේ සියලු වෙනස්කම් මෙම ව්‍යාපෘතියේ ප්‍රධාන ශාඛාවට ඒකාබද්ධ කරමි. වෙනස්කම් ඒකාබද්ධ කළ පසු ඔබට දැනුම්දීමේ Email පණිවිඩයක් ලැබෙනු ඇත. + +## මෙතැන් සිට කොහේ යන්නද? + +සුභ පැතුම්! ඔබ දායකයෙකු ලෙස සම්මත 'fork -> clone -> edit -> pull request' කාර්ය ප්‍රවාහය ඔබ සම්පුර්ණ කර ඇත! + +ඔබේ දායකත්වය සහ ඔබේ මිතුරන් සහ අනුගාමිකයින් සමඟ සමරන්න [web app](https://firstcontributions.github.io/#social-share) ගිහින් share කරන්න. + +ඔබට කිසියම් උදව්වක් අවශ්‍ය නම් හෝ කිසියම් ප්‍රශ්නයක් ඇත්නම් ඔබට අපගේ slack කණ්ඩායමට සම්බන්ධ විය හැකිය. [අපගේ slack කණ්ඩායමට එක්වන්න](https://join.slack.com/t/firstcontributors/shared_invite/zt-kpbyrmkk-JDkRtchcvRvQ0qK4iPmyvA).. + +දැන් අපි ඔබට වෙනත් ව්‍යාපෘති සඳහා දායක වීම ආරම්භ කරමු. ඔබට ආරම්භ කළ හැකි පහසු ගැටළු සහිත ව්‍යාපෘති ලැයිස්තුවක් අපි සම්පාදනය කර ඇත්තෙමු. පරීක්ෂා කරන්න [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) | diff --git a/docs/translations/README.sindhi.md b/docs/translations/README.sindhi.md new file mode 100644 index 00000000..3951a30f --- /dev/null +++ b/docs/translations/README.sindhi.md @@ -0,0 +1,132 @@ +[![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) + +# پهريون تعاون + +اهو ڏکيو آهي. اهو هميشه مشڪل آهي پهريون دفعو توهان ڪجهه ڪيو خاص طور تي جڏهن توهان تعاون ڪري رهيا آهيو ، غلطيون ڪرڻ هڪ آرام واري شيءِ نه آهي. اسان پهريون طريقو کولڻ چاهيون ٿا نئون کليل ذريعو مددگار سکن ٿا ۽ پهريون ڀيرو حصو وٺن ٿا. + +پڙهائي آرٽيڪل ۽ ڏسڻ وارا سبق مدد ڪري سگھن ٿا ، پر اصل ۾ عملي ماحول ۾ شيون ڪرڻ سان سٺو ڇا آهي؟ ھن پروجيڪٽ جو مقصد مقصد مهيا ڪرڻ ۽ آسانيون جوڙيندڙن کي پنھنجي ابتدائي مدد ڪرڻ جو طريقو آھي. جيڪڏھن توھان پنھنجو پھريون حصو بڻائڻ جي ڪوشش ڪري رھيا آھيو ، ھيٺين قدمن تي عمل ڪريو. + +### جيڪڏهن توهان ڪمانڊ لائن سان مطمئن نه آهيو ، [هتي GUI ٽولز استعمال ڪرڻ وارا سبق آهن.] (# سبق استعمال ڪندڙ-ٻئي اوزار) _ + + +#### _ ھن [ٻين ٻولين ۾] پڙھو (ترجما / ترجما. ايم ڊي) ._ + +fork this repository + +#### جيڪڏهن توهان کي پنهنجي مشين تي گٽ نه آهي ، ته [انسٽال ڪريو] (https://help.github.com/articles/set-up-git/). + +## هن مخزن کي سنڀاليو + +هن صفحي جي مٿئين حصي تي فورڪ بٽن تي ڪلڪ ڪري هن مخزن کي دٻايو. +اهو توهان جي اڪائونٽ ۾ هن مخزن جي ڪاپي ٺاهي ڏيندو. + +## مخزن کي کلون + +clone this repository + +هاڻي ڪلون محفوظ ڪيل مخزن کي توهان جي مشين ڏانهن پهچايو. پنھنجي GitHub اڪائونٽ ڏانھن وڃو ، فورڪ ٿيل مخزن کي کوليو ، ڪوڊ واري بٽڻ تي ڪلڪ ڪريو ۽ پوءِ _ ڪپي ڪلپ بورڊ جي آئڪن تي ڪلڪ ڪريو. + +هڪ ٽرمينل کوليو ۽ هيٺيان گٽ ڪمانڊ هلايو. + +" +گٽ کلون ”يو آر ايل توهان ڪاپي ئي ڪئي آهي“ +" + +جتي "صرف توهان يوپي ايل ڪاپي ڪئي آهي" (ڪڻڪ جي نشانين کانسواءِ) هن ريزنزوري ڏانهن يو آر ايل (هن پراجيڪٽ جي ڪانٽ). يو آر ايل حاصل ڪرڻ لاءِ پوئين قدم ڏسو. + +copy URL to clipboard + +مثال طور: + +" +گٽ کلون https://github.com/this-is-you/first-contactions.git +" + +جتي-هي-تون-توهان جو آهي توهان جو GitHub صارف نالو هتي توهان پنهنجي ڪمپيوٽر ڏانهن GitHub تي سڀ کان پهرين شراڪت جي مخزن جو مواد نقل ڪري رهيا آهيو. + +## هڪ شاخ ٺاهيو + +توهان جي ڪمپيوٽر تي مخزن ڊاريڪٽري ۾ تبديل ڪريو (جيڪڏهن توهان پهريان ئي نه آهيو) + +" +سي ڊي پهرين تعاون +" + +ھاڻي شاخ ٺاھيو حڪم "گٽ چيڪ آئوٽ" استعمال ڪندي. + +" +ڏسي چڪاس ڪريو -آب نئون-شاخ-نالو +" + +مثال طور: + +" +گٽ چيڪ آئوٽ -b شامل الونزو-چرچ +" + +(شاخ جو نالو _add_ لفظ شامل ڪرڻ جي ضرورت ناهي ، پر ان ۾ شامل ٿيڻ مناسب ڳالهه آهي ڇاڪاڻ ته هن برانچ جو مقصد توهان جي نالي کي لسٽ ۾ شامل ڪرڻ آهي.) + +## ضروري تبديليون ڪيو ۽ انهن تبديلين کي انجام ڏيو + +ھاڻي ٽيڪسٽ ايڊيٽر ۾ Contributors.md فائل کوليو ، پنھنجو نالو ان ۾ شامل ڪريو. فائل جي شروعات يا آخر ۾ ان کي شامل نه ڪريو. ان کي وچ ۾ ڪٿي به وجھو. ھاڻي ، فائل کي بچايو. + +git status + +جيڪڏهن توهان پروجيڪٽ ڊاريڪٽري ڏانهن وڃو ۽ حڪم کي ختم ڪريو گٽ اسٽيٽس ، توهان ڏسندا ته هتي تبديليون آهن. + +جن شاخن کي توھان ٺاھيو آھي انھن کي شامل ڪريو جيڪي تبديلي آڻي سگھوٿا + +" +git شامل ڪريو Contributors.md +" + +ھاڻي انھن تبديلين کي انجام ڏيو "گٽ ڪمٽ" حڪم استعمال ڪندي: + +" +git commit -m "شرڪت ڪندڙن جي لسٽ ۾ <توھان جو نالو شامل ڪريو" +" + +توهان جي نالي سان "توهان جو نالو" بدلجي ٿو. + +## گٽ هب ۾ پش تبديلين + +پنھنجن تبديلين کي ھٿ سان ڌڪايو "گشت پش": + +" +گٽ پش اصل +" + +توهان جي ٺاهي ڪيل شاخ جي نالي سان "کي تبديل ڪرڻ + +## پنھنجون تبديليون راءِ لاءِ پيش ڪريو + +جيڪڏهن توهان GitHub تي پنهنجي مخزن ڏانهن ويندا آهيو ، توهان ڏسندا "تقابلي ۽ پلڻ واري درخواست" بٽڻ. انهي بٽڻ تي ڪلڪ ڪيو. + +create a pull request + +هاڻي پل جي درخواست جمع ڪر. + +submit pull request + +جلد ئي آئون توهان جي سڀني تبديلين کي ان منصوبي جي ماسٽر برانچ ۾ ضم ڪري ڇڏيندس. توهان جون هڪ ڀيرو اطلاع ملڻ واري اي ميل حاصل ٿيندي هڪ ڀيرو تبديليون ضم ٿي ويون آهن. + +## ڪيڏانهن وڃڻو آهي؟ + +مبارڪون هجن! توهان صرف معياري _فورڪ -> ڪلون -> ايڊٽ ڪيو -> پل درخواست_ ڪم جي وهڪري کي مڪمل ڪيو جنهن سان توهان اڪثر منهن ڏيڻ ۾ مدد ڪندا! + +پنهنجي حصي جو جشن ملهايو ۽ ان کي [ويب ايپ] تي وڃڻ سان پنهنجن دوستن ۽ پوئلڳن سان حصيداري ڪريو (https://firstcontactions.github.io/#social-share). + +جيڪڏهن توهان ڪنهن مدد جي گهرج ۾ يا ڪنهن سوال جي صورت ۾ توهان اسان جي سستي ٽيم ۾ شامل ٿي ويا [سليڪ ٽيم ۾ شامل ٿيو] (https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +هاڻي اچو ته توهان شروع ڪيو ٻين منصوبن ۾ ڀاڙي سان حصو وٺي اسان منصوبن جي هڪ فهرست مرتب ڪئي آهي توهان کي آسان مسئلن تي جيڪي توهان شروع ڪري سگهو ٿا. [ويب ائپ ۾ منصوبن جي فهرست] چيڪ ڪريو (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) | diff --git a/docs/translations/README.sk.md b/docs/translations/README.sk.md new file mode 100644 index 00000000..fa767a49 --- /dev/null +++ b/docs/translations/README.sk.md @@ -0,0 +1,125 @@ +[![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) + +# Prvý príspevok + +Život je ťažký. Obzvlášť keď niečo robíte 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: + +```` +git clone "url ktoré ste práve skopírovali" + +```` + +skopírujte adresu do schránky + +Napríklad: + +```` +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) + +```` +cd first-contributions +```` + +Teraz vytvorte novú vetvu (anglicky *branch*) za použitia príkazu `git checkout`: + +```` +git checkout -b +```` + +Napríklad: +```` +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`: + +```` +git add Contributors.md +```` + +Zostáva už len potvrdiť (anglicky *commit*) zmeny príkazom `git commit`: + +```` +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`: + +```` +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). + +V prípade, ak by ste mali akékoľvek otázky alebo potrebovali pomoc, môžete sa [pridat k našemu Slack teamu](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY). + +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 + +|GitHub Desktop|Visual Studio 2017|GitKraken|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)| \ No newline at end of file diff --git a/docs/translations/README.sl.md b/docs/translations/README.sl.md new file mode 100644 index 00000000..bee6b926 --- /dev/null +++ b/docs/translations/README.sl.md @@ -0,0 +1,121 @@ +[![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) + + +# 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 )* + + +fork this repository + +Č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 ) + +clone this repository + +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: + +``` +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. + +copy URL to clipboard + +Primer: +``` +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): + +``` +cd first-contributions +``` +Sedaj ustvari vejo z uporabo ukaza `git checkout`: +``` +git checkout -b +``` + +Primer: +``` +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. + +git status + +Č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`: + +``` +git add Contributors.md +``` + +Sedaj izvedi commit teh sprememb z ukazom `git commit`: +``` +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`: +``` +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. + +create a pull request + +Sedaj izvedi submit svojega pull requesta. + +submit 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! + +Lahko se pridružiš naši slack ekipi, če rabiš pomoč ali imaš vprašanja. [Pridruži se slack ekipi](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.slk.md b/docs/translations/README.slk.md new file mode 100644 index 00000000..042b3342 --- /dev/null +++ b/docs/translations/README.slk.md @@ -0,0 +1,121 @@ +[![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 )* + +fork this repository + +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 + +clone this repository + +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: + +``` +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. + +copy URL to clipboard + +Napríklad: +``` +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): + +``` +cd prve-prispevky +``` +Teraz vytvor vetvu pomocou príkazu `git checkout`: +``` +git checkout -b +``` + +Napríklad: +``` +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ž. + +git status + +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`: + +``` +git add Contributors.md +``` + +Teraz vykonaj tieto zmeny pomocou príkazu `git commit`: +``` +git commit -m "Pridaj do zoznamu pripievateľov" +``` +nahraď `` tvojim menon. + +## Nahraj zmeny na GitHub + +Nahraj svoje zmeny pomocou príkazu `git push`: +``` +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. + +create a pull request + +Teraz predlož požiadavku na vytiahnutie. + +submit 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) | diff --git a/docs/translations/README.so.md b/docs/translations/README.so.md new file mode 100644 index 00000000..9beec47e --- /dev/null +++ b/docs/translations/README.so.md @@ -0,0 +1,154 @@ +[![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) + +# 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. + + +fork this repository + +#### 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 + +clone this repository + +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 + +copy URL to clipboard + +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. + + +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. + +create a pull request + +Hadda soo gudbi codsiga jiidista (pull request). + +submit pull request + +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). + +Waxaad ku biiri kartaa kooxdeena slack ah haddii aad u baahan tahay wax caawimo ah ama aad qabto wax su'aalo ah. [Ku biir kooxda slack ](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | \ No newline at end of file diff --git a/docs/translations/README.sr.md b/docs/translations/README.sr.md new file mode 100644 index 00000000..b3cca4ae --- /dev/null +++ b/docs/translations/README.sr.md @@ -0,0 +1,118 @@ +[![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) + + +# Prvi prilog + +Teško je. Prvi pokušaj je uvek težak. Kada sarađuješ sa drugima, napraviti greške je utoliko strašnije. Želeli bismo da olakšamo proces kroz koji novi programeri koji doprinose otvorenom softveru (eng. open source) uče i doprinose po prvi put. + +Iako blogovi i tutorijali mogu da pomognu, ništa nije bolje nego uzeti stvari u svoje ruke i zaista doprinositi u trening-sredini. 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, pratite sledeće korake. + + +#### *Ako vam je nezgodno da čitate tekst u komandnoj liniji, [evo linka kroz GUI alate.](#Uputstva-za-druge-alate)* + +Napravite fork repozitorijuma + +Ukoliko nemati git instaliran na vašoj mašini, [instalirajte ga ovde]( https://help.github.com/articles/set-up-git/). + +## Napravite fork repozitorijuma + +Napravite račvanje (fork) tako što ćete kliknuti na dugme *fork* na vrhu stranice. Ovako pravite kopiju repozitorijuma na vašoj strani. + +## Klonirajte repozitorijum + +clone this repository + +Sledeće, klonirajte repozitorijum koji ste prethodno račvali. Posetite svoj GitHub profil, otvorite repozitorijum koji ste račvali, kliknite na *clone* dugme i kliknite na ikonicu *copy to clipboard*. + +Otvorite terminal i upišite sledeće git komande: + +``` +git clone "url you just copied" +``` +Umesto "url you just copied" (bez navodnika i razmaka) upišite url repozitorijuma koji ste kopirali u prethodnom koraku. + +copy URL to clipboard + +Na primer: +``` +git clone https://github.com/this-is-you/first-contributions.git +``` +Gde je umesto `this-is-you` upisano vaše korisničko ime. Ovim kopirate sadržaj repozitorijuma *first-contributions* na vašu mašinu. + +## Pravljenje grane *branch* + +Prebacite se u radni direktorijum na vašoj mašini: +``` +cd first-contributions +``` +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, ali je zgodno uključiti ga jer je svrha ove grane da doda vaše ime na listu. + +## Napravite potrebne izmene i potvrdite promene + +Otvorite `Contributors.md` fajl u tekst editoru i dodajte vaše ime. Nemojte dodavati ime na sam početak ili kraj. Stavite ga negde u sredinu. Potom sačuvajte fajl. + +git status + +Ukoliko odete u radni direktorijum i izvršite komandu `git status`,primetićete da postoje promene. + +Dodajte ove promene u granu koju ste gore napravili koristeći `git add` komandu: + +``` +git add Contributors.md +``` + +Sada potvrdite ove promene koristeći `git commit` komandu: +``` +git commit -m "Add to Contributors list" +``` +Gde umesto `` upisujete svoje ime. + +## Push changes to GitHub + +Pošaljite izmene u repozitorijum na GitHub nalogu `git push`: +``` +git push origin +``` +gde umesto `` stavljate ime vašeg grananja. + +## Pošaljite izmene na reviziju + +Ukoliko odete na repozitorijum na vašem GitHub nalogu primetićete `Compare & pull request` Dugme. Kliknite na njega. + +create a pull request + +a potom pošaljite zahtev klikom na dugme *submit*. + +submit pull request + +Nakon toga, ja ću spojiti promene 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 podeliti vaš doprinos sa prijateljima i pratiocima otvaranjem [stranice](https://firstcontributions.github.io/#social-share). + +Pridružite se i našem Slack timu u slučaju da vam je potrebna ikakva pomoć ili imate bilo kakvih pitanja. [Slack tim](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.sw.md b/docs/translations/README.sw.md new file mode 100644 index 00000000..dae5e389 --- /dev/null +++ b/docs/translations/README.sw.md @@ -0,0 +1,130 @@ +[![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)* + +fork this repository + +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 this repository + +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: + +``` +git clone "url-uliyo-nakili-github" +``` + +url hiyo inapatikana kwenye hatua ya ku clone, hakikisha unaondoa fungua semi na funga semi. + +copy URL to clipboard + +Kwa mfano: + +``` +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 + +``` +cd first-contributions +``` + +Sasa tengeneza branch kwa kutumia command ifuatayo `git checkout` command: + +``` +git checkout -b +``` + +Kwa mfano: + +``` +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: + +``` +git add Contributors.md +``` + +Sasa commit mabadiliko uliyoyafanya kwa kutumia command ya `git commit`: + +``` +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`: + +``` +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. + +create a pull request + +Sasa tuma pull request. + +submit 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! + +Sheherekea hatua uliyofikia na wajulishe wengine kwa kwenda kwenye [wavuti](https://roshanjossey.github.io/first-contributions/#social-share). + +Waweza kujiunga 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) + +## Mafundisho 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) | diff --git a/docs/translations/README.ta.md b/docs/translations/README.ta.md new file mode 100644 index 00000000..edff6820 --- /dev/null +++ b/docs/translations/README.ta.md @@ -0,0 +1,154 @@ +[![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) + + +# முதல் பங்களிப்புகள் + +நீங்கள் ஏதாவது ஒன்றை முதல் முறை செய்யும் போது அது எப்போதுமே கடினமாக தான் இருக்கும். +குறிப்பாக, நீங்கள் குழுவாக சேர்ந்து வேலை செய்யும் போது, தவறு செய்துவிட்டால் அது மிகவும் +வருத்தம் அளிக்கக்கூடியாதாக இருக்கும். ஆகையால், திறந்த மூல மென்பொருள் +(open-source software) பங்களிப்பாளர்களாக எவ்வாறு செயலாற்ற வேண்டும் என்பதையும் +அதில் முதல் முறையாக பங்களிப்பு செய்வதை எளிதாக்குவதுமே எங்கள் நோக்கம். + +கட்டுரைகளைப் படிப்பதும், பயிற்சிகளைப் பார்ப்பதும் உதவக்கூடும், ஆனால் நடைமுறைச் சூழலில் +செய்முறையாகச் செய்வதை விட சிறந்தது என்ன? இந்த திட்டம் வழிகாட்டுதல்களை வழங்குவதையும், +ஆரம்பநிலை பங்களிப்பாளர்களை அவர்களின் முதல் பங்களிப்பை எளிதாக்குவதையும் நோக்கமாகக் +கொண்டுள்ளது. உங்கள் முதல் பங்களிப்பை வழங்க விரும்பினால், கீழே உள்ள வழிமுறைகளை +பின்பற்றவும். + +#### *command line tool உங்களுக்கு வசதியாக இல்லை என்றால், [இங்கே GUI tools ஐ பயன்படுத்தி பயிற்சிகள் உள்ளன.](#பிற-கருவிகளைப்-பயன்படுத்தி-பயிற்சிகள்)* + +இந்த repository ஐ fork செய்யவும் + +உங்கள் கணினியில் git இல்லை என்றால், [install செய்யவும்](https://help.github.com/articles/set-up-git/). + +## இந்த repository ஐ fork செய்தல் + + +இந்த பக்கத்தின் மேலே உள்ள fork பொத்தானைக் கிளிக் செய்வதன் மூலம் செயட்படுத்தலாம். +இது உங்கள் account இல் ஒரு copy ஐ உருவாக்கும். + +## இந்த repository ஐ clone செய்தல் + +இந்த repository ஐ clone செய்யவும் + +இப்போது உங்கள் கணினியில் fork செய்யப்பட்ட repository ஐ clone செய்யவும். உங்கள் GitHub கணக்கிற்குச் சென்று, forked செய்யப்பட்ட repository ஐ open செய்து clone பொத்தானைக் கிளிக் செய்து copy to clipboard கிளிக் செய்வதன் மூலம் நிறைவேற்றலாம். + +*terminal* அல்லது *command prompt* ஐ open செய்து பின்வரும் git கட்டளையை இயக்கவும்: + +``` +git clone "நீங்கள் copy செய்த url" +``` + +copy URL to clipboard + + +உதாரணத்திற்கு: + +``` +git clone https://github.com/இது நீங்கள்/first-contributions.git +``` + +இங்கு `இது நீங்கள்` என்பது GitHub username என்பதாகும். இதன் மூலம் நீங்கள் first-contributions repository இன் பிரதி ஒன்றை உங்கள் GitHub கணக்கில் செயட்படுத்துகிறீர்கள். + +## கிளையொன்றை உருவாக்குதல் + +repository directory க்கு செல்லவும் (நீங்கள் ஏற்கனவே அங்கு இல்லையென்றால்): + +``` +cd first-contributions +``` + + +இப்போது `git checkout` கட்டளையைப் பயன்படுத்தி ஒரு கிளையை உருவாக்கவும்: + +``` +git checkout -b <உங்கள்-கிளையின்-பெயர்> +``` + +உதாரணத்திற்கு: + +``` +git checkout -b உங்கள்-கிளையின்-பெயர் +``` + +(கிளையின் பெயருக்கு அதில் *add* சேர்க்க வேண்டிய அவசியமில்லை, ஆனால் இது ஒரு நியாயமான விஷயம், ஏனெனில் இந்த கிளையின் நோக்கம் உங்கள் பெயரை ஒரு பட்டியலில் சேர்ப்பதுதான்.) + +## தேவையான மாற்றங்களைச் செய்து அந்த மாற்றங்களை commit செய்யுங்கள் + +இப்போது *text editor* அல்லது *notepad* இல் `Contribitors.md` கோப்பைத் திறந்து, அதில் உங்கள் பெயரைச் சேர்க்கவும். கோப்பின் தொடக்கத்திலோ அல்லது முடிவிலோ இதைச் சேர்க்க வேண்டாம். இடையில் எங்கும் வைக்கவும். இப்போது, ​​கோப்பை சேமிக்கவும். + +git status + +நீங்கள் project directory சென்று `git status` இயக்கினால், மாற்றங்கள் இருப்பதை நீங்கள் காண்பீர்கள். + + +`git add` கட்டளையைப் பயன்படுத்தி நீங்கள் உருவாக்கிய கிளையில் அந்த மாற்றங்களைச் சேர்க்கவும்: + +``` +git add Contributors.md +``` + +இப்போது `git commit` கட்டளையைப் பயன்படுத்தி அந்த மாற்றங்களைச் செய்யுங்கள்: + +``` +git commit -m "Add <உங்கள்_பெயர்> to Contributors list" +``` + +`உங்கள்_பெயர்` என்ற இடத்தில் உங்கள் பெயரை கொடுங்கள். + +## மாற்றங்களை GitHub இட்கு push செய்தல் + +`git push` கட்டளையைப் பயன்படுத்தி உங்கள் மாற்றங்களைத் தள்ளுங்கள்: + +``` +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` கோரிக்கை பொத்தானைக் காண்பீர்கள். அந்த பொத்தானைக் கிளிக் செய்க. + +create a pull request + +இப்போது இழுக்கும் கோரிக்கையை சமர்ப்பிக்கவும். + +submit pull request + +விரைவில் உங்கள் எல்லா மாற்றங்களையும் இந்த திட்டத்தின் முதன்மை கிளையில் இணைக்கப்படும். மாற்றங்கள் ஒன்றிணைக்கப்பட்டவுடன் உங்களுக்கு அறிவிப்பு மின்னஞ்சல் கிடைக்கும். + +## இங்கிருந்து எங்கு செல்வது? + +வாழ்த்துக்கள்! நீங்கள் ஒரு பங்களிப்பாளராக அடிக்கடி சந்திக்கும் _fork -> clone -> edit -> PR_ பணிப்பாய்வு முடித்துவிட்டீர்கள். + + +உங்கள் பங்களிப்பைக் கொண்டாடுங்கள் மற்றும் உங்கள் நண்பர்கள் மற்றும் பின்தொடர்பவர்களுடன் [web app](https://firstcontributions.github.io/#social-share) சென்று பகிர்ந்து கொள்ளுங்கள். + +உங்களுக்கு ஏதேனும் உதவி தேவைப்பட்டால் அல்லது ஏதேனும் கேள்விகள் இருந்தால் எங்கள் slack team இல் இணையலாம். [Join our slack crew](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).. + +இப்போது மற்ற திட்டங்களுக்கு பங்களிப்பதன் மூலம் தொடங்குவோம். நீங்கள் தொடங்கக்கூடிய எளிதான சிக்கல்களுடன் திட்டங்களின் பட்டியலை நாங்கள் தொகுத்துள்ளோம். பாருங்கள் [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) | diff --git a/docs/translations/README.te.md b/docs/translations/README.te.md new file mode 100644 index 00000000..1b62c438 --- /dev/null +++ b/docs/translations/README.te.md @@ -0,0 +1,139 @@ +[![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) + + +# ఓపెన్‌సోర్స్‌కు మీ మొదటి సహకారం + +వ్యాసాలు చదవడం & చూడటం ట్యుటోరియల్స్ సహాయపడతాయి, కానీ వాస్తవంగా ఆచరణాత్మక వాతావరణంలో నేర్పిస్తున్నదాని కంటే మెరుగైనది ఏమిటి? + +మార్గదర్శిని అందించడం మరియు ఈ ప్రాజెక్ట్ ప్రారంభకులకు వారి మొదటి ఓపెన్ సోర్స్ సహకారం అందించే విధానాన్ని సరళీకరించడం మరియు మార్గనిర్దేశం చేయడం లక్ష్యంగా పెట్టుకుంది. మీరు మీ మొదటి ఓపెన్ సోర్స్స హకారం అందించాలని చూస్తున్నట్లయితే, దిగువ దశలను అనుసరించండి. + + +#### *మీకు ఆదేశ పంక్తితో సౌకర్యంగా లేకపోతే, [ఇక్కడ GUI సాధనాలను ఉపయోగించి ట్యుటోరియల్స్ ఉన్నాయి.](#ఇతర-సాధనాలను-ఉపయోగించి-ట్యుటోరియల్స్)* + + + + + +మొదటిసారి ఓపెన్ సోర్స్ కొరకు సహకరించాలి అనుకునే ప్రారంభకులకు పద్దతులను సులభతరం చేయడం ఈ ప్రాజెక్ట్ **ముఖ్య ఉద్దేశం** + + మీరు మొదటిసారి ఒపెన్ సోర్స్ ప్రాజెక్ట్ లకొరకు కాంట్రిబ్యూట్ చేయాలి అనుకుంటే కింది సూచనలు పాటించండి. + +మీరు `గిట్(git)`వర్షన్ కట్రోల్ సిస్టమ్ తో సౌకర్యవంతంగా లేకపోతే [ఇక్కడ GUI సాధనాలను ఉపయోగించి ట్యుటోరియల్స్ ఉన్నాయి.](#ఇతర-సాధనాలను-ఉపయోగించి-ట్యుటోరియల్స్)* + +fork this repository + +మీ కంప్యూటర్ లో `GIT` లేకపోతే, [గిట్ వర్షన్ కంట్రోల్ సిస్టమ్ ను ఇన్స్టాల్ చేయండి](https://help.github.com/articles/set-up-git/). + +## ఈ రిపోజిటరీని ఫోర్క్ చెయ్యండి + +ఈ రిపోజిటరీని ఫోర్క్ చెయ్యండి ఈ పేజీ ఎగువ భాగంలో ఫోర్క్ బటన్ పై క్లిక్ చేయడం ద్వారా క్లిక్ చేయండి. +ఇది మీ ఖాతాలో ఈ రిపోజిటరీ కాపీని సృష్టిస్తుంది. + +## ఈ రిపోజిటరీని క్లోన్ చెయ్యండి + +clone this repository + +ఇప్పుడు మీ కంప్యూటరులో ఫోర్క్ రిపోను క్లోన్ చేయండి. మీ GitHub ఖాతాకు వెళ్లండి, ఫోర్క్డ్ రెపోని తెరిచి, క్లోన్ బటన్పై క్లిక్ చేసి, ఆపై * కాపీ * క్లిప్బోర్డ్కు క్లిక్ చేయండి. + +టెర్మినల్ తెరిచి కింది git ఆదేశాన్ని అమలు చేయండి: +``` +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' మీ GitHub ప్రొఫైల్ నేమ్. ఇక్కడ మీరు `first-contribution` రిపోజిటరీ యొక్క కంటెంట్లను మీ GitHub అకౌంట్ లో మీ కంప్యూటర్కు కాపీ చేస్తున్నారు. + +## నూతన బ్రాంచ్ ను సృష్టించండి + +మీ కంప్యూటర్‌లోని రిపోజిటరీ డైరెక్టరీకి మార్చండి (మీరు ఇప్పటికే అక్కడ లేకపోతే): + +```bash +cd first-contributions +``` +ఇప్పుడు 'git checkout' కమాండ్ ను ఉపయోగించి ఒక బ్రాంచ్ ను సృష్టించండి: + + +ఉదాహరణకి: +```bash +git checkout -b add-alonzo-church +``` +(బ్రాంచ్ యొక్క పేరు దానిలో పదం * add * ను కలిగి ఉండవలసిన అవసరం లేదు. + +## అవసరమైన మార్పులు - చేర్పులు చేసి, ఆ మార్పులను నిరూపించండి. + +టెక్స్ట్ ఎడిటర్లో ఇప్పుడు ఓపెన్ `Contributors.md` ఫైల్లో, **మీ పేరుని జోడించండి. ఫైల్ ప్రారంభంలో లేదా ముగింపులో జోడించవద్దు. మధ్యలో ఎక్కడైనా ఉంచండి. ఇప్పుడు, ఫైల్ను సేవ్ చేయండి.** +git status + + +మీరు ప్రాజెక్ట్ డైరెక్టరీకి వెళ్లి `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' బటన్ను చూస్తారు. ఆ బటన్పై క్లిక్ చేయండి. + +create a pull request + +ఇప్పుడు పుల్ అభ్యర్థనను సమర్పించండి. + +submit pull request + + నేను మీ అన్ని మర్పులను ఈ ప్రాజెక్ట్ యొక్క ప్రధాన విభాగానికి విలీనం`merge to main branch` చేస్తాను. +మార్పులు విలీనం`merge` అయిన తర్వాత మీరు ఒక నోటిఫికేషన్ ఈమెయిల్ పొందుతారు. + +## ఇక్కడ నుండి ఎక్కడికి వెళ్లాలి? + +అభినందనలు! మీరు స్టాండర్డ్ _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) ను చూడండి. + +### [అదనపు విషయం](../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) | diff --git a/docs/translations/README.th.md b/docs/translations/README.th.md new file mode 100644 index 00000000..33f03898 --- /dev/null +++ b/docs/translations/README.th.md @@ -0,0 +1,120 @@ +[![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) + +# อยากเริ่ม 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) + +หรือจะมาร่วมสนทนากับเราผ่าน Slack ในกรณีที่คุณต้องการความช่วยเหลือ หรือมีข้อสงสัยใด ๆ [เข้าร่วม slack กับเรา](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 | 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) | diff --git a/docs/translations/README.tl.md b/docs/translations/README.tl.md new file mode 100644 index 00000000..095b0525 --- /dev/null +++ b/docs/translations/README.tl.md @@ -0,0 +1,127 @@ +[![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) + + +# 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)* + + + +fork this repository + +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 + +clone this repository + +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. + +copy URL to 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. + +git status + + +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. + +create a pull request + +I-submit ang pull request. + +submit 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). + +Puwede ka rin sumama sa aming Slack team kung kailangan mo ng karagdagan tulong o gustong magtanong. [Sumama sa aming Slack team](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.tm.md b/docs/translations/README.tm.md new file mode 100644 index 00000000..66af2dbd --- /dev/null +++ b/docs/translations/README.tm.md @@ -0,0 +1,157 @@ +[![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) + +#### _[Başka dillerde](translations/Translations.md) okamak._ + +[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](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.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)[Turkmen language](translations/README.tm.md) + +# Ilkinji goşantlar +Bu proýektiň maksady githuby täze öwrenijilere nädip ilkinji goşantlaryny(contribution) goşup biljeklerini görkezmekdir. + +Kyn bolup biler. Täze bir işi ilkinji sapar etmek hemişe kyn bolup biler. Hem-de başka kişiler bilen bilelikde işleşmeli bolsa, ýalňyşlyk etmäne çekinýäň, gorkýaň. Ýöne açyk çeşmäniň(open source) düýbünde başka kişiler 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, ilkinji goşantlaryny goşmagyny aňsatlaşdyrmak isleýäs. + +Blog post okamak ýa-da wideolardan öwrenmek kömek edip biler, ýöne bir zady edip öwrenmegiň ýerini tutup biljek zat ýok, şeýle dälmi? Ilkinji goşandyňy goşmak isleýän bolsaň, aşakdaky görkezilenleri yzarlap bilersiň. + + +fork this repository + +#### 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) + +clone this repository + +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ň: + +``` +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ň. + +copy URL to clipboard + +Mysal üçin: + +``` +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ň: + +``` +cd first-contributions +``` + +Indi, `git switch` buýrugy arkaly täze şaha(branch) dörediň: + +``` +git switch -c siziň-täze-şahaňyzyň-ady +``` + +Mysal üçin: + +``` +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` faylyny açyň, içinde iň soňunda adyňyzy giriziň we ýatda saklaň(save) + +``` +- [Adyňyz](https://github.com/ulanyjy-adyňyz) +``` + +Mysal üçin: +``` +- [Ahmet Ahmedow](https://github.com/ahmetahmedow) +``` +```](``` arasynda boşluk ýokdur + +git status + +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: + + +``` +git add Contributors.md +``` + +Indi, `git commit` buýrugy arkaly şol üýtgeşmeleri bellige alyp(commit) goýýas: + +``` + +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): + +``` +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ň. + +create a pull request + +Indi, Çekiş haýyşnamasyny(pull request) ýollaň. + +submit pull request + +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. + +Eger-de islendik kömek gerek bolsa ýa-da soraglaryňyz bar bolsa [biziň Slack toparymyza](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) goşulyp bilýaňiz. + + + +### [Goşmaça maglumat](additional-material/git_workflow_scenarios/additional-material.md) + +## Başga gurallar hakynda sapaklar (ýöne iňlis dilinde) + +| 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) | + + +

Bu proýektiň goldaýjysy:

+

+ + + +

diff --git a/docs/translations/README.tr.md b/docs/translations/README.tr.md new file mode 100644 index 00000000..815dd1fc --- /dev/null +++ b/docs/translations/README.tr.md @@ -0,0 +1,133 @@ +[![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) + +# İ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 Kaynakı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. + +fork this repository + +Eğer bilgisayarınızda git kurulu değil ise, [ yükleyin ]( https://help.github.com/articles/set-up-git/ ). + +## Projeyi "çatallama" + +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 + +clone this repository + +Ş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. + +copy URL to clipboard + +Ö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. + +git status + +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. + +create a pull request + +Şimdi çekme isteğini (pull request) gönderin. + +submit pull request + +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. + +Bir sorunuz veya yardıma ihtiyacınız olursa Slack takımımıza katılabilirsiniz. [Slack takımına katıl](https://firstcontributions.herokuapp.com) + +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) | diff --git a/docs/translations/README.ua.md b/docs/translations/README.ua.md new file mode 100644 index 00000000..521bda0f --- /dev/null +++ b/docs/translations/README.ua.md @@ -0,0 +1,138 @@ +[![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) + +# Перший внесок + +Цей проект спрямований на те, щоб спростити та спрямувати шлях новачків, які роблять свій перший внесок. Якщо ви хочете зробити свій перший внесок, виконайте наведені нижче дії. + +_Якщо ви не вмієте працювати з командним рядком, [ось навчальні посібники з використанням інструментів GUI.](#tutorials-using-other-tools)_ + +fork this repository + +Якщо ви ще не встановили git, тоді [зробіть це](https://help.github.com/articles/set-up-git/). + +## Форкніть репозиторій + +Форкніть свою власну копію цього репозиторію, натиснувши кнопку `fork` вгорі цієї сторінки. +Таким чином, ви створите копію цього репозиторію у вашому акаунті. + +## Клонуйте репозиторій + +clone this repository + +Тепер клонуйте цей репозиторій на ваш комп’ютер. Натисніть на кнопку `clone`, а потім - на іконку `copy to clipboard`. + +Відкрийте термінал і виконайте наступні команди: + +```bash +git clone "посилання, яке ви щойно скопіювали" +``` + +де `посилання, яке ви щойно скопіювали` (без лапок) - адреса цього репозиторію. Дивіться попередній крок для того, щоб отримати цю адресу. + +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 +``` + +Наприклад: + +```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`. Сміливо натисніть на неї. + +create a pull request + +Тепер зміни відправлені на перевірку і затвердження. + +submit pull request + +Згодом я об’єднаю ваші запропоновані зміни з основною гілкою цього репозиторію. Ви отримаєте повідомлення, коли це буде зроблено. + +## Що далі? + +Вітаю! Ви щойно виконали стандартний робочий процес _fork -> clone -> edit -> pull request_, з яким ви часто стикаєтеся як контрибутор! + +Відзначте свій внесок і поділіться ним із друзями та читачами, перейшовши до [веб-програми](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) | + +

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

+

+ + + +

diff --git a/docs/translations/README.un-aln.md b/docs/translations/README.un-aln.md new file mode 100644 index 00000000..404826f6 --- /dev/null +++ b/docs/translations/README.un-aln.md @@ -0,0 +1,129 @@ +[![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). diff --git a/docs/translations/README.ur.md b/docs/translations/README.ur.md new file mode 100644 index 00000000..7721e7e3 --- /dev/null +++ b/docs/translations/README.ur.md @@ -0,0 +1,168 @@ +[![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-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w) +[![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)
+ +##
دوسرے ٹولز کو استعمال کرتے ہوئے سبق۔
+ + +| 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) | + +
+اس منصوبے کی حمایت کی ہے +
+

+ + + +

diff --git a/docs/translations/README.uz.md b/docs/translations/README.uz.md new file mode 100644 index 00000000..91b56dbe --- /dev/null +++ b/docs/translations/README.uz.md @@ -0,0 +1,142 @@ +[![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) + + +# Birinchi hissalar + +Ushbu loyiha yangi boshlanuvchilarning birinchi hissasini 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 akkountingizda 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 horizgina ko'chirib olgan url" +``` + +bu yerda "siz horizgina 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 akkount nomingiz (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 add-aliml92 +``` + +## Kerakli o'zgarishlarni qiling va bu o'zgarishlarni commit qiling + +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 yurg'izsangiz, 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 royxatiga 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 yangi-branch-nomingiz +``` + +albatta, `yangi-branch-nomingiz` ni biroz oldin yaratgan branch nomiga almashtirgan holda. + +
+ 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. O'sha tugmani 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 horizgina 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 sizga yordam kerak bo'lsa yoki savollaringiz bo'lsa, bizning slack jamoamizga qo'shilishingiz mumkin.[Slack jamoasiga qo'shiling](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.vn.md b/docs/translations/README.vn.md new file mode 100644 index 00000000..4bf453ee --- /dev/null +++ b/docs/translations/README.vn.md @@ -0,0 +1,129 @@ +[![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 + +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 )* + +fork this repository + +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/). + +## Sao chép kho lưu trữ (Fork) + +Sao chép (copy) kho lưu trữ mã nguồn (repository) này bằng cách nhấn vào nút `Fork` (Tạo nhánh) đầ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) + +clone this repository + +Bây giờ, hãy sao chép bản sao (clone) kho lưu trữ đã được sao chép (fork) 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 mã nguồn (mà bạn đã sao chép) này. Xem các bước trước đó để có được url. + +copy URL to 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. + +git status + +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`, 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 đó. + +create a pull request + +Bây giờ, hãy gửi yêu cầu xem xét thay đổi (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í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 chuẩn copy (fork) -> Sao chép (clone) -> chỉnh sửa (edit) -> yêu cầu kéo (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://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). + +Để 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) | diff --git a/docs/translations/README.yor.md b/docs/translations/README.yor.md new file mode 100644 index 00000000..1edb8e84 --- /dev/null +++ b/docs/translations/README.yor.md @@ -0,0 +1,129 @@ +[![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) + + +# 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)* + +fork this repository + +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ọ + +clone this repository + +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 + +copy URL to 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. + +create a pull request + +oya fi silẹ. + +submit pull request + +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). + +Ẹ lè darapọ̀ mọ́ àwọn òṣìṣẹ́ òṣìṣẹ́ wa tí kò já fáfá tí ẹ bá nílò ìrànlọ́wọ́ èyíkéyìí tàbí kí ẹ lè gba àlọ́ kankan. [Darapo](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/README.zh-cn.md b/docs/translations/README.zh-cn.md new file mode 100644 index 00000000..089dfbd3 --- /dev/null +++ b/docs/translations/README.zh-cn.md @@ -0,0 +1,134 @@ +[![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) +[](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) + +# 第一次参与开源项目 + +万事开头难。特别是和其他人合作时，出错往往会令人不适。不过，开源的本质就是和他人合作。这个项目的初衷就是为初学者提供一个简单的方法去学习以及参与开源项目。 + +你可以通过阅读文章和观看教程来得到帮助，但上手实操才是最好的学习方式。本项目旨在简化并指导初学者参与他们的第一次开源。记住：过程越轻松，学习效益越高。如果你想要做出第一次贡献，只需按照以下简单步骤操作即可。这将会是一个很有趣的过程 :) + +_如果你对 command line（命令行）不熟悉，请参考以下的 [GUI 工具教程](#使用其他工具的教程)。_ + +fork this repository + +#### 如果你的电脑上未安装 git, 请参考 [GitHub 文档](https://docs.github.com/cn/get-started/quickstart/set-up-git) 进行安装。 + +## Fork（复制）本代码仓库 + +点击图示中的按钮去 Fork 这个代码仓库。 +这个操作会将代码仓库复制到你的账户名下。 + +## Clone（克隆）代码仓库 + +clone this repository + +接下来将复制的代码仓库克隆到你的电脑上。点击图示中的绿色按钮，接着点击复制到剪切板按钮（将代码仓库地址复制下来） + +随后打开命令行窗口，敲入如下 git 命令： + +``` +git clone "刚才复制的 url 链接" +``` +"刚才复制的 url 链接"（去掉双引号）就是复制到你账户名下的代码仓库地址。获取该链接的方法详见上一步。 + +copy URL to clipboard + +譬如： +```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` 这命令则可以添加你的改动，就像如下这条命令。 + +git status + +```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` 的按钮。点击该按钮。 + +create a pull request + +接着再点击 `Create pull request` 按钮，正式提交 pull request。 + +submit pull request + +不久之后，我便会把你所有的变化合并到这个项目的主分支。更改合并后，你会收到一封电子邮件通知。 + +### [ 更多资料 ](../additional-material/git_workflow_scenarios/additional-material.md) + +## 接下来该做什么呢？ + +为你的第一次贡献庆祝吧，不要忘记和你的朋友以及你的小迷弟小迷妹们分享我们的[网站](https://roshanjossey.github.io/first-contributions/#social-share)哟！ + +如果有任何疑问或想获得更多协助，欢迎加入我们的 [Slack](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 | 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) | + +

项目支持者:

+

+ + + +

diff --git a/docs/translations/README.zh-tw.md b/docs/translations/README.zh-tw.md new file mode 100644 index 00000000..5c5f5b14 --- /dev/null +++ b/docs/translations/README.zh-tw.md @@ -0,0 +1,133 @@ +[![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) +[](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) + +# 第一次參與開源 + +萬事起頭難。特別是和其他人合作時，犯錯格外令人不舒服。不過，開源的本質就是和其他人合作。我們希望為初學者帶來一個簡單的方法來學習及參與開源項目。 + +閱讀文章和觀看教學會有所幫助。不過，有什麼方法能比在不會弄亂任何東西的情況下，實際動手做來得更好？本項目旨在指導初學者及簡化初學者參與開源的方式。記住：過程越輕鬆，學習效益越高。如果妳/你想要做出第一次貢獻，只需按照以下簡單步驟操作即可。跟你保證，這會很好玩 :) + +#### *如果你不喜歡使用指令列，[這裡有使用圖形界面工具的教學。]( #使用其他工具的教學)* + +fork this repository + +如果你的電腦上尚未安裝 git，請按照這個[安裝指引（英文）](https://help.github.com/articles/set-up-git/)進行安裝。 + +## 分叉（Fork）本代碼庫 + +點選圖示中的按鈕來 Fork 這個 Git 儲存庫。 +這個操作會將儲存庫分叉到你/妳的 GitHub 帳號下。 + +## 複製（Clone）代碼庫 + +clone this repository + +接下來，將複製後的儲存庫複製到你/妳的電腦上。點選圖示中的綠色按鈕，接著點選複製到剪貼簿按鈕（將儲存庫地址複製下來） + +隨後打開命令列視窗，鍵入如下 git 命令： + +```bash +git clone "url you just copied" +``` +"url you just copied"（去掉雙引號）就是複製到妳/你帳戶名下的儲存庫地址。取得這鏈接地址的方法請見上一步。 + +copy URL to clipboard + +譬如： +```bash +git clone https://github.com//first-contributions.git +``` + +'this-is-you' 指的就是你/妳自己的 GitHub 用戶名。這一步，會將你/妳的 first-contributions 儲存庫複製到你的電腦上。 + +## 新建一個分支 + +下面的命令能在命令行窗口中，把目錄切換到 first-contributions。 + +```bash +cd first-contributions +``` +接下來使用 `git switch` 命令建立一個程式碼分支： +```bash +git switch -c +``` + +譬如： +```bash +git switch -c add-david +``` + +（新分支的名稱不一定需要有 *add*。然而，在這個新分支的名稱加入 *add* 是一件合理的事情，因為這個分支的目的是將妳/你的名字添加到貢獻者列表中。） + +## 對程式碼進行修改，然後提交 (Commit) 修改 + +使用妳/你喜歡的文字編輯器打開 `Contributors.md` 這個文件，更新文件內容，將自己的名字加上去，然後存檔。在命令窗口執行 `git status`，這會列出被更動的文件。接著 `git add` 這命令則可以添加更動項目到分支裡，就像以下這條命令。 + +git status + +```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 將你/妳的修改供他人審閱 + +前往先前自己 Fork 的 GitHub 儲存庫，會看到一個 `Compare & pull request` 的按鈕，點選該按鈕。 + +create a pull request + +接著再點選 `Create pull request` 按鈕，正式提交 pull request。 + +submit pull request + +不久之後，如果妳/你更改的文件與原本沒有衝突，我們會把所有的變化合併到這個項目的主分支。 +變更合併後，妳/你會收到通知 email。 + +## 接下來做什麼呢？ + +在[這個網站](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) + +### [ 更多資料 ](../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) | + +

項目支持者:

+

+ + + +

diff --git a/docs/translations/README.zul.md b/docs/translations/README.zul.md new file mode 100644 index 00000000..d9d1bc51 --- /dev/null +++ b/docs/translations/README.zul.md @@ -0,0 +1,130 @@ +[![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) + + +# 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)* + + +fork this 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 + +clone this 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. + +copy URL to clipboard + + +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. + +git status + +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. + +create a pull request + +Manje thumela isicelo sokudonsa. + +submit pull request + +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). + +Ungakwazi ukujoyina ithimba lethu elihle uma kwenzeka udinga noma yiluphi usizo noma unemibuzo. [Joyina ithimba le-slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). + +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) | diff --git a/docs/translations/Translations.md b/docs/translations/Translations.md new file mode 100644 index 00000000..c1677c65 --- /dev/null +++ b/docs/translations/Translations.md @@ -0,0 +1,84 @@ +# 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.ng-pidgin.md) | +| Suomeksi | [Suomeksi](README.fi.md) | +| Español de México | [Español de México](README.mx.md) | +| Српски | [Српски](README.sr.md) | +| Latvia | [Latvia](README.lv.md) | +| Shqip | [Shqip](README.al.md) | +| Беларуская мова | [Беларуская мова](README.by.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) +| Amahric |[አማርኛ(Ethiopia)](README.am.md) +| සිංහල | [සිංහල(Sri Lanka)](README.si.md) +| Tükmençe | [Türkmençe](README.tm.md) | +| հայերեն | [հայերեն](README.arm.md) | +| አማርኛ ቋንቋ | [አማርኛ ቋንቋ](translations/README.et.md) | +| Kurdî | Kurdî | diff --git a/docs/translations/gujarati/gujarati.md b/docs/translations/gujarati/gujarati.md new file mode 100644 index 00000000..02a9a763 --- /dev/null +++ b/docs/translations/gujarati/gujarati.md @@ -0,0 +1,63 @@ +Here’s a normalized version of the text without GitHub command examples: + +--- + +# પ્રથમ યોગદાન + +આ પ્રોજેક્ટનો ઉદ્દેશ નવા સ્રોતકર્તાઓને તેમની પ્રથમ યોગદાન આપવાની પદ્ધતિને સરળ બનાવવાનો અને માર્ગદર્શન આપવાનો છે. જો તમે તમારી પ્રથમ યોગદાન આપવા માગો છો, તો નીચેના પગલાંઓને અનુસરો. + +#### *જો તમે કમાન્ડ લાઈન સાથે નવા છો, તો અન્ય સાધનોના ઉપયોગ માટે ટ્યુટોરીયલ પર જાઓ.* + +જો તમારા કમ્પ્યુટરમાં Git સ્થાપિત ન હોય, તો તેને સ્થાપિત કરવા માટેની માર્ગદર્શિકા જોવા માટે લિંક્પ્રदान કરો. + +## આ રિપોઝિટરીનો "ફોર્ક" કરો + +પૃષ્ઠના જમણાંમાં "ફોર્ક" બટન પર ક્લિક કરો. તે કરવાથી, આ રિપોઝિટરીની એક નકલ તમારા GitHub એકાઉન્ટમાં બનાવાઈ છે. + +## કોપી કરેલા રિપોઝિટરીનો "ક્લોન" કરો + +હવે, તમે જે રિપોઝિટરીનો ફોર્ક કર્યો છે, તે ક્લોન બનાવો. + +તમારા ટર્મિનલને ખોલો અને આડેધોરને અનુસરો. + +## એક શાખા બનાવો + +તમારા કમ્પ્યુટરમાં રિપોઝિટરીના ડિરેક્ટરીમાં જાઓ. હવે શાખા બનાવો. + +## જરૂરી ફેરફાર કરો અને તે ફેરફારોનો "કમિટ" કરો + +ફાઇલને ટેક્સ્ટ એડિટરમાં ખોલો અને તમારું નામ ઉમેરો. ફાઇલને સાચવો. + +જો તમે પ્રોજેક્ટના ડિરેક્ટરીમાં જાઓ, તો તમે ફેરફારો જોઈ શકશો. ફાઇલને તેમાં ઉમેરો. + +હવે આ ફેરફારોને કમિટ કરો. + +## GitHub પર તમારાં ફેરફારોનો "પુષ" કરો + +તમારા ફેરફારોને મોકલવા માટેનું પગલું પૂર્ણ કરો. + +## તમારા ફેરફારોને સમીક્ષ માટે મોકલો + +જો તમે તમારા GitHub પરના રિપોઝિટરીમાં જાઓ, તો તમને બટન દેખાશે. આ બટન પર ક્લિક કરો. + +હવે *પુલ રિક્વેસ્ટ* મોકલો. + +જલદી જ હું તમારા ફેરફારોને આ પ્રોજેક્ટની માસ્ટર શાખામાં જોડવા જઇ રહ્યો છું. જ્યારે ફેરફારો જોડાશે ત્યારે તમને સૂચના મળશે. + +## આગામી પગલાં શું છે? + +અભિનંદન! તમે યોગદાન આપવાની પ્રક્રિયા પૂરી કરી છે. + +તમારા યોગદાનનો ઉત્સવ મનાવો અને તેને શેર કરો. + +જો તમને મદદની જરૂર હોય કે તમારી પાસે કોઈ પ્રશ્ન હોય, તો તમારે જોડાવા માટેનાં વિકલ્પો ઉપલબ્ધ છે. + +હવે બીજા પ્રોજેક્ટમાં યોગદાન આપવાનું શરૂ કરો. અમે સરળ *ઇશ્યુઝ* સાથેના પ્રોજેક્ટોની યાદી એકત્રિત કરી છે. + +### વધુ સામગ્રી માટે અમારું વેબપેજ જુઓ. + +## અન્ય સાધનોના ઉપયોગ કરતા ટ્યુટોરીયલ + +--- + +Feel free to let me know if you need further modifications! \ No newline at end of file