Re: Structuring Documentation

Subject: Re: Structuring Documentation
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
To: "Tony Markos" <ajmarkos -at- yahoo -dot- com>, "Dick Margulis" <margulisd -at- comcast -dot- net>
Date: Tue, 13 Dec 2005 12:21:15 -0800

Based solely on what I've read in this thread, I would
say it sounds to me as if "structured writing" is a loose
synonym for "writing based on analysis" (not just for
analysis). However, in my particular branch of the
woods the term we use to describe all of the above is
"technical writing" (as opposed to the Dujardin-esque
stream of conciousness authoring that seems to make
up 90% of what I read on the Internet). And it doesn't bother me one bit if the non-pubs folk at my company think it's all some sort of black magic.

Gene Kim-Eng


----- Original Message ----- From: "Tony Markos" <ajmarkos -at- yahoo -dot- com>

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

You're not happy with the notion that "structured
writing" is a
loose synonym for analysis.
Tony Markos responds:

If structured writing (formatting considerations
aside) is the same or nearly the same as analysis,
then the term serves no purpose other than to create
confusion. We are writers; we should be about
clarification - not adding to the IT worlds confusion.

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

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: Documenting A Ballet Dance
Next by Author: Re: Smart answers and useful answers
Previous by Thread: Re: Structuring Documentation
Next by Thread: Re: Hiring Question


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

Sponsored Ads


Sponsored Ads