README.bg.md

Първи стъпки

Трудно е. Когато правиш нещо за пръв път винаги е трудно. Още повече, когато се работи съвместно с други хора. Затова решихме да опростим процеса на учене за новобранците в допринасянето към отворен софтуеър.

Четенето на статии и гледането на видео уроци помага, но има ли по-добър учител от практиката в защитена среда? Целта на този проект е да напътства и опрости първите стъпки на новобранците в участието и приноса към отворен софтуеър. Ако искате да направите първата си контрибуция и да станете част от обществото на отворен софтуеър, следвайте стъпките по-долу.

Ако не се чувствате комфортно използвайки command line (терминал), ето и уроци за използването на програми с графичен интерфейс

Можете да прочетете тази статия и на други езици.

🇮🇳 🇲🇲 🇮🇩 🇫🇷 🇪🇸 🇳🇱 🇱🇹 🇷🇺 🇸🇰 🇯🇵 🇻🇳 🇵🇱 🇮🇷 🇮🇷 🇰🇷 🇰🇵 🇩🇪 🇩🇰 🇨🇳 🇹🇼 🇬🇷 🇪🇬 🇸🇦 🇺🇦 🇧🇷 🇵🇹 🇮🇹 🇹🇭 🏴 🇵🇰 🇧🇩 🇲🇩 🇷🇴 🇹🇷 🇸🇪 🇸🇮 🇮🇱 🇨🇿 🇲🇽

Ако нямате git на вашия компютър, инсталирайте го.

Направете Разклонение (Fork) на това хранилище (repository)

Направете разклонение на хранилището като натиснете бутона "Fork" в горната част на тази страница. Това ще направи копие на това хранилище във вашия GitHub профил.

Клонирайте това хранилище

Сега клонирайте локално на вашия компютър разклоненото хранилище. Отидете във вашия GitHub профил, отворете разклоненото хранилище, кликнете на бутона 'Clone' и копирайте линка или натиснете иконката 'copy to clipboard' (копирай в клипборда).

Отворете терминал и въведете следната команда

git clone "линка който току-що копирахте"

като на мястото на "URL-а който току-що копирахте" (без кавичките) поставете линка към това хранилище (Вашето Разклонение на този проект). Вижте предните стъпки за това как да се сдобиете с линка.

Например:

git clone https://github.com/this-is-you/first-contributions.git

Като на мястото на this-is-you се намира вашето потребителско име. В тази стъпка вие направихте копие на съдържанието на GitHub хванилището на 'first contributions' във вашия компютър.

Създайте клон (branch)

Стигнете до местоположението във вашия компютър, където копирахте хранилището (ако вече не се намирате там):

cd first-contributions

Сега създайте клон използвайки командата git checkout:

git checkout -b <add-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 <your-name> to Contributors list"

като смените <your-name> с вашето име.

Качете (Push) промените в GitHub

Качете вашите промени като въведете командата git push:

git push origin <add-your-branch-name>

сменяйки <add-your-branch-name> с името на клона, който създадохте по-рано.

Предайте вашите промени за рецензия

Ако отидете във вашето хранилище в GitHub, ще видите бутона Compare & pull request. Натиснете го.

Сега предайте вашите промени за рецензия.

Скоро аз ще слея (merge) всички ваши промени в главния клон (мастер branch) на този проект. Вие ще бъдете уведомени по електронната поща когато това се случи.

От тук накъде?

Поздравления! Вие току що изпълнихте стандарните fork -> clone -> edit -> PR операции, които ще срещнете като сътрудник!

Отпразнувайте вашия принос и го споделете с приятели и последователи като посетите уеб приложението.

Можете да се присъедините към нашия slack team в случай, че имате допълнителни въпроси или нужда от помощ Присъединете се към slack team.

Време да започнете да допринасяте и към други приекти. Ние сме съставили списък с проекти съдържащи лесни проблеми, които са лесни за начало. Проверете списъка от приекти в уеб приложението.

Допълнителни материали

Уроци за иползването на други приложения

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code

Реклама

Ако този проект ви хареса, хасайте го в GitHub. Ако сме ви харесали изключително много, последвайте Roshan в Twitter и GitHub.