TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Tony said something I can't get a grasp on, to which I respond:
If you can think it, you can write it. If you can think in a structured way, you can write it down in a structured way. Some people have a harder time doing it than others. The trouble is some people don't see the structure and have a harder time getting started. They have to find a different approach to organizing the information. I suppose you've found a way that works for you. Perhaps your mind visualizes information in a way that others can't. Make it work for you, but please stop saying everyone else is wrong because they can't visualize the same way you do.
I suppose there are those who never figure out how to structure information and they see nothing wrong with steps in a random order. My children see a neat floor, I see random clutter. My job is to train them to see things out of place. Technical writers have been trained, we can only hope, to present things in a logical and ordered manner.
I would also suggest several levels of structure exist. On one end would be the structure of words. Then the structure of sentences and on to procedures and paragraphs. Finally, the order topics are divided into sections and books. There's more structure out there than some people are giving credit for.
tjohnson -at- starcutter -dot- com
From: techwr-l-bounces+tjohnson=starcutter -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+tjohnson=starcutter -dot- com -at- lists -dot- techwr-l -dot- com]On
Behalf Of Tony Markos
Sent: Tuesday, December 13, 2005 10:44 AM
To: Spreadbury, David; Dick Margulis
Subject: RE: Structuring Documentation
I did not define structured writing - I said that it
does not exist. Analysis exists - espcially
structured analysis, and writing exits. But I have
found no evidence that structured writing exists as a
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