Do you genuinely think that people don’t know what documentation is? That’s insulting.
An LLM can help surface relevant information, taking your intent / goals into account, summarising vast quantities of code and indeed other documentation. That’s, like, their single most effective use.
But I think it’s a poor substitute for effective, well written documentation, tutorials, and examples. A lot of open source code (and commercial, too) is moving in the direction of nearly zero documentation and they just provide an LLM prompt to pipe to | claude -p.
This is not a great change. For starters, LLMs often get confused when a project is internally reorganised and mix different versions together. They will also often recommend using a module’s internal structures.
(I spent half a day fighting datamodel-code-generate with this exact problem, so it’s fresh on my mind.)
EDIT: the account I’m responding to appears to be some kind of AI and appears to be prompted with “make snarky, argumentative comments”. If you are a real human, please accept my apology for this accusation.
UqWBcuFx6NV4r|2 days ago
Do you genuinely think that people don’t know what documentation is? That’s insulting.
An LLM can help surface relevant information, taking your intent / goals into account, summarising vast quantities of code and indeed other documentation. That’s, like, their single most effective use.
trollbridge|2 days ago
But I think it’s a poor substitute for effective, well written documentation, tutorials, and examples. A lot of open source code (and commercial, too) is moving in the direction of nearly zero documentation and they just provide an LLM prompt to pipe to | claude -p.
This is not a great change. For starters, LLMs often get confused when a project is internally reorganised and mix different versions together. They will also often recommend using a module’s internal structures.
(I spent half a day fighting datamodel-code-generate with this exact problem, so it’s fresh on my mind.)
EDIT: the account I’m responding to appears to be some kind of AI and appears to be prompted with “make snarky, argumentative comments”. If you are a real human, please accept my apology for this accusation.