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: The Burden of Screen Captures From:John Posada <JPosada -at- book -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Fri, 22 Nov 2002 15:45:03 -0500
Maybe I missed something in the original post or maybe I filtered it through
my preferences....
In my documentation, I have two types of explanations...procedure sections
and design sections.
In the procedure sections, I take the users to a result through a process
step by step.....How to Properly Shut Down a Server. The procedure section
may be how to properly shut down a server. OTOH, I have, in the design
section, and explanation of the server with no procedure instructions. If
someone, while performing the task needs to know where something is, maybe
where a config file is on the subdirectory structure, they can go to the
design section, see what they need, then continue with the procedure
In the design, I have pictures and menus, and I explain what the elements of
the pictures and menus are. In the procedure section, I also have pictures,
but the pictures show the end result of a series of tasks. There may be 20
tasks in the procedure and when done, the dialog is supposed to look a
certain way...certain things with checkmarks, radio buttons, paths in text
fields, etc.
The knack is to know when to apply which. I think what reacted to was that
it seemed that it was a blanket statement stating that there was no place
for sections just describing what was on the menu and that everything needed
to be task oriented.
John Posada
Senior Technical Writer
Barnes&Noble.com
jposada -at- book -dot- com
212-414-6656
"Available for next gig Feb 01, 2003"
-----Original Message-----
From: Mike O. [mailto:obie1121 -at- yahoo -dot- com]
Sent: Friday, November 22, 2002 3:20 PM
To: John Posada; TECHWR-L
Subject: RE: The Burden of Screen Captures
> darn...I must have missed that announcement. Was it in the
> "newsletter?"
Prominently featured in many newsletters and on this list...
...
I definitely remember interviewers grilling me about whether I
used a task-oriented approach. They were trying to weed out the
people who used the menu-driven approach.
--- John Posada <JPosada -at- book -dot- com> wrote:
> >>menus and dialog boxes? My impression is that this technique
> is
> >>was generally replaced by the task-oriented procedural
> approach
> >>sometime in the mid-1990s. I don't know your app, so I could
> be
>
> darn...I must have missed that announcement. Was it in the
> "newsletter?"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Order RoboHelp X3 in November and receive $100 mail in rebate, FREE WebHelp
Merge Module and the new RoboPDF - add powerful PDF output functionality
to RoboHelp X3. Order online today at http://www.ehelp.com/techwr-l
Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from http://www.techsmith.com/rdr/txt/twr
Find out what all the other tech writers, including Dan, already know!
---
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.