Задача pull request из Coroid проходит верификацию ещё до того, как вы её увидите. В этом разделе рассказывается, что это значит и как настроить процесс.
Уровни
Верификация — это не одно действие. Выполняется четыре уровня, каждый из которых отвечает на свой вопрос.
Ваш набор тестов. Это самый надёжный сигнал, так как он уже отражает то, что важно для вашей команды. Coroid запускает его в чистом рабочем пространстве для каждой задачи.
Правила качества. Проверки, заданные политикой — покрытие кода, линтинг, сканирование безопасности, браузерные тесты. Блокирующие правила останавливают выполнение задачи; рекомендательные правила фиксируют находки и позволяют продолжить работу. Подробнее о Политики и правила качества.
Рецензирование. Агент-рецензент анализирует готовый дифф и формирует замечания. Исправляемые замечания возвращаются разработчику на доработку; остальные прикрепляются к объекту pull request.
Доказательства. Предварительные деплои, результаты сканирования и изменения в покрытии кода прикрепляются непосредственно к объекту pull request, поэтому верификация поступает вместе с кодом. Узнайте больше о Доказательства для рецензирования.
Что подтверждает и что не подтверждает этот процесс
Верификация подтверждает, что изменение делает то, что заявлено, не нарушает существующую функциональность и соответствует установленным стандартам.
Она подтверждает, но не подтверждает, что данное изменение — правильное решение для разработки. Именно для этого существуют критерии приемки в спецификации и для этого предназначено ваше рецензирование.
Изменение может пройти все уровни проверки и при этом оказаться ошибочным. Чёткое соблюдение этого различия обеспечивает доверие ко всей системе — как только верификация начинает восприниматься как окончательное суждение, люди перестают проводить рецензирование.
Зачем запускать проверки заранее
Каждый уровень проверяется ещё до создания объекта pull request, поэтому ошибки возвращаются на доработку в рамках одного выполнения, а не как отклонённая задача pull request.
Ошибка в рабочем пространстве стоит дешевле, чем ошибка, обнаруженная в интерфейсе. Ваше рецензирование должно стать первым человеческим взглядом, а не первым просмотром.
С чего начать
Если вы настраиваете этот процесс впервые:
- Убедитесь, что ваш набор тестов запускается корректно — см. Настройка сборки и тестирования. Если с этим что-то не так, всё остальное не имеет значения.
- Установите стандартную политику организации на уровне стандарта , а не на самом строгом уровне.
- Подключите уже используемые вами поставщики доказательств.
- Добавляйте правила по одному, сначала рекомендательные.