The Markdown Singularity: Why Generating HTML is a Dead End
How a single question from our Infrastructure Lead forced us to rewrite our documentation pipeline, abandon HTML, and accidentally create Flude.
Build in public: architecture notes, engineering decisions, and progress updates.
How a single question from our Infrastructure Lead forced us to rewrite our documentation pipeline, abandon HTML, and accidentally create Flude.
Why it's easier to rewrite AI code from scratch, how tests became our contract, and how to force the neural network to write its own checks.
How we tried to parse XML, why AI suddenly pulled in tree-sitter, and why control is more important than genius code.
How we tried to outsmart Doxygen, adapt its markup to our standards, and why it led us to build our own engine.
Why stacks like Doxygen+DoxyBook2+Hugo fall short on large projects, and how Flude solves the problem.