No kidding. I don't know how many time I've tweaked my code after starting to write some docs (docstrings/JavaDoc/etc.) and realizing that my abstraction bound

No kidding. I don't know how many time I've tweaked my code after starting to write some docs (docstrings/JavaDoc/etc.) and realizing that my abstraction boundaries were wrong. If writing those docs were somebody else's problem, my code would have been crap. This is after 10+ years in industry. On the other hand, end-user documentation can be a lot of really tedious screenshotting in some markets, and it can't always be automated.