Providing Custom Help for Visual Studio Templates and Policy
As a software architect, you need efficient ways to communicate guidance to development teams. Attaching a policy file to a template allows you to encourage the development team to follow your rules of architecture. It is likely, however, that you will still need to provide other kinds of instruction and information. Visual Studio Templates and Policy (formerly Enterprise Templates) provide a method for you to include this information by enabling you to display links to your own custom, context-appropriate help pages in the Visual Studio Dynamic Help window.
Creating your own custom help pages can be as simple as creating a standard .htm file and editing a few text files. Displaying custom help topics in the Dynamic Help window requires three basic tasks:
Author the custom content (create HTML files).
Specify a context file that maps keywords and attributes to that custom content.
Optionally, you can also set up a Dynamic Help topic category for the new topic; this category is used to group related topics together in the Dynamic Help window.
Associate element nodes in the policy file with those keywords and attributes by referencing them in a Context node.
Whenever a user (a member of the development team in this case) selects an element of a Templates and Policy project, a link to any pertinent help topic available displays in the Dynamic Help window.
In This Section
Understand how you can prepare your own custom help topics for display in the Dynamic Help window.
Describes how to modify your policy file to associate specific policy-governed ELEMENT nodes of your project with specific help topics that display in the Dynamic Help window.
Explains how to associate your custom help topic with the F1 key when a given node is selected in Solution Explorer.
Explains how a context file associates your custom help topics and your policy file with the Dynamic Help window.