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: Alternative to floppy From:"John Posada" <jposada99 -at- gmail -dot- com> To:"McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com> Date:Thu, 23 Oct 2008 14:53:36 -0400
That was my point exactly. In this case, tell them what to do, not how
to do it. Too much chance you'll instruct them to do it one way, turn
out they don't have it, and place a req with their IT to get a backup
mechanism when they had three other ways that would have worked just
as well.
On Thu, Oct 23, 2008 at 12:39 PM, McLauchlan, Kevin
<Kevin -dot- McLauchlan -at- safenet-inc -dot- com> wrote:
>
> Geoff Lane opined:
>
>> In the same way you should (IMO) tell
>> customers to use something you know they have. Since not all computers
>> have floppy drives, CD burners, etc. and not all customers will have a
>> spare thumb drive to hand, it's perhaps better to use a term that
>> encompasses all options while giving the customer the choice of which
>> to use. For example, "Copy the configuration file to removable media
>> and write protect this if possible. Keep this safe for future
>> reference."
>
> Looks good to me.
> I might say:
> " Copy the configuration file to removable media and write protect this
> if possible. Verify the copy. Keep the copy safe for future reference.
> Alternatively, copy to a networked drive that is reliably backed up
> (contact your local IT department or corporate help desk for
> assistance)."
--
John Posada
Senior Technical Writer
NYMetro STC President
'Half this game is ninety percent mental.'
-- Danny Ozark, Philadelphia Phillies manager
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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
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-