msb-public
/
Web-Dev-For-Beginners
mirror of https://github.com/microsoft/Web-Dev-For-Beginners.git
1
0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '100571966f'
${ noResults }
Web-Dev-For-Beginners/translations/uk/1-getting-started-lessons/2-github-basics
History
softchris 2b844a03b0
🌐 Update translations via Co-op Translator 		1 month ago
..
README.md 🌐 Update translations via Co-op Translator 1 month ago

README.md
Escape

Вступ до GitHub

Привіт, майбутній розробнику! 👋 Готовий приєднатися до мільйонів кодерів по всьому світу? Я щиро радий представити тобі GitHub – уяви це як соціальну мережу для програмістів, але замість фотографій обіду ми ділимося кодом і створюємо неймовірні речі разом!

Ось що мене вражає: кожен додаток на твоєму телефоні, кожен вебсайт, який ти відвідуєш, і більшість інструментів, які ти навчишся використовувати, були створені командами розробників, які співпрацювали на платформах, таких як GitHub. Той музичний додаток, який ти любиш? Хтось, як ти, зробив свій внесок у його створення. Та гра, від якої ти не можеш відірватися? Так, ймовірно, створена за допомогою співпраці на GitHub. А тепер ТИ навчишся бути частиною цієї дивовижної спільноти!

Я знаю, що спочатку це може здатися складним – чесно кажучи, я пам'ятаю, як дивився на свою першу сторінку GitHub і думав: "Що це все означає?" Але ось у чому справа: кожен розробник починав саме там, де ти зараз. До кінця цього уроку ти матимеш власний репозиторій на GitHub (уяви це як свою персональну вітрину проектів у хмарі), і ти знатимеш, як зберігати свою роботу, ділитися нею з іншими та навіть робити внесок у проекти, якими користуються мільйони людей.

Ми пройдемо цей шлях разом, крок за кроком. Без поспіху, без тиску – лише ти, я і кілька крутих інструментів, які стануть твоїми новими найкращими друзями!

Вступ до GitHub

Скетчнот від Tomomi Imura

Тест перед лекцією

Тест перед лекцією

Вступ

Перш ніж ми перейдемо до справді захоплюючих речей, давай підготуємо твій комп'ютер до магії GitHub! Уяви це як організацію своїх художніх матеріалів перед створенням шедевра – наявність правильних інструментів робить усе набагато простішим і значно веселішим.

Я особисто проведу тебе через кожен етап налаштування, і обіцяю, це не так страшно, як може здатися на перший погляд. Якщо щось не зрозуміло одразу, це абсолютно нормально! Я пам'ятаю, як налаштовував своє перше середовище розробки і відчував, ніби намагаюся розшифрувати стародавні ієрогліфи. Кожен розробник був саме там, де ти зараз, і думав, чи все він робить правильно. Спойлер: якщо ти тут і навчаєшся, ти вже робиш усе правильно! 🌟

У цьому уроці ми розглянемо:

  • як відстежувати роботу на твоєму комп'ютері
  • як працювати над проектами разом з іншими
  • як робити внесок у програмне забезпечення з відкритим кодом

Попередні вимоги

Давай підготуємо твій комп'ютер до магії GitHub! Не хвилюйся – це налаштування потрібно зробити лише один раз, і тоді ти будеш готовий до всієї своєї подорожі у світі кодування.

Отже, почнемо з основ! Спочатку нам потрібно перевірити, чи Git вже встановлений на твоєму комп'ютері. Git – це як суперрозумний асистент, який запам'ятовує кожну зміну, яку ти робиш у коді – набагато краще, ніж постійно натискати Ctrl+S кожні дві секунди (ми всі це робили!).

Давай перевіримо, чи Git вже встановлений, ввівши цю магічну команду в терміналі: git --version

Якщо Git ще не встановлений, не хвилюйся! Просто зайди на завантаження Git і завантаж його. Після встановлення нам потрібно правильно представити тебе Git:

💡 Початкове налаштування: Ці команди повідомляють Git, хто ти. Ця інформація буде прикріплена до кожного коміту, який ти зробиш, тому вибери ім'я та електронну адресу, які ти готовий публічно показати.

git config --global user.name "your-name"
git config --global user.email "your-email"

Щоб перевірити, чи Git вже налаштований, ти можеш ввести:

git config --list

