News for hackers. Stuff that matters.
Re:Flow vs. Typescript by seanwilson on Monday June 06, 2016 @07:38AM (#11845968)
> That's a very common position, but my experience shows me if the comments are not in line with the code that is usually a very good hint that the code will be buggy.

An example might help but to me bad code is code that repeats itself which includes comments. To me, comments should only be used for high level explanations (e.g. architecture, algorithms, public API) and when the purpose of code is non obvious (e.g. weird bug workarounds, optimisations). The vast majority of comments can be removed by rolling their contents into better function and variable names.

There are no comments on this comment yet.