Насколько часто встречаются, особенно open-source проекты, в которых каждая функция предварена комментарием. А теперь задумаемся: будем ли мы править комментарии, если придется в сжатые сроки добавлять новый функционал.
Думаю, такой сценарий исключен, поэтому код должен быть ясен и понятен и требовать комментариев только в исключительных случаях.