Adapting Technical Communication Core Skills to Navigate the Health Care System  

Technical communicators gather data from subject-matter experts and then transform it into information that helps users accomplish tasks. In this workshop, we demonstrate how to adapt our expertise to effectively interact with health care professionals--to improve our understanding of the health care industry. By relying on our professional skills, we can successfully navigate the health care maze and effectively operate in the "foreign" environment of the doctor's office, hospital, and care facilities. And, in doing so, we will improve the quality of care we receive.

Isakson, Carol S. and Katherine Brennan Murphy. STC Proceedings (2004). Articles>Scientific Communication>Biomedical

Adapting Traditional Editing Practices for Online Documentation

Developing a process and using guidelines for editing online documents, both rooted in traditional editing practices.

Fink, Bonnie L., Carol E. Gasser, Jennifer L. Giordano and Beth A. Williams. STC Orange County (1998). Presentations>Documentation>Editing

Adapting Traditional Editing Practices for Online Documentation  

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

Adaptive Technologies and Techniques for People with Vision Problems  

Talk with Gloria Reece, a senior member of STC’s AccessAbility SIG who can help you understand vision problems and the technologies that exist to make information accessible. Get practical advice for implementing new technologies in your workplace.

Reece, Gloria A. STC Proceedings (2004). Articles>Accessibility>Visual>Workplace

Add a Touch of Drama  

Several similarities exist between writing technical documentation and writing dramatic scripts. Technical writers who also write drama find they become much more aware of audience, differentiate more easily between 'need to know' information and 'nice to know' details, and better anticipate reader actions and reactions.

Blicq, Ronald S. STC Proceedings (2004). Articles>TC

Adding to Your Tool Box

You've applied and interviewed for a position, but you don't get it because you don't have a particular skill set that the employer needs. You want to learn a new tool, but the software is expensive and you can't afford to spend a lot of money on software at this time. Do either of these scenarios sound familiar to you? If they do, you have some options for learning new tools and can add to your portfolio at the same time.This article looks at the options that you have for learning software -- teaching yourself, taking classes, volunteering, and on-the-job training.

Puffer, Paula. STC Northeast Ohio (2001). Articles>Education>Software>Volunteering

Addressing Quality in the Real World  

Members of the STC Quality Special Interest Group (SIG) present a realistic look at Quality in today’s hectic business climate. Based on their experiences, you will gain insight into ways to improve documentation quality, establish processes to assist the improvement, and an understanding how outside forces can impact your documentation efforts. They will look at what is meant by quality, how it’s determined and measured; processes, techniques and basic tools that can be used to improve quality; and the impact of international standards on corporate policies and procedures. A case study will highlight some of the barriers, problems, and successes experienced by an organization in implementing a quality system for monitoring its documentation.

Jong, Steven F., Don Lenk, Amy Perry, Ralph E. Robinson and Roberta A. Rupel. STC Proceedings (2000). Articles>TC>Quality

Administration of an Electronic Classroom  

The electronic classroom in the Oklahoma State University English Department is now a little over a year old. In the three semesters we've been using it, a number of administrative challenges have surfaced. Some of those challenges were easily overcome, but others have been consistent dilemmas with no clear solution in sight. The day-to-day administrative issues in operating the facility center on issues of access and maintenance and repair. This article will focus on some of the major challenges with the intention of pointing out potential problems that may occur as other writing programs establish similar electronic teaching facilities.

Turner, John R. STC Proceedings (1995). Articles>Education>Online

Administrative Decisions in Online Graduate Education  

Much of the discussion about online education appropriately focuses on pedagogy and technology. Any planning for online education must consider teaching methods and the technology to support them as well as the appropriateness of these methods and technology for the students and course materials. However, administrative decisions also influence the success of the course or degree program. This paper reviews these issues based on the experience of Texas Tech University in five years of offering an online Master of Arts in Technical Communication. Issues include course concept, costs, administrative authority within the university, and student selection and retention. The paper looks briefly at legal issues and at the concern about impersonality in online education.

Rude, Carolyn D. STC Proceedings (2003). Articles>Education>Graduate

Adobe Acrobat: Publishing Online Documentation  

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

Advanced Issues in Usability: A Progression  

In this progression, respected usability specialists will moderate tables on subjects of interest to colleagues who have been working in the usability field for some time. These topics will focus on usability test design, data analysis and presentation, and marketing of data. Attendees should plan to contribute their own experiences. This progression addresses the frequently expressed request by Usability PIC members for more sessions on advanced topics in usability.

Wilson, Chauncey E. and Stephanie L. Rosenbaum. STC Proceedings (1996). Presentations>Usability

Advanced Issues in Usability: Balancing User Preference and Performance Data Collection  

The purpose of this paper is to provide a little background on my position for the progression on usability issues. I’ll present what measures I typically collect, and the differences between performance and preference data. Having this as a starting place may help us to have a useful progression discussion.

Rauch, Thyra L. STC Proceedings (1996). Presentations>Usability>Methods

Advanced Toolkit for Experienced Technical Communicators: Using a User-Centered Design Process to Overcome Challenges in Implementing a User-Centered Design Process  

Technical writers have known for years that a good explanation for a bad software interface may be better than nothing, but that it’s not as good as a usable software interface. With ‘usability' gaining greater visibility, this is a good time to implement a usercentered design process. This article looks at ways that the approach and techniques of such a process can be applied to the task of introducing a new process.

Quesenbery, Whitney. STC Proceedings (2001). Design>User Centered Design>Usability

