Skip to content

Latest commit

 

History

History
124 lines (78 loc) · 10.2 KB

README.bg.md

File metadata and controls

124 lines (78 loc) · 10.2 KB

Open Source Love License: MIT Open Source Helpers

Първи стъпки

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

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

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

fork this repository

Ако нямате 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 <add-your-new-branch-name>

Например:

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 <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. Натиснете го.

create a pull request

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

submit pull request

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

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

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

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

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

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

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

GitHub Desktop Visual Studio 2017 GitKraken VS Code Sourcetree App IntelliJ IDEA
GitHub Desktop Visual Studio 2017 GitKraken Visual Studio Code Atlassian Sourcetree IntelliJ IDEA