Тобі також знадобиться обліковий запис GitHub, редактор коду (наприклад, Visual Studio Code), і потрібно буде відкрити термінал (або командний рядок).

Перейди на github.com і створити обліковий запис, якщо ти ще цього не зробив, або увійди і заповни свій профіль.

💡 Сучасна порада: Розглянь можливість налаштування SSH ключів або використання GitHub CLI для зручнішої аутентифікації без паролів.

✅ GitHub – не єдиний репозиторій коду у світі; є й інші, але GitHub – найвідоміший.

Підготовка

Тобі знадобиться папка з проектом коду на локальному комп'ютері (ноутбуці або ПК) і публічний репозиторій на GitHub, який буде слугувати прикладом того, як робити внесок у проекти інших.

Збереження твого коду в безпеці

Давай поговоримо про безпеку – але не хвилюйся, ми не будемо перевантажувати тебе страшними речами! Уяви ці практики безпеки як замикання машини або будинку. Це прості звички, які стають природними і захищають твою важливу роботу.

Ми покажемо тобі сучасні, безпечні способи роботи з GitHub з самого початку. Таким чином, ти розвинеш хороші звички, які будуть корисними протягом усієї твоєї кар'єри в програмуванні.

Коли працюєш з GitHub, важливо дотримуватися найкращих практик безпеки:

Область безпеки Найкраща практика Чому це важливо
Аутентифікація Використовуй SSH ключі або персональні токени доступу Паролі менш безпечні і поступово відходять у минуле
Двофакторна аутентифікація Увімкни 2FA у своєму обліковому записі GitHub Додає додатковий рівень захисту облікового запису
Безпека репозиторію Ніколи не коміть конфіденційну інформацію API ключі та паролі не повинні бути у публічних репозиторіях
Управління залежностями Увімкни Dependabot для оновлень Забезпечує безпеку та актуальність твоїх залежностей

⚠️ Критичне нагадування про безпеку: Ніколи не коміть API ключі, паролі або іншу конфіденційну інформацію в будь-який репозиторій. Використовуй змінні середовища та файли .gitignore для захисту конфіденційних даних.

Сучасне налаштування аутентифікації:

# Generate SSH key (modern ed25519 algorithm)
ssh-keygen -t ed25519 -C "your_email@example.com"

# Set up Git to use SSH
git remote set-url origin git@github.com:username/repository.git

💡 Порада: SSH ключі усувають необхідність постійного введення паролів і є більш безпечними, ніж традиційні методи аутентифікації.

Управління кодом як професіонал

Окей, ОСЬ де починається справжнє захоплення! 🎉 Ми збираємося навчитися відстежувати та управляти твоїм кодом, як це роблять професіонали, і чесно кажучи, це одна з моїх улюблених тем для навчання, тому що це справжній переворот.

Уяви це: ти пишеш дивовижну історію і хочеш зберегти кожен чернетковий варіант, кожну блискучу правку і кожен момент "о, це геніально!" на шляху. Саме це Git робить для твого коду! Це як мати неймовірний блокнот, що подорожує у часі і запам'ятовує ВСЕ – кожен натиск клавіші, кожну зміну, кожен момент "ой, я все зламав", який ти можеш миттєво виправити.

Зізнаюся – спочатку це може здатися складним. Коли я починав, я думав: "Чому я просто не можу зберігати свої файли як завжди?" Але повір мені: як тільки ти зрозумієш Git (а ти зрозумієш!), ти відчуєш той момент осяяння, коли подумаєш: "Як я взагалі міг програмувати без цього?" Це як відкрити, що ти можеш літати, коли раніше всюди ходив пішки!

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

Завдання: Створи свій перший репозиторій!

🎯 Твоя місія (і я дуже радий за тебе!): Ми разом створимо твій перший репозиторій на GitHub! До кінця цього завдання ти матимеш свій власний куточок в інтернеті, де буде зберігатися твій код, і ти зробиш свій перший "коміт" (це розробницький термін для збереження твоєї роботи дуже розумним способом).

Це справді особливий момент – ти офіційно приєднуєшся до глобальної спільноти розробників! Я досі пам'ятаю хвилювання від створення свого першого репозиторію і думки: "Вау, я справді це роблю!"

