Abhorrently bad take and misses the biggest reason that documentation usually is a second class citizen, and that is because your code is law, and code and test

Abhorrently bad take and misses the biggest reason that documentation usually is a second class citizen, and that is because your code is law, and code and tests are coupled, while documentation is not (thats why there is such huge push for autogeneration). Even code comments are considered a code smell because they are not part of CICD process. The way they describe documentation here reads more like a feature story and not being able to fully complete a spec, which is a tangential problem. For LLM aspect - My take is the better approach is similar context enrichment for rag - you ask the LLM to generate a summary for a page, and that can easily be cached against a digest/hash for any code changes - and will always be up to date.