[openstack-dev] writing comments as complete sentences
Jay Pipes
jaypipes at gmail.com
Tue Jan 14 14:00:27 UTC 2014
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 that the thought has been
> completed (i.e., maybe the full comment isn't even present in the
> code).
# Supported.
-jay
More information about the OpenStack-dev
mailing list