Давай пройдемо цей шлях разом, крок за кроком. Не поспішай з кожною частиною – тут немає призу за швидкість, і я обіцяю, що кожен крок буде зрозумілим. Пам'ятай, кожна зірка програмування, якою ти захоплюєшся, колись сиділа саме там, де ти зараз, готуючись створити свій перший репозиторій. Як це круто?

Переглянь відео

Відео про основи Git і GitHub

Давай зробимо це разом:

  1. Створи свій репозиторій на GitHub. Перейди на GitHub.com і знайди яскраву зелену кнопку New (або знак + у верхньому правому куті). Натисни її і вибери New repository.

    Ось що потрібно зробити:

    1. Дай своєму репозиторію назву – нехай вона буде значущою для тебе!
    2. Додай опис, якщо хочеш (це допоможе іншим зрозуміти, про що твій проект)
    3. Виріши, чи хочеш зробити його публічним (усі можуть його бачити) чи приватним (лише для тебе)
    4. Рекомендую поставити галочку, щоб додати файл README – це як титульна сторінка твого проекту
    5. Натисни Create repository і святкуй – ти щойно створив свій перший репозиторій! 🎉

  2. Перейди до папки свого проекту. Тепер відкрий свій термінал (не хвилюйся, він не такий страшний, як здається!). Нам потрібно сказати твоєму комп'ютеру, де знаходяться файли твого проекту. Введи цю команду:

    cd [name of your folder]

    Що ми тут робимо:

    • Ми фактично кажемо комп'ютеру: "Гей, відведи мене до папки мого проекту"
    • Це як відкриття конкретної папки на робочому столі, але ми робимо це текстовими командами
    • Замінити [name of your folder] на фактичну назву твоєї папки проекту

  3. Перетвори свою папку на Git-репозиторій. Ось де відбувається магія! Введи:

    git init

    Ось що щойно сталося (доволі круто!):

    • Git щойно створив приховану папку .git у твоєму проекті – ти її не побачиш, але вона там!
    • Твоя звичайна папка тепер "репозиторій", який може відстежувати кожну зміну, яку ти робиш
    • Уяви це як надання твоїй папці суперздібностей запам'ятовувати все

  4. Перевір, що відбувається. Давай подивимося, що Git думає про твій проект зараз:

    git status

    Розуміння того, що каже Git:

    Ти можеш побачити щось схоже на це:

    Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)

     modified:   file.txt
     modified:   file2.txt

    Не панікуй! Ось що це означає:

    • Файли в червоному – це файли, які мають зміни, але ще не готові до збереження
    • Файли в зеленому (коли ти їх побачиш) – готові до збереження
    • Git допомагає, показуючи, що саме ти можеш зробити далі

    💡 Порада: Команда git status – твій найкращий друг! Використовуй її, коли не впевнений, що відбувається. Це як запитати Git: "Гей, яка ситуація зараз?"

  5. Підготуй файли до збереження (це називається "стейджинг"):

    git add .

    Що ми щойно зробили:

    • Ми сказали Git: "Гей, я хочу включити ВСІ мої файли в наступне збереження"
    • . означає "все в цій папці"
    • Тепер твої файли "стейджовані" і готові до наступного кроку

    Хочеш бути більш вибірковим? Ти можеш додати лише конкретні файли:

    git add [file or folder name]

    Чому ти можеш захотіти це зробити?

    • Іноді ти хочеш зберегти пов'язані зміни разом
    • Це допомагає організувати твою роботу в логічні блоки
    • Полегшує розуміння того, що змінилося і коли

    Передумав? Не хвилюйся! Ти можеш зняти файли зі стейджингу ось так:

    # Unstage everything
git reset

