Процесс авторинга
Рекомендуемый 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
Начинайте с Быстрого старта, если нужен самый короткий путь.