Re: Warm and Fuzzy Documentation

Subject: Re: Warm and Fuzzy Documentation
From: Peter <pnewman1 -at- home -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 29 Jun 2001 09:28:45 -0400

Lisa Bronson wrote:
>
> Another thought, in line with Keith Cronin's advice to "Add some warm
> fuzzy elements to the structure/layout of the document,
> rather than to its actual fonts. For example, add a slightly cutesie
> heading to the beginning of each section like "How Does This Thing-a-ma-jig
> Work?'"
>

To add to your reply. Warm and Fuzzy is purely a matter of perception.
Not too long ago a client complained that a document was too long. I
felt that it could not be shortened without a serious loss of content.
Rather than meet him head on, I reprinted the document, using a smaller
font and narrower margins. The client accepted the revision, saying that
this was more like what he wanted. It seems that having said something
in a moment of haste, all he needed was a graceful way out.


--
Peter
Mailto:peternew -at- optonline -dot- net

Adapting old programs to fit new machines
usually means adapting new machines to
behave like old ones.

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

*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com

Sponsored by Cub Lea, specialist in low-cost outsourced development
and documentation. Overload and time-sensitive jobs at exceptional
rates. Unique free gifts for all visitors to http://www.cublea.com

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


References:
Re: Warm and Fuzzy Documentation: From: Lisa Bronson

Previous by Author: Re: Supremes rule for freelancers
Next by Author: Re: Warm and Fuzzy Documentation
Previous by Thread: Re: Warm and Fuzzy Documentation
Next by Thread: Re: Warm and Fuzzy Documentation


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


Sponsored Ads