SkillsTechnologiesPlatformsSurvey Home

The use of technologies is a defining element in the identity of software user assistance professionals. Enhancing a product’s usability requires transforming our words and ideas into digital form using a variety of technologies. In our survey we provided a list of popular user assistance technologies and asked the respondents to value the importance of those technologies in their current development efforts.

The technologies we presented to the survey respondents are broad solution technologies as opposed to specific file formats. For example, Microsoft’s HTML Help provides a comprehensive solution to user assistance in the Windows environment, while HTML is a technology that gains value only when used in conjunction with a broader technology like HTML Help or browser-based Help. Our work with foundation technologies like HTML, XML, and JavaScript are dealt with specifically in the Skills section of the survey.

The use of Microsoft’s proprietary Help standards continues to diminish. Just a quarter of respondents indicate HTML Help as a key element in their work.

Support for manuals in the form of PDF (77%) is at the top of the list as the most valued technology component. Using PDF as a delivery format has become a staple in our documentation sets. PDF files can be delivered on an installation CD or via the Web. In the past, this technology was mainly used for legacy print documents like user guides, and also for supplemental white papers and troubleshooting information. Today we find many organizations using PDF files as the primary distribution format for product documentation.

Print is still of use to 1 ot of 5 respondents which is a healthy number. ePub and Kindle are likely to grow in usage, but the UA community doesn’t seem to have found them exceptionally useful yet.

The use of browser-based Help (73%) continues to be very popular with our respondents placing it second. The lure of displaying content in a web browser window seems to offer enough positive value for us to favor it over more feature-rich, platform-specific proprietary Help systems. This form of content delivery uses standard and non-standard Web technologies to deliver Help content through Internet Explorer, Firefox, Safari, Chrome, and other browsers. Implementation strategies run the gamut from using basic HTML pages to proprietary solutions, such as WebHelp and WebWorks Help, to complex renderings employing custom JavaScript and HTML5/CSS.

Other formats for Help are used be very small percentages of respondents. Some of these are helpful in very special use cases. Others represent legacy support.

The World Wide Web (56%) continues to be a key element of our user assistance as evidenced by the strong showing in the survey. This includes content that is distributed through the public Internet and private intranets.

Traditional documentation components such as quick reference materials (54%), knowledge-bases (46%), and Multimedia tutorials (46%) are valued highly by about half of respondents.

Collaborative technologies like discussion Forums (25%), Wikis (24%), and Interactive Helpers (20%) have maintained the same level of popularity for several years now.

Top

Detailed Results

Here is the complete list of skills presented in the survey. They are separate into functional groups. The percentages are of responses rating a technology as “Very Valuable” or “Invaluable”.

Microsoft Help Systems Table

System Response
HTML Help 1.x (.chm) 24%
WinHelp (.hlp) 3%
Help 2.x for Visual Studio (.hxs) 3%
Help Viewer 1.0 for Visual Studio (.mshc) 2%

 

Other Help Systems Table

System Response
Browser-based Help
(WebHelp or any HTML/XML-based Help content displayed in a browser)
73%
Eclipse Help 6%
Oracle Help for Java 4%
JavaHelp 5%
Apple Help 3%
Oracle Help for Web 2%

 

Manuals (User, Admin, Installation, or Reference Guides) Table

Manual Response
PDF manuals 77%
Print (distributed on paper) 22%
Epub 10%
Kindle 5%
iBook 2%
Mobi 2%
XPS 2%

 

Other Delivery Technologies Table

Technology Response
World Wide Web or intranet content 56%
Quick reference (Reference cards, Getting Started guides, release notes, job aids) 54%
Knowledge bases (web-based repositories for reference information) 46%
Multimedia tutorials (Video, Flash, simulations) 41%
Forums (discussion groups, blogs, Twitter) 25%
Wikis 24%
Interactive helpers (wizards, troubleshooters) 20%
Social sites (Facebook, LinkedIn, Google+, etc.) 13%
RSS feeds 5%

 

Other delivery technologies mentioned by respondents: embedded Help, DVD, Semantic web.

A few respondents mentioned specific tools. We keep tools in a separate Tools Survey.