Re: Document layout: Whose decision?

Subject: Re: Document layout: Whose decision?
From: "Jeanne A. E. DeVoto" <jaed -at- jaedworks -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 14 Feb 2001 13:09:39 -0800

At 12:49 PM -0800 2/14/2001, Sunshine QT wrote:
>guide is set, my templates are set. A programmer who
>usually does not need documentation recently needed a
>doc done and complained that he wants it without the
>side-head - in other words, he wants the lines to go
>all the way across. (He didn't say why.)

Why haven't you asked him why?

>My feeling is that, I don't tell them how to program;
>they don't tell me how to lay out documents. But I am
>willing to listen to *your* feedback. (Since you are
>fellow tech writers.)

Well, maybe that's the answer to my question. If so, it makes me sad.

Ask the programmer why he wants documentation without a side column. There
are a number of possibilities, which break down into two cases:

1) He has a reason for wanting it done this way.

2) He has no reason for wanting it done this way.

You, and much less random writers on a mailing list, can't begin to come up
with a response until you know which.

jeanne a. e. devoto ~ jaed -at- jaedworks -dot- com

Develop HTML-Based Help with Macromedia Dreamweaver 4 ($100 STC Discount)
**WEST COAST LOCATIONS** San Jose (Mar 1-2), San Francisco (Apr 16-17) or 800-646-9989.

Sponsored by ForeFront, Inc., maker of ForeHelp Help authoring tools
for print, WinHelp, HTML Help, JavaHelp, and cross-platform InterHelp
See for more information and free evaluation downloads

You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: Re: The Sub Shop Guy
Next by Author: Re: Proving an MS standard
Previous by Thread: Document layout: Whose decision?
Next by Thread: Document layout: Whose decision?

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

Sponsored Ads