A directory of resources inthe field of technical communication (and technical writing).Articles>TC>Writing
25 found.
   
About this Site | Advanced Search | Localization | Site Maps  
 
 


 

1.
#28580

Applying Common Sense to Technical Writing   (peer-reviewed)   (members only)

How can budding writers achieve a middle path in their approach to documentation? This no-model approach is an attempt at busting the myth that only a model-based approach works.

Chitkara, Promila. International Journal for Technical Communication (2007). Articles>TC>Writing>Technical Writing

2.
#19839

Applying Minimalist Principles, Strategies, and Techniques   (PDF)

People use documentation differently from what we might expect. They don’t like to read; instead they jump to a task with prior knowledge, and sometimes don’t realize they’ve made an error. Understanding how users learn and applying John Carroll’s minimalist principles will help provide solutions to this problem. Documentation that has been successfully planned and designed for minimalism may take longer to create than other manuals, but reaps the benefits of making users more productive and happy, while reducing support calls, maintenance, translation, and publishing costs. The key factors to a successful minimalist approach (or any good documentation design) are a keen understanding of your users, prototypes designed to match tasks relevant to users, and iterative testing to improve each draft.

Lester, Susan M.J. STC Proceedings (2000). Articles>TC>Writing>Minimalism

3.
#14026

Beyond the Mechanical: Technical Writing Revisited   (peer-reviewed)

Optimism about the future of technical writing can be sustained only if we persist in setting for technical writing the same standards we apply to other sophisticated modes of writing and require refinement in style as well as accuracy in content. The importance of content in technical writing, of the information presented, may seduce us into seeing technical writing as purely a form of language engineering and into teaching our students to perform mechanical writing tasks, churning out dull reports to fit mindlessly into the institutional norms of industry and government.

Iyasere, Marla Mudar. JAC (1988). Articles>Writing>TC>Technical Writing

4.
#13978

The Composing Process of Technical Writers: A Preliminary Study   (peer-reviewed)

Janet Emig's 1971 study, The Composing Process of Twelfth Graders, spurred an interest in the writing process: how writers compose rather than simply what they compose. However, a survey of current literature indicates that little has been published on the composing processes of technical writers. Perhaps we have assumed that technical writers compose as other writers do. In order to test this assumption, we conducted the research on which we base this study.

Roundy, Nancy and David Mair. JAC (1983). Articles>Writing>TC

5.
#31143

Confessions of a Technical Author: What Can Technical Communicators Learn from David Ogilvy?

David Ogilvy was an advertising genius who distilled his successful concepts and techniques into a bestselling book I've just finished reading, called "Confessions of an Advertising Man". I wanted to read his book, because I often find it useful to look at other professions and ask whether their ideas could be applied to the world of technical authoring.

Pratt, Ellis. Cherryleaf (2008). Articles>TC>Writing>Technical Writing

6.
#18692

A Day in the Life of a Technical Writer  (link broken)

This TECHWR-L Magazine section features a selection of quotations from active technical writers about what a day at work looks like.

TECHWR-L. Articles>TC>Writing

7.
#15110

Delivering Clear Messages in a Technical Environment   (PDF)

Argues that effective titles and slogans can help members of a documentation team keep their focus while working on a project.

Kocak, Paul J. Intercom (2001). Articles>Writing>TC

8.
#20321

Establishing Yourself in a Writerless World   (PDF)

Establishing a presence in a department that hasn’t had the benefit of technical writers can pose many challenges. As a writer newly assigned to such a department, I worked closely with my manager to develop the technical writer’s role, presented the role to key staff and teams, and created initial procedures to support writers within the department. By performing these tasks and thinking creatively about handling projects with a limited amount of writers, we’ve been able to work constructively with teams in our department and produce effective documentation.

Caliendo, Corin J. STC Proceedings (1998). Articles>Writing>TC

9.
#31115

How Important is the Writing Part of Technical Writing?

Writing documentation isn't merely the act of pounding out dry prose. There is some creativity involved which comes from how you present the information, both textually and visually. The writing, though, needs to be easy to read, complete, concise, and to the point.

DMN Communications (2007). Articles>TC>Writing>Technical Writing

10.
#29127

Illustration and Language in Technical Communication   (peer-reviewed)   (members only)

