Re: Need some opinions on phrasing

Subject: Re: Need some opinions on phrasing
From: Janice Gelb <Janice -dot- Gelb -at- Sun -dot- COM>
To: Techwr-l <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 29 Jan 2009 06:34:24 +1100

Sarah Blake wrote:
> I see the distinction they're trying to make, but I don't think it's a
> distinction that the language actually supports. The 'promise' may be
> more obvious in the 'or higher' but it's still implicit in the 'at
> least'.
> I can see the support calls now...
> Customer: This feature doesn't work.
> Support: OK, well what do you have installed...
> Customer: I'm running VaporWare 3.8 with BugWare 2.7
> Support: Ah, that's your problem. BugWare 2.7 doesn't work with
> VaporWare later than 3.2.
> Customer: Your documentation says 'at least VaporWare 2.7'. I'm
> running at least VaporWare 2.7. I followed your advice exactly, so if
> it doesn't work it's your fault and I want you to fix it.
> ...I don't really see that particular phrase substitution as solving the
> problem :)

Legal's point of view is that the phrasing "at
least VaporWare 2.7" only states that versions
before 2.7 won't work and that version 2.7 will.
It doesn't say anything specific about 2.8 or later.
Future versions of the documentation can clarify later
incompatibilities without specifically contradicting
earlier statements.

"Sorry, ma'am, but the documentation you're referring
to was superseded by a later statement in the docs
for version 3.0, which clearly said that the product
no longer worked with BugWare. We never claimed that
future versions above 2.7 would continue to offer this

-- Janice

Janice Gelb | The only connection Sun has with
janice -dot- gelb -at- sun -dot- com | this message is the return address


ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

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

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Please move off-topic discussions to the Chat list, at:


Re: Need some opinions on phrasing: From: Stuart Burnfield
Re: Need some opinions on phrasing: From: Janice Gelb
RE: Need some opinions on phrasing: From: Sarah Blake

Previous by Author: Re: Need some opinions on phrasing
Next by Author: Re: Need some opinions on phrasing
Previous by Thread: RE: Need some opinions on phrasing
Next by Thread: RE: Need some opinions on phrasing

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

Sponsored Ads