I disagree with the Author: literate programming is Great but it is true that gives a better result For small codebases. I have few tiny projects that are just a README.md which contains code and docs, and I am really glad about this Solution I called KISS Literate Programming: as an example, see <a href="http:&#x2F;&#x2F;g14n.info&#x2F;bb-clone&#x2F;" rel="nofollow">http:&#x2F;&#x2F;g14n.info&#x2F;bb-clone&#x2F;</a>