вопрос практикующим программистам

[mbla]

У наших студентов на пятом курсе полугодовая стажировка.

Найти стаж обычно просто - всем хочется получить готового инженера по дешёвой цене - платят стажёрам, естественно, мало.

Обычно ребят берут разработчиками на конкретные проекты.

После окончания стажировки - защита - в комиссии кто-то от нас и руководитель стажа "с места". Иногда руководитель с места по тем или иным причинам отсутствует и вместо себя присылает оценочную бумагу.

Сегодня у меня "защищал" свою работу мальчик, у которого страсть - интеллектуальные компьютерные игры. Ему удалось найти соответствующий стаж. В компании, которую 5 лет назад организовали двое братьев - совсем молодые ребята - были у них какие-то идеи, взяли кредиты. Сейчас в компании шестеро, естественно, друзья-сокурсники. Такие маленькие фирмы, по крайней мере во Франции, всегда дружеские тусовки.

Так вот студент мой, страшно расстроенный тем, что его не оставили - нет у них денег ещё одному человеку платить - рассказал, что "отцы-основатели" с самого начала установили несколько абсолютно жёстких правил программирования.

Первое - понятное - функция должна умещаться на экране - не умещается - разбивай.

А вот второе меня поразило - комментарии запрещены. Идея в том, что комментарии позволяют писать нечётко, - дескать, прочтёт человек комментарий и всё поймёт, а на самом деле, ежели код хорошо написан, он должен быть полностью понятен при чтении с листа.

Это правило, естественно, совершенно противоречит правилам, которым учат на первом курсе, когда за отсутствие комментариев аж оценку снижают.

Как по-вашему?

Comments

[liber-polly.livejournal.com]

комментарии все же нужны... может быть, не длинные, но без них очень неудобно код читать... А мне приходится.
по крайней мере, над кодом с комментариями меньше засыпаешь:))

[ivan-ghandhi.livejournal.com]

javadoc only. The rest is shit.

[clement.livejournal.com]

А если не Java?

[andrzejn]

Тогда просто Javadoc-подобные комментарии, и то только перед теми методами, суть которых не очевидна из имён метода и параметров.

[mbla.livejournal.com]

Если не объектное? Как насчёт программы на lisp, prolog или caml?

[andrzejn]

Со всем перечисленным я знаком только на уровне идеологии, синтаксиса и простейших примеров. Не знаю, как они себя поведут в больших серьёзных проектах. Может быть, их конструкции и правда настолько неестественны, что требуют дополнительных пояснений - но я хочу, чтобы было иначе. Очень уж красивые идеи в них заложены :)

[mbla.livejournal.com]

А я как раз всё перечисленное нежно люблю. но это - логические игры. И когда нужно понять умещающуюся на двух сторчках прологовую программу, которая эквивалентна паре страниц на С, так это отличное развлечение. Надо, впрочем, сказать, что комментарии тут едва ли помогут.

[mbla.livejournal.com]

А как насчёт lispoподобных языков?

[mbla.livejournal.com]

Спорно. Иногда от комментариев ещё хуже засыпаешь. Вообще-то за чтение чужого кода должны что-нибудь хорошее давать - за вредность.

[liber-polly.livejournal.com]

Мне это иногда приходится делать по работе, я т.н. тестер-аналитик, в случаях большого затыка приходится вздыхать и читать чужой код. На том языке, которым он сочинен... с комментариями мне забавнее:)) как Пьера Безухова, меня иногда умиляют ошибки...

[mbla.livejournal.com]

А, это да. Посмотри там в конце ссылку у грина.