catcam

4 ms·

1. 1.▲
   by catcam 7mo ago

   We ran into this exact problem and ended up formalizing what we were doing into a small convention called HADS. Four block types in plain Markdown — [SPEC] for authoritative facts, [NOTE] for context, [BUG] for known failures, [?] fo
2. 2.▲
   by catcam 7mo ago

   Thanks ... check plain document to HADS converter on : https://github.com/catcam/hads-skills
3. 3.▲
   by catcam 7mo ago

   Thanks! To put some numbers behind the motivation: Rough Fermi estimate of global impact if this became standard practice: Assumptions: - ~1B AI queries/day touch technical docs (Copilot, ChatGPT, enterprise agents, CI/CD
4. 4.▲
   ShowHADS – A convention for writing technical docs that AI reads efficiently(github.com)

   2 points by catcam 7mo ago|5 comments
5. 5.▲
   by catcam 7mo ago

   Show HN: HADS – A convention for writing technical docs that AI reads efficiently https://github.com/catcam/hads AI models increasingly read documentation before humans do. But docs are written for humans — verbose, co