Складана. Заўсёды складана пачынаць нешта з самага пачатку. Даволі непрыемна рабіць памылкі, асабліва калі вы працуеце ў камандзе. Увесь open source складаецца з супрацоўніцтва і сумеснай працы. Мы хочам аблегчыць першыя крокі ў навучанні і супрацоўніцтве пачаткоўцам распрацоўнікам.
Чытанне артыкулаў і падручнікаў можа дапамагчы, але што можа быць лепш, чым сапраўдны практычны вопыт, без рызыкі што-небудзь сапсаваць. Мэта гэтага праекта - належным чынам накіраваць маладых навабранцаў, а таксама даць ім магчымасць зрабіць іх першы ўклад. Памятаеце: чым менш вы напружаныя, тым лепш вы вучыцеся. Калі вы шукаеце магчымасць ажыццявіць свой першы ўклад, проста прытрымлівайцеся простым крокам, размешчаным ніжэй. Абяцаем, будзе цікава.
Калі ў вас не ўсталяваны git на кампутары, ўсталюйце яго
Стварыце асобную галінку, націснуўшы на кнопку fork
зверху гэтай старонкі. Такім чынам вы створыце копію гэтага рэпазітара ў сваім запісе.
Цяпер каб скапіяваць ваш рэпазітар на персанальны кампутар. Націсніце на кнопку clone
, а затым на абразок copy to clipboard
, каб скапіяваць спасылку.
Адкрыйце тэрмінал і запусціце наступную git каманду:
git clone "url you just copied"
Дзе "url you just copied" (без двукоссяў) гэта спасылка на ваш рэпазітар. Паглядзіце папярэднія крокі, каб атрымаць гэтую спасылку.
Напрыклад:
git clone https://github.com/this-is-you/first-contributions.git
Дзе this-is-you
ваш лагін на github. Такім чынам вы капіруеце рэпазітар 'first-contributions' з GitHub на ваш персанальны кампутар.
Перайдзіце ў каталог рэпазітара на вашым кампутары, калі вы яшчэ не там.
cd first-contributions
Цяпер стварыце галінку, з дапамогай каманды git checkout
git checkout -b <add-your-name>
Напрыклад:
git checkout -b add-alonzo-church
(Сінтаксічную не патрабуецца, каб назва галіны ўтрымлівала слова * add *, але гэта апраўдана, паколькі падкрэслівае прызначэнне гэтай галіны - дадаць ваша імя ў спісы.)
Цяпер адкрыйце файл Contributors.md
ў вашым тэкставым рэдактары, запішыце ваша імя і захавайце файл. Калі вы пяройдзеце ў дырэкторыю праекта і выканайце git status
, вы ўбачыце змены. Дадайце гэтыя змены з дапамогай каманды git add
.
git add Contributors.md
Цяпер занясіце дадзеныя змены з дапамогай каманды git commit
.
git commit -m "Add <your-name> to Contributors list"
Зменіце <your-name>
на ваша імя
Занясіце вашыя змены з дапамогай каманды git push
git push origin <add-your-name>
Зменіце <add-your-name>
на імя галіны, якую вы стварылі раней.
Калі вы зойдзеце ў свой рэпазітар на GitHub, вы ўбачыце кнопку Compare & pull request
. Націсніце на яе.
Цяпер пацвердзіце pull-request.
Хутка я ўчыню аб'яднанне ўсіх вашых змяненняў з асноўнай галіной гэтага праекта. Вы атрымаеце паведамленне па электроннай пошце, калі змены будуць прынятыя (ўнесены ў галоўную галіну).
Асноўная галіна вашага рэпазітара не будзе зменена. Для сінхранізацыі выканайце крокі, размешчаныя ніжэй.
Перш за ўсё перайдзіце ў асноўную галіну:
git checkout master
Затым дадайце url майго рэпазітара ў полі upstream remote url
:
git remote add upstream https://github.com/Roshanjossey/first-contributions
Такім чынам мы паведамім git, што існуе іншая версія дадзенага праекта па пэўнай спасылцы, і мы яе лічым майстрам. Як толькі змены смержены, падгрузіць новую версію майго рэпазітара.
git fetch upstream
Такім чынам мы забралі ўсе змены ў маім адгалінаванні (upstream remote). Пасля, вам трэба зліць новую версію майго рэпазітара з вашай майстар-галіной.
git rebase upstream/master
Так вы ўжываеце ўсе змены, якія вы падцягнулі да вашай майстар-галіны. Калі вы запушите зараз майстар-галіна, ваша адгалінаванне таксама будзе ўтрымліваць змены.
git push origin master
Звярніце ўвагу, што вы робіце push ў выдаленай рэпазітар origin.
На гэтым этапе я аб'яднаў вашу галіну <add-your-name>
са сваёй майстар-галіной, а вы аб'ядналі сваю майстар-галіна з маёй. Ваша галіна больш не патрэбна, вы можаце выдаліць яе:
git branch -d <add-your-name>
Таксама можаце выдаліць яе версію ў аддаленым рэпазітары:
git push origin --delete <add-your-name>
Гэта зусім не абавязкова, але назва гэтай галіны адлюстроўвае яе даволі спецыфічнае прызначэнне. І працягласць яе жыцця можа быць адпаведна кароткай.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |
Ніжэй некалькі папулярных рэпазітароў, дзе вы можаце знайсці заданні для пачаткоўцаў. Наперад, перайдзіце ў рэпазітары, каб даведацца больш.