# Unstage just one file
git reset [file name]

    Не хвилюйся – це не видаляє твою роботу, це просто прибирає файли з "готових до збереження".

  6. Збережи свою роботу назавжди (зроби свій перший коміт!):

    git commit -m "first commit"

    🎉 Вітаю! Ти щойно зробив свій перший коміт!

    Ось що щойно сталося:

    • Git зробив "знімок" всіх твоїх стейджованих файлів у цей момент

    • Твій коментар до коміту "first commit" пояснює, про що цей момент збереження

    • Git дав цьому знімку унікальний ID, щоб ти завжди міг його знайти

    • Ти офіційно почав відстежувати історію свого проекту!

    • Ми створили зв'язок між вашим локальним проектом і вашим репозиторієм на GitHub.

    • "Origin" – це просто псевдонім для вашого репозиторію на GitHub, як додавання контакту до вашого телефону.

    • Тепер ваш локальний Git знає, куди надсилати ваш код, коли ви готові ним поділитися.

    💡 Простий спосіб: Якщо у вас встановлений GitHub CLI, ви можете зробити це однією командою:

    gh repo create my-repo --public --push --source=.

  7. Надішліть ваш код на GitHub (великий момент!):

    git push -u origin main

    🚀 Це воно! Ви завантажуєте ваш код на GitHub!

    Що відбувається:

    • Ваші коміти подорожують з вашого комп'ютера на GitHub.
    • Прапорець -u встановлює постійний зв'язок, щоб майбутні push були простішими.
    • "main" – це назва вашої основної гілки (як головна папка).
    • Після цього ви можете просто вводити git push для майбутніх завантажень!

    💡 Швидка примітка: Якщо ваша гілка називається інакше (наприклад, "master"), використовуйте цю назву. Ви можете перевірити це за допомогою git branch --show-current.

  8. Ваш новий щоденний ритм кодування (ось де це стає захоплюючим!):

    Відтепер, коли ви вносите зміни до вашого проекту, у вас є цей простий трьохетапний танець:

    git add .
git commit -m "describe what you changed"
git push

    Це стає вашим серцем кодування:

    • Внесіть круті зміни до вашого коду ✨
    • Додайте їх за допомогою git add ("Гей, Git, зверни увагу на ці зміни!")
    • Збережіть їх за допомогою git commit і описового повідомлення (майбутній ви вам подякує!)
    • Поділіться ними зі світом за допомогою git push 🚀
    • Повторюйте – серйозно, це стає таким природним, як дихання!

    Мені подобається цей робочий процес, тому що це як мати кілька точок збереження в відеогрі. Зробили зміну, яка вам подобається? Зробіть коміт! Хочете спробувати щось ризиковане? Без проблем – ви завжди можете повернутися до останнього коміту, якщо щось піде не так!

    💡 Порада: Можливо, вам також варто використовувати файл .gitignore, щоб запобігти появі файлів, які ви не хочете відстежувати, на GitHub – наприклад, файл з нотатками, який ви зберігаєте в тій самій папці, але він не має місця в публічному репозиторії. Ви можете знайти шаблони для файлів .gitignore на .gitignore templates або створити один за допомогою gitignore.io.

Сучасні робочі процеси Git

Розгляньте можливість впровадження цих сучасних практик:

  • Conventional Commits: Використовуйте стандартизований формат повідомлень комітів, як feat:, fix:, docs: тощо. Дізнайтеся більше на conventionalcommits.org
  • Атомарні коміти: Нехай кожен коміт представляє одну логічну зміну.
  • Часті коміти: Робіть коміти часто з описовими повідомленнями, а не рідкісні великі коміти.

Повідомлення комітів

Чудовий заголовок повідомлення коміту завершує наступне речення: Якщо застосувати, цей коміт <ваш заголовок тут>

Для заголовка використовуйте наказовий теперішній час: "змінити", а не "змінено" чи "зміни". Як і в заголовку, в тілі (опціонально) також використовуйте наказовий теперішній час. Тіло повинно включати мотивацію для зміни та контрастувати це з попередньою поведінкою. Ви пояснюєте чому, а не як.

✅ Приділіть кілька хвилин, щоб пошукати на GitHub. Чи можете ви знайти дійсно чудове повідомлення коміту? Чи можете знайти дуже мінімальне? Яка інформація, на вашу думку, є найважливішою та корисною для передачі в повідомленні коміту?

Співпраця з іншими (найцікавіша частина!)

Приготуйтеся, тому що ОСЬ де GitHub стає абсолютно магічним! 🪄 Ви освоїли управління власним кодом, але тепер ми занурюємося в мою абсолютну улюблену частину – співпрацю з дивовижними людьми з усього світу.

Уявіть це: ви прокидаєтеся завтра і бачите, що хтось у Токіо покращив ваш код, поки ви спали. Потім хтось у Берліні виправляє баг, над яким ви застрягли. До обіду розробник у Сан-Паулу додає функцію, про яку ви навіть не думали. Це не наукова фантастика – це просто вівторок у всесвіті GitHub!

