Skip to content

Процесс авторинга

Рекомендуемый workflow намеренно простой:

text
init -> generate -> validate --strict -> test -> handoff

Что означает каждый шаг

ШагНазначение
initСоздать package-standard layout проекта
generateСгенерировать target artifacts из исходного состояния проекта
validate --strictЗапустить главную проверку готовности
testЗапустить стабильные smoke-тесты там, где это применимо
export / bundle flowВыпустить handoff artifacts для поддерживаемых Python и Node сценариев

Правила, которые держат repo здоровым

  • исходное состояние проекта живёт в package-standard layout
  • generated target files — это outputs, а не долгосрочный source of truth
  • strict validation — это обязательная проверка, а не необязательная опция

Этот workflow одинаково важен и для single-target, и для multi-target repo.

Разница только в том, что в multi-target проекте цикл generate и validate повторяется для каждого target’а, который repo действительно обещает поддерживать.

Когда workflow меняется

Workflow может расширяться в специальных случаях:

  • doctor и bootstrap важны для Python и Node runtime-путей
  • import и normalize важны, когда нужно собрать вручную поддерживаемые target files обратно в управляемую модель проекта
  • bundle commands важны для portable Python и Node handoff flows

Начинайте с Быстрого старта, если нужен самый короткий путь.

Публичная документация для авторов плагинов и интеграторов.