Зачем нужен GitHub

GitHub — это облачный сервис для хостинга репозиториев Git и совместной разработки. Это не просто место для хранения кода, а полноценная платформа для управления проектами и командной работы.

Основное назначение

GitHub решает две главные проблемы:

1. Хранение и история кода — безопасное хранилище с полной историей изменений
2. Совместная разработка — инструменты для работы в команде

Основные функции GitHub

1. Хранилище кода (Repository)

Это центральное хранилище, где находится весь исходный код проекта.

# Создаёшь репозиторий на GitHub
# Затем клонируешь его
git clone https://github.com/username/project.git

# Работаешь локально
echo "print(Hello)" > main.py
git add main.py
git commit -m "Add hello script"

# Отправляешь на GitHub
git push origin main

# Другие разработчики могут получить актуальный код
git pull origin main

Преимущества:

• Сохранение кода в облаке (не потеряется)
• История всех изменений
• Возможность откатить любые изменения
• Доступ из любого места

2. Совместная разработка (Pull Requests)

Pull Request (PR) — это предложение изменений из одной ветки в другую. Это основной способ работы в команде.

# Разработчик 1: создаёт ветку для новой функции
git checkout -b feature/auth
# ... разрабатывает функцию ...
git push origin feature/auth

# На GitHub создаёт Pull Request
# feature/auth → main

# Разработчик 2: проверяет код (Code Review)
# Комментирует, просит изменения
# GitHub показывает разницу кода (diff)

# Разработчик 1: отвечает на замечания
git add .
git commit -m "Fix code review issues"
git push origin feature/auth

# Разработчик 2: одобряет (Approve)
# Разработчик 1: сливает (Merge)
# feature/auth автоматически объединяется с main

3. Code Review (Проверка кода)

Комманда может проверять код перед слиянием.

При создании PR:

1. Показывается diff (разница кода)
2. Можно оставить комментарии на конкретных строках
3. CI/CD автоматически прогоняет тесты
4. Требуется одобрение перед merge

Преимущества:
- Качество кода выше (несколько глаз)
- Знание code base лучше
- Обучение в команде (junior видит лучшие практики)
- Предотвращение ошибок

4. Версионирование и теги

Можно отмечать важные версии проекта.

# Создаёшь тег для версии
git tag v1.0.0
git push origin v1.0.0

# На GitHub автоматически создаётся Release
# Можно добавить описание, скачать исходник, приложить файлы

5. Issues и управление проектами

Issues — система отслеживания задач и багов.

Примеры Issues:
- Bug: Login page crashes on Firefox
- Feature: Add dark theme
- Task: Refactor database queries
- Discussion: Architecture for microservices

В каждом issue:
- Описание
- Ассигнация (кому поручить)
- Лейблы (type:bug, priority:high)
- Связь с PR ("Fixes #123")
- Комментарии и обсуждение

# В сообщении коммита или PR можно ссылаться на issue
git commit -m "Fixes #42: Fix login page crash"
# GitHub автоматически закроет issue #42

6. Actions (CI/CD)

Автоматическое тестирование и развёртывание кода.

# .github/workflows/tests.yml
name: Tests
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Run tests
        run: |
          pip install -r requirements.txt
          pytest tests/
      - name: Check coverage
        run: |
          coverage run -m pytest
          coverage report --fail-under=80

# При каждом push и PR:
# 1. Запускаются автоматически тесты
# 2. Результаты показываются в PR
# 3. Merge блокируется если тесты не пройдены

7. Documentation и Wiki

Естественное место для документации проекта.

# README.md (первое, что видит пользователь)

# My Awesome Project

## Installation
```bash
pip install awesome-project

Usage

from awesome import do_something do_something()

Contributing

See CONTRIBUTING.md

GitHub Pages

- Можно развернуть сайт проекта
- Документацию
- Блог

8. Сотрудничество (Collaboration)

Для командной работы:

• Разные разработчики могут работать на разных ветках одновременно
• Автоматическое слияние (merge) не конфликтующих изменений
• Ревью перед внедрением в main
• История всех изменений (кто, когда, почему)

Типичный workflow:

main (production)

  ↑
  ├─ feature/auth (разработчик A)
  ├─ feature/payment (разработчик B)
  └─ bugfix/login (разработчик C)

Каждый работает независимо,
Потом PR → Code Review → Merge

9. Открытый исходный код (Open Source)

GitHub — центр опенсорс сообщества.

Преимущества публичного репозитория:
- Люди могут предложить улучшения (Fork + PR)
- Сообщество помогает находить баги
- Портфолио для работодателей
- Вклад в экосистему

Типичный workflow разработки на GitHub

1. Fork репозитория (для опенсорса)

git clone https://github.com/your-username/project.git
cd project

2. Создать ветку

git checkout -b feature/new-feature

3. Разработка

echo "new code" > feature.py
git add feature.py
git commit -m "Add new feature"

4. Отправить в GitHub

git push origin feature/new-feature

5. На сайте GitHub создать Pull Request

Описать изменения, прикрепить скриншоты

6. Code Review

Может быть несколько итераций обсуждений

7. Merge в main

После одобрения PR объединяется

8. Удалить ветку

git branch -d feature/new-feature

Альтернативы GitHub

GitLab   - open-source, самохостинг, больше功能для DevOps
Gitea    - лёгкий самохостинг
Bitbucket - для команд Atlassian
GitBucket - Java альтернатива

Интеграции с инструментами

GitHub интегрируется с:

• Slack — уведомления о PR и issues
• Jira — синхронизация задач
• Docker Hub — автоматическая публикация образов
• Vercel/Netlify — автоматический деплой при push
• AWS/Google Cloud — развёртывание приложений
• SonarQube — анализ качества кода

Почему GitHub, а не просто Git?

Git — это инструмент контроля версий (локально)
GitHub — это облачный сервис + инструменты для команды

Без GitHub:
- Нужна своя серверная инфраструктура
- Сложнее управлять доступом
- Нет Code Review
- Нет истории через UI
- Сложнее откатывать ошибки

С GitHub:
- Всё готово
- Удобный интерфейс
- Встроенные инструменты
- Безопасность
- Масштабируемость

Вывод

GitHub — это стандартный инструмент для разработки в любой профессиональной команде. Он обеспечивает:

• Хранение кода в облаке
• Историю изменений с полной трассировкой
• Совместную разработку через PR и Code Review
• Управление проектом через Issues
• Автоматизацию через Actions
• Сообщество для опенсорса

Опытный разработчик умеет работать с GitHub так же хорошо, как и писать код.