Technical Writing

As an experienced technical writer, I present technical information in a manner that facilitates ready assimilation and comprehension. I strive for clarity and avoid ambiguity. I am very well trained in the proper use of the English language as well as in formal logic, informal fallacies, and recognizing and correcting amphiboly.

I have generated the full gamut of technical instructional literature, including the following:

Guidelines for product application & selection,
Instructions for assembly, installation, and operation,
Instructions for maintenance, and troubleshooting
Instructions for safety & quality assurance,
Product documentation, &
Process documentation.

Deliverables

Deliverables have included user manuals, training materials, brochures, catalogs, data sheets, job aids, and presentation graphics. Subject matter has included mechanical, electromechanical, and automated products, systems, controls, and user interfaces, encompassing the following:

Conveyors and material-handling products, systems, and controls,
Automated chemical-processing systems,
CNC machine tools,
Integrated manufacturing systems,
Rocket-engine avionics & automated systems for testing rocket-engine avionics,
Web-fed, multi-station, offset and ink-jet perfector printing systems,
Paper-making and converting machines,
Electronic medical-diagnostic equipment,
Commercial ovens,
Architectural, ventilating, and plumbing products,
Control systems for hydronic heating and cooling systems, &
Modular office furniture.

Since virtually all of the technical writing I have done has been performed under nondisclosure agreements, I am unable to provide very many actual work-related Writing Samples. I have, however, written, illustrated, and photographed everything on this website, with one notable exception: I did not take the photograph of the brain on the Cognitive Psychology page . . . and it isn't even my brain!

Avoiding Confusion

Flaws that I commonly find in technical literature that contribute to confusion include the following:

Failure to orient the end user to the topic before delving into details,
Failure to define or clarify obscure terms,
Inconsistent terminology to refer to the same object,
Convoluted syntax,
Disagreement in number between the subject and the predicate, or between a pronoun and its antecedent, especially where a modifying phrase intervenes,
Lack of parallelism in lists,
Use of words as parts of speech not proper to them,
Misuse of the solidus (“slash”),
Dangling modifiers, and
Improper punctuation.

These flaws not only contribute to confusion in the immediate message, but cumulatively and collectively, acceding to them in technical communication compromises the capacity of the language to convey precise things in a precise way. Preserving the capacity of the language to convey precise things in a precise way is vitally important, especially in technical communication.

Linguistic Philosophy

By its very nature, a language – any language – is a convention consisting of a set of symbols, such as a vocabulary, and a set of rules governing the use of those symbols, such as a grammar (and no, so-called “body language” is not a real language; it may be a mode of expression, but it is not a genuine language per se). This is true for all languages – natural languages, computer languages, mathematical, scientific, and engineering notation, symbolic logic, and so forth. What makes a convention a convention is adherence, not deviation. In order for a language to serve as an effective mode of communication, it is necessary for users of the language to adhere to its conventions. Deviation from established conventions invites ambiguity and confusion.

On Definitions

Logicians recognize five kinds of definitions:

Lexical – established or “dictionary” definitions. A lexical definition not only describes how a given term is normally used but also prescribes how the term normally should be used,
Stipulative – a definition that is given for a brand-new term when it is first introduced,
Precising – a description that clarifies the exact, intended meaning in instances where the relevant lexical definition alone may not be sufficient,
Theoretical – the formulation of a theoretically adequate characterization of the objects to which it is applied, and
Persuasive – a type of definition the purpose of which is to influence attitudes.

The notion of a personal “definition” of a word that is unique to the individual (e. g., “my definition” of a word versus “your definition”) is antithetical to the essential nature of language. Confusion over the difference between a definition of a word and a referent to which the word is applied, however, abounds. When one uses a word, he or she invokes a (normally lexical) definition for the word and uses the word to refer to some object under discussion. The object in question is called a "referent," not a definition. It is frequently over the referents or objects to which they are referring that people disagree, not their "definitions." A given object may be the epitome of the category to which the object belongs, but such an object is never the definition of the term.