Що мене дійсно захоплює, так це те, що навички співпраці, які ви зараз освоюєте? Це ТОЧНО ті ж робочі процеси, які команди в Google, Microsoft і ваших улюблених стартапах використовують щодня. Ви не просто вивчаєте крутий інструмент – ви вивчаєте секретну мову, яка дозволяє всьому світу програмного забезпечення працювати разом.

Серйозно, як тільки ви відчуєте захват від того, що хтось об'єднав ваш перший pull request, ви зрозумієте, чому розробники так захоплюються відкритим кодом. Це як бути частиною найбільшого, найкреативнішого командного проекту у світі!

Перегляньте відео

Відео основ Git і GitHub

Основна причина розміщення речей на GitHub – це зробити можливим співпрацю з іншими розробниками.

У вашому репозиторії перейдіть до Insights > Community, щоб побачити, як ваш проект порівнюється з рекомендованими стандартами спільноти.

Хочете зробити ваш репозиторій професійним і привітним? Перейдіть до вашого репозиторію і натисніть Insights > Community. Ця крута функція показує, як ваш проект порівнюється з тим, що спільнота GitHub вважає "хорошими практиками репозиторію".

🎯 Зробіть ваш проект блискучим: Добре організований репозиторій з гарною документацією – це як мати чистий, привітний магазин. Це показує людям, що ви дбаєте про свою роботу, і змушує інших хотіти внести свій внесок!

Ось що робить репозиторій чудовим:

Що додати Чому це важливо Що це робить для вас
Опис Перше враження має значення! Люди миттєво знають, що робить ваш проект
README Головна сторінка вашого проекту Як дружній гід для нових відвідувачів
Керівництво для внесків Показує, що ви вітаєте допомогу Люди знають точно, як вони можуть допомогти вам
Кодекс поведінки Створює дружній простір Усі відчувають себе привітно для участі
Ліцензія Юридична ясність Інші знають, як вони можуть використовувати ваш код
Політика безпеки Показує, що ви відповідальні Демонструє професійні практики

💡 Професійна порада: GitHub надає шаблони для всіх цих файлів. При створенні нового репозиторію, поставте галочки, щоб автоматично створити ці файли.

Сучасні функції GitHub для дослідження:

🤖 Автоматизація та CI/CD:

  • GitHub Actions для автоматичного тестування та розгортання
  • Dependabot для автоматичного оновлення залежностей

💬 Спільнота та управління проектами:

  • GitHub Discussions для обговорень спільноти поза межами задач
  • GitHub Projects для управління проектами у стилі канбан
  • Правила захисту гілок для забезпечення стандартів якості коду

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

✅ Файли README, хоча їх підготовка займає час, часто ігноруються зайнятими підтримувачами. Чи можете ви знайти приклад особливо описового README? Примітка: є деякі інструменти для створення хороших README, які вам можуть сподобатися.

Завдання: Об'єднайте трохи коду

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

  1. Форк вашого репозиторію. Ви, ймовірно, захочете, щоб люди форкнули ваш проект. Форк означає створення копії вашого репозиторію у їхньому профілі на GitHub.
  2. Клонування. Звідти вони клонують проект на свою локальну машину.
  3. Створення гілки. Ви захочете попросити їх створити гілку для їхньої роботи.
  4. Сфокусуйте їхню зміну на одній області. Попросіть учасників зосередити свої внески на одній речі за раз – таким чином шанси, що ви зможете об'єднати їхню роботу, вищі. Уявіть, що вони пишуть виправлення багу, додають нову функцію і оновлюють кілька тестів – що, якщо ви хочете або можете впровадити лише 2 з 3, або 1 з 3 змін?

✅ Уявіть ситуацію, де гілки особливо важливі для написання та доставки хорошого коду. Які випадки використання ви можете придумати?

Примітка: будьте зміною, яку хочете бачити у світі, і створюйте гілки для своєї власної роботи також. Будь-які коміти, які ви робите, будуть зроблені на гілці, до якої ви зараз "перевірені". Використовуйте git status, щоб побачити, яка це гілка.

