http://tc.eserver.org/dir/Presentations/Documentation/Help A listing of the most recently indexed works about Presentations and Documentation and Help in the field of technical communication. en-us Copyright (c) 2005-08 by the EServer. All rights reserved. tclib-editorial@eserver.org (TC Library Editorial Board) webmaster@eserver.org (Geoffrey Sauer) http://tc.eserver.org/images/newlogo.gif http://tc.eserver.org/dir/Presentations/Documentation/Help http://tc.eserver.org/35322.html http://tc.eserver.org/35322.html What Are These Tools? Screen recorders that let you: record a series of screens as frames in a movie – like chaining together screen shots; annotate the frames with text captions, high-lights, and other effects for enhanced learning and explanation; add testing – informally through “dead-end” quizzes or formally using eLearning; publish the result. http://tc.eserver.org/35338.html http://tc.eserver.org/35338.html Web 2.0 includes: wikis, podcasts, blogs, widgets/gadgets, social networks … and combinations of all the above. Not everyone contributes equally – Creators (18%), Critics (25%), Spectators (48%). But all are important. http://tc.eserver.org/34420.html http://tc.eserver.org/34420.html Online formats can be confusing—consider "WebHelp" vs. "Web Help." This session describes XML, XHTML, HTML Help, WebHelp, DotNet Help, AIR, and others—and how to select the appropriate one. http://tc.eserver.org/34063.html http://tc.eserver.org/34063.html Online help. User assistance. That thing that pops up when you press F1. No matter what you call it, user assistance is an important element in the experience of a user. It can mean the difference between a frustrated user and a productive one. But is today's user assistance all it can be? Are we giving users purposeful information at the right time, in the most effective format, and ultimately in the way that they need it? Unfortunately, no. http://tc.eserver.org/31973.html http://tc.eserver.org/31973.html Discusses in detail why you might want to consider a specific tool for help authoring. http://tc.eserver.org/28749.html http://tc.eserver.org/28749.html This is a presentation titled 'Creating Help in the Web 2.0 Age' that Neil Perlin gave to the Suncoast Chapter in Tampa, Florida in February 2007. Neil talks about what Web 2.0 is, and how help can be delivered on the fly according to specific user requests. http://tc.eserver.org/26204.html http://tc.eserver.org/26204.html Common goofs, mistakes, bloopers, mal mots, slip ups, lapses, oversights, gaffes, and 'foe paws' in online documentation and Help. http://tc.eserver.org/18225.html http://tc.eserver.org/18225.html Designing multi-platform online help can be made more efficient by placing special effort in the design of the development plan. If the development plan is broken up into four key elements the resulting multi-platform design will yield a great amount of latitude for both maintenance and future enhancements. During the demonstration we will discuss our use of these elements to design both online and hardcopy documentation to support both a mainframe and a windows interface. http://tc.eserver.org/18219.html http://tc.eserver.org/18219.html With the explosion of online help authoring tools (primarily in the Windows® environment) companies are clamoring for the ability to produce online help on multiple platforms. This demonstration presents one solution to the problem of creating online help in a multiplatform environment. We will demonstrate the process of translating FrameMaker™ files from the Macintosh® to Windows NT®, and ultimately, to UNIX®. http://tc.eserver.org/14560.html http://tc.eserver.org/14560.html Traditionally, custom document production begins with an empty “New” electronic document and with the writer confined to the paper delivery mode. Networked software reuse facilities can allow writers to avoid this requirement of continually starting from scratch. Hence, net worked software reuse may provide a framework for efficiently creating custom documents in either academic or industrial settings for single-source, multimode delivery (Reece, 1993- 1994). More importantly, software reuse facilities may also provide common ground for technical training within a variety of computing environments. This paper defines software reuse, recommends a process for the development of documents in a software reuse facility, and provides information on quality characteristics for evaluating such software. http://tc.eserver.org/14550.html http://tc.eserver.org/14550.html Online documentation is now widely accepted for its convenience and cost savings. However, some small, non-Windows shops find very few offerings in the market place for online documentation software. http://tc.eserver.org/14548.html http://tc.eserver.org/14548.html Aha, you say, you’ve finally gotten permission to go online. And your boss has even allocated enough precious-budget dollars to buy the right hardware and software to do the job. How hard can if be to find a good authoring tool, you think. And then you start to receive the product literature from n developers of Windows help authoring tools . . . http://tc.eserver.org/14551.html http://tc.eserver.org/14551.html One way to create Windows help is by using Word for Windows. To begin, you must become familiar with the help concepts of topics and hyperlinks. Then, you create these components: projectile, header file, and source files. Source files are created using Word for Windows. Next create the actual help file by compiling the elements you have created. Finally, view and debug the results. http://tc.eserver.org/14366.html http://tc.eserver.org/14366.html Developing a Windows online help system that clients can use effectively and bringing it in on time and within budget is a challenging task. You can dramatically improve your chances of success by doing the following: Develop help as sofnvae is being developed (and even before!); Chunk information for easy reading and to facilitate reuse by other writers; Create design and style guidelines to cut down peer review and editing time; Develop and use information webs to cut down on technical review time; Integrate the information web and the user interface to complete your help system. http://tc.eserver.org/14372.html http://tc.eserver.org/14372.html In preparation for the next release of our flagship so~are product, the International Publications Department at Waters Corporation wanted to assess the usefulness of our current product software documentation with the idea of moving the next generation of documentation in the direction requested by our customers. Based on extensive customer contact, we formulated a plan to dramatically revamp the documentation, namely to replace the paper user’s guides and transform our existing online Help into a comprehensive Online User’s Guide. http://tc.eserver.org/14351.html http://tc.eserver.org/14351.html To successfully communicate to users, documentation must do more than meet the user’s information needs, it must present the information in the same way the user processes the information. The design of sofhYare and its accompanying documentation must be reconceived so that the design is done porn the problem-solver’s pornt of view. Effectively designing documentation requires the writer to: start with the user, answer the user’s rest questions, optimize all documentation as a smgle umt, allowfor user mistakes, and consider how you present the information. http://tc.eserver.org/14352.html http://tc.eserver.org/14352.html One of the ironic things about online help systems is that they are very often not helpful and even increase the user's frustration and stress level. A consequence of this increased frustration sometimes results in the rejection of the software. One solution is to increase the effectiveness of online help systems by designing them from an instructional design perspective. Some of the things we can provide users include: imperative, task-focused procedures; graphic feedback; access to redundant instructions; links to tutorial practice; philosophical and conceptual explanations for “why” they are completing specific tasks. http://tc.eserver.org/13301.html http://tc.eserver.org/13301.html Computerized Medical Systems, Inc. (CMS) has implemented an extensive online help system based on HTML for its FOCUS radiation therapy planning system. Netscape Navigator was selected as the browser because FOCUS is based on the UNIX platform and Netscape was the only HTML browser available for UNIX. http://tc.eserver.org/13202.html http://tc.eserver.org/13202.html HTML...HTML Help...HTML-based help...WebHelp... JavaHelp...Oracle Help...what does it all mean? There are so many online help options, it’s easy to get overwhelmed and confused. This paper discusses the difference between HTML Help, WebHelp, JavaHelp, and Oracle Help. Specifically, it explains each help technology’s features and limitations, the user requirements, and best use.