Documentation

Documentation is like sex: when it is good, it is very, very good; and when it is bad, it is better than nothing.

9 Responses

  1. Andrea_R
    Andrea_R August 15, 2011 at 6:00 pm |

    Pretty much, yes. ;)

    Reply
  2. Lisa
    Lisa August 15, 2011 at 7:50 pm |

    …and when its non-existent, you rely on your own devices.

    Reply
  3. Jim Gaudet
    Jim Gaudet August 16, 2011 at 9:02 pm |

    This is just great! Where’s the share options, making me do it manually?

    Reply
  4. mp
    mp August 19, 2011 at 11:50 am |

    I’ll agree – it’s exactly like sex – but, having been married – my reasoning differs somewhat:

    My experience is that when it is “good” – It was produced by marketing – and doesn’t represent the actual product, which, upon closer-inspection is SO covered with “makeup” that you can’t see its obvious flaws and comprehend its irreconcilable inconsistencies, nor the irresponsible behavior of its provider…

    And when it is “bad” – At least, habitually so – Eventually, there’s going to be a room full of lawyers, a judge, and a lot of lying involved.

    Reply
  5. Marlon Amancio
    Marlon Amancio August 25, 2011 at 3:52 pm |

    LOL!

    Reply
  6. Ashley
    Ashley September 7, 2011 at 12:15 pm |

    Applying it makes you a better performer. As well as writing, as time goes on, you’ll improve.

    Better bad than nothing.

    Reply
  7. John Currie
    John Currie October 1, 2011 at 2:14 am |

    Bad documentation is a curse because the average dimwit believes anything that is written, be on paper or a website.

    Personally I don’t believe one can have “bad” sex… Any sex is good sex.

    Reply
  8. Kane
    Kane November 6, 2011 at 2:48 am |

    It’s funny, pizza and documentation have that in common…

    Reply

Leave a Reply

By submitting a comment here you grant this site a perpetual license to reproduce your words and name/Web site in attribution.

Please use your real name or a pseudonym (i.e., pen name, alias, nom de plume) when commenting. If you add your site name, company name, or something completely random, I'll likely change it to whatever I want.