Давайте пройдемо через робочий процес учасника. Припустимо, учасник вже форкнув і клонував репозиторій, тому у нього є готовий Git-репозиторій на локальній машині:

  1. Створіть гілку. Використовуйте команду git branch, щоб створити гілку, яка буде містити зміни, які вони мають намір внести:

    git branch [branch-name]

    💡 Сучасний підхід: Ви також можете створити і переключитися на нову гілку однією командою:

    git switch -c [branch-name]

  2. Переключіться на робочу гілку. Переключіться на зазначену гілку і оновіть робочий каталог за допомогою git switch:

    git switch [branch-name]

    💡 Сучасна примітка: git switch – це сучасна заміна git checkout при зміні гілок. Це зрозуміліше і безпечніше для початківців.

  3. Виконайте роботу. На цьому етапі ви хочете додати ваші зміни. Не забудьте повідомити Git про це за допомогою наступних команд:

    git add .
git commit -m "my changes"

    ⚠️ Якість повідомлення коміту: Переконайтеся, що ви даєте вашому коміту гарну назву, як для себе, так і для підтримувача репозиторію, над яким ви працюєте. Будьте конкретними щодо того, що ви змінили!

  4. Об'єднайте вашу роботу з гілкою main. У якийсь момент ви закінчили роботу і хочете об'єднати вашу роботу з тією, що є в гілці main. Гілка main могла змінитися за цей час, тому переконайтеся, що спочатку оновіть її до останньої версії за допомогою наступних команд:

    git switch main
git pull

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

    git switch [branch_name]
git merge main

    Команда git merge main принесе всі зміни з main у вашу гілку. Сподіваємося, ви зможете просто продовжити. Якщо ні, VS Code покаже вам, де Git заплутався, і ви просто зміните відповідні файли, щоб вказати, який контент є найбільш точним.

    💡 Сучасна альтернатива: Розгляньте використання git rebase для чистішої історії:

    git rebase main

    Це відтворює ваші коміти поверх останньої гілки main, створюючи лінійну історію.

  5. Надішліть вашу роботу на GitHub. Надсилання вашої роботи на GitHub означає дві речі. Завантаження вашої гілки у ваш репозиторій і відкриття PR, Pull Request.

    git push --set-upstream origin [branch-name]

    Наведена вище команда створює гілку у вашому форкованому репозиторії.

  6. Відкрийте PR. Далі ви хочете відкрити PR. Ви робите це, перейшовши до форкованого репозиторію на GitHub. Ви побачите індикацію на GitHub, де вас запитають, чи хочете ви створити новий PR, ви натискаєте це і вас перенаправляють до інтерфейсу, де ви можете змінити заголовок повідомлення коміту, дати йому більш відповідний опис. Тепер підтримувач репозиторію, який ви форкнули, побачить цей PR і сподіваємося оцінить і об'єднає ваш PR. Ви тепер учасник, ура :)

    💡 Сучасна порада: Ви також можете створювати PR за допомогою GitHub CLI:

    gh pr create --title "Your PR title" --body "Description of changes"

    🔧 Найкращі практики для PR:

    • Посилайтеся на пов'язані задачі за допомогою ключових слів, як "Fixes #123".
    • Додавайте скріншоти для змін у інтерфейсі.
    • Запитуйте конкретних рецензентів.
    • Використовуйте чернетки PR для роботи, яка ще триває.
    • Переконайтеся, що всі перевірки CI пройшли перед запитом на рецензію.

  7. Очистіть. Вважається гарною практикою очистити після успішного об'єднання PR. Ви хочете очистити як вашу локальну гілку, так і гілку, яку ви завантажили на GitHub. Спочатку видаліть її локально за допомогою наступної команди:

    git branch -d [branch-name]

    Переконайтеся, що ви перейшли на сторінку GitHub для форкованого репозиторію і видалили віддалену гілку, яку ви щойно завантажили 🤞Тримаємо кулаки, щоб усі перевірки пройшли успішно, і власник(и) проєкту об'єднали ваші зміни в проєкт🤞

Оновіть вашу поточну локальну робочу гілку всіма новими комітами з відповідної віддаленої гілки на GitHub:

git pull

Внесок у відкритий код (Ваш шанс зробити вплив!)

Готові до чогось, що вас абсолютно вразить? 🤯 Давайте поговоримо про внесок у відкриті проєкти – і я вже відчуваю мурашки, думаючи про те, щоб поділитися цим із вами!

Це ваш шанс стати частиною чогось справді неймовірного. Уявіть, що ви покращуєте інструменти, якими щодня користуються мільйони розробників, або виправляєте помилку в додатку, який обожнюють ваші друзі. Це не просто мрія – це те, що означає внесок у відкритий код!

