TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
I had set up DoxyGen to do this with FrameMaker. I saved the Maker as HTML, ran some custom java routines over the individual topic to clean out the junk Maker put into them, and then used DoxyGen configuration to generate the final package that included the code docs plus the authored docs. The result was a two-section piece, with a "guide" made of authored content, and a "reference" from the generated content. I would imagine that you could do something similar with JavaDoc, where you can merge some form of Maker's PUBLISH output with JavaDoc output.Â
I'm not aware of any out-of-the box tools to do this.Â
cud
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com
