Re: Structuring Documentation

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


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

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

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!

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.

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

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit for more resources and info.


Re: Structuring Documentation: From: Dick Margulis

Previous by Author: Re: Documenting A Ballet Dance
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