README.ua.md

Перший внесок

Цей проект спрямований на те, щоб спростити та спрямувати шлях новачків, які роблять свій перший внесок. Якщо ви хочете зробити свій перший внесок, виконайте наведені нижче дії.

Якщо ви не вмієте працювати з командним рядком, ось навчальні посібники з використанням інструментів GUI.

Якщо ви ще не встановили git, тоді зробіть це.

Форкніть репозиторій

Форкніть свою власну копію цього репозиторію, натиснувши кнопку fork вгорі цієї сторінки. Таким чином, ви створите копію цього репозиторію у вашому акаунті.

Клонуйте репозиторій

Тепер клонуйте цей репозиторій на ваш комп’ютер. Натисніть на кнопку clone, а потім - на іконку copy to clipboard.

Відкрийте термінал і виконайте наступні команди:

git clone "посилання, яке ви щойно скопіювали"

де посилання, яке ви щойно скопіювали (без лапок) - адреса цього репозиторію. Дивіться попередній крок для того, щоб отримати цю адресу.

Наприклад:

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

де this-is-you - ваш нікнейм з GitHub. Таким чином, ви копіюєте вміст репозиторію з GitHub, в який збираєтесь зробити внесок, на ваш комп’ютер.

Створюємо гілку

Перейдіть в директорію з репозиторієм на вашому комп’ютері (якщо ви ще цього не зробили):

cd first-contributions

Тепер створюємо гілку за допомогою команди git checkout:

git checkout -b <add-your-name>

Наприклад:

git checkout -b add-petro-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> своїм іменем.

Відправляємо зміни в GitHub

Відправте зміни на віддалений репозиторій в GitHub за допомогою команди git push:

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

Замініть <your-branch-name> назвою гілки, яку ви створили раніше.

Якщо під час натискання виникають помилки, натисніть тут:

• Authentication Error

  remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
  remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
  fatal: Authentication failed for 'https://github.com//first-contributions.git/'

  Перейдіть до туторіалу GitHub щодо створення та налаштування ключа SSH для вашого облікового запису.

Відправляємо зміни на перевірку

Коли ви перейдете до свого репозиторію в GitHub, ви побачите кнопку Compare & pull request. Сміливо натисніть на неї.

Тепер зміни відправлені на перевірку і затвердження.

Згодом я об’єднаю ваші запропоновані зміни з основною гілкою цього репозиторію. Ви отримаєте повідомлення, коли це буде зроблено.

Що далі?

Вітаю! Ви щойно виконали стандартний робочий процес fork -> clone -> edit -> pull request, з яким ви часто стикаєтеся як контрибутор!

Відзначте свій внесок і поділіться ним із друзями та читачами, перейшовши до веб-програми.

Ви можете приєднатися до нашої команди Slack, якщо вам потрібна допомога або якщо виникнуть запитання. Приєднайтеся до команди Slack.

Тепер давайте почнемо робити внески в інші проекти. Ми склали список проектів із простими проблемами, з яких ви можете почати. Перегляньте список проектів у веб-додатку.

Додаткові матеріали

Інструкції для інших інструментів

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

Цей проект підтримується: