Faster Factfinding With Digital Libraries?  

This paper covers the usability testing of a prototype digital library. The library holds technical manuals for scientific instruments. Findings show test subjects can locate desired documents faster with this digital library than a corresponding paper library. However, the same subjects can locate desired information faster in a paper document than a digital one. Finally, most subjects reported they would prefer to using the online library of technical documents over the library of paper ones.

Barnett, Mark R. STC Proceedings (1997). Articles>Usability>Documentation>Online

Fault Tolerance: A More Forgiving Doc-To-Help and Word for Windows  

Doc-To-Help 2000 has a new 'fault tolerance' feature that forgives novice authors their Microsoft Word mistakes, including direct formatting and stretched bookmarks. These problems often cause corrupted cross-references as well as document-to-Help-system conversion problems. Doc-To-Help's automatic diagnostic and repair utilities now find these common errors and correct them automatically.

Wade, Jenny. ComponentOne (1999). Articles>Documentation>Online>Help

From Information to User Assistance: A Support System for a User Technology Organization  

Our plight as users of process information is much like that of the users of the information for our software products. Like them, we want to do useful work and get appropriate assistance when we need it. Instead of just reading about a task such as writing an information plan, we want the templates and samples to use when writing the plan. Just-in-time assistance, experience captured in a useful form, would suit us just fine. This paper, by the designers and developers of a system that supports the work and processes of a user technology organization, presents the information design issues that we encountered and the design of the system that we created.

Hargis, Gretchen, Deirdre Longo and Lindsay Bennion. STC Proceedings (1999). Articles>Documentation>Online>Help

From Online Document to Electronic Performance Support System  

This demonstration introduces the concept of an Electronic Performance Support System (EPSS), an online end-user support system that provides whatever is necessary to generate performance and learning at the moment of need. The speaker will step through a five-level analysis of the design and delivery components of an EPSS and demonstrate how to design and position online documents for inclusion in an EPSS.

Hyman, Francine N. STC Proceedings (1994). Articles>Documentation>EPSS>Online

From Online Help to Embedded User Assistance  

Online help systems have evolved over the past twenty years to meet the needs of our users. Designers must consider the content, format, presentation, navigation, and access methods of online help systems. A series of design checklists based on the past 20 years of research are presented in this paper, which summarizes a journal article currently being considered for publication. The latest trend in online help system design is embedded user assistance, which includes integrating information into the interface and including an embedded help pane within that interface to display a context-sensitive online help system.

Corbin Nichols, Michelle. STC Proceedings (2003). Articles>Documentation>Online>Help

From Print to CD-ROM  

A panel of industry experts provides an overview of the CD-ROM publishing process—and its business issues–for technical communicators who are responsible for implementing CD-ROM publishing in their organizations. The panelists will discuss how to gain the benefits of reduced manufacturing warehousing and distribution costs, without degrading documentation quality.

Gale, John, Stephanie L. Rosenbaum and Pamela Sansbury. STC Proceedings (1994). Articles>Documentation>Online

Goal-Oriented Paper Versus Online Documentation Search Strategies  

In this age of information, advanced technology gives us access to more than ever imagined. Are people easily moving toward gathering information online instead of from paper? This study investigated novice and expert user access of paper versus online documentation.

Anson, Patricia H. and Robert Anson. STC Proceedings (1996). Articles>Documentation>Online

Going Paperless — No Longer a Revolutionary Idea  

Moving user documentation from paper to online requires long–term planning and hard work. You must rethink how you design documents and determine the best way to present information online. You can take steps to downsize the existing documentation workload. You may even change the way you work with the software development staff. As a result, you will probably produce better documents, start working a lot smarter and save the company a lot of money.

Mulreany, Sharon R. and Risa Glick. STC Proceedings (1996). Articles>Documentation>Online

Grassroots Documentation  

We often hear how the Web can be used to deliver technical documentation. But have you ever thought about the Web as technical documentation? When dozens, or perhaps hundreds, of people, all using the same product, start posting tips and solutions to problems on different Web sites, the entire Internet becomes a kind of crude users’ manual.

Martin, Maurice. Intercom (2003). Articles>Documentation>Online>Community

Help Development: "Just in Time, and Just Enough"

Too often technical writers fall into the 'tell them everything and tell them all at once' pit. Guided by a well-meaning desire to 'educate' users, what these writers typically do is overwhelm them. Finding the information you need when you need it is a key to success in every business function of every company. Therefore, technical communicators who are able to provide their customers with quick and useful knowledge bring an incredible added value to a beleaguered work force constantly expected to do more and to do it faster.

Edwards, Verlane. STC Central Iowa (2000). Articles>Documentation>Online

Help Is Dead. Long Live Help!  

As Help Authors, we often treat online help as a 'thing,' not an activity. We’ve favored the noun over the verb! This preference is natural for writers, who enjoy producing books. If we hope to survive on a dynamic development team, we must train ourselves away from writing books, toward helping people. This shift means examining the bigger picture and adopting different ways of working.

Sisler, Paul and Catherine M. Titta. STC Proceedings (2001). Articles>Documentation>Help>Online

The Help Landscape: A Mile Wide and 30 Seconds Deep

Two questions any writer must deal with are: 'What do I write about?' and 'How much do I say about it?' Essentially, these questions deal with the scope and the depth of a document. Technical communicators have a tendency to want to document a topic as completely as possible, and we carry this instinct with us when we architect and write Help files. In this column, I challenge that prevalent instinct and offer an alternative way of thinking about the scope and depth requirements of Help systems. The benefits of this approach are, I hope, better Help for users and, for our clients and employers, a more efficient use of technical communicators' time. First, I'll discuss three principles that underpin my perspective, then I'll give some practical advice about writing Help that people will actually use.

