What tools are available to create a help file in Visual Studio 2010?

Question

I need to write a help file for a WinForms app in Visual Studio 2010. Ideally, I\'d like to use a tool that integrates with Visual Studio, rather than a totally separate too

Answer 1

As others have said, you can convert the triple slash XML MSDN-style help using Sandcastle on all class-level members and objects

/// <summary>
/// I am a method help Header
/// </summary>
/// <param name="parm1">info for param 1</param>
/// <param name="parm2">info for parm2</param>
/// <remarks>Some Extra Info</remarks>
public override void MeMethod(SourceElement rootElm, Subject subject){
...

Here is the link to Sandscastle

A more feature-rich help generator that integrates with Visual Studio 2010 and generates multiple help formats is VSDocMan . It includes a WYSIWYG comment editor, and actually comments some of your code for you. Extremely useful

Answer 2

it is an awkward target for tool vendors. In most shops, the help is authored by professional writers that don't have any use for Visual Studio in their day-to-day activities. Third party authoring tools like RoboHelp is their preferred weapon of choice.

The VS2005 SDK tool you probably saw was HelpStudio Lite, a product of Innovasys. There is no version available that integrates with VS2010 and judging from a forum post they have no intention of releasing one. Their Document X! product however does, sounds like what you ought to take a look at. The eval version is available for download from here.

Answer 3

Html Help, is replaced by Html Help 2.

http://www.mshelpwiki.com/wiki/tiki-index.php?page=Help2

Answer 4

If the audience for your help file is the user of the application html help 2 is not usable, you will still need to create a chm file. The tool which can do this for your from your winforms application is Help Generator for Visual Studio, which takes away a lot of work in preparing the help and linking it to the forms.

Answer 5

Probably doesn't integrate with VS2010 but I remember using RoboHelp back around '97 and it was ok:ish then so if I needed to write helpfiles now I'd probably give that another look since it seems like it's still around here. Fairly expensive though it seems but if you've got some Adobe licenses (which isn't totally unsual for a development shop) for some other reason maybe you've already got this?

Answer 6

I remember that a year or so ago some people on Joel's The Business of Software forum were recommending HelpNDoc.

Forum discussion: http://discuss.joelonsoftware.com/default.asp?biz.5.359131.10