Здравствуйте, Анатолий Абрамович!
Встретились мысли по теме Вашего сайта. Из книги Питера Сейбела “Кодеры за работой. Размышления о ремесле программиста”, с. 212 - 214.
Джо Армстронг, один из основателей языка Erlang: "Некоторые говорят: “Хотите знать, что делает программа? Читайте код”. Думаю, это непрофессиональный подход. Код показывает мне, что программа делает, а не то, что она должна делать. Код – это решение задачи. Если нет спецификации или какой-либо документации, приходится догадываться о задаче по решению. Догадка может быть неверной.
Может, это переключение между полушариями мозга, а может еще что, но при написании документации думаешь о программе по-другому.
Со мной время от времени советуются университеты насчет учебных планов по компьютерным наукам. Я говорю: “Учите их писать и подбирать убедительные доводы. Большинство выпускников, имеющим степень по компьютерным наукам, не сильны в написании текстов."