1. Используйте понятные комментарии:
# Плохой комментарий:
a = 10 # переменная
# Хороший комментарий:
max_users = 10 # Максимальное число пользователей
2. Комментируйте сложные алгоритмы
def factorial(n):
# Вычисляет факториал числа n рекурсивно
return 1 if n == 0 else n * factorial(n - 1)
3. Используйте docstrings для функций
def add(a, b):
"""Функция складывает два числа."""
return a + b