erusev/parsedown — pull request #65 by hkdobrev (2014-01-23 22:50:26+00:00)
Title: Use imperative tense in comments

There are number of styleguides, recommendations and suggestions about
formatting and wording of the comments in your code.

One of the "rules" which seems quite common is the usage of present
imperative tense instead of third-person.

Here are some of the resources I've just found:
- http://luisespinal.wordpress.com/2012/01/02/rules-for-commenting-code-revisited-v2/
- http://stackoverflow.com/questions/8910214/comment-style-imperative-or-third-person
- http://www.hongkiat.com/blog/source-code-comment-styling-tips/
- http://luisespinal.wordpress.com/2011/03/11/simple-rules-on-commenting-code/
- http://www.devtopics.com/13-tips-to-comment-your-code/

Also there is a similar recommendation for commits messages (which serve similar purpose):
- http://programmers.stackexchange.com/questions/157590/why-is-it-preferred-to-write-a-commit-message-in-present-tense-imperative-mood
- http://programmers.stackexchange.com/questions/56031/version-control-comments-past-or-present-tense
- http://stackoverflow.com/questions/3580013/should-i-use-past-or-present-tense-in-git-commit-messages

My personal argument are:
- It is shorter.
- It sounds like programming without the programming language. Imagine writing the comments first. You would definitely write them in imperative form.