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.
Subject:Is known-new the best cohesion lesson? From:Geoff Hart <ghart -at- videotron -dot- ca> To:techwr-l List <techwr-l -at- lists -dot- techwr-l -dot- com>, Rob Hudson <caveatrob -at- gmail -dot- com> Date:Thu, 25 Sep 2008 17:23:42 -0400
Rob Hudson wondered: <<... is "known-new" the way to teach cohesion
in a paragraph? Or should I do something more natural that doesn't
seem to rely so much on placement, which can feel forced?>>
Known/new is very effective for some things, but blindly following
that structure is way too draconian an approach. The actual best
approach depends entirely on the goal of the paragraph and on
context. For example, if you're talking about something unknown, it's
perfectly natural to say "here is something we didn't used to
understand", followed by "here's what we speculate is actually
happening".
(Of course, one could argue that the "this is what we didn't
understand" could constitute "known". Fair enough.)
Known/new works very well when you're trying to teach something that
requires readers to muster their intellectual tools before they try
to build something new. Then, the "known" part reminds them of what
they need to have available, and the text that follows shows them how
to fit new knowledge into that existing framework.
----------------------------------------------------
-- Geoff Hart
ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com
www.geoff-hart.com
--------------------------------------------------
***Now available*** _Effective onscreen editing_
(http://www.geoff-hart.com/home/onscreen-book.htm)
ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial. http://www.componentone.com/DocToHelp/
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-