Re: Structured stuff for the beginner

Subject: Re: Structured stuff for the beginner
From: Lauren <lauren -at- writeco -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Fri, 28 Apr 2017 13:05:47 -0700

I want to see an example of this, as well. Mark’s statement asserts a claim of proof, so there is either an example that supports the claim or there is no support for the claim and the claim is false.

How has structured writing “guided” a writer in a real world application of structured writing?

How has a reader’s experience been “improved” in a real world application of structured writing?

Mark is describing “structured writing” as a cookie-cutter approach to producing documentation that seems like it would be helpful for new writers learning to write provided they are producing documentation that will have all needed information according to an established rhetorical pattern. If the “established rhetorical pattern” is incomplete, then the writer will still need to be able write without the crutch of structured writing.

In following this discussion, I see what looks like more than one discussion in that there seems to be a discussion of structured writing as a methodology for how to write and structured authoring as a technology for producing reusable documentation in multiple formats.

What problem does structured writing solve that is not solved by writing experience and structured authoring?



On 4/28/2017 9:54 AM, Robert Lauriston wrote:

You keep talking about "it" as if it were a real thing, but absent
real-world examples, you might as well be talking about a magic wand.

On Fri, Apr 28, 2017 at 9:47 AM, <mbaker -at- analecta -dot- com> wrote:
It improves the experience for your human readers by making the content much more consistent and complete by guiding writers to supply all needed information according to an established rhetorical pattern.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com

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

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

References:
Structured stuff for the beginner: From: Dave C
RE: Structured stuff for the beginner: From: mbaker
RE: Structured stuff for the beginner: From: Rick Quatro
RE: Structured stuff for the beginner: From: mbaker

Previous by Author: Re: Grammar: "Multiply by" or "Multiply times"?
Next by Author: Ethics in Technical Writing
Previous by Thread: RE: Structured stuff for the beginner
Next by Thread: RE: Structured stuff for the beginner


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


Sponsored Ads