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
variable.

-David Castro
email[at]davidcastro[dot]com
http://jsp.davidcastro.com

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

ANNOUNCING ROBOHELP STUDIO
Create professional Help systems that feature interactive tutorials and
demos with all new RoboHelp Studio. More at http://www.ehelp.com/techwr-l2

Mercer University's online MS Program in Technical Communication Management:
Preparing leaders of tomorrow's technical communication organizations today.
See www.mercer.edu/mstco 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
http://www.raycomm.com/techwhirl/ for more resources and info.



Follow-Ups:

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