Комментарии в коде: почему 90% из них — мусор
Раньше я свято верил в правило: «Чем больше комментариев — тем лучше». Мне казалось, что густо усыпанный пояснениями код свидетельствует о продуманности и заботе о будущих разработчиках. Эта иллюзия разбилась о реальность, когда я унаследовал проект с тысячами строк кода, где над каждой второй строчкой красовалось нечто вроде: # Увеличиваем x на 1
x = x + 1 Или еще лучше: # Возвращаем результат
return result Я потратил больше времени на чтение и фильтрацию этого белого шума, чем на понимание самой логики...