Advanced Usability Topics  

An increasing number of STC members now have usability programs as part of their job responsibilities, although they’re not always full-time usability specialists. Many STC members have been performing usability activities for several years.

Rosenbaum, Stephanie L. and Lori K. Anschuetz. STC Proceedings (1997). Articles>Usability

Age Discrimination in Technical Communication  

Age discrimination in the workplace occurs any time one worker is treated differently from another due to age, or another worker's beliefs about age-related inabilities. Solving the problem of age discrimination in the workplace involves three things: understanding the problem and how it affects the way we work, educating ourselves and the rest of the general working public about age discrimination, and finding specific ways to address and overcome the issue.

Steele, Karen A. and Linda I. Bell. STC Proceedings (1993). Careers>Advice>Discrimination>Workplace

Analysis and Resolution of Problems Occurring During the Production of Manuals  

We produce numerous manuals pertaining to telecommunications and, although we routinely devote much energy to reducing the number of problems occurring during the production process, this time we took up the challenge of eliminating the occurrence of problems altogether. Here, we overview the characterisitics of problems occurring at the company, profile their occurrence by process, and review a few corrective measures.

Konno, Toshiaki, Masanori Takagi and Osamu Tomooka. STC Proceedings (1995). Articles>Documentation>Quality

Analysis of Virtual Classroom Environments: Survey of Classroom Dynamics in RSVP Courses  

Students can earn Master's degrees or continuing education certificates by at tending courses offered live satellite or compressed video or on videotape for delayed viewing. This panel discussion evaluates the effects of the various forms of technology and modes of interaction on the classroom dynamics in a live satellite class offered by Rensselaer Polytechnic institute (RPI).

Brunner, Kirsten, Roger A. Grice, David F: Hans, Teresa L. Hood and Leo J. Smith. STC Proceedings (1997). Articles>Education>Online

Analyzing Documents to Understand Tags  

SGML is a language for describing the structure of a document. The language involves using a system of tags for elements of a document. Document analysis is the process of discovering the elements of a document and understanding how the parts work together to form the document.

Coggin, William O. STC Proceedings (1996). Articles>Information Design>SGML

Analyzing Web-Based Help Usage Data to Improve Products  

This paper describes how user assistance can streamline deliverables and improve product design by analyzing usage patterns from server-based content. We can then base decisions about how to improve deliverables on a thorough understanding of how customers use help content to find information and solve problems. This approach enables user assistance to add more value to both our companies and our customers by creating a three-way dialog between user assistance, the customer, and the product team. It also broadens the definition of assistance to include helping to design products that people can use without the need for instructions.

Raiken, Nancy. STC Proceedings (2005). Articles>Documentation>Audience Analysis>Log Analysis

Anatomy of a Corporate Intranet Project  

Today more and more companies use intranets to communicate with employees and to help them perform their jobs. An intranet is an internal network that operates like the Internet.

Rhines, Becky. STC Proceedings (1998). Articles>Web Design>Intranets

And Now, From the Company that Brought You the Seven-Eyed Trout: Risk Communication in Action  

Risk communication is usually defined as an interactive process of exchanging information and opinions among individuals, groups, and institutions or agencies concerning a risk or potential risk to human health, safety, or the environment. It draws from established principles of sociology and psychology to communicate with hostile or frightened audiences about sensitive issues. The demonstration illustrates the most important principles of risk communication as they are applied to a fictitious community.

Durbin, Margaret E., Linnea E. Wahl, S.T. Molony, Susan Klein and Carol Wade. STC Proceedings (1993). Articles>Risk Communication

Animation as Documentation: A Replication with Reinterpretation  

Animated demonstrations are replacing text as the vehicle for documentation, help, and training on new software systems. An animated demonstration is a demonstration of a particular feature or features by a ghost user. The demonstration executes the procedure for performing a task, on-screen, as the user passively watches. Whereas research into the effectiveness of animated demonstrations has produced mixed results, certain patterns of behavior are emerging. The current study replicates the learning advantage offered by animated demonstration and shows that retention is equal to that of a group instructed by text after a one week retention interval. Implications for development of on-line training materials are discussed.

Lipps, Audrey W., J. Gregory Trafton and Wayne D. Gray. STC Proceedings (1997). Presentations>Documentation>Interactive

Anything That Can Go Wrong: Lessons Learned from A Decade of Toolkit Documentation  

Writing software toolkit documentation for programmers is a special challenge and opportunity for technical writers. Compared with writing software documentation for lay users, toolkit documentation is more demanding and exacting. Checking facts and finding tiny errors is like riding a motorcycle through a swarm of gnats. However, for me at least, toolkit writing has opened doors to a larger role and greater input into product design. Engineers treat me like a peer and I get to see into their culture. I know my readers and salespeople need me.

van Oss, Joseph E. STC Proceedings (1999). Articles>Documentation>SDK>Technical Writing

Application of Theory: Minimalism and User Centered Design  

In the discipline of software and information development, minimalist design is not just doing with less (less features, words, widgets). It is selectively choosing what to include or eliminate with the purpose of making it easier for the user to quickly learn about a product in a natural and painless way and to start using it to do real work. User centered design fits well with minimalist theory because it incorporates user feedback throughout the development cycle. It is the best way to find out what customers actually do with your product and learn first-hand how you can help them with their goals. My team applied both these theories to our task of designing and building a set of samples for a Web development product. This paper shares our struggles and successes.

Lou, Mary Mazzara. STC Proceedings (2001). Presentations>Usability>User Centered Design>Theory