Today I successfully generated some documentation directly from commented Flows code in both php and python, and I also found that Doxygen ought to work with Ruby (we'll see). In a Flows-like way, Doxygen generates the documentation in XML, HTML, RTF, etc.
I learned enough about the process though to realize that it might be smarter to write a Flows component that generates the documentation you need when you are looking at it in the browser, instead of pre-generating static files of documentation.
Will have to contemplate....