Работа в пул-реквесте в SourceCraft

Для работы с пул-реквестами в SourceCraft, в том числе для ревью, не требуется специально переходить в IDE на локальном компьютере, все действия можно выполнять в интерфейсе SourceCraft. Доступны поиск и навигация по коду проекта, а также возможность редактировать код.

После того, как пул-реквест был создан и опубликован, вы можете:

Создать новую итерацию

После того как пул-реквест был создан, каждая отправка изменений в удаленную ветку репозитория создает новую итерацию. Итерация включает в себя все коммиты, которые были сделаны перед выполнением команды git push.

Чтобы создать новую итерацию:

  1. В той же ветке, из которой был создан пул-реквест, внесите новые изменения в файлы репозитория.

  2. Внесите измененные файлы в индекс git, сделайте коммит и отправьте изменения в удаленный репозиторий:

    git add .
git commit -m "<комментарий_к_коммиту>"
git push origin <название_ветки>

    В итерациях будут зафиксированы все предыдущие изменения, даже если новые коммиты были отправлены с помощью команды git push --force.

    Примечание

    Вы можете выполнить несколько коммитов и после этого отправить изменения в удаленный репозиторий. Все они будут включены в одну итерацию.

  3. После создания новой итерации пул-реквест переводится в статус черновика. Повторно опубликуйте его.

Вы можете внести изменения в ветку и создать новую итерацию непосредственно в интерфейсе SourceCraft.

Посмотреть изменения, вносимые в целевую ветку

  1. Откройте главную страницу SourceCraft.
  2. На вкладке Home перейдите в раздел Repositories.
  3. Выберите репозиторий.
  4. На странице репозитория в разделе Code перейдите в секцию Pull requests.
  5. Выберите пул-реквест.
  6. Посмотрите содержимое пул-реквеста:

    • На вкладке Overview отображается история итераций пул-реквеста. Чтобы посмотреть изменения из конкретной итерации, напротив этой итерации нажмите Show changes.

    • На вкладке Files changed отображаются измененные файлы репозитория.

      • Чтобы сравнить изменения между итерациями, выберите их в выпадающих списках в поле Compare.

      • Чтобы вывести структуру файлов, нажмите кнопку рядом с выпадающими списками сравнения веток и итераций.

        Подробнее см. на странице Навигация и поиск по коду в SourceCraft.

    • На вкладке Commits отображаются все коммиты за все итерации пул-реквеста.

Оставить комментарий и запросить изменения

  1. Откройте главную страницу SourceCraft.

  2. На вкладке Home перейдите в раздел Repositories.

  3. Выберите репозиторий.

  4. На странице репозитория в разделе Code перейдите в секцию Pull requests.

  5. Выберите пул-реквест.

  6. Оставьте комментарий:

    На вкладке Overview в блоке Activity введите свой комментарий.

    1. На вкладке Files changed напротив строки, к которой хотите оставить комментарий, нажмите .
    2. В открывшемся окне введите свой комментарий.

  7. (опционально) Чтобы запросить изменения в пул-реквесте, выберите опцию Change request.

  8. Нажмите Comment.

    Также вы можете не публиковать комментарий, а сохранить его черновик, чтобы доработать позже. Для этого нажмите Draft.

Вынести резолюцию

  1. Откройте главную страницу SourceCraft.
  2. На вкладке Home перейдите в раздел Repositories.
  3. Выберите репозиторий.
  4. На странице репозитория в разделе Code перейдите в секцию Pull requests.
  5. Выберите пул-реквест.
  6. В правом верхнем углу напротив кнопки Approve нажмите .
  7. Выберите резолюцию:
    • Approve — одобрить текущую итерацию пул-реквеста. После внесения изменений в пул-реквест, резолюцию надо будет получить повторно.
    • Trust — одобрить текущую и все последующие итерации пул-реквеста.
    • Block merge — запретить слияние изменений из пул-реквеста в целевую ветку.

Выполнить слияние с целевой веткой

После того как пул-реквест будет одобрен, вы можете выполнить слияние с целевой веткой.

  1. Откройте главную страницу SourceCraft.
  2. На вкладке Home перейдите в раздел Repositories.
  3. Выберите репозиторий.
  4. На странице репозитория в разделе Code перейдите в секцию Pull requests.
  5. Выберите пул-реквест.
  6. В правом верхнем углу напротив кнопки Merge pull request нажмите .
  7. Выберите способ слияния с целевой веткой:
    • Create a merge commit — в целевой ветке создается отдельный коммит слияния, который сохраняет историю изменений обеих веток. Этот подход наглядно показывает, когда и как происходило слияние, сохраняя всю историю разработки без изменений.
    • Squash and merge — перед слиянием с целевой веткой коммиты из ветки с изменениями объединяются в один коммит. Это помогает сохранить более чистую и упрощенную историю изменений, сводя серию мелких коммитов к одному.
    • Rebase and merge — коммиты из ветки с изменениями присоединяются к основной ветке без создания специального коммита слияния. Это перемещает коммиты из ветки с изменениями в конец целевой ветки, сохраняя линейную историю изменений.
  8. В правом верхнем углу нажмите кнопку с выбранным способом слияния.

Отклонить пул-реквест

  1. Откройте главную страницу SourceCraft.
  2. На вкладке Home перейдите в раздел Repositories.
  3. Выберите репозиторий.
  4. На странице репозитория в разделе Code перейдите в секцию Pull requests.
  5. Выберите пул-реквест.
  6. В правом верхнем углу нажмите кнопку и выберите Discard pull request.

См. также

Предыдущая
Создать пул-реквест
Следующая
Создать задачу (issue)