Skip to content

Latest commit

 

History

History
151 lines (108 loc) · 22.3 KB

README.by.md

File metadata and controls

151 lines (108 loc) · 22.3 KB

Open Source Love License: MIT Open Source Helpers

Першы ўклад у праект

Складана. Заўсёды складана пачынаць нешта з самага пачатку. Даволі непрыемна рабіць памылкі, асабліва калі вы працуеце ў камандзе. Увесь open source складаецца з супрацоўніцтва і сумеснай працы. Мы хочам аблегчыць першыя крокі ў навучанні і супрацоўніцтве пачаткоўцам распрацоўнікам.

Чытанне артыкулаў і падручнікаў можа дапамагчы, але што можа быць лепш, чым сапраўдны практычны вопыт, без рызыкі што-небудзь сапсаваць. Мэта гэтага праекта - належным чынам накіраваць маладых навабранцаў, а таксама даць ім магчымасць зрабіць іх першы ўклад. Памятаеце: чым менш вы напружаныя, тым лепш вы вучыцеся. Калі вы шукаеце магчымасць ажыццявіць свой першы ўклад, проста прытрымлівайцеся простым крокам, размешчаным ніжэй. Абяцаем, будзе цікава.

fork this repository

Калі ў вас не ўсталяваны git на кампутары, ўсталюйце яго

Стварыце асобную галінку

Стварыце асобную галінку, націснуўшы на кнопку fork зверху гэтай старонкі. Такім чынам вы створыце копію гэтага рэпазітара ў сваім запісе.

Капіюйце рэпазітар

clone this repository

Цяпер каб скапіяваць ваш рэпазітар на персанальны кампутар. Націсніце на кнопку clone, а затым на абразок copy to clipboard, каб скапіяваць спасылку.

Адкрыйце тэрмінал і запусціце наступную git каманду:

git clone "url you just copied"

Дзе "url you just copied" (без двукоссяў) гэта спасылка на ваш рэпазітар. Паглядзіце папярэднія крокі, каб атрымаць гэтую спасылку.

copy URL to clipboard

Напрыклад:

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 *, але гэта апраўдана, паколькі падкрэслівае прызначэнне гэтай галіны - дадаць ваша імя ў спісы.)

Занясіце неабходныя змены і стварыце commit

Цяпер адкрыйце файл Contributors.md ў вашым тэкставым рэдактары, запішыце ваша імя і захавайце файл. Калі вы пяройдзеце ў дырэкторыю праекта і выканайце git status, вы ўбачыце змены. Дадайце гэтыя змены з дапамогай каманды git add.

git add Contributors.md

Цяпер занясіце дадзеныя змены з дапамогай каманды git commit.

git commit -m "Add <your-name> to Contributors list"

Зменіце <your-name> на ваша імя

Занясіце дадзеныя змены на github

Занясіце вашыя змены з дапамогай каманды git push

git push origin <add-your-name>

Зменіце <add-your-name> на імя галіны, якую вы стварылі раней.

Пацвердзіце змены для праверкі вашага кода

Калі вы зойдзеце ў свой рэпазітар на GitHub, вы ўбачыце кнопку Compare & pull request. Націсніце на яе.

create a pull request

Цяпер пацвердзіце pull-request.

submit 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 VS Code Sourcetree App IntelliJ IDEA
GitHub Desktop Visual Studio 2017 GitKraken Visual Studio Code Atlassian Sourcetree IntelliJ IDEA

Што далей?

Ніжэй некалькі папулярных рэпазітароў, дзе вы можаце знайсці заданні для пачаткоўцаў. Наперад, перайдзіце ў рэпазітары, каб даведацца больш.

exercism fun-retro habitat scikit-learn elasticsearch
exercism Fun Retros react habitat scikit-learn Leiningen numpy elasticsearch
homebrew rust vuejs Suave OpenRA PowerShell coala moment
homebrew Rust vuejs Suave OpenRA PowerShell coala moment
ava freeCodeCamp webpack hoodie pouchdb neovim babel
ava freeCodeCamp webpack hoodie pouchdb neovim babel brackets
Node.js
Node.js Semantic-UI-React