TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:RE: Need some opinions on phrasing From:"Sarah Blake" <Sarah -dot- Blake -at- microfocus -dot- com> To:"Techwr-l" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 28 Jan 2009 12:02:49 -0000
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 :)
S.
> The problem isn't that you're promising that
> there will be a future version. The problem is
> when you appear to be promising that something
> will work or will be available in all future
> versions. So, we're not supposed to say things
> like "This feature is available in GoodCode
> version 7 and higher" or "To run this application,
> you need GoodCode version 7 or later." Saying
> "at least version 7" only gives the starting point
> of the availability or feature.
>
> -- Janice
Please consider the environment before printing this e-mail.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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. http://www.doctohelp.com
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! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-