When something new is discovered, invented, or innovated, of course, we obviously need to have some way of referring to it, and so new terms are coined, or new definitions are added to pre-existing words. Also obviously, a word can have multiple definitions. It is important to note, however, that words take on new definitions by accretion, not displacement; pre-existing definitions are retained even as new definitions are added. So, when a new definition is added to a word, the risk of ambiguity is increased. Consequenty, when encountering a term to which a relevant new definition has recently been attached, it is necessary to clarify which sense is intended.

Linguistic "Evolution"

Some people argue that the English language is constantly changing and evolving, that nothing in the language is stable. While there is some truth to that proposition – fad words and trendy idioms come and go, for example – it is more important to notice that the core of Standard English stays the same, that the definitions of most words do not really change significantly from one generation to the next. Otherwise, it would be impossible for people to make sense of the novelties.

To some degree, linguistic evolution may be unavoidable. Shakespearean English, for example, is practically unintelligible to us today. Yet Shakespeare died over 400 years ago. To our current, highly technological generation, it is imperative to maintain the capacity of the language to express precise things in a precise way. Professional users of the language therefore have a natural fiduciary duty to resist the impulse and pressure to give the language an "evolutionary push." Taking liberties with the language is for advertising copywriters and demagogic politicians. The dutiful technical writer, however, adheres to the established conventions of the language, to the lexical definitions of words, and to the use of words as parts of speech that are proper to them.

Layout & Design

The layout and design of a page are integral to the presentation of information. When it comes to the topic of layout and design, many technical-writing instructors simply tell their students to make the page “pleasing to the eye,” and they leave it at that. That kind of advice seems awfully subjective, and it provides utterly no guidance for precisely how to make the page “pleasing to the eye.”

Neurological Processing of Visual Data

It is often assumed that graphic displays are acquired directly into the mind wholly intact, much like importing a raster image into a document, but it doesn’t work that way at all. The retina and primary visual cortex are not conceptual organs; they do not recognize what they are beholding or comprehend the slightest significance of anything presented to them. Yet all of the information presented in written and graphic form must be processed through the retina and visual cortex before it is received into working memory, that is, the presently conscious mind. So, it is beneficial to have some understanding of how the retina and visual cortex process incoming visual data in order to design the presentation of information judiciously.

A very complex series of analyses occurs, beginning in the retina and in the primary and secondary areas of the visual cortex in the occipital lobe of the brain. Further processing occurs via the dorsal stream (the "where-and-how" path) in the parietal lobe and via the ventral stream (the "what-and-who" path) in the temporal lobes. Altogether, these analyses include detecting light and dark, color, contrast, motion, shape, feature and object recognition, and a host of additional attributes. In the retina and in the visual cortex, there are dedicated neural synapses for detecting each of these aspects of the visual array.

These analyses occur even before the mind becomes aware of what the eyes are looking at, which is to say that the process is entirely subliminal. Ultimately, the results of this analysis are filtered when transferring data from sensory memory to working memory in accordance with the perceiver's attentional focus. Yet it only takes a fraction of a second for the mind to recognize and respond to what the eyes are looking at, which attests to how rapidly this analysis occurs.

When reading a document or viewing a presentation, the end user is normally focused on the content and meaning of the message and not specifically on the design features of the visual display. Yet the eye and brain have to process every visual element presented to them on a page or screen, including those elements that are filtered out before reaching working memory. The more complex the graphic display, the more work the eye and brain have to do to process it, which results in increased eye strain and visual fatigue, which in turn reduce the tolerable duration of concentrated attention. So, for the end user's sake, it behooves the technical writer or instructional designer to simplify the graphic display as much as possible and to cater to the sensibilities of the eye and brain.

My Design Approach

I take a design approach based on cognitive and Gestalt psychology, and I apply principles of Design for Effective Communication of Technical Information (DECTI). I eliminate graphic elements that are not essential. I utilize visual mass, grouping, alignment, and spacing to enable the content of the message to organize itself visually and to optimize space utilization. These techniques are especially helpful with very complex tables in which horizontal space is at a premium.

Though such a “hard-core” approach is not needed for the easy cases on certain pages, I design the whole document based on the hard cases, and the easy cases will fall into place. That way, the entire document has a consistent “look and feel,” and the graphic treatment speaks with a single, professional corporate voice. By no small coincidence, objectively speaking, this approach also tends to be “pleasing to the eye.”

Return to the top of the page.