A directory of resources inthe field of technical communication.

Documentation>Online

218 found. Page 1 of 9.

About this Site | Advanced Search | Localization | Site Maps
 

1 2 3 4 5 6 7 8 9  NEXT PAGE »

 

1.
#20272

Adapting Traditional Editing Practices for Online Documentation  (link broken)   (PDF)

Technical editors are possibly best known for their abilities to transform information with format, content, grammatical, and mechanical problems into coherent, concise, understandable, and usable documents. Editors must not only provide such services for the information authors, but they must also understand and support users' needs and expectations. This presentation gives editors an approach to editing online documentation that is rooted in traditional editing practices.

Fink, Bonnie L., Carol Gasser, Jennifer Giordano and Beth A. Williams. STC Proceedings (1998). Articles>Editing>Documentation>Online

2.
#20273

Adobe Acrobat: Publishing Online Documentation   (PDF)

Documentation departments are often faced with the challenge of quickly distributing high-quality versions of printed documentation via the company Intranet, the World Wide Web, or CD-ROM. Adobe Acrobat is a simple, cost-effective way to publish documentation for a variety of media and requires little time or technical expertise to produce professional-looking results. Technical writers and web developers can easily use Adobe Acrobat to create portable document format (PDF) files from printed documentation. They can then add links and bookmarks, create an index, produce simple interactive forms, and add multimedia components to their documents.

Ogata, Kerry L. and Thomas A. Witherspoon. STC Proceedings (1998). Articles>Documentation>Online>Adobe Acrobat

3.
#37273

Adobe Community Help and AIR Help: A Disconnect?

I’ve used Adobe Community Help when trying to get answers regarding Creative Suite products. I like the emphasis on searching and the integration of results that aren’t within Adobe’s domain. I think Adobe Community Help is a great example of what help can be: pulling answers and information together from various sources and formats and then showing context in search results.

Minson, Benjamin. Gryphon Mountain (2010). Articles>Documentation>Online>Help

4.
#33335

Alternatives to Software Documentation

Software documentation such as Help systems and user guides may be the best method of helping your customers to use your software effectively. However, one or more of these alternatives may be a better solution.

Unwalla, Mike. TechScribe (2007). Articles>Documentation>Online>Help

5.
#30385

Applying Expectancy-Violations Theory to Online Documentation   (PDF)

A person usually expects another person to behave according to accepted norms, but how does a person respond to a message that violates his/her expectations? One theory dealing with violations of expectations is Burgeon and Hale's (1) nonverbal expectancy-violations theory. This theory posits that, under certain circumstances, violations of social norms and expectations may be an effective strategy for communicators to achieve the intended communication purpose. Although the expectancy-violations theory focuses on expectations for nonverbal behavior, such as gaze and conversational distance (2), I believe that this theory can also apply to expectations for humancomputer interaction.

Chiu, Yu-Kwong. STC Proceedings (1993). Articles>Documentation>Rhetoric>Online

6.
#18790

Australasian Online Documentation Conference

Since the very first Australasian Online Documentation Conference in Melbourne in 1998, the conference has developed a reputation as the premier event for technical writers, help developers, Web authors and documentation developers from Australia and New Zealand. Our speaker list reads like a Who's Who of documentation, as we strive to ensure that experts in techniques and technologies are available to share their knowledge and expertise. The conference is also a great place to network with other documentation professionals.

AODC. Academic>Conferences>Documentation>Online

7.
#30388

Authoring for Electronic Delivery   (PDF)

Caterpillar is dramatically changing the way technical, product support information is authored. Book paradigms have been replaced by the more granular Information Element (IE) approach. The new integrated environment utilizes Unix based, TCP/IP connected, ECALS compliant tools on multi-tasking author workstations. Research data, in-process work approved IE's and relational indices are distributed to work group servers. Application software tools include a graphics editor and an interactive, context sensitive, SGML text editor. The environment is managed by a robust file management system that provides file tracking, revision control, workflow sensitive tool launching, burden planning and management reporting capabilities.

Hudson, Dave. STC Proceedings (1993). Articles>Documentation>Online>Help

8.
#20122

Basic WinHelp for Beginners   (PDF)

The first time you create a Windows Help file can be very confusing. This paper should help reduce confusion by explaining the basic WinHelp concepts and components, and then walking you through the procedure.

Van Sant, Carol J. STC Proceedings (1996). Articles>Documentation>Online>Help

9.
#21479

Beyond Help: Making Help a Core Component of a Performance Support System  (link broken)   (PDF)

With the advent of HTML Help and the ability to embed Help directly inside an application, there's been an increased interest in creating Help systems that are seamlessly integrated with their host applications. By blurring the line between the application and the Help that supports it, and by developing Help that automatically responds to user actions, application developers and Help authors now have the ability to develop true electronic performance support systems.

Wexler, Steven S. ComponentOne (1998). Articles>Documentation>Online>Help

10.
#21505

Browse Sequence in Online Help   (PDF)

A browse sequence enables users to navigate through a series of help topics in the sequence established by the help author. Although often omitted from help systems, the browse sequence is useful and will become essential as print documentation diminishes. Effective design options for a browse sequence include multiple segments, rings, branching, and the use of a browse button to take the user to the first topic in the current segment of the browse sequence.

Farkas, David K. and Bruce R. Gibbs. STC Proceedings (1994). Articles>Documentation>Online>Help

11.
#37054

Browse vs. Search in Application Navigation

When I gave my own UIE Virtual Seminar last year on Navigation, I got a question from one of the attendees. He said that it was a requirement at his company that the user be able to get to any screen in the product (and there were 1,000+) with no more than 2 clicks. I enjoyed the challenge of thinking about how I'd do it. At the time, I was imagining a massive Site Map of the application, but now I think that perhaps another way to satisfy that requirement would be to implement the kind of searching that Apple has.

Rivers, Hagan. User interface Engineering (2010). Articles>Documentation>Online>Help

12.
#20287

Building the Treasure House: Creating Knowledge Bases on the World-Wide Web   (PDF)

Web knowledge bases offer an excellent platform for delivering technical documentation and customer support information. They also represent an area of great opportunity for technical communicators to expand their skills, satisfy their customers, and create value for their employers or clients. This session explores the components of a web knowledge base and the tasks involved in planning and building one.

Massa, Jack A. STC Proceedings (1998). Articles>Documentation>Online>Web Design

13.
#24972

"By the Way, We Also Want Online Help"   (PDF)

This presentation describes a strategy to meet a last-minute enterprise demand for online help for a software application program. We established design standards for writing online help, developed a process for gaining consensus from the project team on the content of the online help, and wrote the online help. We accomplished this in less than four months-a task that originally seemed impossible.

Davis, Herbert S. and Meryl Natchez. STC Proceedings (1994). Articles>Documentation>Online>Help

14.
#30395

CD-ROM: From Print to Prototype   (PDF)

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 John Gale 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.

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

15.
#30396

CD-ROM: From Print to Prototype   (PDF)

There are many significant benefits to releasing documentation on CD ROM rather than on hardcopy including cost savings, storage capacity, and the ability to implement search and retrieval functionality. To determine whether or not you should go to CD ROM, it is advisable to survey your users and to get approval from the folks in "corporate." Once you decide to pursue CD ROM, you need to determine the platform requirements and feature set of the search and retrieval software. You will then be able to choose from a variety of products, and ask the selected vendor to produce a prototype for you.

Florsheim, Stewart J. STC Proceedings (1993). Articles>Documentation>CD ROM>Online

16.
#19059

Cherryleaf Survey: Uptake of New Help Trends

During March and April 2003, Cherryleaf carried out an online survey into the current trends in technical communication. One of the questions we asked was: Do the online user assistance documents produced by your organization contain the following advanced capabilities?

Cherryleaf (2003). Articles>Documentation>Help>Online

17.
#24803

Choices, Challenges, and Constraints: Documentation and Newsletters Over the World Wide Web   (PDF)

