Pull Request и проверка изменений
9 февраля 2026
Оглавление
- Что такое Pull Request
- Создание Pull Request
- Процесс проверки
- Комментарии и правки
- Слияние изменений
- Статусы Pull Request
- Лучшие практики
- Частые вопросы
Что такое Pull Request
Pull Request (PR) — это запрос на внесение изменений в репозиторий. Это способ предложить свои изменения команде на рассмотрение перед тем, как они попадут в основной код.
Зачем нужен Pull Request:
| Преимущество | Описание |
|---|---|
| 🔍 Проверка качества | Другие участники видят изменения и могут их проверить |
| 💬 Обсуждение | Можно обсудить изменения до их публикации |
| 🐛 Поиск ошибок | Ошибки находятся до попадания на рабочий сайт |
| 📚 Документирование | История всех изменений сохраняется |
| 🤝 Командная работа | Несколько человек могут работать над одним документом |
Как это работает:
[Ваш форк] → [Pull Request] → [Проверка] → [Слияние] → [Основной репозиторий]
Термины:
| Термин | Значение |
|---|---|
| Fork | Ваша копия репозитория |
| Branch | Ветка — отдельная линия разработки |
| Source branch | Ветка с вашими изменениями |
| Target branch | Ветка, куда должны попасть изменения |
| Merge | Слияние — объединение изменений |
| Review | Проверка изменений |
Создание Pull Request
Шаг 1: Сохраните изменения
После редактирования статьи нажмите "Commit changes" в редакторе GitHub:
- Введите Commit message (описание изменений)
- Нажмите "Commit changes"
Правила для commit message:
| Хорошо | Плохо |
|---|---|
docs: Add new article about PR | update |
fix: Fix typo in images guide | fixed stuff |
docs: Update monitoring guide | changes |
Шаг 2: Создайте Pull Request
- Перейдите на страницу репозитория
- Нажмите "Pull requests" в верхнем меню
- Нажмите "New pull request"
- Выберите:
- Base repository:
itcomgroup/owix-ai-division - Base branch:
main(куда вливаются изменения) - Head repository: ваш форк
- Compare branch: ваша ветка с изменениями
- Base repository:
Шаг 3: Заполните описание Pull Request
## Что изменено
- Добавлена новая статья о Pull Request
- Исправлены опечатки в разделе изображений
## Проверка
- [x] Статья проверена на локальном сервере
- [x] Все ссылки работают
- [x] Изображения отображаются
## Скриншоты (если применимо)
[Добавьте скриншоты изменений]
Шаг 4: Создайте Pull Request
- Нажмите "Create pull request"
- При необходимости добавьте дополнительные комментарии
- Выберите рецензентов (Assignees)
- Добавьте метки (Labels):
documentation,bug,enhancement
Процесс проверки
Кто проверяет Pull Request:
| Роль | Ответственность |
|---|---|
| Мейнтейнер | Окончательное решение о слиянии |
| Рецензент | Проверяет качество и содержание |
| Автор | Отвечает на комментарии и вносит правки |
Что проверяется:
| Проверка | Описание |
|---|---|
| ✅ Содержание | Информация актуальна и полезна |
| ✅ Форматирование | Markdown соответствует стандартам |
| ✅ ** Ссылки** | Все ссылки работают |
| ✅ Изображения | Картинки отображаются |
| ✅ Грамматика | Нет ошибок в тексте |
| ✅ Стиль | Единый стиль с другими статьями |
Этапы проверки:
1. Автор создает PR
↓
2. Автоматические проверки (CI/CD)
- Проверка синтаксиса Markdown
- Проверка ссылок
↓
3. Рецензент назначается
↓
4. Рецензент просматривает изменения
↓
5. Если есть замечания → комментарии
↓
6. Автор исправляет
↓
7. Рецензент одобряет
↓
8. Мейнтейнер сливает изменения
Комментарии и правки
Как работать с комментариями:
-
Просмотр комментариев
- Перейдите на вкладку "Files changed"
- Нажмите на строку с комментарием
- Прочитайте замечание
-
Ответ на комментарий
Спасибо за замечание! Исправлю. -
Внесение правок
- Нажмите на иконку карандаша рядом с изменением
- Внесите исправления
- Нажмите "Commit changes"
- Изменения автоматически появятся в PR
-
Ответ на исправление
Исправлено. Проверьте, пожалуйста.
Типы комментариев:
| Тип | Значок | Действие |
|---|---|---|
| Suggestion | 💡 | Рекомендация по улучшению |
| Question | ❓ | Вопрос к автору |
| Blocking | 🔴 | Блокирует слияние (ошибка) |
| Approval | ✅ | Одобрение изменений |
Пример диалога:
Рецензент: 💡 Рекомендую добавить скриншот для наглядности
Автор: Добавил скриншот в раздел 3
Рецензент: ✅ Отлично, спасибо!
Слияние изменений
Когда можно сливать:
| Условие | Статус |
|---|---|
| Все проверки пройдены | ✅ Зелёный статус |
| Нет блокирующих комментариев | ✅ |
| Минимум 1 одобрение | ✅ |
| Конфликтов нет | ✅ |
Слияние вручную:
- Нажмите "Squash and merge" или "Merge"
- Подтвердите слияние
- При необходимости удалите ветку
Типы слияния:
| Тип | Описание | Когда использовать |
|---|---|---|
| Create a merge commit | Сохраняет все коммиты | Большие изменения |
| Squash and merge | Объединяет в один коммит | Мелкие исправления |
| Rebase and merge | Переносит коммиты | Чистая история |
Рекомендация: Используйте "Squash and merge" для документации — это создаёт один чистый коммит.
После слияния:
- Pull Request закрывается автоматически
- Ветка удаляется (если выбрано)
- Изменения попадают в основную ветку
- Сайт обновляется (если настроен деплой)
Статусы Pull Request
Статусы в GitHub:
| Статус | Значок | Значение |
|---|---|---|
| Open | 🟢 | PR создан, ожидает проверки |
| In review | 🟡 | На проверке у рецензента |
| Changes requested | 🔴 | Нужны исправления |
| Approved | ✅ | Одобрено, готово к слиянию |
| Merged | 🟣 | Изменения слиты |
| Closed | ⚫ | PR закрыт без слияния |
Статусы проверок (CI/CD):
| Статус | Значок | Значение |
|---|---|---|
| Success | ✅ | Все проверки пройдены |
| Failure | ❌ | Есть ошибки |
| Pending | ⏳ | Проверка в процессе |
| Skipped | ⏭️ | Проверка пропущена |
Лучшие практики
Для автора:
| ✅ Делать | ❌ Не делать |
|---|---|
| Проверять изменения перед созданием PR | Создавать PR с ошибками |
| Писать понятное описание | Оставлять пустое описание |
| Отвечать на комментарии | Игнорировать замечания |
| Исправлять ошибки быстро | Откладывать правки |
| Запрашивать review | Сливать без одобрения |
Чек-лист перед созданием PR:
- Статья проверена на локальном сервере
- Нет битых ссылок
- Изображения загружены и отображаются
- Форматирование Markdown корректно
- Нет опечаток и грамматических ошибок
- Описание PR заполнено
- Выбраны рецензенты
Для рецензента:
| ✅ Делать | ❌ Не делать |
|---|---|
| Проверять тщательно | Просматривать бегло |
| Давать конкретные замечания | Писать размытые комментарии |
| Быть вежливым | Быть грубым |
| Предлагать улучшения | Только критиковать |
| Одобрять, когда всё хорошо | Блокировать без причины |
Частые вопросы
В: Можно ли создать PR для небольшого исправления?
Да! Даже исправление опечатки — это полезное изменение. Создавайте PR для любых улучшений.
В: Что делать, если PR долго не проверяют?
Напишите комментарий: "Готов к review, прошу проверить." Или свяжитесь с мейнтейнером напрямую.
В: Как отменить Pull Request?
Нажмите "Close pull request" внизу страницы PR. Изменения останутся в вашей ветке.
В: Можно ли добавить изменения в уже созданный PR?
Да! Просто продолжайте редактировать файл в том же репозитории. Изменения автоматически добавятся в PR.
В: Что делать при конфликте слияния?
1. Обновите основную ветку:
git fetch origin
git merge origin/main
2. Разрешите конфликты вручную
3. Загрузите исправления:
git add .
git commit
git push
В: Как посмотреть историю изменений в PR?
Перейдите на вкладку "Commits" в PR. Там показаны все коммиты.
В: Можно ли комментировать отдельные строки?
Да! На вкладке "Files changed" нажмите на строку и добавьте комментарий.
См. также: