49

So true. But alas, my team doesn't believe in documenting code! 😢

Comments
  • 1
    Even after a few weeks for me and I'm like "Ugh what is this."
  • 1
    @Pseudonymous Good code in and of itself is capable of explaining what it does (with a few comments sprinkled here and there)
    It's the 'why' which needs a documentation. Why a functionality exists? Why this code deviates from established patterns, etc.
    Writing comments which are obvious by reading the code itself simply creates clutter.
Add Comment