Literate code documentation

facilitates code audit