История изменений
Исправление slackwarrior, (текущая версия) :
Надо писать так, чтобы код отражал СУТЬ.
что, камменты в коде, уже не в тренде?
Это самое заклинание про «самодокументируемость» работает до той поры, когда
а) в кот все равно никто посторонний не смотрит даже теоретически
б) как всегда ВНЕЗАПНО хотят из чего-то вытащить наружу API с самогенерящимися автодоками.
в) (вризультати)к «ЭтошОпенСорц»(ТМ) библиотеке нет никаких вменяемых доков, кроме автогенеренных (да и те невменяемые) :)
Исходная версия slackwarrior, :
Надо писать так, чтобы код отражал СУТЬ.
что, камменты в коде, уже не в тренде?
Это самое заклинание про «самодокументируемость» работает до той поры, когда а) в кот все равно никто посторонний не смотрит даже теоретически б) как всегда ВНЕЗАПНО хотят из чего-то вытащить наружу API с самогенерящимися автодоками. в) (вризультати)к «ЭтошОпенСорц»(ТМ) библиотеке нет никаких вменяемых доков, кроме автогенеренных (да и те невменяемые) :)