Статьи

Когда комментарии исходного кода указывают на проблему

Декабрь 3, 2018

У разработчиков свой собственный, циничный вид юмора. Рассмотрим, например, взгляд Geek и Poke на оскорбление разработчика .

Но лучше юмор, чем публиковать что-то на сайте. Есть комментарии исходного кода. Потому что теперь вы можете хихикать, написать остроумное замечание и подождать, пока ваши коллеги обнаружат ваше чувство юмора только через 3-4 года (когда вы давно ушли, работая в другом проекте, отделе или компании). Разве это не лучший способ выразить цинизм?

Например, однажды я встретил этот жирный кусок Javadoc в устаревшем исходном коде предыдущего работодателя:

1
2
3
4
/**
 * NEVER EVER TOUCH THIS METHOD OR EVERYTHING
 * WILL EXPLODE!!!!!
 */

Но ошибка была в этом методе! Монстр с 500 линиями и 80 символами отступа! Итак, я пошел и сначала исправил Javadoc:

1
2
3
4
5
6
/**
 * NEVER EVER TOUCH THIS METHOD OR EVERYTHING
 * WILL EXPLODE!!!!!
 * ^^^^^^^^^^^^^^^^^
 * Chicken!
 */

Если у вас есть пара свободных минут (или часов) для прочтения других остроумных и циничных комментариев, погрузитесь в этот удивительный вопрос переполнения стека, в котором представлены 549 лучших комментариев в коде . Выдержка Стива Вита .

Однажды мне пришло в голову то, что я считал элегантным решением особенно сложной проблемы, в ретроспективе это было что-то вроде умопомрачения и интенсивное использование макропрограммирования. Спустя годы я нашел этот комментарий от программиста по обслуживанию

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
/*
The Total Perspective Vortex derives its picture of
the whole Universe on the principle of extrapolated
matter analyses.
 
To explain - since every piece of matter in the
Universe is in some way affected by every other
piece of matter in the Universe, it is in theory
possible to extrapolate the whole of creation -
every sun, every planet, their orbits, their
composition and their economic and social history
from, say, one small Macro.
 
The man who invented the Total Perspective Vortex
did so basically in order to annoy the IT
department.
 
Steve Weet - for that was his name - was a dreamer,
a thinker, a speculative philosopher or, as some
would have it, a slacker.
 
And they would nag him incessantly about the
utterly inordinate amount of time he spent staring
out into space, or mulling over the mechanics of
Chelsea FC, or doing spectrographic analyses of
macros.
 
"Have some sense of proportion!" they would say,
sometimes as often as thirty-eight times in a
single day.
 
And so he built the Total Perspective Vortex - just
to show them.
 
And into one end he plugged the whole of reality as
extrapolated from one macro, and into the other
end he plugged the IT department: so that when he
turned it on they saw in one instant the whole
infinity of creation and theirselves in relation to
it.
 
To Steve Weet's horror, the shock completely
annihilated their brains; but to his satisfaction
he realized that he had proved conclusively that if
life is going to exist in a Universe of this size,
then the one thing it cannot afford to have is a
sense of proportion.
*/

39
Share: