Роберт Мартин в "Чистом коде" написал жёстко: комментарий — это признак неудачи. Если вам нужно объяснять код словами, значит, вы написали его недостаточно ясно.
В C++ эта идея получила новое дыхание с приходом
[[nodiscard]], концептов из C++20 и строгой типизации. Тип std::expected<Result, Error> уже сообщает о возможной ошибке без единого слова.Но у этой философии есть тёмная сторона. Когда через год вы видите
static constexpr int MAGIC = 0x5F3759DF — никакое именование не объяснит, что это константа из алгоритма быстрого обратного квадратного корня Quake III. Здесь нужен комментарий и, желательно, ссылка на статью.Самодокументирующийся код работает для структуры. Комментарии работают для контекста и истории.
✏️ Вы придерживаетесь правила "код без комментариев" или считаете это крайностью?
📍Навигация: Вакансии • Задачи • Собесы
Библиотека C/C++ разработчика
#междусобойчик