Декомпозиция Pipeline: от симлинк-хака до пяти независимых деплоев
Как мы за один присест распутали монорепозиторий из пяти репозиториев — и чему нас научил единственный на весь аккаунт Cloudflare-токен.
Тег: architecture
Типизированные модели: как мы перестали молча терять данные
Старая универсальная модель хранила данные как бесформенные строки, что приводило к тихим потерям информации. Мы переписали ядро на строгие типы, заменив тихую деградацию на громкие ошибки валидации.
Developer Guides: мы отказались не от гайдов, а от Flude в них — и передумали
Мёртвые кросс-ссылки между рукописными гайдами и страницами автосгенерированного API быстро объяснили, почему решение вести гайды в стороне от Flude, чистым Markdown, было ошибкой.
Сингулярность Markdown: Почему генерация HTML — это тупик
Как один вопрос от Infrastructure Lead заставил нас переписать пайплайн документации, отказаться от HTML и случайно создать Flude.
TDD как поводок для нейросети: пишем тесты, не зная языка
Почему проще переписать ИИ-код с нуля, как тесты стали нашим контрактом и как заставить нейросеть саму писать для себя проверки.
Программирование без знания языка: как ИИ уволил Doxygen
Как мы пытались парсить XML, почему ИИ внезапно потянул за собой tree-sitter и почему контроль важнее гениального кода.
Как не надо строить документацию: история одного парсера HTML
Как мы пытались обмануть Doxygen, переделать его разметку под наши стандарты и почему это привело нас к созданию собственного движка.
Flude: От исходного кода к качественной документации
Почему связки вроде Doxygen+DoxyBook2+Hugo не справляются с большими проектами, и как Flude решает эту проблему.