RE: 10 Things All Technical Writers Should Do

Subject: RE: 10 Things All Technical Writers Should Do
From: John Posada <jposada01 -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 12 Nov 2004 09:46:48 -0800 (PST)


> DFD are for documenting procedure to a higher level of
> abstraction. Detailed level text is often needed in
> support.

I understand the difference. I wasn't sure you did by reading your
blanket statement that screenshots were low impact and DFD's were
high impact.

Maybe we should say that the RIGHT type of graphic/image when applied
correctly is high impact and the wrong type of graphic/image applied
incorrectly is low impact.

Tony...I've been writing for over 20 years, as many others on the
list have. You're not the first one to discover DFDs or any of the
UML diagrams, we just don't try to cram it down people's throats as
the end-all/be-all. It has its place and there are places that it
doesn't belong.

Sometimes, just a simple stick figure is the best graphic

> >
> > I've yet to figure out how to use a DFD to show a
> > user where the
> > ellipsis button is on a dialog or the members of a
> > dropdown list
> >
> > --- Tony Markos <ajmarkos -at- yahoo -dot- com> wrote:
> >
> > > Screen shots = lower impact graphics. Good
> > > Data Flow Diagrams = very powerful graphics.


=====
John Posada
Senior Technical Writer



__________________________________
Do you Yahoo!?
Check out the new Yahoo! Front Page.
www.yahoo.com



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

ROBOHELP X5 - SEE THE ALL NEW ROBOHELP X5 IN ACTION!

RoboHelp X5 is a giant leap forward in Help authoring technology, featuring all new Word 2003 support, Content Management, Multi-Author support, PDF and XML support and much more! View an online demo: http://www.macromedia.com/go/techwrldemo

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

References:
RE: 10 Things All Technical Writers Should Do: From: Tony Markos

Previous by Author: RE: 10 Things All Technical Writers Should Do
Next by Author: Re: Usability Assessment: A Common Sense Activity
Previous by Thread: RE: 10 Things All Technical Writers Should Do
Next by Thread: RE: 10 Things All Technical Writers Should Do


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


Sponsored Ads