Документирование кода. Правильно ли я делаю?
А я вот не люблю документированный код. Если код написан хорошо и человек который читает его не тупой - всё понятно.
Да и как-то не красиво смотрится документированный код, ужс как не нравится)
Хотя это лично моё мнение.
C одной стороны правильно.
С другой чем больше комментариев, тем больше вероятность того что они не будут соответствовать коду.
Поэтому идеально, когда код документирует сам себя.