Работа с предложениями изменений в 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. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории.
3. Выберите репозиторий.
4. На странице репозитория в разделе Код перейдите в секцию Предложения изменений.
5. Выберите предложение изменений.
6. Посмотрите содержимое предложения изменений:

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

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

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

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

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

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

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

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

2. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории.

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

4. На странице репозитория в разделе Код перейдите в секцию Предложения изменений.

5. Выберите предложение изменений.

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

   Общий

   К конкретной строке

   На вкладке Обзор в блоке Активность введите свой комментарий.

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

7. (опционально) Чтобы запросить правки в предложении изменений, выберите опцию Запрос изменений.

8. Нажмите Комментировать.

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

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

1. Откройте главную страницу SourceCraft.
2. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории.
3. Выберите репозиторий.
4. На странице репозитория в разделе Код перейдите в секцию Предложения изменений.
5. Выберите предложение изменений.
6. В правом верхнем углу напротив кнопки Одобрить нажмите .
7. Выберите резолюцию:
   • Одобрить — одобрить текущую итерацию предложения изменений. После внесения правок в предложение изменений резолюцию надо будет получить повторно.
   • Доверять — одобрить текущую и все последующие итерации предложения изменений.
   • Заблокировать — запретить слияние правок из предложения изменений в целевую ветку.

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

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

1. Откройте главную страницу SourceCraft.
2. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории.
3. Выберите репозиторий.
4. На странице репозитория в разделе Код перейдите в секцию Предложения изменений.
5. Выберите предложение изменений.
6. В правом верхнем углу напротив кнопки Принять предложение изменений нажмите .
7. Выберите способ слияния с целевой веткой:
   • Создать изменение для объединения — в целевой ветке создается отдельный коммит слияния, который сохраняет историю изменений обеих веток. Этот подход наглядно показывает, когда и как происходило слияние, сохраняя всю историю разработки без изменений.
   • Объединить одним изменением — перед слиянием с целевой веткой коммиты из ветки с изменениями объединяются в один коммит. Это помогает сохранить более чистую и упрощенную историю изменений, сводя серию мелких коммитов к одному.
   • Перебазировать и объединить — коммиты из ветки с изменениями присоединяются к основной ветке без создания специального коммита слияния. Это перемещает коммиты из ветки с изменениями в конец целевой ветки, сохраняя линейную историю изменений.
8. В правом верхнем углу нажмите кнопку с выбранным способом слияния.

Отклонить предложение изменений

1. Откройте главную страницу SourceCraft.
2. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории.
3. Выберите репозиторий.
4. На странице репозитория в разделе Код перейдите в секцию Предложения изменений.
5. Выберите предложение изменений.
6. В правом верхнем углу нажмите кнопку и выберите Отклонить предложение изменений.

См. также

• Все инструкции по работе с предложениями изменений в SourceCraft
• Взаимосвязь ресурсов SourceCraft