Re: Structuring Documentation

[Tony Markos <ajmarkos -at- yahoo -dot- com>]

Oppss!  I was in the middle of composing the below
posting, when I accidently hit the Send button. 
Please disregard the below until I resubmit a finished
version.

Tony Markos


--- Tony Markos <ajmarkos -at- yahoo -dot- com> wrote:

> Dick:
> 
> I had previously asked if strutured WRITING existed
> (outside of formatting considerations - a relatively
> minor thing).  I specifically asked what were the
> concrete, specific steps involved in structured
> writing.  I got none from listerv members - only a
> couple of comments that it is basically a
> mysterious,
> illdefinable black art. Addtionally, my research
> revealed nothing more than loosey-goosey sound bites
> as to what structured writing is - no concrete,
> specific steps.
> 
> (In all candor, I thought the above was highly
> unusual
> as I was, prior to this inquiry, told that the major
> skill set of a Technical Writer is skill in
> structured
> writing.)
> 
> I did read (I think on the Infomapping web site)
> that
> Charles Horn says that, in the main, structured
> writing is all about analysis (which to someone
> highly
> skilled in structured analysis is confusing).
> 
> 
> 
> 
> --- Dick Margulis <margulisd -at- comcast -dot- net> wrote:
> 
> > Tony Markos wrote:
> > 
> > > Note: Properly done, software requirements specs
> > are
> > > structured the same way as end-user
> documentation.
> >  
> > > 
> > 
> > 
> > I can see that under some circumstances that's
> true.
> > However, before you 
> > were asking what a structured document was,
> implying
> > you doubted such a 
> > thing existed, and now you've just described two
> > documents as sharing a 
> > common structure. So do you now believe that it is
> > possible to write a 
> > structured document or don't you?
> > 
> > 
> 
> 
> __________________________________________________
> Do You Yahoo!?
> Tired of spam?  Yahoo! Mail has the best spam
> protection around 
> http://mail.yahoo.com 
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> 
> Now Shipping -- WebWorks ePublisher Pro for Word!
> Easily create online
> Help. And online anything else. Redesigned interface
> with a new
> project-based workflow. Try it today!
> http://www.webworks.com/techwr-l
> 
> Doc-To-Help 2005 now has RoboHelp Converter and HTML
> Source: Author 
> content and configure Help in MS Word or any HTML
> editor. No 
> proprietary editor! *August release.
> http://www.componentone.com/TECHWRL/DocToHelp2005
> 
> ---
> You are currently subscribed to TECHWR-L as
> ajmarkos -at- yahoo -dot- com -dot- 
> 
> To unsubscribe send a blank email to 
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/ajmarkos%40yahoo.com
> 
> Send administrative questions to lisa -at- techwr-l -dot- com -dot- 
> Visit
> http://www.techwr-l.com/techwhirl/ for more
> resources and info.
> 
> 


__________________________________________________
Do You Yahoo!?
Tired of spam?  Yahoo! Mail has the best spam protection around 
http://mail.yahoo.com 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l

Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author 
content and configure Help in MS Word or any HTML editor. No 
proprietary editor! *August release. http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot- 

To unsubscribe send a blank email to 
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com

Send administrative questions to lisa -at- techwr-l -dot- com -dot-  Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.