Жили были два программиста - Ваня и Вася. Работали они на фирме и
получали хорошую зарплату. Ваня писал очень аккуратный код. Он
тщательно его комментировал и документировал. Код Васи был полной
противоположностью ваниному коду. Он был настолько запутан, что его
было невозможно читать. Вася никогда не ставил комментариев и не писал
документацию. Ваня гордился своей аккуратностью и смеялся над кодом
Васи.
Однажды на стажировку в фирму пришли два неопытных, но очень
талантливых программиста - Коля и Петя. Начальник был настолько
поражен способностями Коли и Пети, что уволил своих программистов и
назначил талантливых новичков на их должность.
Коля быстро освоился на новом месте. Он прочитал документацию Вани и
сразу понял что к чему. У Пети же ничего не получалось. Днями и ночами
он пытался разобраться васином в коде. Петя потерял покой и сон. Когда
он засыпал, ему снился код Васи, и он просыпался в холодном поту.
Время шло, сдача проекта задерживалась, план не выполнялся. Петя
совсем отчаялся и решил переписать все с нуля, но было уже поздно.
Начальник был очень недоволен деятельностью Пети. Он разочаровался в
Пете и выгнал его из фирмы. Потом он позвонил Васе и предложил ему еще
большую зарплату.

Мораль:
Хороший программист никогда не ставит комментариев. То что писалось с
трудом, должно и пониматься с трудом.

LI 3.9.25