По адресу
http://stackoverflow.com/questions/184618/what-is-the-best-comment-in-source-code-you-have-ever-encountered
опубликовано голосование за лучшие комментарии исходного кода, встречавшиеся когда-либо разработчикам в разное время и в разных проектах. Этот раздел stackoverflow.com на 20 страницах из области тех, которые нужно смотреть обязательно, дабы привести мозги и чувство юмора в порядок , в начале рабочего дня, или перед сном.

Некоторые комментарии оттуда:
#define TRUE FALSE //Happy debugging suckers



// This comment is self explanatory.



# This job would be great if it wasn't for the fucking customers.



int MyFunction()
{
// There once was a man named Dave
int Result = 0
// Whose code just wouldn't behave
MyObject *Ptr = new MyObject();
// He left to go to a meetin'
Result = Ptr->DoSomething();
// And left his memory a leakin'
return Result;
}


// somedev1 - 6/7/02 Adding temporary tracking of Login screen
// somedev2 - 5/22/07 Temporary my ass


// sometimes I believe compiler ignores all my comments



// drunk, fix later



/*
* You may think you know what the following code does.
* But you dont. Trust me.
* Fiddle with it, and youll spend many a sleepless
* night cursing the moment you thought youd be clever
* enough to "optimize" the code below.
* Now close this file and go play with something else.
*/


//This code sucks, you know it and I know it.
//Move on and call me an idiot later.


// If this comment is removed the program will blow up



//Woulda
if(x) {}
//Shoulda
else if(y) {}
//Coulda
else {}


raise InvalidChild() # e.g. no legs



// I am not responsible of this code.
// They made me write it, against my will.

sysadmins.ru

Предыстория:
Как то раз шеф отдела спустил распоряжение - записывать все дела за день и в конце недели отправлять ему отчет ... разумеется 2-м сисадминам и программеру это быстро надоело и было решено написать базу с веб мордой для приема заявок (пользователи сами пишут проблему, а там расставляются ответственные... и...) оказалось приятно и забавно - ниже избранные места вся орфография и пр. сохранена ;-)

User - Саша приди и помоги посмотреть в дипосте как мы отправили а то что то у нас не получается
Админ - Пришел и посмотрел вместе с ними
(причем реально так и было ... постоял ... посмотрел .. ушел)

User - совсем глючит компьютер нечего не хочет делать
Программист - первоначально для решения проблемы был вызван Админ проблема: не работала заявка на оплату что cделано: переоткрыл Оперативный учет Причина: глюк оперативного учета

User - Шумит системный блок.
Админ - Вынул компакт-диск.

User - Пропал оперативный учет
Админ - Факт пропажи не установлен.

User - Не работает факс(идут короткие гудки)_
Адмн - Вылечено с помощью сброса всех пользовательских настроек
(пользователи перестарались ...)

User - Не работает телефон в бухгалтерии.
Админ - Вообще-то в столовой. Сделано.

User - Не включается компьютер
Админ - Научил корректно вводить пароль
(при чем тут бедолага компьютер ... ?)

User - Посьба настроить компьютеры на 1 столе ткацкого производства.
Админ - Настроить - настроить почту, объяснить третий раз как работает электронный прием заявок...
(интересно сколько еще раз надо будет объяснить ???)

User - На компьютерах первого стола настроить ярлыки на каталог ковровых изделий)
Админ - Необходимо закупить книжки сетевое окружение для кофейников для выполнения данной заявки.
(это в минуту ярости :-) им надо было найти шару с каталогом продукции в сетевом окружении)

User - Не работает принтер
Админ - Выдернули вилку из розетки - воткнул обратно.
(это после 3-х заверений по телефону, что все провода на месте)

User - Не работает принтер в автослужбе.
Админ - Показано окно выбора принтера и принтер на который нужно печатать.
(и когда они научатся смотреть что делают ?)

User - Настроить просмотр сайта www.lcarpets.ru с компьютера XXX. В настоящее время сайт открывается не полностью.
Админ - проблема в мониторе, необходима замена.
(Гм ... у монитора от времени яркость упала процентов на 60 ... а я уже было полез в искать удаленно что не так с днс)

заявка № 585
User - Выдать права на группу маркетинг г-же XXX.
Админ - Права на группу маркетинг г-же XXX выданы.

заявка 593
User - Дать права доступа XXX к группе "Маркетинг"
Админ - А что она успела сделать с выданным по заявке № 585?
(и действительно - те что были на прошлой неделе мы давно уже съели ...)

