We are working on a tool to automatically generate skeletal documentation from source code, but until then, we are documenting the Open Dylan libraries manually using Sphinx to build the HTML pages. Sphinx uses reStructuredText markup with some extensions of its own, and we have created additional extensions to document Dylan language entities.
The documentation — a number of RST files — is in the OpenDylan
directory. Consult the Sphinx web-site for details about
reStructuredText markup and Sphinx extensions to it, and see the
Dylan sphinx-extensions documentation
repository for details about the Dylan language extensions. (You may
rst2html tool to generate an HTML page from an