BT

Packaging Visual Studio Help Files

| by Jonathan Allen Follow 636 Followers on Jun 10, 2011. Estimated reading time: 1 minute |

If you are offering a commercial or open source library for .NET developers, including an integrated help file is a great way to show your professionalism. It can also be handy when working on a framework that is reused across a company’s internal applications.

In a recent article Jeff Braaten explains the process of creating Visual Studio Help Files. Individual Help files for Visual Studio 2010 RTM and SP1 are essentially XHTML files with special meta tags. These meta tags handle basic information such as the page’s language/locale, place in the table of contents, keywords, and F1 support. Jeff stresses that the pages will be read with .NET’s XmlReader class and thus must be well-formed XML compliant with XHTML Basic 1.1.

Loose pages are then grouped into book. Each book is comprised of a zip file containing all of the topic pages and a loose XHTML file that describes the book. Installing a book created in this fashion requires administrative access. If that isn’t acceptable you can then bundle the zip and description files into a signed CAB file. This will of course require obtaining a signing certificate.

A missing piece to this process is how to distribute it via package managers, especially Nuget. Administrative access for installs isn’t really acceptable but neither is requiring signed CAB file for what is essentially just documentation.

Rate this Article

Adoption Stage
Style

Hello stranger!

You need to Register an InfoQ account or or login to post comments. But there's so much more behind being registered.

Get the most out of the InfoQ experience.

Tell us what you think

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread
Community comments

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread

Discuss
BT