Hughes, Michael A. UXmatters (2007). Articles>Documentation>Help>Online

Help! Six Fixes to Improve the Usability of Your Online Help  

Tight deadlines and limited resources often force wiiters to cut corners and release less than optimal help system designs. After considerable trial and error, I te come up with a checklist that can help you evaluate and improve your help system for the next release. Each question represents an important usability issue.

Timpone, Donna. STC Proceedings (1997). Articles>Documentation>Online>Help

Hero Stuff: Saving 50% on Support Costs with Fax and Modem Support Documents  

In the PC products market, customers insist on excellent support at rock-bottom prices. The traditional model of customer support, having a phone technician answer customer questions, is becoming too expensive.

Brown, Constance C. STC Proceedings (1993). Articles>Documentation>Online>Help

The Hidden Power of the Online Manual

Writing software manuals is boring, isn't it? We often think, "My software is easy to use. The user interface is intuitive. Why should I waste so much time writing documentation which nobody will read anyway?" Sometimes it's true. I've never read the WinZip or Internet Explorer manuals. Everything seems clear enough without further explanation. Nevertheless, even if your manual isn't being helpful to your software users, it may be helpful to you. Publish your manual online and turn its hidden power into a real benefit for your business.

Crane, Dennis. Dr. Explain (2006). Articles>Documentation>Online>Technical Writing

HTML-Based Help: A Convergence of Two Solutions  

IDX Systems launched two separate HTML-based help authoring efforts simultaneously. The results were two very different HTML-based help solutions. One solution emphasized thorough and complete information while compromising accessibility. The other solution emphasized accessibility while compromising thoroughness and completeness. In both cases, the compromises were forced by the limitations of current web technologies. The two writing efforts have now been merged into one solution that uses HTML, database technology, and Active Server Pages.

Johnson, Wayne and Fritz Garrison. STC Proceedings (1998). Articles>Documentation>Online>Help

Impact of Multimedia on Online Documentation  

Multimedia is commonplace in entertainment and the Internet is proliferating the use of multimedia in electronic materials. Online documentation has traditionally been composed of text and some graphics. The proliferation of Intranets and online documentation is pushing the acceptance of multimedia in reference and procedural materials like Help. However, there is little research on the value of multimedia in online documentation nor its effective use.This paper describes an exploratory study done for a Master of Information Science thesis to determine the impact of multimedia on online documentation.

Rockley, Ann. STC Proceedings (1998). Articles>Documentation>Online>Multimedia

Implementing Help Systems for Java Applications  

Technical communicators are facing a revolution in how we develop online help for software applications. No where is this more apparent than in the development of help systems for applications written in Java. Sun Microsystems, Inc., expects to roll out JavaHelp in the early part of 1998. Until JavaHelp arrives, technical communicators will have to find creative ways to implement HTML help systems for Java applications. The best news is that we have some standards to follow, like HTML, and some methods for browsing HTML help today. The key is to develop scalable help systems designed with the future in mind. This paper discusses some ways you can create HTML help content that works with your applications today and tomorrow.

Colvin, Richard D. STC Proceedings (1998). Articles>Documentation>Online>Help

In Defense of Print

The reduced reading speed on computers can be compensated by good hypertext design that allows the user to read less information and to find it faster. A typical example is online help and documentation: because the information is right there on the computer, there is no need to spend time finding the hardcopy manual, and because of good search tools and hypertext links between related information, users can go directly to the one or two sections that contain the answer to their problem. After all, Nielsen's first law of computer documentation is that users don't read it. The second law is that if they read it anyway, it's because they are in deep trouble and need the answer to a specific problem. Thus, somebody reading a manual won't really read it cover-to-cover, so online presentation makes perfect sense.

Nielsen, Jakob. Alertbox (1996). Articles>Documentation>Online>Usability

Indexing Online Help  

In order to make a help system really helpful, you need to provide an effective index. But many online help writers face two dilemmas when it's time to index their help systems: How to prepare a useful index that meets the users' needs and how to code the keywords to make the index compile correctly. This article provides tips to help writers solve both problems.

Hamilton, Beth. STC Indexing SIG (1999). Articles>Documentation>Online>Help

Indicating Changed Text in Help Files

There are still many circumstances when drawing a user's attention to changed text is important. How do we do that with Help systems? By borrowing techniques from paper manuals, we don't have to reinvent the wheel. So here's a good approach that will work for Microsoft Word-based HATs.

Self, Tony. HyperWrite (2004). Articles>Documentation>Online>Help

Integrating Javadoc (API Reference) with JavaHelp (Online Help): Two Approaches

Although online help (either task-based or UI-centric) and API reference documents serve different purposes, there are times when you may want to at least create associations between the two or at most merge them into one system.

Sapir, Rick. KeyContent.org (2004). Articles>Documentation>Online

Interactive Electronic Technical Manuals

Advances have been made to provide that information online to the point where electronic access to the information involves nothing more futuristic than a laptop computer and access to a database.

Albing, Bill. KeyContent.org (2004). Articles>Documentation>Interactive>Online

Issues in Designing, Implementing, and Evaluating a Help System  

The design team for a major new product approached our publications group about ideas on developing an online manual and/or online help. Together, we developed a task-oriented, easy-to-use online help system, and continue to work together to evaluate it. Where do we best put the buttons that access the help for various subsystems?

Evans, Jeanette P. STC Proceedings (1993). Articles>Documentation>Online>Help