Предложить изменения в репозитории SourceCraft

Предложение изменений — это запрос на интеграцию правок из одной ветки в другую, обычно в основную ветку проекта. Предложение изменений содержит описание правок, сравнение веток, обсуждение для ревью, а также может интегрироваться с CI/CD-процессами. Это облегчает командную работу и позволяет проверять и утверждать изменения по заданным правилам перед тем, как они будут добавлены в основной проект.

Чтобы создать предложение изменений:

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

2. На вкладке Домой:

   • Если вы работаете в своем личном репозитории — в секции Ваша мастерская перейдите в раздел Репозитории.
   • Если вы работаете в репозитории организации:
     1. Откройте раздел Организации и выберите организацию.
     2. В секции Мастерская перейдите в раздел Репозитории.

3. Выберите репозиторий для создания предложения изменений.

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

5. В правом верхнем углу нажмите Предложить изменения.

6. В списках источник и цель выберите ветки, которые вы хотите объединить.

7. Введите название предложения изменений.

8. (опционально) В разделе Описание подробно опишите, какие правки вносятся в предложении изменений.

   В описании и комментариях задач и предложений изменений поддерживаются краткие ссылки на другие задачи и предложения изменений. Такая запись автоматически преобразуется в гиперссылку, а при наведении указателя отображается карточка с краткой информацией. Используйте следующие форматы:

   • !<номер_предложения_изменений> — предложение изменений в текущем репозитории.
   • <слаг_репозитория>!<номер_предложения_изменений> — предложение изменений в другом репозитории текущей организации.
   • <слаг_организации>/<слаг_репозитория>!<номер_предложения_изменений> — предложение изменений в указанных организации и репозитории.
   • #<номер_задачи> — задача в текущем репозитории.
   • <слаг_репозитория>#<номер_задачи> — задача в другом репозитории текущей организации.
   • <слаг_организации>/<слаг_репозитория>#<номер_задачи> — задача в указанных организации и репозитории.

   Вы можете использовать Code Assistant для генерации описания, для этого нажмите Создать с помощью ИИ.

   Генерация описания может занять некоторое время.

   Совет

   Вы можете задать правила, по которым Code Assistant будет формировать описания, в файле AGENTS.md в корне репозитория.

9. (опционально) Посмотрите вносимые правки:

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

     Чтобы посмотреть изменения в формате «было — стало», нажмите .

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

   • На вкладке Изменения отображается история коммитов в ветке, изменения из которой вы хотите добавить.

10. (опционально) В блоке Рецензенты выберите пользователей, которые будут проверять предложение изменений.

11. Нажмите Опубликовать предложение изменений.

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

Создать предложение изменений из черновика

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

Полезные ссылки

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