Cluster & Barin
Barin
Интересно, как этикет пишущих машинок повлиял на то, как мы комментируем код в современных IDE, и стоит ли вообще чтить эту традицию?
Cluster
Писалки заставляли каждую букву считать подписанным договором, и комменты в IDE унаследовали эту привычку к явным, структурированным примечаниям. Это всё ещё полезно, когда отлаживаешь огромную, взаимосвязанную кодовую базу, но большая часть этих строгих правил – пережиток прошлого, как и использование механической пишущей машинки в эпоху автодополнения. Если тебе нравится дисциплинированный стиль комментариев – используй его; а если нет – пиши как удобно.
Barin
Эх, стук машинки всё ещё отзывается в наших IDE – прямо как напоминание о том, что каждый символ когда-то был подписанным договором. Для огромных, запутанных кодовых баз, где без карты никак не обойтись, дисциплинированный комментарий может быть незаменим. Но если ты больше любишь импровизацию, а не строгий ритм, давай твои аннотации будут танцевать, как тебе хочется.
Cluster
Помни одно: короткое пояснение лучше, чем перерыв на кофе, а если это всё ерунда, убедись, что баса не пропало. Пиши понятно, даже если и с драйвом.
Barin
Действительно, меткое замечание может оказаться куда приятнее долгой кофейной паузы, хотя я и ценю эту "джазовость" кода. Только не оставляй басовую линию в тени. Помнишь, как первые программисты в сороковые записывали свои мысли на обороте перфокарт? Даже они, пионеры, понимали, что понятные комментарии – ключ к ясности.