6
sugoi
6y

How many of you hate documentation and how many of you never skip it?

Comments
  • 1
    I love documentation and I hate it when I forgot to make a documentation.
  • 11
    Code should be self documenting, if it's not then you need to refactor it.

    Externally (an API page, GitHub, wiki pages, etc.) documentation is great (especially if people don't have access to source code).

    Important distinction there.
  • 1
    I love having it, I hate writing it, speaking of which, there’s goes my day tomorrow.
  • 3
    I love having it, well written documentation is like the Holy Grail to me. I've been trying to get better at writing my documents, or at least making better comments in my code. New rule for me is that at the beginning of each coding session I go back through what I wrote the previous day. I am not allowed to write any new code until the old code is documented. This way I never have more than 2-3 functions without comments/documentation.
  • 1
    I document whenever management makes me code something in a way that does not make sense for the user. I then write unit and ui tests around it. They can own the mess.
  • 2
    I just paste stuck overflow links in comment lines.
  • 1
    I'd love to do some documentation but wouldn't get paid to do it.
Add Comment