In Kislay Verma’s excellent post Why programmers don’t write documentation (April 29, 2021), he writes:
Software engineers, like everyone else, don’t write because writing clearly is very, VERY difficult.
I find this both amusing and scary. If writing documentation clearly is very VERY difficult then doesn’t this imply that writing code clearly is also very difficult?
And there we have it. If you can’t write documentation clearly, I suspect your code is equally unclear, which is exactly my experience.
Marc Clifton 