[openstack-dev] Hacking and PEP 257: Extra blank line at end of multi-line docstring

Kevin L. Mitchell kevin.mitchell at rackspace.com
Tue Feb 25 23:18:05 UTC 2014


On Tue, 2014-02-25 at 00:56 +0000, Ziad Sawalha wrote:
> Seeking some clarification on the OpenStack hacking guidelines for
> multi-string docstrings. 
> 
> 
> Q: In OpenStack projects, is a blank line before the triple closing
> quotes recommended (and therefore optional - this is what PEP-257
> seems to suggest), required, or explicitly rejected (which could be
> one way to interpret the hacking guidelines since they omit the blank
> line).


I lobbied to relax that restriction, because I happen to use Emacs, and
know that that limitation no longer exists with Emacs.  I submitted the
change that eliminated that language from nova's HACKING at the time…
-- 
Kevin L. Mitchell <kevin.mitchell at rackspace.com>
Rackspace




More information about the OpenStack-dev mailing list