Documentation skinning

Perhaps I did something wrong, or failed to follow documentation rules, but the fact that the HTML files that I generated for Boost Exception were processed and wrapped in additional HTML caught me by surprise. Obviously I'm not against using uniform skin throughout Boost, but in general we can't just get HTML+CSS and wrap it with more HTML+CSS, there might be class name collisions, and whatnot. Besides the fact that now the Boost Exception documentation doesn't validate as XHTML 1.0, another problem is that some headings are simply function and class names, which the Boost CSS converts to allcaps, making them look like macros. It seems like other libraries have similar problems, I saw an instance of library documentation having its own tags indicating that it's HTML compliant, to which Boost is adding an additional XHTML 1.0 compliance tag, the end result being that the file is neither HTML or XHTML compliant. This is unfortunate and unprofessional. Is there a standardized XML format that can be used as documentation source? Emil Dotchevski Reverge Studios, Inc. http://www.revergestudios.com/reblog/index.php?n=ReCode

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Thursday 14 August 2008 22:25 pm, Emil Dotchevski wrote:
This is unfortunate and unprofessional. Is there a standardized XML format that can be used as documentation source?
There is boostbook, which some of the libraries use directly, and some use indirectly via quickbook. -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.6 (GNU/Linux) iD8DBQFIpXxE5vihyNWuA4URAte8AKDKmbHA1uRhd9zKAjQ0RbpSboS4TQCgrobm 7ijVKBrGk65HYfWkTv1gDt0= =Z5VW -----END PGP SIGNATURE-----
participants (2)
-
Emil Dotchevski
-
Frank Mori Hess