Been working on things off/on since the middle of last year. Most of the effort has gone into the Doxygen tool (
openscad-amu). I've only spent the last few weeks putting together the example library (
omdl) mostly as a test/demonstration for the tool.
What started me down this road is the belief in the potential of language-based mechanical design. And in this area, OpenSCAD is the only widely accessible option. I quickly discovered that what I was missing was (1) a way to automate my design flow from a set of high-level parameters to rendered (printable/carvable/cutable) parts and (2) a way to manage documentation in the world of SCAD (design, parts, libraries, etc). This is what I've tried to address with openscad-amu... It has a bit of a learning curve, but good potential... I have created an install script and example use template to help.
To respond: Yes the documentation can be built in HTML format (thanks to Doxygen).. And HTML is my preference (web browsers have come a long way). I hope you will have a look at the HTML version of the omdl documentation.... Moreover, if you have interest, use openscad-amu to "install" this example library. This will install the SCAD library files and the HTML/PDF documentation. It uses a simple documentation "repository" that makes it easy to organize and reference ones collections of core libraries.
The install instruction can be found at the GitHub source repository in the section
Automated install. The install process should be fairly painless on Linux (and Cygwin). The build script gathers the system dependencies and can build to a local user-space cache directory that can be easily removed.
I think something resembling the summary page you suggest _can_ be found in the HTML formatted documentation. See the tab called "Modules." (It's the third from the left starting from the Main Page).
Thank you for having a look and for the feedback!!!