Вот так и живем ... но в целом молодцы юзера, настроение поднимают неслабо.

Q: Для чего пользователю ноги?

A: Чтобы пинать по системному блоку, отпинывать провода от системного блока, ходить к сисадмину.



Q: Для чего пользователю руки?

A: Чтобы правильно их затачивать, выпрямлять, тыкать ими в Клаву, тыкать в кнопку пауэр, засовывать в принтер вместо бумаги, дергать телефонную трубку и нажимать на аппарате всякие незнакомые рычажки(TONE, PULSE, громпкость звонка в офф).



Q: Для чего пользователю рот?

A: Для дачи правильных указаний сисадмину и советов без которых сисадмин просто сидит и кусает локти не зная что дальше делать. Ну незнает он и все - это аксиома.



Q: Для чего пользователю уши?

A: Чтобы закрывать их подобно листьям лопуха дабы не слышать мат сисадмина по поводу очередного оторванного провода кривыми ногами (почему большинство всех пользователей раньше были ковбоями или жили на фермах с№%?ки е№%%й в р;%:т).



Q: Зачем пользователи ходят на обед за рабочим местом?

A: Для того чтобы смягчить это надоедливое щелканье клавиатуры чем нибудь вкусным.



Q: Какие вопросы любят задавать пользователи?

A: А что это за ерунда, а как включить процессор, почему у меня ничего не печатает, почему у меня ничего не видно, почему у меня ничего не работает, зайдите в меня(удаленное управление компом), а куда я зашла, а что я сделала, а где все компьютеры, а где я, а как я называюсь, почему я такая дура?



Q: Что нужно пользователям для полного счастья?

A: Чтобы с их подохшим компом сисадмин возился больше чем с компами других, тогда этим можно будет хвастаться и щеголять перед другими сотрудниками.



Q: Любимые фразы пользователей?
A: Игорь, тьфу ты, как тебя там ну иди смотри мой процессор.

Программеры - они толстые. Потому что они сидят.
А админы - они тощие. Потому что бегают.
Впрочем, бывают тощие программеры.
Hо не надо думать, что это исключение из правил - это переученные админы.
Также встречаются и толстые админы.
Это обленившиеся программеры.

Программеры курят быстро, потому что мысль.
Потому что она уйдет и придется думать ее снова.
У админов мыслей нет, поэтому они курят медленно.
Они делают это в те моменты,когда все работает и ничего не падает.
Поэтому они курят редко.

Программеры ходят на обед сами.
Они приносят много еды в офис и вкусно ей пахнут.
Они едят ее прямо на клаве. Потому что мысль.
Админы заказывают еду в офис.
Потому что если они за ней пойдут, что-нибудь упадет.
И придется бежать в офис с недоеденным гамбургером.
Потому что админы любят питаться от Макдональдса.
Потому что вкусно, а потолстеть им не грозит.
Если они не обленившиеся программеры.

Программеры уходят с работы ночью. Потому что мысль.
Hекоторые из них уходят вечером и думают мысль дома.
Hекоторые, у которых есть ноутбук, думают ее в метро.
Админы домой не ходят. Потому что если они пойдут домой, что-нибудь упадет.
И придется идти на работу. А на работу они ходить не любят. И не ходят.
Они там живут.
У них обычно есть отдельное гнездо за отдельной дверью, часто запираемой на отдельный замок.

Программеры спят в выходной. Обычно это среда или понедельник.
Потому что мысль. В понедельник мысли еще нет.
А в среду идет переход от одной мысли к другой.
Админы спят в гнезде. Из-за отдельного замка в это время иногда раздается храп.
Админы редко спят больше десяти минут.
Потому что если проспать больше, что-нибудь упадет.
И придется просыпаться по необходимости.
А админы любят просыпаться сами, пусть и через десять минут.

Программеры пьют пиво. В основном светлое и много.
Потому что мысль. Пока она плавает - ее можно думать. Главное, чтобы не утонула.
Админы тоже пьют пиво. Потому что если что-нибудь упадет, им будет пофиг.
Админы любят когда им пофиг. И программеры любят, когда им пофиг.
Поэтому часто они пьют пиво вместе. И им вместе пофиг. После этого они спят.
Hо не вместе. Админы спят в гнезде, а программеры - на клаве.
Когда они просыпаются, они снова пьют пиво.
Потому что хочется.

Потому что они админы. И программеры.