TechWhirl Sponsors

About TechWhirl

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.

Re: Structured stuff for the beginner

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.

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