One shot style guides

Subject: One shot style guides
From: "Feldman, Richard" <FeldmanR -at- MTSS -dot- KIRTLAND -dot- AF -dot- MIL>
Date: Wed, 27 May 1998 19:52:28 -0600

Another in a series of periodic questions from the world of documenting
flight simulators:

My employer has farmed me out to a customer which needs an operation and
maintenance manual written for a flight simulator which its people have
modified. I am not starting from scratch, but instead working on a
document torso which was copied from manual in progress for a related
device and which was then modified by several engineers who were briefly
assigned to the writing project before I was brought in. Not
surprisingly, given the document's lineage, the style in which the
various document elements have been treated is somewhat erratic.

While some of the stylistic components have been prescribed by powers
that are, I still have considerable leeway. I have personal preferences
in some matters, but on others I am still not sure how I want to treat
them. I would like to create a style guide both to remind me what
stylistic decisions I've already made or haven't made and to leave on
site for reference in case anybody else has to revise the manual after
I finish the assignment and return to my regular office in a few months.

I looked at several archived discussions of style guides and sheets and
got some ideas, but none of the discussions seemed to apply to my
current situation: I would like to create a chart/guide both to
facilitate stylistic consistency and to leave a record of what style
decisions were made, but just for a single project. Can folks point me
towards a template of or generate a list of elements which they would
include in such a chart?

Please follow your inclination whether it's more appropriate to reply
directly to me or to the list. I will summarize personal replies for
the list if demand warrants.


Richard Feldman, Technical Writer
Camber Corporation, Simulation Systems Division
feldmanr -at- mtss -dot- kirtland -dot- af -dot- mil (1-505) 256-6708
Bldg. 952, Rm 129 Kirtland AFB, Albuquerque New Mexico USA


Previous by Author: New Slant
Next by Author: Re: Quark to Pagemaker
Previous by Thread: Re: The Lessons of ValuJet 592
Next by Thread: Re: RoboHelp 6.0

What this post helpful? Share it with friends and colleagues:

Sponsored Ads