Re: Chattiness in manuals

Subject: Re: Chattiness in manuals
From: Rebecca Stevenson <rjstevenson -at- sprynet -dot- com>
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 17 Oct 2006 07:13:02 -0400 (GMT-04:00)

Depends on what the manual is for, I suppose, and whether that remark stands out from the rest of it. If nothing else, I would know that I have something in common with the author, and possibly even go make some tea. :-)


Rebecca

-----Original Message-----
>From: Sarah Bouchier <Sarah -dot- Bouchier -at- exony -dot- com>
>Sent: Oct 17, 2006 6:52 AM
>To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
>Subject: Chattiness in manuals
>
>Having spent much of yesterday wrestling with a sudden random desire to
>ditch all rules of formal writing (not being a fan of being fired, I did
>eventually succeed in convincing my brain to be professional instead!),
>I'm vaguely curious.
>
>
>
>How would you react to a manual that said, "The installation of this
>component may take several minutes. This would be a good time to go and
>get a cup of tea"?
>
>
>
>(Other than concluding that the author had run mad and needed to be
>fitted with a snazzy waistcoat with long sleeves, of course)
>
>
>
>S.
>
>-----------------------------------------
>Sarah Bouchier
>Technical Author
>

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l

Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at http://www.DocToHelp.com/TechwrlList

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -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/archive%40infoinfocus.com


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

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Previous by Author: Hot new trends in tech writing?
Next by Author: Re: Chapter summaries at start of doc: yes/no?
Previous by Thread: Re: Chattiness in manuals
Next by Thread: RE: Chattiness in manuals


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


Sponsored Ads