Re: Silly but important to me

[Steven Brown <stevenabrown -at- yahoo -dot- com>]

Hi Joe,

I think your choice depends on how/whether you
incorporate screenshots into your documentation.

If you do not incorporate screenshots, I like using
the two sentences in the same paragraph:

  1. On the New Address Screen, type your name,
address, and phone number, and click the Save button.
The Address Confirmation Screen appears.


If you incorporate screenshots, you may have to
consider how to best orient the reader:

  1. On the New Address Screen, type your name,
address, and phone number.

     <SCREENSHOT>

  2. Click the Save button.

  3. On the Address Confirmation screen, stick your
thumbs in your nose and yell, "I'm picking me a
winner!"

     <SCREENSHOT>

(Not the only solution, but it's food for thought.)

At the end of the day though, it doesn't matter all
that much, as long as you're consistent. I always ask
myself, Will the reader mostly likely understand this?
If the answer is yes, I go to lunch or go home for the
day, depending on what time it is.

Steven Brown

P.S. And it's "appears."



		
__________________________________
Do you Yahoo!?
Read only the mail you want - Yahoo! Mail SpamGuard.
http://promotions.yahoo.com/new_mail 

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

ROBOHELP X5: Featuring Word 2003 support, Content Management, Multi-Author
support, PDF and XML support and much more!
TRY IT TODAY at http://www.macromedia.com/go/techwrl

WEBWORKS FINALDRAFT: New! Document review system for Word and FrameMaker
authors. Automatic browser-based drafts with unlimited reviewers. Full
online discussions -- no Web server needed! 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- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot-  Visit
http://www.raycomm.com/techwhirl/ for more resources and info.