August 2009 | Visit Doc-To-Help | Live Chat
 
 What's Inside
Feature Spotlight
Creating Context Sensitive Help
Words From the Editor
Doc-To-Help is an Extension of Your Development Team
Featured Article
Bringing Help to the Forefront: An STC Intercom Article
What's New
Ask The Expert
New Doc-To-Help Review Published
Technical Writer Survey from Aberdeen
Event Center
UA Europe 2009
Survey Center
August Quick Survey
July Survey Results
 Resource Center
 Download Center
Get started for free with
Doc-To-Help & DemoWorks

Visit the Download Center
 Customer Corner
Your Feedback is Welcome
Your feedback is important to us. Please click here to send us your questions, comments or suggestions.
 Referral Program
Refer a Friend; Get $50
Know someone who could benefit from Doc-To-Help?
If so, refer them to us and get a $50 gift card. Contact sales now.
 Become a Fan
Doc-To-Help
 
  Feature Spotlight
Creating Context Sensitive Help

Since context sensitive Help is a very common need, Doc-To-Help gives you many ways to create it. The most important thing for a writer to do when preparing for context sensitive Help is to assign IDs to each topic.

Doc-To-Help provides three ways to do this:

  1. Doc-To-Help can generate and assign IDs automatically.
  2. You can enter the IDs manually in the topics grid.
  3. You can enter the IDs directly in each topic using the Doc-To-Help toolbar.

Once you have generated or entered your IDs, you can create a report listing them or view the header (.h) file that can be found in your Target's output folder. Additionally, you can find code samples for developers in the Context-Sensitive Help folder of Doc-To-Help's install directory.

Download Doc-To-Help today to give it a try.

 
  Words from the Editor
 
Gustavo Eydelsteyn Doc-To-Help is an Extension of Your Development Team
Gustavo Eydelsteyn, Co-founder

ComponentOne is widely known as an industry leader among software development organizations. While ComponentOne’s flagship product, Studio Enterprise gives the Visual Studio developer a toolset for rapid application development, Doc-To-Help gives documentation authors a solution for single-source publishing.

What may not be widely known is that Doc-To-Help is the only product of its kind that includes technology designed to assist in every part of the applications development cycle, not just end-user documentation.

For example, developers can automatically create .NET reference documentation with the Microsoft Sandcastle plug-in, combine that with project information, and create a project information center to share with the team (or customers if appropriate). Additionally, every Doc-To-Help purchase also includes a license for ComponentOne DynamicHelp, a Windows Form control that embeds help into the application's interface.

Learn more about this in the upcoming Don't Forget Your Documentation Webcast.

 
  Featured Article
Nicky Bleiel Bringing Help to the Forefront: An STC Intercom Article
Nicky Bleiel, Senior Information Developer

In the June issue of the STC Intercom magazine, our own Nicky Bleiel writes about embedding a dynamic Help pane in an application's interface, how Help should be designed in that context, and how embedded Help improves usability. Check out an excerpt from the article:

"Online Help is passive, with the user taking the initiative. Embedded Help is nonintrusive and does not require the user to take the initiative," says Lynne Hall. "Embedded Help sidesteps the user's reluctance to go to the help system, providing background and often invisible support to users. An embedded, dynamic Help pane displays relevant information as the user navigates the interface, making the concepts and language of the interface obvious to the user. It's task-specific, context-specific, doesn't require users to look for it, and doesn't require them to ask the right question."

Read the entire article.

 
  What's New
Ask the Expert*

Q: Can I change the Doc-To-Help icon to a custom image in my NetHelp output?

A: Yes, you can. NetHelp's packaged themes all have the Doc-To-Help icon in the upper-right corner. To change that icon to a custom image (your own logo for example) use the Theme Designer to specify the new image, as well as its URL and tooltip. I have published complete instructions in our knowledge base.

*If you have a question about technical communication, email me at asktheexpert@doctohelp.com.

By the way, I'll be at the LavaCon Conference this October, where I'll be presenting a talk: "Designing and Implementing Embedded, Dynamic User Assistance" and a workshop: "Doc-To-Help 2009: Publishing in a Click." Early registration ends Friday, August 7th. If you're interested, go to www.lavacon.org/program-registration.php.

Thanks, Nicky

----------------------------------------------------------------
New Doc-To-Help Review Published

Communicator Magazine recently published a review of Doc-To-Help 2009 v2. Robert Meijer, a long time expert, discussed Doc-To-Help's history and how it has evolved to stand up to today's challenges.

Read the review.

----------------------------------------------------------------
Technical Writer Survey from Aberdeen

The Aberdeen Group, the leading provider of fact-based research focused on the global technology-driven value chain, is conducting a survey about technical writing and structured authoring. Participate in this survey and you'll see the results when Aberdeen makes them available.

Take the survey.

 
  Event Center
UA Europe 2009

Visit us at UA Europe, the only European conference to focus specifically on software user assistance and online Help. Come by our table ready with your questions and your business cards.

UA Europe UA Europe 2009
17-18 September 2009
Cardiff, UK
  Survey Center
August Quick Survey

Please take a moment to answer the following question. We will publish the results next month so you can see what your peers had to say.

Do you need to produce Help for mobile devices?
Please click your answer.
Yes - Blackberry
Yes - iPhone
Yes - Windows Mobile
Yes - All or combination of the above
Yes - Other
No
--------------------------------------------------------
Last Month's Survey Results
Last month, we asked what you normally publish. Here are the results:

July Survey Results

 

Copyright © 1987-2009 ComponentOne LLC. All rights reserved.
201 South Highland Avenue • Third Floor • Pittsburgh, PA 15206 • USA
1.800.858.2739 | 412.681.4343

All product and company names herein may be trademarks of their respective owners. | Privacy Policy