[Author Prev][Author Next][Thread Prev][Thread Next]
[Author Index (this month)][Thread Index (this month)][Top of Archive]

Re: Giving a Document **One Voice**

Subject: Re: Giving a Document **One Voice**
From: Martha J Davidson <editrix -at- nemasys -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Fri, 03 Feb 2006 12:30:29 -0800

At 10:00 AM 2/3/2006, John Posada wrote:

I do this often. The first thing I do is make sure all the documents
are using the same style template. This is one of the reasons I like
FM...it's easier to enforce strict style usage.

I agree completely. In fact, I agree with everything John wrote.

Check that important words are are used consistently. For example,
some authors like "Dialog box", some like "Dialogs"...on any similar
instance, pick one, any one, and stick to it.

I think this is an essential step. And I'd go one step further and
suggest (which I read implicitly in John's words and want to
make explicit) that each time you make a word or style choice,
you write it down so you'll remember the next time what you chose.
This list will become the kernel of a style guide for the document,
and for future projects like it.

martha
--
Martha Jane {Kolman | Davidson}
Dances With Words
editrix -at- nemasys -dot- com

"Too many words bring about exhaustion."
--Tao Te Ching, Chapter 5 (translated by Sheets/Tovey)


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-
To unsubscribe send a blank email to techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.

Follow-Ups:

References:
Giving a Document **One Voice**: From: Kirk Turner
Re: Giving a Document **One Voice**: From: John Posada

Previous by Author: RE: Most annoying word
Next by Author: Re: Most annoying word
Previous by Thread: Re: Giving a Document **One Voice** -CORRECTION
Next by Thread: Re: Giving a Document **One Voice**

[Top of Archive] | [Author Index (this month)] | [Thread Index (this month)]

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

Sponsored Ads