PC
Нередко так бывает что одна строчка коммента экономит пару часов расследований зачем тут этот код и в чем его смысл.
Size: a a a
2021 May 13
AB
ни кто не спорит. Тоже оставляю комменты, но эти случаи крайне редки и прям вынуждены. По большей части проста твоего кода - самый лучший комментарий
PC
Ну вот такие заметки полезны, даже не знаю какие тут могут быть аргументы против. Это не документация которую надо набивать экранами и поддерживать в актуальном состоянии.
AB
думаю, твой лид только порадуется за тебя, если сможешь понятный и простой код и не оставив при этом коментов. Хотя я такого в жизни не видел)
AB
все пишут комменты, так или иначе, идеально самодокументируемый код, думаю, ни кто не пишет
AB
хотя прям с топовыми челиками не знаком)
UT
Я, после того, как прочитал «все так или иначе пишут идеально самодокументирований код»:
о_0
о_0
AP
вот так же и пишут, да )
AB
поправил)
AB
не не не, я не истина в последней инстанции, просто мыслю разгоняю)
PC
А причем тут лид или не лид, заметки должны оставлять все, от стажера до техдира ;)
I
конченый хероку, уже 0 син, тупо не понимаю как приложуху поставить
PC
Писать "самодокументируемый код" - это похоже на некий грааль, все к нему стремятся но врядли кто-то даже теоретически достигнет этого. Есть такие кейсы где выражение смысла через код будет смотреться очень уродливо либо станет менее тестируемым
AB
тут наверное вопрос не в необходимости писать или нет, а больше что комментировать, что бы не описывать очевидные вещи или не не описывать не очивидные
Dm
особенно если зашел в проект и ничего не шаришь за предметную область что и как, я не должен часами сидеть разбирать, все либы должны быть задокументированы чтобы я мог нормально их использовать, стоит там какой-то bool в методе и попробуй пойми что конкретно он делает
PC
Ну неочевидные как раз и надо описывать
AB
спес, кэп)
Dm
я не должен кликать по кнопкам руками чтобы узнать что они делают, примерно такая философия
PC
А там вопрос выше как раз был о том, необходимо писать или нет.