Indeed, the documentation (diagrams/text with particular layout and formatting) should abstract a lot of what the code does. Otherwise, what's the point since t

Indeed, the documentation (diagrams/text with particular layout and formatting) should abstract a lot of what the code does. Otherwise, what's the point since the code is there for you to read. In my experience, auto-generated documentation in general does a poor job. That said, such automation is improving by virtue of better AI, that understands and cross translates people's languages and computer languages.