GitHub, що це таке і як ним користуватися

GitHub — це програмне забезпечення, яке широко використовується групами розробників програмного забезпечення для контролю версій розробки.

Це корисно, коли над проектом працює більше ніж одна людина.

Наприклад, припустімо, що команда розробників програмного забезпечення хоче створити веб-сайт, і їм усім потрібно одночасно оновити код під час роботи над проектом. У цьому випадку Github допомагає створити централізоване сховище, де кожен може завантажувати, редагувати та керувати файлами програмного коду.

Перш ніж почати використовувати GitHub, вам потрібно створити обліковий запис GitHub.

Сховище

Репозиторій зазвичай використовується для організації проекту прикладного програмного забезпечення. Репозиторії можуть містити папки та файли, зображення, відео, електронні таблиці та набори даних – усе, що потрібно вашому проекту. Часто репозиторії включають файл README, файл з інформацією про ваш проект.

Файли README записуються мовою Markdown у вигляді звичайного тексту. Можете проконсультуватися цієї сторінки веб як короткий довідник мови Markdown. GitHub дозволяє додавати файл README під час створення нового сховища. GitHub також пропонує інші поширені параметри, як-от файл ліцензії, але вам не потрібно вибирати спочатку.

Щоб створити нове сховище, у верхньому правому куті виберіть у меню New repository. Виконайте наступні дії:

1. У верхньому правому куті будь-якої сторінки скористайтеся спадним меню та виберіть New repository.

1. У полі Ім’я сховища введіть first-repository.
2. У полі Опис напишіть короткий опис.
3. Виберіть Додати файл README.
4. Виберіть, чи буде ваше сховище загальнодоступним чи приватним.
5. Натисніть на Create repository.

Створення гілки

Створення гілки дозволяє мати кілька версій сховища одночасно.

За замовчуваннямdefinita, сховище first-repository має іменовану гілку main яка вважається філією defiнітивний. Ви можете створити додаткові гілки до основних у сховищі first-repository. Ви можете використовувати гілки, щоб мати різні версії проекту одночасно. Це корисно, коли ви хочете додати нову функціональність до проекту без зміни основного вихідного коду. Робота, виконана на різних гілках, не відображатиметься на головній гілці, доки ви її не об’єднаєте. Ви можете використовувати гілки, щоб експериментувати та вносити зміни перед тим, як передавати їх у main.

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

На наступній діаграмі ми бачимо:

Основна гілка
Нова філія дзвонить feature
Шлях, який feature виконує перед об’єднанням з main

Створення гілки для нової реалізації або виправлення помилок схоже на збереження файлу. За допомогою GitHub розробники програмного забезпечення використовують гілки, щоб виправляти помилки та працювати над функціями окремо від основної виробничої гілки. Коли зміна готова, вона об’єднується в основну гілку.

Давайте створимо гілку

Після створення нашого сховища переходимо на вкладку <>Code(1) сховища:

Натисніть головне (2) спадне меню, а потім дайте назву новому branch (3)

Натисніть на Create branch: first branch from 'main'

Тепер у нас два branch, main e first-branch. Зараз вони виглядають абсолютно однаково. Пізніше ми додамо зміни до нового branch.

Внесіть і підтвердіть зміни

Щойно створив новий branch, GitHub привів вас до code page для нового first-branch, який є копією main.

Ми можемо вносити та зберігати зміни до файлів у сховищі. На GitHub викликаються збережені зміни commit. Кожен commit має повідомлення від commit пов’язаний, який є описом, який пояснює, чому була внесена певна зміна. Повідомлення від commit вони фіксують історію змін, щоб інші учасники могли зрозуміти, що було зроблено і чому.

Під гілкою first-branch створено, натисніть на файл README.md, а потім на олівець, щоб відредагувати файл.

У редакторі пишіть за допомогою Markdown.

У коробці Commit changes (Попередній перегляд), пишемо повідомлення про commit описуючи зміни.

Нарешті натисніть на кнопку Commit changes.

Ці зміни буде внесено лише до файлу README first-branch, тому тепер ця гілка містить інший вміст, ніж основна.

Відкриття одного pull request

Тепер, коли у нас є зміни у гілці від main, ми можемо її відкрити pull request.

Le pull request вони є серцем співпраці на GitHub. Коли ви відкриваєте a pull request, ви пропонуєте свої зміни та просите когось зробити a review e pull вашого внеску та об’єднати їх у своїй гілці. The pull request показати відмінності змісту обох гілок. Зміни, додавання та віднімання зображено різними кольорами.

Як тільки ви зробите фіксацію, ви можете відкрити запит на отримання та розпочати обговорення, навіть до того, як код буде завершено.

Використання функції @mention GitHub у вашому повідомленні від pull request, ви можете запитати відгук у конкретних людей або команд, незалежно від їх місцезнаходження.

Можна навіть відкрити pull request у вашому сховищі та об’єднайте їх самостійно. Це чудовий спосіб вивчити потік GitHub перед тим, як працювати над великими проектами.

Щоб зробити один pull request ти мусиш:

• Натисніть вкладку pull request вашого сховища first-repository.

• Натисніть на New pull request
• В коробці Example Comparisons, виберіть створену вами гілку, first-branch, для порівняння з основним (оригіналом).
• Перегляньте свої зміни у відмінностях на сторінці порівняння, переконайтеся, що це ті, які ви хочете надіслати.

• Натисніть на Create pull request.

• Дайте назву своєму pull request напишіть короткий опис ваших змін. Ви можете додати емодзі та перетягнути зображення та gif.

• За бажанням праворуч від назви й опису клацніть поруч із рецензентами. Одержувачі, мітки, проекти або етапи, щоб додати будь-який із цих параметрів до ваших pull request. Вам ще не потрібно їх додавати, але ці параметри пропонують кілька способів співпраці за допомогою вашого pull request.
• Натисніть на Create pull request.

Тепер ваші співавтори можуть переглядати ваші зміни та вносити пропозиції.

Об’єднайте свої pull request

На цьому останньому кроці ви об’єднаєте свою гілку first-branch в основній гілці. Після об'єднання pull request, зміни до філії first-branch буде вбудовано в основний файл.

Іноді запит на отримання може внести зміни в код, які конфліктують із існуючим кодом на main. Якщо виникнуть будь-які конфлікти, GitHub попередить вас про конфліктний код і запобіжить злиття, доки конфлікти не будуть вирішені. Ви можете зробити фіксацію, яка вирішить конфлікти, або використати коментарі в запиті на отримання, щоб обговорити конфлікти з членами вашої команди.

• Натисніть на Merge pull request щоб об’єднати зміни в основний.

• Натисніть на Confirm merge. Ви отримаєте повідомлення про те, що запит успішно об’єднано та запит закрито.
• Натисніть на Delete branch. Тепер, коли ваш richiesta pull об’єднано, а ваші зміни є основними, ви можете безпечно видалити гілку first-branch. Якщо ви хочете внести подальші зміни у свій проект, ви завжди можете створити нову гілку та повторити цей процес.

Ercole Palmeri