Literate Programming

http://www.literateprogramming.com/

В качестве тренировки языка решил попереводить, подвернулось значимое:

Donald Knuth. "Literate Programming (1984)" in Literate Programming. CSLI, 1992, pg. 99.

Я верю, что пришло время для существенного улучшения документирования программ, и мы можем наилучшим образом достичь этого представляя программы как произведения литературы. Отсюда мой заголовок: "Литературно грамотное Программирование".

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

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

Прошу понять правильно, перевод не литературный, но верный - к этому стремлюсь.

Оригинал:

I believe that the time is ripe for significantly better documentation of programs, and that we can best achieve this by considering programs to be works of literature. Hence, my title: "Literate Programming."

Let us change our traditional attitude to the construction of programs: Instead of imagining that our main task is to instruct a computer what to do, let us concentrate rather on explaining to human beings what we want a computer to do.

The practitioner of literate programming can be regarded as an essayist, whose main concern is with exposition and excellence of style. Such an author, with thesaurus in hand, chooses the names of variables carefully and explains what each variable means. He or she strives for a program that is comprehensible because its concepts have been introduced in an order that is best for human understanding, using a mixture of formal and informal methods that reinforce each other.