Как не надо строить документацию: история одного парсера HTML
Как мы пытались обмануть Doxygen, переделать его разметку под наши стандарты и почему это привело нас к созданию собственного движка.
Engineering Drama: Эволюция Flude
Как Flude вырос из одноразового скрипта в самостоятельный движок документации — по одной архитектурной ошибке за эпизод.
Программирование без знания языка: как ИИ уволил Doxygen
Как мы пытались парсить XML, почему ИИ внезапно потянул за собой tree-sitter и почему контроль важнее гениального кода.
TDD как поводок для нейросети: пишем тесты, не зная языка
Почему проще переписать ИИ-код с нуля, как тесты стали нашим контрактом и как заставить нейросеть саму писать для себя проверки.
Сингулярность Markdown: Почему генерация HTML — это тупик
Как один вопрос от Infrastructure Lead заставил нас переписать пайплайн документации, отказаться от HTML и случайно создать Flude.
Партизанский DevOps: Как мы сбежали на GitHub Actions
Корпоративная инфраструктура, отпуска коллег и медленные инструменты заставили нас построить независимый CI/CD пайплайн. Рассказываю, как ИИ помог освоить YAML за пару вечеров.
Регрессионное тестирование: Как доказать, что твой код не теряет данные
Написать быстрый генератор документации — это весело. Легализовать его в кровавом энтерпрайзе — та еще задача. Рассказываю, как мы доказывали надежность Flude, сравнивая его со старым стандартом.
Developer Guides: мы отказались не от гайдов, а от Flude в них — и передумали
Мёртвые кросс-ссылки между рукописными гайдами и страницами автосгенерированного API быстро объяснили, почему решение вести гайды в стороне от Flude, чистым Markdown, было ошибкой.
Типизированные модели: как мы перестали молча терять данные
Старая универсальная модель хранила данные как бесформенные строки, что приводило к тихим потерям информации. Мы переписали ядро на строгие типы, заменив тихую деградацию на громкие ошибки валидации.
Пасхалка «if not 0:»: как автономный ИИ-аудит поймал мёртвый код в оркестраторе
Никакой драмы с падением прода — только курьёзная и показательная находка. Прогнали автономный ИИ-аудит по ядру движка и наткнулись на условие, которое гарантированно выполняется всегда.
Декомпозиция Pipeline: от симлинк-хака до пяти независимых деплоев
Как мы за один присест распутали монорепозиторий из пяти репозиториев — и чему нас научил единственный на весь аккаунт Cloudflare-токен.
Flude.guide: имя, которое пришлось искать между Udemy, дебаггером и nude.com
Рабочее название движка оказалось занято брендом отладчика микроконтроллеров. Мы перебирали короткие варианты с подстрокой ude, одновременно оценивая благозвучие, чистоту и продвигаемость.
Иллюзия скорости: двухуровневый кэш, который не может ускорить то, что не умеет Doxygen
Каждая пересборка гоняла Doxygen и парсинг XML заново, даже если ничего не изменилось. Двухуровневый кэш на двух отпечатках эту боль снял. Но название неслучайно с подвохом: реальную скорость он дать не может, потому что кэшировать умеет только то, что вообще можно пропустить целиком.
Утечка, которая не умирает: Как сборщик мусора Python предал нас
Трижды наш сервер падал от нехватки дискового пространства. История о том, почему нельзя делегировать управление файлами Garbage Collector'у.
Фантом, которого не было: Как ненадёжный grep заставил нас чинить призрака
Что делать, если парсер генерирует документацию для класса, которого не может найти глобальный текстовый поиск по всему репозиторию? История одной ложной паники.