Re: Structuring Documentation

Subject: Re: Structuring Documentation
From: "Fred Ridder" <docudoc -at- hotmail -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 13 Dec 2005 11:08:15 -0500

Tony says that asking for "an algorithmic way to do writing" is "nutso".

Then he turns around and asks Dick to provide "the steps to structured
writing" which sure sounds like "an algorithmic way" to me.

So if Tony himself is asking for an algorithmic way to do writing, what are
we to conclude?


From: Tony Markos <ajmarkos -at- yahoo -dot- com>
To: Dick Margulis <margulisd -at- comcast -dot- net>, sharon -at- anthrobytes -dot- com
CC: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Subject: Re: Structuring Documentation
Date: Tue, 13 Dec 2005 08:00:21 -0800 (PST)

Dick:

I have not been asking for an algorithmic way to do
writing. To me, asking for such is nutso.

Analysis exists - specific steps can be identified for
doing such. Writing also exists - you are reading
some. But I have found no evidence that structured
writing exists as a seperate entity from these two.

Dick, you mentioned Logic 101 to me before. As you
are a fan of logic, let me ask you: What are the steps
to structured writing? (Please do not say do analysis
and then write.)

Tony Markos


--- Dick Margulis <margulisd -at- comcast -dot- net> wrote:

> Sharon,
>
> I think this may be crux of Tony's misunderstanding.
> He seems to be
> asking for an algorithmic way to do the actual
> writing--to automate the
> this task for the tech writer, in other words, thus
> rendering
> differences in human ability irrelevant and reducing
> the tech writer to
> a fungible warm body with or without language
> ability or making the job
> obsolete altogether.


_________________________________________________________________
Express yourself instantly with MSN Messenger! Download today - it's FREE! http://messenger.msn.click-url.com/go/onm00200471ave/direct/01/

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

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.


Follow-Ups:

References:
Re: Structuring Documentation: From: Tony Markos

Previous by Author: RE: Documenting A Ballet Dance
Next by Author: RE: Document Control Systems
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