Why Developers Write Horrible Documentation
While you might expect developers to get stuck with writing the documentation in a smaller or newer organization, even an established company can end up with developer-written documentation.
It’s not that developers don’t write well or can’t write documentation. They certainly could…if they weren’t developing the product. The problem is that developers are too close to their product.
Jacquie Samuels discusses this dilemma in her article, Why Developers Write Horrible Documentation.
Read the article and then leave a comment here. What has been your experience with developer-written documentation?