My intent to is to create documentation for our software project that is checked into our SCM system along with the source code.
These files can be spread among various sub-projects but I want to bring the documentation together so that, e.g. a page can include documentation on more than one sub-project at once. The viewer should not see a ‘page per sub-project’ – rather they see the documentation for the project and not the boundaries between sub-projects.
This documentation needs to load direct from a user’s local PC in their browser, so I can’t composite or transform XML files into a single HTML on a server.
First thing I would suggest to transform XML into another form would be XSLT http://www.w3schools.com/xsl/.