Many technical documents present information both graphically and verbally. While much is known about the verbal tools of technical professionals, technical graphics have been less fully examined. Here the drawings of a United States patent are examined revealing a system for organizing and presenting visual information that is analogous to commonly-used models for organizing and presenting verbal information.

Donnell, Jeffrey. Journal of Technical Writing and Communication (2005). Articles>TC>Technical Writing>Technical Illustration

11.
#26474

Issues in Technical Writing

Now it is very important to recognize the vital role of a technical writer and services expected to provide to justify the requirements of this profession. Since technical writer is a sub category of technical communication, that involves other categories involved in documentation, like content writer, software configuration manager, technical editor, information designer and many more.

Albing, Bill. KeyContent.org (2005). Articles>TC>Communication>Technical Writing

12.
#22598

Learn to Read Technical Writing!

Why is my daughter not being taught to read technical literature? Practical things like reading a VCR manual or a pamphlet on health.

Kamath, Gurudutt R. IT People (2003). Articles>TC>Writing>Technical Writing

13.
#30089

Mystery Fiction and the Technical Communicator: Emotion Separates Fiction from Fact    (PDF)

Although technical documents and mysteries share certain characteristics, emotion separates the two types of writing. Mystery fiction may be popular among technical communicators because it engages both the analytical and the emotive parts of the readers' personality. This panel presentation describes techniques that mystery authors use to trigger readers' emotions. An awareness of these techniques can help technical communicators understand their affection for mysteries and stay clear about the purpose of their own work.

Jennings, Ann S. STC Proceedings (1999). Articles>Writing>TC>Emotions

14.
#10426

On Writing, Technical Communication, and Information Technology: The Core Competencies of Technical Communication   (peer-reviewed)   (members only)

This article contributes two arguments to the disciplinary conversation of technical communication with the aim of exploring leadership opportunities our field has in the field of information technology. The arguments assert that 1.) Writing is the core technology in any IT system, and all IT systems attempt to leverage the core strengths of writing to make these systems more valuable. 2.) Technical communicators have a central role to play in IT systems consonant with our core competencies: we attend to the balance of situated as opposed to generalized strategies and the balance of appeals to identity in writing about the practical use of technology, and we are well prepared to attend to these balances in other important arenas of IT discourse. Together, these two arguments are meant to begin or continue conversations—in workplace and academic contexts alike—that bring the issues of IT development and the future of technical communication closely together.

Hart-Davidson, William. Technical Communication Online (2001). Articles>TC>Writing>Technical Writing

15.
#19131

Reflections of a GTA on the Teaching of Technical Writing

Though I have a degree in technical communication and have worked as a technical writer for four years, I still had no idea what should be taught in a technical writing classroom, or how one should go about teaching it. Before I ventured into the arena as an instructor, I wanted to find out what goes on in a technical writing classroom. Two types of practical research that I thought would provide some insight into technical writing instruction were: an observation of different technical communication classrooms; and a survey of various textbooks available for technical communication courses.

Anderson, Ginger. Michigan Tech University (1998). Articles>Education>TC>Technical Writing

16.
#19159

Tactics and the Quotidian: Resistance and Professional Discourse   (peer-reviewed)

The research I discuss in this essay addresses what I take to be an unfortunate imbalance in current research on professional writing. Research reports in journals and in edited collections describe different professional discourses, how they are formed, how they operate, how organizational structure and discourse are related, and how writers learn to participate productively in institutional discourse. With some notable exceptions, very little of the research being reported concerns the ideologically coercive effects of institutional and professional discourse—what my students and I have come to call 'the dark side of the force.' If Foucault had to argue that cultural theorists should think of power as productive rather than merely repressive, I argue that rhetoric needs to recognize that the opposite is also true of discourse. That is, research in professional and nonacademic writing should begin to investigate not only the ways in which discourse produces knowledge, but also the ways in which it extends the grid of discipline and the ways in which writers resist the mute processes to which de Certeau refers in the epigraph above.

Herndl, Carl G. JAC (1996). Articles>Writing>TC

17.
#13840

Taking a Political Turn: The Critical Perspective and Research in Professional Communication   (PDF)   (peer-reviewed)   (members only)

