Нужны ли комментарии

Комментарии полезны, но их следует использовать разумно. Они должны объяснять почти код делает, а не что он делает (это должно быть понятно из самого кода).

Хорошие комментарии:

• Объясняют сложную логику или алгоритмы
• Указывают на неочевидные решения
• Документируют публичные API (например, через JavaDoc)

Плохие комментарии:

• Дублируют очевидный код (i++; // increment i)
• Устаревшие или неактуальные

Пример хорошего комментария:

// Используем быструю сортировку, т.к. данные почти отсортированы 
// и это даёт O(n log n) в худшем случае  
Arrays.sort(data);  

Избыточные комментарии загромождают код и усложняют его поддержку.