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.
If your customers start demanding that you support VMWare then you must
ask your testing/development/managers and everyone else what their
policy is. Cop-out? Perhaps. But in all honesty they'll be able to make
that 'call' and spare you grief when a customer comes, manual in hand
asking why it states here that they can, when they can't :)
We test using VMWare, but we don't say that the product is supported in
it. Come to think of it, the help doesn't say what we do support. Hmmm.
Nicola
-----Original Message-----
From: techwr-l-bounces+n -dot- harlow=seamsltd -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+n -dot- harlow=seamsltd -dot- com -at- lists -dot- techwr-l -dot- com] On
Behalf Of McLauchlan, Kevin
Sent: 02 April 2008 16:03
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: reporting testing
This is just for you folks who document software and hardware/software
products.
This is just hypothetical for now... of course...
Does your testing department test your product on the supported OS
platforms "nekkid", or do they use (for example) VMWare for convenience?
If they use (say) VMWare to test (say) several Windows versions, Linux
versions, Solaris x86 versions, and so on, do you list in your published
documentation that the product was tested on the OS or on the
OS-under/over-VMWare? Or do you just ignore that "issue" and simply
report that a platform is supported or not?
What happens when customers begin demanding that you explicitly support
VMWare?
If you are already testing using VMWare for convenience, do you just add
a "yes" or checkmark for VMWare, or do you now have to differentiate....
oh my head.... ?
In the end, it's not an ethical issue because we support what we
support, and we are on the hook to make something work if it is found
not to work. I'm just looking to get a feel for how it's handled by the
rest of the documentation world. I suspect that it's simply not an
issue for most, but I thought I'd inquire.
Kevin
The information contained in this electronic mail transmission may be
privileged and confidential, and therefore, protected from disclosure.
If you have received this communication in error, please notify us
immediately by replying to this message and deleting it from your
computer without copying or disclosing it.
Create HTML or Microsoft Word content and convert to Help file formats
or printed documentation. Features include support for Windows Vista &
2007 Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as N -dot- Harlow -at- seamsltd -dot- com -dot-
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 http://www.techwr-l.com/ for more resources and info.
This e-mail and any files transmitted with it are confidential and intended solely for the use of the addressee. If you are not the intended addressee, or the person responsible for delivering it to them, you may not copy, forward disclose or otherwise use it or any part of it in any way. To do so may be unlawful. If you receive this e-mail by mistake, please advise the sender immediately. Skipworth Engelhardt Asset Management Strategists Limited (SEAMS Ltd) is not responsible for any changes made to the message after it has been sent. Where opinions are expressed, they are not necessarily those of SEAMS Ltd. SEAMS Ltd make no representation that this e-mail or any attachments are free of viruses and virus scanning is recommended and it the responsibility of the recipient. Skipworth Engelhardt Asset Management Strategists Limited. Registered office: Ash House, Hallamshire Court, Sheffield, S11 8HA UK. Registered in England no: 4097101
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
