Re: Engineering specs: The way it spozed to be?

Subject: Re: Engineering specs: The way it spozed to be?
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 21 Sep 2006 13:16:53 -0700

I think it's important here to define exactly what "spec" you're
working on. A development spec is the design goal/requirements
the developers are tasked with developing the product to meet,
a product/customer spec is the list of features and performance
you're telling your customer that your finished product *does*
meet. The product/customer spec can be updated any way you
choose, so long as it agrees with the product you're actually
delivering on the day you start handing it out to customers.
The development spec should not be changed on the fly by
the engineers as they change the product, but should only be
changed *after* a design review or whatever passes for one in
your process produces a consensus among all approvers that
the changes the engineers want to make are acceptable. I would
be very wary of any development process where it is possible
for developers to change the development spec unilaterally just
because they cannot produce a product that meets it.

Gene Kim-Eng

----- Original Message ----- From: <stevefjong -at- comcast -dot- net>

Paraphrasing the VP's concern: "I don't expect you to update the end-user documentation every time the engineers make a change. But I don't want them to update a spec every time they make a change, either. What is the triggering mechanism? What changes should be written down, and when? I want you to answer that question."


WebWorks ePublisher Pro for Word features support for every major Help format plus PDF, HTML and more. Flexible, precise, and efficient content delivery. Try it today!

Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at

You are currently subscribed to TECHWR-L as archive -at- infoinfocus -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 lisa -at- techwr-l -dot- com -dot- Visit for more resources and info.

Engineering specs: The way it spozed to be?: From: stevefjong

Previous by Author: Re: Contractor Rates
Next by Author: Re: Acrobat 8
Previous by Thread: RE: Engineering specs: The way it spozed to be?
Next by Thread: Re: Engineering specs: The way it spozed to be?

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

Sponsored Ads