Домен: buttondown.email ¹

Люди говорят «комментируйте, почему, а не что», идея состоит в том, что код должен быть самодокументированным, а комментарии должны быть только последним средством для объяснения вещей. Комментарии могут рассинхронизироваться, но код всегда остается кодом, поэтому нет необходимости в ненужной избыточности.

Я не согласен: независимо от того, насколько самодокументированный код, комментарии очень помогают в понимании вещей…