Некоторые рекомендации по написанию комментариев в PEP8:

• Комментарии должны быть законченными предложениями. 1 Первое слово должно быть написано с большой буквы, если только это не имя переменной, которая начинается с маленькой буквы. 1 Если комментарий короткий, можно опустить точку в конце предложения. 1
• Ставить два пробела после точки в комментариях, кроме последнего предложения. 2
• Блочные комментарии объясняют следующий за ними участок кода. 2 Выравнивать их на том же уровне и начинать каждую строку с # и пробела. 2 Параграфы в блочных комментариях разделяются строкой с одной #. 2
• Не злоупотреблять комментариями на той же строке (внутренними). 2 Они не должны объяснять очевидных вещей и затруднять чтение кода. 2 Отделять их от текста как минимум двумя пробелами и начинать с # и пробела. 2
• Ограничить длину строки комментариев и документации 72 символами. 4
• Обновлять комментарии при изменении кода. 4