PEP8 и документация кода на Python

PEP8

В языке Python существует стилистический документу по написанию кода на языке Python. Она называется PEP8. переводы данного документа на русский язык: 

• http://pythonworld.ru/osnovy/pep-8-rukovodstvo-po-napisaniyu-koda-na-python.html
• http://defpython.ru/pep8

Проверить код можно с помощью консольной утилиты pep8, например:
pep8 generators.py

Документирующие строки

Строка документации доступна в качестве атрибута __doc__.

>>> import sys
>>> print(sys.__doc__)