While I agree to an extent, I think it's not ideal. The point of documentation in my opinion is to explain intent. If want to figure out the functionality of something the code is just as good as documentation, arguably better.
AI ,because by default only sees the code, in general describes the functionality not the intent behind the code.
> The point of documentation in my opinion is to explain intent.
Of course, that's what your tests are for: To document your intent, while providing a mechanism by which to warn future developers if your intent is ever violated as the codebase changes. So the information is there. It's just a question of which language you want to read it in.
"Updating docs" seems pointless, though. LLMs can translate in realtime, and presumably LLMs will get better at it with time, so caching the results of older models is not particularly desirable.
AI ,because by default only sees the code, in general describes the functionality not the intent behind the code.