New submission from Julien:

Hi,

Shouldn't Python use PEP8 in its examples in the documentation ? I found a lot 
of missing spaces around binary operators, and things like "setup (name = 
'PackageName'," (found in the Distributing section, but that's just a single 
example) which hurt my eyes and will probably teach bad practices to newcomers 
reading it.

If everybody agree documentation examples should be PEP8 compliant, I'll can 
gladly provide some patches.

I also found http://bugs.python.org/issue23921 which is probably not merged as 
it's still open, and the patch don't fix my example, so there is probably some 
problems left.

----------
assignee: docs@python
components: Documentation
messages: 257649
nosy: docs@python, sizeof
priority: normal
severity: normal
status: open
title: Use PEP8 in documentation examples
type: enhancement
versions: Python 3.5

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue26030>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to