def programming


The proper use of comments is to compensate for our failure to express ourself in code.

When you feel the need to write a comment, first try to refactor the code so that any comment becomes superflous.

Good code is its own best documentation. As you're about to add a comment, ask yourself, "How can I improve the code so that this comment isn't needed?"

Code never lies, comments sometimes do.

Don't comment bad code ‐ rewrite it.

Built with using

Source code available @ githubpull requests are more than welcome ;-)