A problem I’ve found with LLMs for docs is that they are like ten times too wordy. They want to document every path and edge case rather focusing on what really matters.

It can be addressed with prompting, but you have to fight this constantly.

I think probably my most common prompt is "Make it shorter. No more than ($x) (words|sentences|paragraphs)."