Ось що мене завжди надихає: кожен інструмент, з яким ви навчалися – ваш редактор коду, фреймворки, які ми будемо досліджувати, навіть браузер, у якому ви це читаєте – почався з когось, хто, як і ви, зробив свій перший внесок. Той геніальний розробник, який створив ваш улюблений розширення для VS Code? Колись він був новачком, який тремтячими руками натискав "створити pull request", так само, як ви зараз.

І ось найкраща частина: спільнота відкритого коду – це як найбільше групове обіймання в інтернеті. Більшість проєктів активно шукають новачків і мають завдання з тегом "good first issue", спеціально для таких, як ви! Мейнтейнери щиро радіють, коли бачать нових учасників, бо пам'ятають свої перші кроки.

Ви не просто вчитеся програмувати – ви готуєтеся приєднатися до глобальної родини творців, які щодня прокидаються з думкою: "Як ми можемо зробити цифровий світ трохи кращим?" Ласкаво просимо до клубу! 🌟

Спочатку знайдіть репозиторій (або repo) на GitHub, який вас цікавить і до якого ви хочете внести зміни. Вам потрібно скопіювати його вміст на свій комп'ютер.

✅ Хороший спосіб знайти репозиторії для новачків – шукати за тегом 'good-first-issue'.

Скопіювати репозиторій локально

Є кілька способів скопіювати код. Один із них – "клонувати" вміст репозиторію, використовуючи HTTPS, SSH або GitHub CLI (Command Line Interface).

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

# Using HTTPS
git clone https://github.com/ProjectURL

# Using SSH (requires SSH key setup)
git clone git@github.com:username/repository.git

# Using GitHub CLI
gh repo clone username/repository

Щоб працювати над проєктом, перейдіть до потрібної папки: cd ProjectURL

Ви також можете відкрити весь проєкт за допомогою:

  • GitHub Codespaces – хмарне середовище розробки GitHub із VS Code у браузері
  • GitHub Desktop – GUI-додаток для операцій Git
  • GitHub.dev – натисніть клавішу . на будь-якому репозиторії GitHub, щоб відкрити VS Code у браузері
  • VS Code із розширенням GitHub Pull Requests

Нарешті, ви можете завантажити код у вигляді архіву.

Кілька цікавих фактів про GitHub

Ви можете поставити зірочку, стежити або "форкнути" будь-який публічний репозиторій на GitHub. Ви знайдете свої зіркові репозиторії у випадаючому меню у верхньому правому куті. Це як закладки, але для коду.

Проєкти мають трекер завдань, здебільшого на GitHub у вкладці "Issues", якщо не зазначено інше, де люди обговорюють проблеми, пов'язані з проєктом. А вкладка Pull Requests – це місце, де люди обговорюють і переглядають зміни, які перебувають у процесі.

Проєкти також можуть мати обговорення у форумах, списках розсилки або чат-каналах, таких як Slack, Discord або IRC.

🔧 Сучасні функції GitHub:

  • GitHub Discussions – Вбудований форум для спільнотних розмов
  • GitHub Sponsors – Фінансова підтримка мейнтейнерів
  • Security tab – Звіти про вразливості та рекомендації з безпеки
  • Actions tab – Автоматизовані робочі процеси та CI/CD пайплайни
  • Insights tab – Аналітика про учасників, коміти та стан проєкту
  • Projects tab – Вбудовані інструменти управління проєктами на GitHub

✅ Ознайомтеся з вашим новим репозиторієм на GitHub і спробуйте кілька речей, як-от редагування налаштувань, додавання інформації до репозиторію, створення проєкту (наприклад, Канбан-дошки) та налаштування GitHub Actions для автоматизації. Тут є багато чого зробити!

🚀 Виклик

Гаразд, час випробувати ваші нові суперсили GitHub! 🚀 Ось виклик, який допоможе вам зрозуміти все на практиці:

