Внешний вид кода
Есть такое понятие как PEP 8. Это специальный стандарт, правило хорошего тона, если хотите. Единый стиль оформления делает код понятным как для самого программиста, так и для его коллег с разным уровнем подготовки.
В идеале наиболее сложный фрагмент кода должен быть понятен с первого прочтения.
PEP 8 затрагивает следующие основные моменты:
▪️выбор кодировки исходного кода
▪️группировку инструкций по импорту модулей
▪️максимальную длину строки кода — рекомендуется до 79 знаков, а для строк документации (docstring) — 72 знака
▪️использование отступов — табуляции и пробелов
▪️использование пустых строк для разбивки кода на блоки и выделения функций верхнего уровня
▪️использование комментариев
▪️именование переменных, констант, классов и экземпляров, функций, аргументов, модулей, пакетов
▪️выбор уровня доступности классов и методов (public, private, API-подклассы), а также порядка их наследования.
Ссылка тут