Skip to Content Skip to Main Navigation

Why Developers Write Horrible Documentation

29th March 2013 Posted in Blog, Documentation, Technical Writers 2 Comments


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?


  1. By judy lapalmeon 20th, March 2018 at 9:00 am

    the link is broken – I cannot see the article – it loops back here each time.

  2. By WAI_editoron 20th, March 2018 at 9:44 am

    Sorry about that, Judy. Thanks for bringing it to our attention. Links have been updated.

Leave a Reply