[issue17966] Lack of consistency in PEP 8 -- Style Guide for Python Code

2013-05-12 Thread Paul Jurczak 

New submission from Paul Jurczak:

This may be too subjective, but here it goes:

PEP 8 discourages vertical alignment: "More than one space around an assignment 
(or other) operator to align it with another", but contrary to this rule, 
vertical alignment is used many times in the same paragraph, e.g.:
Yes: spam(1)
No:  spam (1)
If vertical alignment is so evil, the above should be changed to:
Yes: spam(1)
No: spam (1)

Disclosure: I use vertical alignment in my code quite often.

http://www.python.org/dev/peps/pep-0008/

--
assignee: docs@python
components: Documentation
messages: 189093
nosy: docs@python, pauljurczak
priority: normal
severity: normal
status: open
title: Lack of consistency in PEP 8 -- Style Guide for Python Code
type: enhancement
versions: Python 2.7, Python 3.3

___
Python tracker 
<http://bugs.python.org/issue17966>
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue17966] Lack of consistency in PEP 8 -- Style Guide for Python Code

2013-05-13 Thread Paul Jurczak 

Paul Jurczak added the comment:

Correct, it is in mixed prose and code. However, the underlying principle in 
this PEP is: "guidelines provided here are intended to improve the readability 
of code". The author used vertical alignment (for mixed prose and code), 
because of its superior readability. Many others had found that aligning long 
columns of data improves readability, from newsprint and spreadsheets to 
multiple assignment statements.

--

___
Python tracker 
<http://bugs.python.org/issue17966>
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue17966] Lack of consistency in PEP 8 -- Style Guide for Python Code

2013-05-13 Thread Paul Jurczak 

Paul Jurczak added the comment:

I admit, it is somewhat silly, but not entirely silly.

--

___
Python tracker 
<http://bugs.python.org/issue17966>
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com