[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