Трудно е. Когато правиш нещо за пръв път винаги е трудно. Още повече, когато се работи съвместно с други хора. Затова решихме да опростим процеса на учене за новобранците в допринасянето към отворен софтуер.
Четенето на статии и гледането на видео уроци помага, но има ли по-добър учител от практиката в защитена среда? Целта на този проект е да напътства и опрости първите стъпки на новобранците в участието и приноса към отворен софтуер. Ако искате да направите първата си контрибуция и да станете част от обществото на отворен софтуер, следвайте стъпките по-долу.
Ако не се чувствате комфортно използвайки command line (терминал), ето и уроци за използването на програми с графичен интерфейс
Ако нямате git на вашия компютър, инсталирайте го.
Направете разклонение на хранилището като натиснете бутона "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' във вашия компютър.
Стигнете до местоположението във вашия компютър, където копирахте хранилището (ако вече не се намирате там):
cd first-contributions
Сега създайте клон използвайки командата git switch -c:
git switch -c <add-your-new-branch-name>
Например:
git switch -c add-alonzo-church
(Името на клона не е задължително да съдържа думата add, но е препоръчително, защото целта на този клон е да добавите името си към списък.)
Сега отворете файла Contributors.md в текстов редактор и добавете името си в него. Не го добавяйте в началото или края на файла. Поставете го някъде посредата. Сега запазете промените.
Ако навигирате през терминала до директорията на проекта и въведете командата git status, ще видите че има променени файлове.
ДОбавете тези промени към клона, който създадохте, използвайки командата git add:
git add Contributors.md
Сега commit-нете тези промени с командата git commit:
git commit -m "Add <your-name> to Contributors list"
като смените <your-name> с вашето име.
Качете вашите промени като въведете командата 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 | Atlassian Sourcetree | IntelliJ IDEA |