I hate the "code should be self-explanatory so no comments" thing. I love comments. However, *how many* comments also depends on the language - in Elixir I write less because I feel it's expressive. I would write a ton of comments in C or a new language.
-
-
So with the exception of open source code that is widely used and also very well maintained+evolved+released, I recommend to ditch those nasty comments and work out your clarity in code skills.
-
In my experience companies have proportionally the same amount of newcomers to code that open source does. Maintaining comments is part of the job. I believe that if you strike the right balance of comments, it's not hard to keep them relevant.
End of conversation
New conversation -
-
-
There usually aren’t enough domain knowledge comments or enough comments with links to research (a point I first heard from Joe Armstrong)...the research is the part that takes the longest! The code is practically the easy part.
Thanks. Twitter will use this to make your timeline better. UndoUndo
-
-
-
Depends on what is put in a comments. Partially describing business logic here and there won't work -they can't replace proper project documentation. Also there is a maintenance cost that comes with them.
Thanks. Twitter will use this to make your timeline better. UndoUndo
-
-
-
Also there is a saying about people who think they will somehow manage to express themselves clearly in comments when the can’t do so with their code.
Thanks. Twitter will use this to make your timeline better. UndoUndo
-
-
-
They do hurt. Not by essence but by negligence golf the people who come, quickly change the function and leave, without updating the comment. It is unavoidable unless you put in place an expensive review process.
Thanks. Twitter will use this to make your timeline better. UndoUndo
-
-
-
In some project i think also that the same rule aplly for design, like 'design is self explicatory' but indeed is not :)
Thanks. Twitter will use this to make your timeline better. UndoUndo
-
Loading seems to be taking a while.
Twitter may be over capacity or experiencing a momentary hiccup. Try again or visit Twitter Status for more information.
