Комментарии
Комментарии не компенсируют плохого кода Объясните свои намерения в коде Хорошие комментарии Юридические комментарии Информативные комментарии Представление намерений Прояснение Предупреждения о последствиях Комментарии TODO Усиление Комментарии Javadoc в общедоступных API Плохие комментарии Бормотание Избыточные комментарии Недостоверные комментарии
Обязательные комментарии Журнальные комментарии Шум Опасный шум Не используйте комментарии там, где можно использовать функцию или переменную Позиционные маркеры Комментарии за закрывающей фигурной скобкой Ссылки на авторов Закомментированный код Комментарии HTML Нелокальная информация Слишком много информации Неочевидные комментарии Заголовки функций Заголовки Javadoc во внутреннем коде Пример Литература