Discussion on "Comments are useful. You just need to learn when to use them"

Rodrigo · 2021-03-22T21:25:26.163Z

Perhaps you may have heard some of the following statements: "Code needs to be self-explanatory" "Comments are useless" "Don't write comments in your code" "Comments are a code-smell" "Comments are an anti-pattern" The thing is that writing commen...

Insightful information Rodrigo 👍🏻👍🏻👍🏻

Awesome article, my thought before writing a comment is always to write the "WHY" of the function with minimal "WHAT" it does.

Thanks!. What you do it's an excellent approach

"Occasionally you may find outdated comments in the code that can create confusion."

Why is that happening? Because one might update the code and not the comments?

Nevertheless, amazing article. Well done! 👍

You're right, that's the reason, I'll clarify that point in the article.

Thanks for the feedback Catalin :)

Excellent article, well thought-out! I'd like to stress a lot about justifying choices or explaining why there must be a workaround by providing a Stack Overflow thread of a GitHub issue. This saved me countless times from trying to mess up something believing that I could make it better or fix it.

You touched on an important point.

Sometimes, in our need to leave the code clean or optimal, we immediately change the original code for a better version, but sometimes, there is a reason behind that code and out of ignorance and not having a proper context, we end up changing it anyway.

Thank you, I'm glad you liked the article.

Rodrigo keep it up 🙌 !

Amazing Article Rodrigo!

I agree with you on this Rodrigo. Amazing article!

Discussion

Comments are useful. You just need to learn when to use them

Responses(7)

Recent discussions

Search Hashnode

Comments are useful. You just need to learn when to use them

Responses(7)

Recent discussions