Готовый перевод Style Guide for Python Code: A Foolish Consistency is the Hobgoblin of Little Minds

Один из принципов Гвидо - код читается намного чаще, чем пишется.

Рекомендации приведенные здесь призваны улучшить удобочитаемость кода и сделать его совместимым с широким спектром Python кода.

Как написано в PEP 20, "Читаемость имеет значение".

Руководство про согласованность.

Согласованность с руководством - важна.

Согласованность в рамках проекта - ещё важнее.

Согласованность в рамках функции или модуля - наиболее важно.

Но самое важное: когда не будет согласовываться знать -- иногда руководство просто не применимо.

Когда сомневаетесь, используйте ваше лучшее суждение.

Смотрите на другие примеры и решите которое выглядит лучше.

И не стесняйтесь спрашивать!

Две хороших причины нарушить определённое правило:

1. Если применение правила сделает код менее читаемым, даже для кого-то, кто привык читать код следующий правилам.

2. Что бы быть согласованным с окружающим кодом, который также нарушает их (возможно по историческим причинам) -- хотя это также удобный случай подчистить чей-то ещё беспорядок (в истинном стиле XP).

Переведено на Нотабеноиде
http://notabenoid.org/book/1336/5345

Переводчики: Guria, sevenov, 2tl, rnd0011