Providing timely information to diverse users on different platforms can challenge any document delivery system; however, the World Wide Web provides an effective solution for some applications. While the Web presents some extra problems and challenges that other media do not, the results justify the resources required. This paper describes and evaluates an implementation of Computing and Information Services documentation on the World Wide Web.

Ray, Eric J. STC Proceedings (1995). Articles>Documentation>Online

18.
#22119

Choosing and Using Help Topics

This paper describes some common types of help topic and when to use each. Different applications require different mixes of help topics. Choose the topic types that are appropriate for the application you are documenting.

Hollis Weber, Jean. Technical Editors Eyrie (1999). Articles>Documentation>Online>Help

19.
#30401

Compaq QuickFind: The Editorial Process from Print to CD-ROM   (PDF)

COMPAQ QuickFind is a CD-ROM database of COMPAQ product information. Available by subscription, QuickFind offers full-text search-and-retrieval functions and full-color graphics in a 350-megabyte database. QuickFind incorporates hard-copy information into an electronic format. The QuickFind editorial process (converting hard- copy information to searchable files) is the key to creating a valuable, centralized support tool for COMPAQ dealers, customers, and internal personnel.

Tacker, Susan and Susan L. Maloney. STC Proceedings (1993). Articles>Documentation>CD ROM>Online

20.
#18794

Comparison of HTML Produced by Several Help Authoring Tools (HATs)

Recently, there was a lively discussion on the Help Authoring Tools and Techniques (HATT) mailing list about the relative compactness and efficiency of the HTML code produced by various Help authoring tools. As a result of these discussions, several industry consultants decided to collaborate on a project to compare the HTML, CSS, and CHM files produced by a variety of Help authoring tools.

Knopf Online. Articles>Documentation>Online>Help

21.
#29760

Constructing a One-Stop "Answer Station" for Software Users   (PDF)

The web allows us to easily provide updated documentation to our users, but why stop there? There is more to making users successful quickly than just providing documentation. By creating a complete "Answer Station" that is accessible from the application or product, we can not only direct users to that updated documentation, but we can also provide information about technical support, consulting, training, sales, etc. This paper discusses writing a proposal for an Answer Station, determining content, working with other departments to gather information, designing the site, making that design work with an existing corporate website, dealing with tool issues, and finally, going live.

Bleiel, Nicoletta A. and Beth A. Williams. STC Proceedings (2004). Articles>Documentation>Help>Online

22.
#36768

Context-Sensitive Help

This article is for software developers who have never implemented context-sensitive help. It explains the concepts and the basic types of context-sensitive help. A demonstration application with context-sensitive help is available.

TechScribe (2008). Articles>Documentation>Help>Online

23.
#23422

Converting Paper Mountains to Data Highlands

Big producers of equipment and systems of all branches often have piled up enormous volumes of product documentation in various formats on different media over long periods. How does one deal with that in the Internet age? How will brochure-like product catalogs be converted to type-specific clickable web pages, and printed price lists to present-day worldwide retrievable tables? Experiences with a large converting project show the process to achieve such document management.

Pichler, Wolfram. TC-FORUM (2000). Articles>Documentation>Online

24.
#21506

Creating a Hypertext Help System for a GUI-Based Client/Server Application   (PDF)

We are currently in the second phase of development of a large Windows online help system. This paper reviews the major decisions we had to make during the first phase of the project, and lists some project evaluation results that have helped us plan for subsequent phases.

Asher, Betsy, David E. Lasecke and John Wenstrom. STC Proceedings (1994). Articles>Documentation>Online>Help

25.
#14404

Creating an Interactive Online User Guide  (link broken)   (PDF)

Want to create a colorful, interactive online version of your FrameMaker® documents? Not many steps are involved in making the conversion: start with template changes in the FrameMaker files; create a postscript file; convert it into a PDF (Portable Document Format) file using Adobe Distiller®; and add final touches to the PDF file in Adobe Exchange®.

Beren, Wendy G. STC Proceedings (1998). Presentations>Documentation>Online>Adobe FrameMaker

 
 NEXT PAGE »

 

Follow us on: TwitterFacebookRSSPost about us on: TwitterFacebookDeliciousRSSStumbleUpon