What do you think about literate programming [1,2,3]? I've never tried it, but I like the idea. WEB and Noweb look a bit outdated, but there is also Babel [4,5,6].
Would you like to give it a try? If so, we can start with 'guix-package' and 'guix-build' because they are already documented. [1] https://en.wikipedia.org/wiki/Literate_programming [2] http://www-cs-faculty.stanford.edu/~uno/lp.html [3] http://www.cs.tufts.edu/~nr/noweb/intro.html [4] http://orgmode.org/worg/org-contrib/babel/intro.html#literate-programming [5] http://orgmode.org/worg/org-contrib/babel/how-to-use-Org-Babel-for-R.html [6] http://kimavcrp.blogspot.com/2012/05/literate-programming-in-clojure-table.html
pgpz4Epc8woEw.pgp
Description: PGP signature