Hi folks, Recently I've been looking at how to improve Apache Traffic Server's Documentation: http://trafficserver.apache.org/docs.html
Initially it has been written using http://www.adobe.com/products/framemaker/ with ``help'' from http://developer.yahoo.com/yui/grids/builder/ When looking at the source, the first thing one notices is that it's HTML (with SSI) only. https://svn.apache.org/repos/asf/trafficserver/site/trunk/ >From this fact arises the wish for change: To make the documentation more accessible to extension and enable easy transformation to different formats, such as HTML, LaTeX, etc.. I have considered httpd's docs-project as base, but I'm not sure how easily adaptable that is. From what I gather, most of https://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/manual/style/ would need to be rewritten. My barrier here might be the lack of insight in XSLT. I'd be glad to hear about your experiences with this or any other comparably sane documentation system. So long, i -- Igor Galić Tel: +43 (0) 664 886 22 883 Mail: [email protected] URL: http://brainsware.org/ --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
