U « Inútil
'* *• MlitH
.».•Г««..,7,.• ••»*«** •
•I••< »
«.•rè» |7*
I
!•( HMMilHr • • »/••"••«»*» / rt|[
1 *♦«KMmtM’ti («nil
1 I
1 rniilMUti
I.,M • *r " 'tj •# < **• t**,Utr.
If
_________________
»HI iMt
,4-M *"^U< «II
»•'*f 'MhlKf III,
»•* • mwilUiij
(щнщ
i I
i
I Nilitnli,
I
uiVeryImportantVariableThatVolatileAndCanBeUsedByManyProccessors;
и вариант с комментарием:
muiVIP; //очень важная переменная, которая может использоваться множеством процессоров
m - mutable, разделяемая.
http://joyreactor.cc/post/3528234#comment16373138
В первом варианте: имя заполнено кучей бесполезной информации, например волатильность и мьютабилити всегда очевидным образом выплывает из модификаторов переменной, а вместо писания всяких "убер-важная-переменная" стоит использовать нормальное имя описывающие предназначение переменной, использование разными процессорами (скорее всего ты имел в виду конкурентный доступ в нативной среде) - выглядит весьма стрёмно, доступ к такой переменной не может контролироваться просто именем переменной, явно вокруг неё всё говорит о конкурентном доступе к ней.
Второй вариант ещё хуже: "m - mutable" - это фольклор, который будет передаваться из уст в уста, покуда преемственность поколений разработчиков на проекте не прервётся, в части паблик API - это вообще катастрофа, первый вариант хоть сам о себе расскажет прямо в IDE, когда попытаешься посмотреть на состав класса. Сокращения и аббревиатуры (кроме самых распространённых и понятных из контекста кода) - плохая практика, могут быть неправильно поняты, расшифровки могут быть забыты и утеряны в веках.
ИМХО, лучше увидеть что-то вроде:
uiConcurrentAccessNumberOfFlyingDildosOnScreen, чем muiNOFDOS (mui меня наталкивает на одну известную песню Кати Лель)
Цитировать даже 10% от этой книги здесь не вижу смысла.
В любом случае, всё должно быть гармонично и лаконично, тут уж мы точно с тобой согласимся.
ПРЯМИКОМ В АД НАХУЙ
некоторые решения могут быть неочевидными. для этого и комментарии, чтобы потом понять.
поэтому комментарии обьясняют не то, что делает код, а зачем он что-то делает.
Ну ещё бывают редкие случаи когда нужно комментировать не только "почему это здесь", но и "что это вообще такое". Но это уже большая экзотика, которую обычно можно отрефакторить.
а иногда и два часа - если я на обед ходил
http://www.mk.ru/social/2017/02/28/zagadka-smerti-andreya-zhdanova-chempiona-svoey-igry-pogubilo-razbitoe-serdce.html
ещё вариант - запустить и посмотреть.