Re: Phrasing recommendations -Reply

Subject: Re: Phrasing recommendations -Reply
From: "Campbell, Art" <artc -at- NORTHCHURCH -dot- NET>
Date: Mon, 24 May 1999 10:00:47 -0400

IMHO, telling a user to accept the default selection instead of allowing
to adjust whatever the setting is advertises a weakness in the program or
installation routine. If a setting is supposed to be adjustable but doesn't
work with anything but the defaults, it's broken -- it's a bug -- and ought
to be fixed; it shouldn't be documented as a bug.


Art Campbell
Technical Publications
Northchurch Communications
Five Corporate Drive
Andover, MA 01810
978 691-6344

-----Original Message-----
From: Kathryn Northcut [mailto:KNorthcut -at- TASC -dot- USDA -dot- GOV]
Sent: Monday, May 24, 1999 9:55 AM
Subject: Phrasing recommendations -Reply

I've run into this several times lately, and when possible, I go with this:

"To avoid blah blah, use the default rather than changing the user name."
If I can't document what they're avoiding (or whatever verb fits), I'd just
cut off the part before the comma. I totally agree that "it is recommended"
and "we recommend" without attribution is uncomfortable.


From ??? -at- ??? Sun Jan 00 00:00:00 0000=

Previous by Author: Re: Summary: Documenting a **** user interface feature
Next by Author: Re: Technical Editing
Previous by Thread: Phrasing recommendations -Reply
Next by Thread: Re: Phrasing Question

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

Sponsored Ads

Sponsored Ads