This article examines the critical perspective as an alternative to our current descriptive, explanatory research focus. The critical perspective aims at empowerment and emancipation. It reinterprets the relationship between researcher and participants as one of collaboration, where participants define research questions that matter to them and where social action is the desired goal. Examples of critical research include feminist, radical educational, and participatory action research. Adopting the critical perspective would require that scholars in professional communication rethink their choices of research questions and sites, their views of the ownership of research results, and the types of funding they seek for research initiatives.

Blyler, Nancy. Technical Communication Quarterly (1998). Articles>TC>Writing>Rhetoric

18.
#29125

To Attract or to Inform: What Are Titles For?   (peer-reviewed)   (members only)

This article critiques some titles in journal articles for being misleading and it argues that titles need to be informative. Examples are given of work on measuring the effectiveness of titles in two areas--sentence structure and reader comprehension--and the article concludes with brief comments on the effectiveness of book titles.

Hartley, James. Journal of Technical Writing and Communication (2005). Articles>TC>Writing>Metadata

19.
#14000

Transferable and Local Writing Skills   (peer-reviewed)

One indication of the state of our profession is the discriminations that we are just getting around to making: useful, even essential, 'sortings out' that, when then, are made, seem embarrassingly obvious. One such 'sorting out' or discrimination is essential for an understanding of what any composition class can do, whether advanced composition, technical writing, feature writing, or whatever. In the writer’s repertoire, there are local and transferable skills. Local skills have to do with a given genre and involve such matters as special forms (e. g., the scientific report), footnoting, vocabularies, special styles, and even the 'tones' that particular fields demand. Transferable skills are the 'basics' of writing: syntactic fluency, control of diction, sense of audience, organizational ability, 'mechanics' such as punctuation and spelling.

Winterowd, W. Ross. JAC (1980). Articles>TC>Writing>Rhetoric

20.
#19602

We'll Never Get This Past Legal

Looks at usable writing, and convincing the legal department to adopt the tenets of clear writing.

Jarrett, Caroline. Usability News (2003). Articles>Writing>TC

21.
#29053

When a Production Worker is Technically a Writer: Using Craft and Rhetorical Knowledge in a Manufacturing Environment   (peer-reviewed)   (members only)

Although rhetoricians have studied the discourse practices of engineers, little is known about the production workers who must assemble engineering knowledge into functional products. This case study examines what happens when a production worker tried to improve manufacturing documentation, and how her success depended upon both her craft knowledge and the rhetorical skills she attributes to a Writing Across the Curriculum program she experienced in college.

VÎlez, Lili Fox and Susan P. Hall. Journal of Technical Writing and Communication (2001). Articles>TC>Technical Writing>Engineering

22.
#21686

Why Technical Writers are Midwives

Technical writers are midwives who deliver the message to users. Experienced technical writers enable you to understand complex technical concepts easily. Based on personal experience, technical writers always put the reader first.

Klariti. Articles>TC>Writing>Technical Writing

23.
#18774

Writing to the Nines   (PDF)

The perils and temptations of high fashion are not unlike those of technical writing. As technical writers, we are bombarded by ever-changing trends. And beyond trends, we must contend with larger movements driven by the digital generation. In the midst of constant change, we are tasked with creating quality material and then shaping it to fresh and exciting designs.

Morris, Angie and Candace Wagner. STC Proceedings (2002). Articles>Writing>TC

24.
#31739

How Can I Become a Successful Technical Writer?

The best thing you can do to develop your skills and ability with technical writing is to actually do some technical writing. Find an open source project, such as WordPress.org or Pligg, and write some documentation for it. Most open source projects have poor documentation, so they provide excellent opportunities.

Johnson, Tom H. I'd Rather Be Writing (2008). Articles>TC>Writing>Technical Writing

25.
#31794

It's Not the Tool, It's the Writer

This blog post ponders whether or not technical communicators are sometimes too enamoured with the tools, and because of that lose sight of what's best for the reader.

DMN Communications (2008). Articles>TC>Technical Writing>Technology

 

Copyright © 2001-08 by the EServer. All rights reserved.Add a Work | Site Preferences | Discussion Forum | Habitués  

There are 20 readers currently online: 0 registered users and 20 guests. Register.RSS feedClick here to learn how to embed the RSS feed of this category in your website.