Pull to refresh

Comments 3

Вся статья выглядит как "Смотря какой fabric, смотря сколько details"

Согласен, тоже поймал себя на этом, но такой набор терминов.. Лаконичнее и на слуху они всегда употребляются на английском.

Постановка задачи убедительная: ошибка не в модели, а в том, что репозиторий не отвечает на вопрос об authority. Но у декларативного слоя ровно та же болезнь, которую он лечит — строка «api.yaml is canonical» разойдется с реальностью так же тихо, как разошелся api.md, и вопрос «кто следит за самой моделью» вы задаете, но не закрываете. Надежнее не объявлять authority, а делать производное генерируемым: docs/api.md собирается из контракта, и расхождение становится невозможным по построению, а не проверяемым постфактум. Требует ли AIRepo, чтобы декларация authority сама валидировалась в CI, или это опять текст, за актуальность которого никто не отвечает?

Sign up to leave a comment.

Articles