RE: tutorials vs. instructions

Subject: RE: tutorials vs. instructions
From: Jim Shaeffer <jims -at- spsi -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 1 May 2002 13:02:10 -0400


Speaking from my perspective of documenting software:

Tutorials are self-contained, provide a controlled environment and
are designed primarily to teach. At the end of a tutorial the user
has not (usually) done any actual work.
Instructions can be applied directly to the real-world work that the
user is attempting to do.
One common difference is that a tutorial will often provide a known,
but artificial, starting point (document, database, etc.) and build
on that. Instructions don't have that luxury.

Jim Shaeffer (jims -at- spsi -dot- com)


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Free copy of ARTS PDF Tools when you register for the PDF
Conference by April 30. Leading-Edge Practices for Enterprise
& Government, June 3-5, Bethesda,MD. www.PDFConference.com

Are you using Doc-to-Help or ForeHelp? Switch to RoboHelp for Word for $249
or to RoboHelp Office for only $499. Get the PC Magazine five-star rated
Help authoring tool for less! Go to http://www.ehelp.com/techwr

---
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.



Previous by Author: Documenting a buggy feature (was: RE: techwr-l digest: April 30, 2002)
Next by Author: RE: New TECHWR-L Poll Question
Previous by Thread: RE: tutorials vs. instructions
Next by Thread: RE: tutorials vs. instructions


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


Sponsored Ads