Начали встречаться статьи про красоту кода DOOM3.
Открыл файл Actor.cpp репозитория
Некоторые восхищаются:
Код должен быть задокументирован «сам по себе». Комментариев следует избегать во всех возможных ситуациях. Комментарии дублируют работу и для чтения, и для написания кода. Если вам требуется что-то прокомментировать, то скорее всего оно должно быть переписано с нуля.
Смотрю
Вижу - комментарии дублируют код.
Строка с lastAnimBlendFrames нарушила выравнивание в столбце по =.
Кстати есть расширение vs code для решения таких и аналогичных проблем: vscode-better-align-columns.
Следующий фрагмент - сложный if и сбивающий с толку комментарий про цикл.
Вариант почитабельнее:
Закрыл файл.
Да кто я такой обсуждать id Software?
Это про - красота в глазах смотрящего.
Если смотрящий считает это "красивым", то его ждут прекрасные открытия.