from Hacker News

Ask HN: Is it time to start optimizing documentation for machines?

by dandrew5 on 10/1/24, 1:43 PM with 2 comments

The more I lean into LLMs for my daily job, the less I find myself reading published documentation. A lot of time has historically been put into having really good, human-readable docs but I'm wondering if that will shift. If a service's documentation was written in a way optimized for training, what might it look like?

  • by JohnFen on 10/1/24, 2:28 PM

    > A lot of time has historically been put into having really good, human-readable docs but I'm wondering if that will shift.

    I hope not. The state of documentation in general is already distressing. Making it even less aimed at people can only make it worse.

    We shouldn't be worsening things in order to cater to LLMs. LLMs, if there is even a kernel of truth in all the hype, should be able to make good use of human-centered documentation.