Re: Structuring Documentation

Subject: Re: Structuring Documentation
From: Tony Markos <ajmarkos -at- yahoo -dot- com>
To: Tony Markos <ajmarkos -at- yahoo -dot- com>, Dick Margulis <margulisd -at- comcast -dot- net>
Date: Tue, 13 Dec 2005 06:08:41 -0800 (PST)

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.


References:
Re: Structuring Documentation: From: Tony Markos

Previous by Author: Re: Structuring Documentation
Next by Author: Re: Structuring Documentation
Previous by Thread: Re: Structuring Documentation
Next by Thread: Re: Structuring Documentation


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

Sponsored Ads


Sponsored Ads