donald knuth introduced the "literal programming". This paradigm, having documentation and code in one, make the code readable like a book. Also, one needs to put more thoughts into code structure, making the code not only readable, but also "good layouted" with clear separations of documentation and the code.
reply