No matter what system you run there are areas that just don't make any sense. I love Visual Studio and will argue with anyone that it's the best way to develop traditional platform applications. That being said, it's help system is quite ridiculous.
You would think that a company that is so focused on developer productivity would make it trivial to integrate third-party documentation. The pages of the documentation are all just HTML files. Each documentation package might contain some indexes but on the whole it's just HTML. Here's an idea. Just make the help format a zip archive and inside this zip you layout the HTML in whatever tree structure you like. Include whatever scripts, CSS, or binary content you like. Any top level pages that should not appear in the TOC can be listed in some .exclude file. There can be a file that lists the name to file indexes. All of this could then …
[Read more]