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:Re: Object Oriented Analysis Is An Oxymoron From:TechComm Dood <techcommdood -at- gmail -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 19 Aug 2004 17:32:53 -0400
Sorry, I can't let this one go... ;-)
> > It is easy to throw barbs. Why don't you explain why
> > you think my comments are so shallow and narrow
> > minded?
> For example, the design may involve everything under the sun of how to
> hook into a Oracle database. The UI may provide a dialog box with
> fields for username, password, host, port, SID, driver type, etc. Now,
> suppose there are environments where the user may be required to have
> a digital certificate to allow the SSL connection. How does the tech
> writer allow for this if the UI doesn't concern it and the tech writer
> knows only the WHAT about the application and not the HOW about the
> task and environment?
Given the very basic example above, if you were the writer for this
"product" and were "given" a dialog to document containing fields for
username, password, host, SID, and driver type, and you knew only the
WHAT and not the HOW...
... how would you know the UI is missing a critical element?
If you expect development and/or quality assurance to tell you and/or
fix it, doesn't that limit the value you give back to the company? And
thus doesn't that limit your career growth within the company?
I don't just eat what I'm fed, so to speak. I hunt and forage for my
"food" and I experiement with various recipies, many which I invent
myself.
By being agile, getting into the design process, learning the HOW, and
applying that knowledge both internally and in external information
collateral, I help my audiences (internally and externally) and help
my career along as well.
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.
