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.
QUOTE
The developers didn't like it because it was too detailed. Too detailed.
Like vague and ambiguous is the better way to go.
UNQUOTE
Something I read in Computerworld (back in the early 80's). I don't have
the exact words, but I am sure you get the idea.
As McKracken (Sp?) stated in the early '80s.
Paraphrased "Your are programming the first (internal) computerized heart
monitor. You will be the first recipient. Can you rely on your code?"
One of the problems we have nowadays is that no one wants the 'details' as
it is 'too complicated' to put it in code.
Just imagine if you went to a doctor and said "I have a cough, and I can't
breathe very well." And he tells you, take two aspirin a day, and get some
cough drops. That will take care of the cough. As far as breathing, take
shorter breaths. See you in two weeks."
Or, you buy something on credit, but aren't told the interest rate, the late
fees, or the overlimit charges. They will change twice a month for the next
12 months (but your not told that either.
Maybe a little over the top, but ...
You get the drift.
Imagine if the Apple people did not have VERY DETAILED design specifications
for the iPhone? And still charged an arm and a leg for it. And said, what
you see is what you get.
Been there, done that, got calluses on the hind end.
Just my personal comments.
Harry
.
************************************** Get a sneak peek of the all-new AOL at http://discover.aol.com/memed/aolcom30tour
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
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-