Документация

Проекты для предварительного просмотра и временных экспериментов

Временные проекты для экспериментов и среды предпросмотра для демонстрации работающих изменений.

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

Временные проекты

Временный проект — это обычный проект, который вы планируете удалить позже. Используйте его, чтобы опробовать Coroid на незнакомой кодовой базе, протестировать изменение политики перед широким применением или изучить подход, к которому вы не привязаны окончательно.

Главное преимущество — изоляция. Эксперименты во временном проекте не загрязняют историю задач, метрики или контекст проекта, на котором зависит ваша команда.

Удаляйте их, когда закончите работу. Если временный проект существует более шести месяцев, он незаметно превращается в реальный проект, без соответствующей настройки.

Среды предпросмотра

Предпросмотр — это ваша изменённая программа, уже запущенная, созданная на основе ветки, сформированной задачей.

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

Среды предпросмотра — это то, браузерные тесты запускаются против них, и то, что открывают рецензенты, когда скриншот не даёт однозначного ответа.

Как среды предпросмотра интегрируются в pull request

Если у вас уже есть среды предпросмотра — от провайдера хостинга или CI — Coroid может привязать их как доказательства рецензирования, поэтому ссылка отображается рядом с изменением, а не там, где её придётся искать.

Суть в том, чтобы доказательства проверки и код, который они подтверждают, поступали вместе.

Когда использовать то или иное

  • Опробование Coroid или подхода, который вы можете отбросить → временный проект
  • Проверка корректности конкретного изменения → среда предпросмотра

Они совместимы: во временном проекте могут быть среды предпросмотра, как и в любом другом.