Which Doc Format Is Best for AI Specifications?
A developer converted 674 documents between AsciiDoc, Markdown, and HTML using Fable, and compared these formats for AI specifications.
I have a Spec Driven Project with 674 documents incl 181 specs, 429 tasks, and 40 project docs. About 1/3 of these are an acceptance sub-project to show the root project meets fit-for-purpose requirements. I used Fable to convert these to and from AsciiDoc, Markdown, and HTML. From this, I tried to draw some conclusions about which format is better than the others for AI specifications.