Буквально сегодня было. Разбираю древний модуль. там какой-то наркоманский массив. Начинаю разбираться почему он такой наркоманский и зачем он нужен. Дохожу до комментария //нахуя этот массив???
В другом месте тоже наследие индусского кода: //нельзя так делать, но пока будет так. И это "пока" тянется с 2002 года.
Если нет адекватного начальства и правил работы с кодом, то комментировать сам себя приучишь: каждый сталкивается с тем, что приходится переписывать/разбирать СВОЙ старый код. Вот тогда и понимаешь всю ценность комментариев.
Иди посмотри топовые опенсорсные проекты, какой-нибудь V8 или что-то от яндекса. Там 40% кода это комментарии. Иногда сложность проекта такая, что без них не обойтись.
Все комментарии там - JavaDoc. Документируются интерфейсы и API, что экспоузится. Я работаю в софтверной компании в США, на позиции тимлида с опытом более 15 лет работы. И если у меня в команде появится необходимость писать комментарии - следует задуматься о профессионализме команды и архитектуре.
А Яндекс для меня вообще не показатель, шарашкина контора с говнокодерами
<4
I Главная По Дому
в сети
□о
Сегодня
Здравствуйте , Ангелина, на вашу квартиру поступила вторая жалоба. Шумы из квартиры.
Скулит собака. Видимо одну оставляете дома и собака скучает. Устраните пожалуйста проблему
Здравствуйте, у меня нет собаки
Это я изучаю java script ^
В другом месте тоже наследие индусского кода: //нельзя так делать, но пока будет так. И это "пока" тянется с 2002 года.
Если нет адекватного начальства и правил работы с кодом, то комментировать сам себя приучишь: каждый сталкивается с тем, что приходится переписывать/разбирать СВОЙ старый код. Вот тогда и понимаешь всю ценность комментариев.
А Яндекс для меня вообще не показатель, шарашкина контора с говнокодерами
Это нос!
И это морда.
Еще это начало. Еще это черный. Еще это животное. Еще это питомец.