[docs] [issue26030] Use PEP8 in documentation examples

Julien report at bugs.python.org
Wed Jan 6 17:06:04 EST 2016

New submission from Julien:


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 at python
components: Documentation
messages: 257649
nosy: docs at python, sizeof
priority: normal
severity: normal
status: open
title: Use PEP8 in documentation examples
type: enhancement
versions: Python 3.5

Python tracker <report at bugs.python.org>

More information about the docs mailing list