Comments by "Lee Rothman" (@leesoftwareengineer) on "DON'T Comment Your Code" video.

  1. I do like his quote ‘comments are a failure in expressing your intent with code’.
    3
  2. That’s on code already written. He’s not saying remove old comments on hard to understand badly written code in legacy applications. Don’t use comments on new code, write clean easy to understand code not tomorrow’s legacy code.
    2
  3. Totally agree. I can probably use the fingers on one hand to count the amount of times I’ve used a comment in the last 10 years or so. Funnily enough that’s about the same I’ve been practicing clean code & TDD.
    1
  4. Maybe those details should be linked to the story that it was committed against?
    1
  5.  @alexaneals8194 I’d say it was common practice to link every commit to a work item so it’s easy to find with your version control tool and work planning tool? If you want to know what specific scenario a piece of code was covering then your well named unit test will tell you that. You do write tests don’t you?
    1