Tech Biz Writing

Printing
Categories of printing methods: Most modern technical documentation will be printed by fast laser, docuprint techniques, often in-house, leaving the writer considerable control over the final outcome. Still to be found, however, are three traditional methods of printing:

* Relief printing
* Intaglio printing
* Planographic printing.

Relief printingTechnical Illustrations

Diagrams
Diagrams are two-dimensional line representations, usually intended for line plate reproduction. They are used in the presentation of symbolic, statistical, and functional information.

Line illustrations
Reproduction of line illustrations: These pictorial drawings are reproduced in a single solid colour with no tonal gradation. They have no intermediate grey tones and consist entirely of lines, dots or solids.
Perspective drawings: Realism is added to line illustrations by means of perspective:

* One-point (parallel)
* Two-point (angular)
* Three-point (oblique)

Three-point perspective is usually incorporated in technical illustration because it is the only form which allows the depiction of three faces of an object without distortion.

Vanishing points are dots placed at the periphery of a perspective drawing to which parallel lines apparently converge. This gives the impression of actual perspective on a two-dimensional plane. In three-point perspective, three vanishing points are used.

Half-tones
Half-tone process: is used to reproduce any subject employing continuous tonal gradation. The material is overlaid with a screened negative or glass plate, which breaks up the image into a pattern of dots of apparently varying density.

Validating technical illustrations
Checklist for vetting illustrations:

* Has spec been followed?
* Is format right?
* Are there technical errors?
* Is title correct?
* Is lettering of sufficient size?
* Are page and figure numbers correct?
* Is security marking accurate?
* Are layout and composition clear?
* Is line thickness correct?
* Are cross-references correct?
* Is material crossing spine clear?
* Is shading correctly placed?
* Have tints or colour codes been correctly indexed?

Next : 58. Technical Editing.

A few short years ago the materials and equipment of a technical writer would not have seemed out of place in the latter part of the 19th century. Today, much of that has been swept away by the all-devouring march of information technology. It’s hard to think of any function now that is not carried out using computerized equipment of one sort or another.

Whole swathes of earlier textbooks on the subject have had to be scrapped because of this. Irritating though this might be in one regard, in another — convenience — it’s a Godsend. Life is so much easier now for tech writers that they don’t have to worry about mountains of small, specialised items relating to their task and their’s alone. Almost every office is now equipped with the standard kit for every trade. Hot-desking is a real solution.

So, when it comes to describing the materials and equipment of a technical writer, there’s not that much to say beyond the contents of an average office. Paper sizes are now standard, and esoterica like “demy octavo” a thing of the past, except to the historically-minded.

Photocopying technology has moved on to digital printing/copying using fast laser techniques which are set to replace offset litho for most jobs in the very near future.

Microfilm is still around, especially in libraries, but is being rapidly replaced by CD ROMS and DVDs with “burn” capabilities.

As we discussed in the previous section, almost all technical artwork is now done on-screen, and for small-to-medium sized technical documentation a single cluster of IT hardware handles every task from draft to final copy, to design and artwork, to resource storage, to draft print, final output and binding. Such is the capacity of modern systems to embrace every task within the same box of tricks. All that’s needed to make it work is that even more exquisite unit of hardware/software: the technical writer in person.

The Technical Writer
Technical writing is rather a mixed bag of a career. The qualities required of a writer vary from literary proficiency of a basic sort to capabilities of man management. In between, there are the technical skills and a knowledge of many divergent disciplines. A writer usually requires some aptitude for general management, and also the elusive ability to prise information from reluctant sources: engineers, busy technicians or frantic designers behind on their schedules.

A technical writer may be pictured as the co-ordinating centre of a complex web of trades and profession. here we examine some of the peripheral aspects of the subject. It’s not possible to cover everything here, but prospective writers should get at least a glimpse of the kind of tasks they may be faced with. We begin with translations — points to look for when preparing technical material for a translator. We then examine the sometimes awkward topic of abstracting and abridging; awkward because it takes some skill to distil a larger document to a smaller one, without missing anything out. A brief consideration of indexing is included here, as also in the next module which deals with the editing of an index. This is followed by a section on the Development Documentation System (DDS), and a look at the documentation systems used for the maintenance of complex equipment. A discussion of Network Analysis concludes the section.

Next: 42. Translations.

Technical illustrations need to be checked in much the same way as the accompanying text. In complex drawings, authors should watch particularly for omissions of lines or annotations. Annotations may be direct or indirect. That is, set on the drawing, or keyed to a separate table. In the latter case all cross-referencing should be confirmed.

The following checklist suggests points to look for when vetting a technical illustration:

* Has the specification been adhered to?
* Is the format correct?
* Are there any technical inaccuracies?
* Is the titling correctly placed and worded properly?
* If the illustration is to be reduced, is the lettering readable?
* Is the page identity or figure number accurate?
* Is the security marking present and correct?
* Is the layout and composition clear?
* Is the line thickness to spec and uniform?
* Are cross-references correct, or hyperlinks live and true?
* For double-page spreads, is the material across the fold readable?
* For simulated shadow-lines, are these placed correctly and uniformly?
* If a variety of tints are used, have they been correctly indexed?

For more detail in this peripheral area for the author, there are many good books available.

Next: 41. Materials and Equipment.

Picture from designer-info.com.

The half-tone process is used to reproduce any subject with continuous varying tones, such as photographs, shaded-in or wash drawings, air-brush work, and drawings in which the lines are so closely spaced that they would reproduce as tonal gradations.

Half-tone illustrations are generally more costly to reproduce than line drawing. Photographs may need retouching by expert hands, or the tonal contrasts may require heightening. Another consideration is the compatibility of the printed half-tone with the rest of the artwork, especially since it demands a certain quality of paper for satisfactory reproduction. We have all come across relatively expensive books which have half-tones like poor photocopies — mostly a sludge of black ink with a few dim details barely discernible. New tech doesn’t always serve the reader as well as it might.

Line drawing may sometimes be more appropriate, and less expensive, for the subject matter and presentation required. In order to produce a continuously toned subject, a printer overlays the photographically sensitive material with a screened (grid-like) glass plate or negative, which has the effect of breaking up the image into a pattern of dots. Dark areas of the original are reproduced by large dots with less separation than the smaller points representing lighter areas. In this way, tone and shape are built up on the plate. Newspaper pictures are traditionally printed this way.

You must always be careful not to submit a printed screened picture for printing — and hence further screening — without making sure that the printer adjusts the screen adequately to eliminate that irritating wavy effect you can sometimes spot in cheaply produced brochures.

Next: 40. Validating Technical Illustrations.