Цей проект спрямований на те, щоб спростити та спрямувати шлях новачків, які роблять свій перший внесок. Якщо ви хочете зробити свій перший внесок, виконайте наведені нижче дії.
Якщо ви не вмієте працювати з командним рядком, ось навчальні посібники з використанням інструментів 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 за допомогою команди git push
:
git push -г origin <your-branch-name>
Замініть <your-branch-name>
назвою гілки, яку ви створили раніше.
Якщо під час натискання виникають помилки, натисніть тут:
-
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 |
Цей проект підтримується: