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 Published |

    Pretty much, yes. 😉

  2. Lisa
    Lisa Published |

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

  3. Jim Gaudet
    Jim Gaudet Published |

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

  4. mp
    mp Published |

    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.

  5. Marlon Amancio
    Marlon Amancio Published |


  6. Ashley
    Ashley Published |

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

    Better bad than nothing.

  7. John Currie
    John Currie Published |

    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.

  8. Kane
    Kane Published |

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

Comments are closed.