BT

Packaging Visual Studio Help Files

| by Jonathan Allen Follow 576 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

Login to InfoQ to interact with what matters most to you.


Recover your password...

Follow

Follow your favorite topics and editors

Quick overview of most important highlights in the industry and on the site.

Like

More signal, less noise

Build your own feed by choosing topics you want to read about and editors you want to hear from.

Notifications

Stay up-to-date

Set up your notifications and don't miss out on content that matters to you

BT