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: levels of detail -- are we beyond this? From:Laura Praderio Lynn <lpraderio -at- alpineclimbs -dot- com> To:"Butler, Darren J CTR USAF AFMC 584 CBSS/GBHAC" <Darren -dot- Butler -dot- ctr -at- Robins -dot- af -dot- mil> Date:Fri, 15 Aug 2008 14:22:54 -0600
my fav is a chinese manual we ran across in our tech writing program at
northeastern; the before you begin requested that the user "compose your
mind".
Butler, Darren J CTR USAF AFMC 584 CBSS/GBHAC wrote:
>>> Is it me, or is this kind of detail totally unnecessary in this day and age?<<
>
>
>
> You--would--be-shocked!! ≡8^@
>
>
>
> If they STILL put instructions on some shampoo bottles………
>
>
>
> Instructions:
>
> 1. Wet hair thoroughly with warm water
>
> 2. Apply a generous amount of Mr. Andre’s SuperModel-Strength, Anti-Sludge Shampoo (with kumquat & alfalfa extracts)
>
> 3. Gently Wash hair
>
> 4. Rinse
>
> 5. Repeat
>
>
>
> PLUS, they also include a phone number to call if you have any questions!
>
>
>
> -Darren
>
>
>
>
>
> -----Original Message-----
> From: techwr-l-bounces+darren -dot- butler -dot- ctr=robins -dot- af -dot- mil -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+darren -dot- butler -dot- ctr=robins -dot- af -dot- mil -at- lists -dot- techwr-l -dot- com] On Behalf Of Tom Johnson
> Sent: Friday, August 15, 2008 3:56 PM
> To: TECHWR-L'
> Subject: levels of detail -- are we beyond this?
>
>
>
> I just ran into some detailed instructions on going to a website that look
>
> like this:
>
>
>
> 1. Open Internet Explorer by clicking *Start* > *Programs* > *Internet
>
> Explorer*.
>
> 2. In the *Address* field, enter *http://sampleurl.com* and press *Enter*.
>
>
>
>
>
> Is it me, or is this kind of detail totally unnecessary in this day and age?
>
> I'd say 99% of the time, people will understand the much simpler version:
>
> "1. Go to http://sampleurl.com."
>
>
>
> Tom
>
>
>
> ---------------------
>
> cell: 801-822-2241
>
> blog: www.idratherbewriting.com
>
> twitter: www.twitter.com/tomjohnson
>
> news: www.writerriver.com
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
>
>
> ComponentOne Doc-To-Help gives you everything you need to author and
>
> publish quality Help, Web, and print content. Perfect for technical
>
> authors, developers, and policy writers. Download a FREE trial.
>
>http://www.componentone.com/DocToHelp/
>
>
>
> 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 Darren -dot- Butler -dot- ctr -at- robins -dot- af -dot- mil -dot-
>
>
>
> To unsubscribe send a blank email to
>
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
>
> or visit http://lists.techwr-l.com/mailman/options/techwr-l/darren.butler.ctr%40robins.af.mil
>
>
>
>
>
> 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.
>
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> ComponentOne Doc-To-Help gives you everything you need to author and
> publish quality Help, Web, and print content. Perfect for technical
> authors, developers, and policy writers. Download a FREE trial.
>http://www.componentone.com/DocToHelp/
>
> 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 lpraderio -at- alpineclimbs -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit http://lists.techwr-l.com/mailman/options/techwr-l/lpraderio%40alpineclimbs.com
>
>
> 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.
>
>
>
ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial. http://www.componentone.com/DocToHelp/
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-