[![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) |