Skip to Content Skip to Main Navigation

Why Developers Write Horrible Documentation

29th March 2013 Posted in Blog, Documentation, Technical Writers 3 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?

Please follow and like us:


  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.

  3. By Why You Should Become a Documentation Writer – 1on 7th, November 2018 at 1:31 pm

    […] it stands that the role is (and needs to be) distinct from that of a developer. Technical writer Jacquie Samuels believes that documentation requires content written from the user’s perspective, takes the […]

Leave a Reply