News for hackers. Stuff that matters.
Re:Show HN: Treedocs: Documentation that automatically check... by gritzko on Tuesday June 23, 2026 @11:56AM (#48647040)
The question is who maintains it. I think, LLM is the only practical option. In my agent rules, I tell it to maintain INDEX.md on each level. That takes 1 line of instruction and starting with an example file. Then, it self-maintains.
Re:Show HN: Treedocs: Documentation that automatically check... by DandyLyons on Tuesday June 23, 2026 @01:17PM (#48648163)
In practice, the LLM, treedocs and I all work together to maintain it. treedocs finds missing and extra paths, and missing descriptions. The LLM writes descriptions. git makes sure I never forget to run treedocs sync. And I always have the ability to easily correct incorrect descriptions by the LLM, or add my own special instructions.

Sure the LLM can do all of that but it's a waste of a lot of tokens, and in my experience it often makes incorrect assumptions or doesn't realize certain details.