Roshanjossey
8.0 KiB
Перші внески
 |
Інтерфейс командного рядка GitHub (CLI) |
|---|
Це керівництво для нас, нердів, які хочуть робити все у терміналі, і завдяки Github-CLI, ми можемо досягти цього, пам'ятаючи, що ваш перший внесок повинен бути цікавим, корисним та мотивувати до подальшої роботи!
Це керівництво трохи складніше, оскільки ми зовсім не використовуємо графічний інтерфейс, але це все ще дуже цікаво і ви точно зможете його виконати крок за кроком!
Перша умова - мати:
- Встановлений Git (як встановити git)
- Обліковий запис на Github
Тепер нам потрібно встановити інструмент github-cli у нашу систему, виконавши кроки з офіційної документації
Після цього нам потрібно увійти до CLI, застосовуючи цю команду:
gh auth login
Дотримуйтесь інструкцій, і ми готові починати!
Відгалужуємо репозиторій
Це робиться, всього навсього, за допомогою однієї команди:
gh repo fork firstcontributions/first-contributions
**Важливо: Якщо ви хочете одразу клонувати репозиторій, виберіть варіант "yes" **
Створюємо свою гілку
Ми зробимо цей крок за допомогою git, тому введіть цю команду, замінивши taras-shevchenko на ваше ім'я:
git switch -c add-taras-shevchenko
Вносимо необхідні зміни та записуємо їх
Тепер ви можете відкрити файл Contributors.md в текстовому редакторі і додати до нього своє ім'я. Впишіть своє ім'я десь між початком і кінцем, а потім збережіть файл.
У директорії проекту виконайте команду git status, і ви побачите виконані зміни.
Додайте ці зміни до гілки, яку ви щойно створили, використовуючи команду git add:
git add Contributors.md
Тепер запишіть ці зміни за допомогою команди git commit:
git commit -m "Add taras-shevchenko to Contributors list
замінюючи taras-shevchenko на ваше ім'я.
Відправляємо зміни в GitHub
Відправте свої зміни за допомогою команди git push:
git push origin -u your-branch-name
замініть your-branch-name ім'ям гілки, яку ви створили раніше.
Якщо ви отримаєте помилки під час відправки, натисніть тут:
-
Помилка автентифікації
remote: Підтримка автентифікації за допомогою пароля була припинена 13 серпня 2021 року. Замість цього використовуйте особистий токен доступу. remote: Будь ласка, перегляньте https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ для отримання більш докладної інформації. fatal: Автентифікація завершилася помилкою для 'https://github.com//first-contributions.git/'
Перейдіть до посібника GitHub щодо створення та налаштування SSH-ключа для вашого облікового запису.
Створюємо запит на рецензування своїх змін
Тепер, запускаючи цю команду у директорії нашого репозиторію, ми зможемо створити запит на витяг (pull request) для рецензування.
gh pr create --repo firstcontributions/first-contributions
Після цього подайте запит на витяг.
Ви можете використати команду gh status, щоб побачити ваш вищезгаданий запит на витяг у дії.
Що далі?
Вітаємо! Ви щойно завершили стандартний робочий процес fork -> clone -> edit -> pull request, який часто зустрічається серед співавторів open source проектів!
Відзначте свій внесок та поділіться ним з друзями та підписниками, перейшовши до веб-додатку.
Ви можете приєднатися до нашої команди у Slack, якщо вам потрібна допомога чи у вас є які-небудь питання.
Тепер ви можете розпочати робити ваш внесок до інших проектів. Ми склали список проектів з легкими проблемами, з яких ви можете почати. Посилання до списку проектів.