RE: LONG - A colloquial writing style?

Subject: RE: LONG - A colloquial writing style?
From: "Joe Malin" <jmalin -at- tuvox -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 10 May 2005 11:47:30 -0700


Hello Guy!

I have to check this out.

You bring up an excellent point. Creative ways of *learning* are
important. The question is, are you presenting really presenting your
documentation as a way of *learning*? If you are, then a different
language may be extremely useful.

Most of the documentation I find myself writing is less about *learning*
and more about, well...

I don't know how to put it. It's the case of presenting a small snippet
of information that the reader uses to quickly solve a particular task.
They don't have time to "learn", they're just trying to solve a problem.

In that case, what style should we use?


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

New from Quadralay Corporation: WebWorks ePublisher Pro!
Completely XML-based online publishing. Easily create 14 online formats, including 6 Help systems, in a streamlined project-based workflow. Word version ships in June, FrameMaker version ships in July. Sign up for a live, online demo! http://www.webworks.com/techwr-l

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -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.



Follow-Ups:

Previous by Author: RE: Online Help Tool - Decision
Next by Author: RE: What notebook did you buy?
Previous by Thread: RE: LONG - A colloquial writing style?
Next by Thread: Re: LONG - A colloquial writing style?


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


Sponsored Ads