Incidentally, I just spent some time yesterday with Gemini and Grok writing a first draft of docs for a complex codebase. The end result is far more useful and complete than anything I could have possibly produced without AI in the same amount of time, and I didn't even have to learn Mermaid syntax to fill the docs with helpful visual aids.
Of course it's a collaborative process — you can't just tell it to document the code with no other information and expect it to one-shot exactly what you wanted — but I find that documentation is actually a major strength of LLMs.
Of course it's a collaborative process — you can't just tell it to document the code with no other information and expect it to one-shot exactly what you wanted — but I find that documentation is actually a major strength of LLMs.