Learn More
Resend Email
39
Top advice you'd give to a new dev?
Week 26 Group Rant
Lokuzt
10y

Please don't comment in front of the code like this:

doSomething(); // does something

Please just stahp

Do this:

// does something
doSomething();

Much better and friendly for everyone

undefined

wk26

commenting

code
Favorite
Ranter
Comments
  • 0
    10y
    @filthyranter if it's that short on a short file yeah. Large apps with big lines of code and huge amounts of code do not benefit of this
  • 0
    10y
    Is that a bad practice? I always do this if the comment is short. And it can show up in the search result in case I have to do a global search.
  • 2
    10y
    Seriously that's just an opinion. With no logic driven reason. There are more advantages to using it, just like seeing it in search results.
  • 0
    10y
    Or better yet: Don't write the comment at all. If you named your function correctly that comment is completely not necessary.
  • 0
    10y
    I do this for short comments.
    However like someone mentioned about longer comments, I prefer multiple lines of comment, each line with roughly 7 words. easy to scan through and does not mess with the flow of the code :)
  • 1
    10y
    I do this when I am trying to comment if/else if/else blocks

    if () { // do stuff
    ...
    } else if () { // do other stuff
    ...
    } else { // do other stuff
    ...
    }
  • 0
    10y
    @deusprogrammer I can't imagine commenting if/else statements any other way!
  • 0
    10y
    I wouldn't generalize this both is ok under the right circumstances
Related Rants
devRant © 2021 Hexical Labs LLC
Privacy Policy  |  Terms of Service
Add Comment