Запросіть друга (або члена сім'ї, який завжди питає, чим ви займаєтеся з усім цим "комп'ютерним") і вирушайте разом у пригодницьку подорож з колаборативного програмування! Тут починається справжня магія – створіть проєкт, дайте їм його форкнути, створіть кілька гілок і об'єднайте зміни, як справжні професіонали.

Не буду брехати – ви, ймовірно, будете сміятися (особливо коли обидва спробуєте змінити один і той самий рядок), можливо, почухаєте голову від здивування, але точно матимете ті дивовижні моменти "ага!", які роблять весь процес навчання вартим зусиль. А ще є щось особливе в тому, щоб поділитися першим успішним об'єднанням із кимось – це як маленьке святкування того, як далеко ви зайшли!

Ще не маєте друга для програмування? Не хвилюйтеся! Спільнота GitHub сповнена неймовірно привітних людей, які пам'ятають, як це бути новачком. Шукайте репозиторії з міткою "good first issue" – це як запрошення: "Гей, новачки, приходьте вчитися з нами!" Як це круто?

Післялекційний тест

Післялекційний тест

Огляд і продовження навчання

Ух! 🎉 Подивіться на себе – ви щойно підкорили основи GitHub як справжній чемпіон! Якщо ваш мозок зараз трохи перевантажений, це абсолютно нормально і навіть хороший знак. Ви щойно освоїли інструменти, на які мені знадобилися тижні, щоб почуватися комфортно.

Git і GitHub неймовірно потужні (серйозно потужні), і кожен розробник, якого я знаю – включаючи тих, хто зараз здається чарівником – мусив практикуватися і трохи плутатися, перш ніж усе стало зрозумілим. Той факт, що ви пройшли цей урок, означає, що ви вже на шляху до освоєння одних із найважливіших інструментів у наборі розробника.

Ось кілька чудових ресурсів, які допоможуть вам практикуватися і стати ще крутішими:

І пам'ятайте: практика робить прогрес, а не досконалість! Чим більше ви використовуєте Git і GitHub, тим природніше це стає. GitHub створив кілька чудових інтерактивних курсів, які дозволяють вам практикуватися в безпечному середовищі:

Відчуваєте себе авантюристом? Ознайомтеся з цими сучасними інструментами:

Виклик GitHub Copilot Agent 🚀

Використовуйте режим Agent, щоб виконати наступний виклик:

Опис: Створіть спільний проєкт веб-розробки, який демонструє повний GitHub workflow, який ви вивчили в цьому уроці. Цей виклик допоможе вам практикувати створення репозиторію, функції співпраці та сучасні Git workflows у реальному сценарії.

Завдання: Створіть новий публічний репозиторій GitHub для простого проєкту "Ресурси веб-розробки". Репозиторій має включати добре структурований файл README.md, який містить корисні інструменти та ресурси для веб-розробки, організовані за категоріями (HTML, CSS, JavaScript тощо). Налаштуйте репозиторій із відповідними стандартами спільноти, включаючи ліцензію, рекомендації щодо внеску та кодекс поведінки. Створіть щонайменше дві гілки функцій: одну для додавання ресурсів CSS і іншу для ресурсів JavaScript. Зробіть коміти до кожної гілки з описовими повідомленнями комітів, а потім створіть pull requests для об'єднання змін назад у main. Увімкніть функції GitHub, такі як Issues, Discussions, і налаштуйте базовий робочий процес GitHub Actions для автоматичних перевірок.

Завдання

Ваша місія, якщо ви вирішите її прийняти: Пройдіть курс Вступ до GitHub на платформі GitHub Skills. Цей інтерактивний курс дозволить вам практикувати все, що ви вивчили, у безпечному, керованому середовищі. А ще ви отримаєте крутий значок після завершення! 🏅

Готові до нових викликів?

  • Налаштуйте SSH-аутентифікацію для вашого облікового запису GitHub (більше ніяких паролів!)
  • Спробуйте використовувати GitHub CLI для щоденних операцій з Git
  • Створіть репозиторій із робочим процесом GitHub Actions
  • Досліджуйте GitHub Codespaces, відкривши цей самий репозиторій у хмарному редакторі

Пам'ятайте: кожен експерт колись був новачком. У вас все вийде! 💪

Відмова від відповідальності:
Цей документ був перекладений за допомогою сервісу автоматичного перекладу Co-op Translator. Хоча ми прагнемо до точності, будь ласка, майте на увазі, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ на його рідній мові слід вважати авторитетним джерелом. Для критичної інформації рекомендується професійний людський переклад. Ми не несемо відповідальності за будь-які непорозуміння або неправильні тлумачення, що виникають внаслідок використання цього перекладу.