[](https://github.com/firstcontributions/open-source-badges) [<img align="right" width="150" src="https://firstcontributions.github.io/assets/Readme/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/zt-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w) [](https://opensource.org/licenses/MIT) [](https://www.codetriage.com/roshanjossey/first-contributions) # Առաջին ներդրումները Այս նախագիծը նպատակ ունի պարզեցնել և ուղղորդել, թե ինչպես են սկսնակները կատարում իրենց առաջին ներդրումը: Եթե ցանկանում եք կատարել ձեր առաջին ներդրումը, հետևեք ստորև նշված քայլերին. _Եթե ձեզ դուր չի գալիս հրամանի տողը, [այստեղ կան ձեռնարկներ՝ օգտագործելով GUI գործիքները](#tutorials-using-other-tools)_ <img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="պատառաքաղել այս պահոցը" /> #### Եթե դուք չունեք git ձեր մեքենայի վրա, [տեղադրեք այն](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Պատառաքաղեք այս պահոցը Պատառաքաղեք այս պահոցը՝ սեղմելով այս էջի վերևի պատառաքաղի կոճակը: Այս կստեղծի այս պահոցի պատճենը ձեր հաշվում. ## Կլոնավորեք պահեստը <img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="Կլոնավորեք պահեստը" /> Այժմ կլոնավորեք պատառաքաղված պահոցը ձեր մեքենայի մեջ: Գնացեք ձեր GitHub հաշիվ, բացեք պատառաքաղված պահոցը, սեղմեք կոճակի կոճակը և սեղմեք _copy to clipboard_ պատկերակը. Բացեք տերմինալ և գործարկեք հետևյալ git հրամանը: ```bash git clone "url-ը որ դուք հենց նոր պատճենեցիք" ``` որտեղ «url-ը, որը հենց նոր պատճենեցիր» (առանց չակերտների) այս պահոցի url-ն է (այս նախագծի ձեր պատառաքաղը): Դիտեք նախորդ քայլերը՝ URL-ը ստանալու համար <img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="պատճենել 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` ֆայլը տեքստային խմբագրիչում, ավելացրեք ձեր անունը դրան: Մի ավելացրեք այն ֆայլի սկզբում կամ վերջում: Տեղադրեք այն ցանկացած տեղ արանքում: Այժմ պահեք ֆայլը. <img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="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`-ը փոխարինելով ավելի վաղ ստեղծված մասնաճյուղի անունով. <details> <summary> <strong>Եթե հրելիս սխալներ եք ստանում, սեղմեք այստեղ.</strong> </summary> - ### Վավերացման սխալ <pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information. fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre> Գնացեք [GitHub-ի ձեռնարկ](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) ձեր հաշվի համար SSH բանալի ստեղծելու և կազմաձևելու վերաբերյալ. </details> ## Ներկայացրեք ձեր փոփոխությունները վերանայման Եթե գնաք ձեր պահոց GitHub-ում, կտեսնեք `Compare & pull request` կոճակը: Սեղմեք այդ կոճակի վրա. <img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" /> Այժմ ներկայացրեք pull request-ը. <img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" /> Շուտով ես կմիավորեմ ձեր բոլոր փոփոխությունները այս նախագծի հիմնական ճյուղի մեջ: Փոփոխությունները միաձուլվելուց հետո դուք կստանաք ծանուցման նամակ. ## Որտեղ գնալ այստեղից? Շնորհավորում եմ Դուք հենց նոր ավարտեցիք ստանդարտ _fork -> clone -> edit -> pull request_ աշխատանքային հոսքը, որը հաճախ կհանդիպեք որպես ներդրող! Նշեք ձեր ներդրումը և կիսվեք այն ձեր ընկերների և հետևորդների հետ՝ գնալով [վեբ հավելված](https://firstcontributions.github.io/#social-share). Դուք կարող եք միանալ մեր Slack թիմին, եթե օգնության կարիք ունեք կամ հարցեր ունեք. [Միացե՛ք Slack թիմին](https://join.slack.com/t/firstcontributors/shared_invite/zt-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w). Հիմա եկեք սկսենք ձեր ներդրումն ունենալ այլ նախագծերում: Մենք կազմել ենք հեշտ խնդիրներ ունեցող նախագծերի ցանկ, որոնցից կարող եք սկսել: Ստուգեք [վեբ հավելվածի նախագծերի ցանկը](https://firstcontributions.github.io/#project-list). ### [Լրացուցիչ նյութ](additional-material/git_workflow_scenarios/additional-material.md) ## Ձեռնարկներ՝ օգտագործելով այլ գործիքներ | <a href="gui-tool-tutorials/github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="gui-tool-tutorials/github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a> | <a href="gui-tool-tutorials/gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="100"></a> | <a href="gui-tool-tutorials/github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/2/2d/Visual_Studio_Code_1.18_icon.svg" width=100></a> | <a href="gui-tool-tutorials/sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a> | <a href="gui-tool-tutorials/github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/9c/IntelliJ_IDEA_Icon.svg/512px-IntelliJ_IDEA_Icon.svg.png" width=100></a> | | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [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) | <p>Այս նախագծին աջակցում են:</p> <p> <a href="https://www.digitalocean.com/"> <img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px"> </a> </p>