On Thu, Jan 16, 2014 at 5:35 AM, Renat Akhmerov rakhme...@mirantis.comwrote:
I absolutely agree with that. Honestly, I don’t even understand why it can
be different (not compliant with regular grammar rules). Comments are
supposed to clarify things so they should be worded very clearly and
I absolutely agree with that. Honestly, I don’t even understand why it can be
different (not compliant with regular grammar rules). Comments are supposed to
clarify things so they should be worded very clearly and read as normal English
sentences. Additionally it’s one of the small bricks that
Ned Batchelder had an interesting post a few days ago about why code
comments should be written as complete sentences, rather than fragments.
The main point is that with an unterminated phrase or sentence fragment it
isn't always clear that the thought has been completed (i.e., maybe the
full
On Tue, 2014-01-14 at 08:01 -0500, Doug Hellmann wrote:
Ned Batchelder had an interesting post a few days ago about why code
comments should be written as complete sentences, rather than
fragments. The main point is that with an unterminated phrase or
sentence fragment it isn't always clear