Welcome to the world of advocating for Literate Programming:

http://literateprogramming.com/