Re: Technical Specifications

Subject: Re: Technical Specifications
From: HBacheler -at- aol -dot- com
To: vrfour -at- verizon -dot- net, techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 25 Jul 2007 12:51:04 EDT

It was stated:

The developers didn't like it because it was too detailed. Too detailed.
Like vague and ambiguous is the better way to go.

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.



************************************** Get a sneak peek of the all-new AOL at

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.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Previous by Author: Re: Web conferencing/webinar tool recommendations needed
Next by Author: Re: toggle switch instructions?
Previous by Thread: Technical Specifications
Next by Thread: Re: Help for a non-native speaker

What this post helpful? Share it with friends and colleagues:

Sponsored Ads