40ants-doc
provides a rudimentary explorable programming environment. The narrative primarily lives in so-called sections that mix Markdown docstrings with references to functions, variables, etc., all of which should probably have their own docstrings.
The primary focus is on making code easily explorable by using SLIME's M-. (slime-edit-definition
). Generating documentation in Markdown or HTML format from sections and all the referenced items is also implemented.
With the simplistic tools provided, one may obtain results similar to literate programming, but documentation is generated from code, not the other way around, and there is no support for chunking. Code comes first, code must look pretty, documentation is code.
40ants-doc
is a fork of MGL-PAX with fewer dependencies (only named-readtables
and pythonic-string-reader
) for the core system, and additional features in the full system.