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:Object Oriented Analysis Is An Oxymoron From:Tony Markos <ajmarkos -at- yahoo -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Fri, 20 Aug 2004 07:16:51 -0700 (PDT)
Unfortunately, it always seems that those who are
"into" the design details never have a comprehensive
integrated understanding of the essential end-user
tasks performed, and how those tasks interrelate.
(Such is critical for a TW to effectively orgainze
documentation.) This is not just a TW issue; often the
entire developement staff is "drowning in an ocean of
details" - while no one has the bigger picture.
Having both a comprehensive understanding of essential
end-user tasks AND all the design details can happen.
(though it very rarely occurs); but it requires a
strong as-top-down-as-possible approach (i.e., getting
a good overall architecture of essential end-user
tasks first, and then using that understanding to
"pigeon hole" in all the design details).
Tony Markos
--- John Posada <jposada01 -at- yahoo -dot- com> wrote:
>
> > rather than how it works -- it is largely
> irrelevant. In
> > fact, in some cases knowing too much about the
> internals
> > makes getting that sort of description harder.
>
> Knowing too much about anything never makes it
> harder to write about
> it. Not knowing how to write make it hard to write
> about it.
>
> =====
> John Posada
> Senior Technical Writer
ROBOHELP X5: Featuring Word 2003 support, Content Management, Multi-Author
support, PDF and XML support and much more!
TRY IT TODAY at http://www.macromedia.com/go/techwrl
WEBWORKS FINALDRAFT: New! Document review system for Word and FrameMaker
authors. Automatic browser-based drafts with unlimited reviewers. Full
online discussions -- no Web server needed! http://www.webworks.com/techwr-l
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.
