Making Help Authoring a Pleasure to Do
Free DownloadStart your free trial now

Help Authoring Resources

Tips & Tricks

Create Help for the User Interface of Your Application Automatically

Writing documentation for user interfaces is an essential part of work on the help file for your desktop or web application. Usually this process involves tasks such as creating and editing screenshots, and providing comprehensive descriptions for dialogs or for selective UI elements, which can be quite time-consuming.

However, HelpSmith offers a unique solution allowing you to automate most of these tasks and provide quality documentation for the user interface of your application almost automatically.

1. Capture a Window that You Want to Document

On the first step, you can take a screenshot of the window for which you want to provide documentation. While taking a screenshot, you can also enable the "Capture Controls" mode, so HelpSmith will recognize UI elements such as input boxes, buttons, etc., and prepare annotations for them automatically.

To Capture a Window with Controls:

  1. In the built-in word processor, put the cursor where you want to insert a screenshot.
  2. On the Insert tab, click Create Screenshot.
  3. In the Image Tool, ensure the "Capture Controls" button is pressed.
  4. Now click the "Capture Screenshot" button and select the window that you want to capture.
  5. Take the screenshot by pressing Print Screen or Ctrl+Click keys on the selected window.

Please note that HelpSmith properly captures a screenshot with rounded edges, and also automatically clears, the transparent background, so you do not need to the image it in a third party graphics editor.

2. Add and Edit Annotations

On this step, you can add new annotations or edit existing annotations that were added for recognized UI elements. For example, you can move an annotation, or resize the area for its linked control. Also, you can edit properties of an annotation, for example, to change its title, or to set if the linked control should also be show in the help topic below the image.

To edit properties of an annotation:

  1. Double-click on the annotation that you want to edit.
  2. In the "Edit Annotation" dialog set the title and other options according with your needs.
  3. Click OK.

3. Customize the Style of Your Annotations

You can select an existing style, or create a custom style for your annotations.

  1. In the Image Tool, click Image Properties.
  2. In the Style box, select one of the ready-to-use style schemes.
  3. Click OK.

On this step, you can also customize other settings such as shadow parameters, fonts, document-related options, etc.

4. Export Annotations to the Help Topic

Now you can prepare the documentation by exporting your screenshot and annotations directly to the help topic.

  1. In the Image Tool, check the option "Create or update control annotations in the document".
  2. Click OK.

Finally, using the word-processor, you can provide a description for each of the UI element exported to the help topic.

Editing Existing Screenshots

Please note that you will be able to update your screenshot, add new annotations or edit existing ones at any time. To open an existing screenshot for editing in the Image Tool again, hover over the screenshot, and then click the Edit Image button that appears in the top-left corner.

Thus, you can see how the Image Tool in HelpSmith can help you in producing a high-quality and comprehensive help file or web help system, and to significantly save your time and effort of creating such documentation manually.

Video: How to Create a Help File for User Interfaces Automatically

You can see the video below that demonstrates how you can use HelpSmith to create a help file for user interfaces.

Download HelpSmith


Detail Value
Product HelpSmith 8.2 (Build 19.919)
Filename HelpSmithSetup.exe
File size 40 MB
Platform Windows 10/8/7