Re: Solution! RE: pushpins

Subject: Re: Solution! RE: pushpins
From: David Castro <thetechwriter -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 1 Jul 2003 03:18:49 -0700 (PDT)

Bruce Byfield wrote:

> Wasn't it just last week that half the posters on the list were
> belittling designers for worrying about a fractional different in font
> size?
> How is worrying about whether to use a hyphen, a space, or no space any
> better?
> I'm sorry, but I just can't see how taking a stand on the matter affects
> the useful of your docs one way or the other....It's a small gesture
> that can make a reviewer feel better, and I simply can't get worked up
> about such matters one way or the other.

Exactly, Bruce! When I'm figuring out whether/how to incorporate feedback from
reviewers, I have a litmus test question that I ask: "Will incorporating this
feedback make the documentation harder to understand?" If the answer is no, I
will always, always, *always* incorporate the feedback. It's hard enough to get
feedback out of certain developers, so the last thing that I want to do is
refuse to go with the way they want to spell things or say things if there
isn't a compelling reason to do so.

In a worst-case scenario, consider using a variable for the word, and then if
you decide later that it should be spelled differently, you can just change the

-David Castro


Create professional Help systems that feature interactive tutorials and
demos with all new RoboHelp Studio. More at

Mercer University's online MS Program in Technical Communication Management:
Preparing leaders of tomorrow's technical communication organizations today.
See or write George Hayhoe at hayhoe_g -at- mercer -dot- edu -dot-

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: ADMIN: Civility and content
Next by Author: Spell-checking documents with lots of code?
Previous by Thread: Re: Has anyone reviewed or edited using PDF marked up by Acrobattools?
Next by Thread: Re: Solution! RE: pushpins

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

Sponsored Ads