Как не надо строить документацию: история одного парсера 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 заставил нас чинить призрака
Что делать, если парсер генерирует документацию для класса, которого не может найти глобальный текстовый поиск по всему репозиторию? История одной ложной паники.
Побег из облака: как пять репозиториев перестали делить один лимит минут
Поскольку проект состоял из пяти репозиториев, каждый из них обзавёлся своей собственной CI. Красиво архитектурно — и дорого по минутам GitHub Actions. Подняли свою Windows-машину с одним раннером на всех пятерых — и написали для него сторожа, которому предстояло с треском провалиться меньше чем через сутки.
Рост на пять репозиториев: gitlink'и и дублирующийся CI
Как архитектура из нескольких репозиториев обернулась ловушками `not our ref` в Git и необходимостью тестировать ядро в двух параллельных реальностях.
Призрак в проводе: как мы два дня искали сетевой баг, которого не существовало
Раннер падал каждые две с половиной минуты, а job для одного репозитория не мог запуститься больше суток. Мы искали сетевой баг — с захватом пакетов и дампом памяти в WinDbg. Настоящая причина оказалась в одной строке фильтра API и логике watchdog'а.
Clean Room: рефакторинг, который решал не архитектурный вопрос
Разбираемся, почему разделение одного семейства рендереров на отдельный приватный плагин было ответом не на архитектурный зуд, а на юридический вопрос.