TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
I thought I should post this update to my little dilemma. A coworker
wrote a macro that will strip all spaces and all punctuation from our
five million page document library. In fact, the macro will take the
random, jumbled, and half-formed thoughts of our engineers and will
publish new documents automatically, without any human interaction!
Moreover, the macro will reduce the publication cycle to a few days.
Just before product FCS, we can run the macro to produce the product
documentation. The macro intelligently "collates" a database of notes,
diagrams, and specs written by our product development engineers, and
then produces camera-ready copy for use by our document control and
distribution center.
In addition, since the macro only uses the latest information from our
engineers, all information in our documents will be current and
accurate! There is now no need for review cycles. Our documents will
be generated a few days before FCS--ready to ship!
Since the macro runs a spell check and since there is no more need to
check grammar (because we eliminated all punctuation), our documents
no longer require editing. Consequently, we fired all of our editors
yesterday. (Will the miracles of modern technology ever cease?)
Alas and alak, my expected job security was short lived. My manager
just told me that since our documents are no longer readable by human
beings and since nobody reads our documentation anyway, my services are
no longer required. I've, I've, been fired!
Oh, the irony of it all. I've been replaced by a macro. ;-)
>At first I opposed these new style guidelines that eliminate all instances of
>spaces, apostrophes, and punctuation marks. It meant I would have to work
>around the clock for the next 10 years to make our documentation conform to
>the new style guidelines. 10 years without sleep was not a pleasant thought.
>However, after some more reflection, I realized that this made perfect sense
>in a twisted and warped sort of way. I realized that job security is more
>important than readable documentation any day! Still got to pay the bills...
Randy Grandle
-------------------------
Project Lead Writer
Sun Professional Services
-------------------------
TECHWR-L List Information
To send a message about technical communication to 2500+ list readers,
E-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send administrative commands
ALL other questions or problems concerning the list
should go to the listowner, Eric Ray, at ejray -at- ionet -dot- net -dot-