Hypertext as a Productivity Tool for Technical Writing  

Hypertext is a novel approach to computer-based information management based on associative indexing. The concept in general and the characteristics of typical systems are briefly reviewed. Strategies for applying hypertext techniques to the process of writing a technical document are examined. The way in which hypertext documents are used is discussed, focusing on a commonly encountered problem -- user disorientation within the document. Hypertext-based technical documents are compared and contrasted against their paper-based antecedents.

Lenarcic, John. STC Proceedings (1993). Articles>Information Design>Hypertext>Technical Writing

Information Architecture Concepts for the Technical Writer

Information Architecture (IA) as a discipline practiced by professionals in the information processing and development industry has many definitions and levels of understanding.

Gummaraju, Anupama. Indus (2005). Articles>Information Design>Writing>Technical Writing

Putting the "Technical" in "Technical Writer"  

Owens explains how technical writers can bolster their credentials as technically knowledgeable employees. He provides brief introductions to technologies that technical writers are most likely to encounter on the job: programming languages, databases, and Web server technologies.

Owens, David. Intercom (2003). Articles>Writing>Information Design>Technical Writing

Quality Criteria for Indexes, Website Navigation and Search    

When users find the answers they are looking for, the investment in technical documentation gets a chance to pay off. In large volumes of technical information, just finding the answer can be half the battle. Microsoft found that users of its intranet were spending an average of 2.5 hours per day online - 50% of that being searching. This article was written as part of an experimental online workshop with the MITWA (Mentors, Indexers, Technical Writers & Associates) discussion group(http://groups.yahoo.com/group/MITWA/). The article retains the workshop format including learning assignments.

Brown, Fred. International Journal for Technical Communication (2006). Articles>Information Design>Web Design>Technical Writing

Semantic, Structured Authoring

This article looks at the impact of the introduction of semantic markup and structured authoring on the world of technical writers, editors, Help authors and content developers. This article is not specifically about the Semantic Web movement itself, but about the implementation of semantic concepts in the documentation field.

Self, Tony. HyperWrite (2006). Articles>Information Design>Semantic>Technical Writing

A Style in Technical Writing   

This course is designed to teach you to: recognize the variety and characteristics of styles of technical communication; adapt your writing style for different aims and audiences; revise efficiently and appropriately; and articulate reasons for revisions in your writing.

Dragga, Sam. Texas Tech University (2009). Articles>Information Design>Visual>Technical Writing

Two Approaches to Modularity: Comparing the STOP Approach with Structured Writing  

The first time I heard of the STOP paper was sometime in the mid 80's when the historian of technical writing, John Brockman, phoned me to ask if my Information Mapping method of structured writing derived from the STOP method. At the time I told Brockman that there was no direct relationship between our two approaches since I'd never read the paper. When the editor of this journal sent me the STOP document in preparation for writing this paper, I read it with delight. Although our two innovations date from the same period, the STOP authors and I were working in two completely different disciplines, cultures, organizations, and locations. These two approaches resulted in modularity - albeit of quite different kinds. The main purpose of this project is to compare and contrast these two approaches to modularity. I should note here that I approach this article principally as an exercise in historical comparison, rather than as an exposition of my current views, about which I will say a bit at the end of this article.

Horn, Robert E. Journal of Computer Documentation (1999). Articles>Information Design>Technical Writing>History

Web Application Maps Business Opportunities

A technical writer develops a way to help a government contractor uncover procurement opportunities -- and in the process discovers a new opportunity for himself as an information profit center.

Montague Institute Review (1998). Articles>Knowledge Management>Information Design>Technical Writing

Potential Position Descriptions for Information Engineering Professionals

This article defines the tasks and responsibilities for up to seven levels of information engineers, plus two levels of management.

Capri, Steve. TechCom Manager (2007). Articles>Management>Information Design>Technical Writing

Lessons in Introductions from O'Reilly

Book published by O'Reilly Media have a good flow to the information and they're well structured. One of the best features of many of those books is the introductory material. It can be a good guide, and help readers zero in on what they want to learn.

DMN Communications (2008). Articles>Writing>Information Design>Technical Writing

Structured Authoring for Everyone

Structured authoring isn't just for technical writers. Just about any department in an organization can benefit from it. This article looks at one way of bringing structured authoring to the masses: by adopting the authoring concepts used in an obscure word processor called Yeah Write.

DMN Communications (2009). Articles>Information Design>Technical Writing>XML

Syntext Serna and New Trends in XML Content Authoring

Recent trends in XML content authoring demonstrate increasing shift towards advanced reuse patterns and multi-source compound document architectures. This imposes completely new requirements for the XML authoring tools, most of which were originally developed for narrative document authoring and architectures like Docbook or TEI. The key requirement is the ability to provide a single, transparent, directly editable view for such complex documents.

Antonov, Paul. IDEAlliance (2005). Articles>Information Design>Technical Writing>XML

Wurman’s LATCH Model of Information Organization For Technical Documentation

Technical writing has its mechanical aspects that need to be mastered. A good technical writer must know how to use English effectively as well as various software products to produce acceptable technical documents. But I wish technical writing were all about that. The hardest part comes before one even sits down in front of a computer to type the first word. The hardest part in documenting anything is organizing the information in a way that makes sense from the user’s point of view. Otherwise a technical document suddenly looks irrelevant.

Akinci, Ugur. Technical Communication Center (2009). Articles>Information Design>Documentation>Technical Writing

The Case for Simple Numbering

Rather than spend hours coming up with a complex numbering scheme, this might be an excuse to implement something far more straightforward discovered by an extensive readability study at IBM, of which I was a part. My work involved sitting behind a one-way mirror with a stopwatch, watching people take tests that involved, among other things, "how fast can you find Figure 3-4?" We had cameras mounted over the participant's shoulders and could watch them thumb through the documents, and we also monitored eye movements. Then we followed up with a short interview where we got feedback.

Techknowledgecorp (2007). Articles>Document Design>Information Design>Technical Writing

What Technical Communicators Can Learn from Comics    

Citing the rise of graphic novels, comics, and in particular, Google’s new web browser Chrome, which has a comic-book-style manual, Opsteegh argues that technical communicators can learn a thing or two about conveying information from graphic novelists.

Opsteegh, Michael. Intercom (2009). Articles>Information Design>Technical Writing>Documentation

Creating Topics: Where do you Draw the Line?

It's hard to look at a page of text and try to decide where to divide things to create individual topics. That "bottom up" approach is kind of pointless, in fact. There are better ways.

Armstrong, Eric. Sun Microsystems (2008). Articles>Documentation>Information Design>Technical Writing

Content Curation: A Manifesto

A Content Curator is someone who continually finds, groups, organizes and shares the best and most relevant content on a specific issue online. I think that professional writers and technical writers should consider a move towards this role. We already search for and find the best content, sift through loads of content, discard poor content, and publish the most worthy content whenever a software release goes out. This description also sounds like something a content strategist would do as part of their analysis of the content.

Gentle, Anne. Just Write Click (2009). Articles>Content Management>Information Design>Technical Writing