Re: Technical Spec or Functional Spec?

Subject: Re: Technical Spec or Functional Spec?
From: Ben Kovitz <ben-kovitz -at- vertel -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 16 Aug 2001 16:02:22 -0700

At 03:41 PM 8/16/01 -0700, skwpt ("Kelly") wrote:

>I have an interview Monday where I'm supposed to talk
>about technical specifications I have written. I have
>"written" *functional* specs (with data sent to me by
>developers) but I have never heard of a document
>called a Technical Specification.
>
>Since different organizations/industries call
>documents by different names (For example, is it a doc
>plan or a doc spec??) I am hoping they mean functional
>spec. (Yes, I asked the women who screened me, but she
>didn't know and I didn't want to too boldly flag my
>ignorance.)

You just gotta ask them. As you say, different companies use the same
terminology for different things, so the only way to know is to ask. Just
say to them what you said to us: "I've written functional specs, but I've
never heard of a document called a Technical Specification. Can you tell
me something about the type of document you have in mind?"

BTW, about boldly flagging your ignorance, this is actually a very powerful
thing to do. It's scary, because you naturally feel like they're going to
slam the door in your face if you confess to not knowing something. But
asking, as a knee-jerk reaction, "What is X" when you hear X and don't know
what it means, actually buys you instant credibility. (Only with sensible
people, but most people are sensible.)

It says, more clearly than if you'd stated it explicitly, that you're here
to get a job done and you don't hide potential problems that other people
need to know about. I can't say I've convinced my stomach to quit tying a
knot every time I boldly flag my ignorance, but I've never regretted doing
it. The increase in trust and respect is usually noticeable within seconds.

"Audentes fortuna juvat." --Virgil


Ben Kovitz
Author, Practical Software Requirements: A Manual of Content & Style
http://www.amazon.com/exec/obidos/ASIN/1884777597
http://www.browsebooks.com/Kovitz


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com

A landmark hotel, one of America's most beautiful cities, and
three and a half days of immersion in the state of the art:
IPCC 01, Oct. 24-27 in Santa Fe. http://ieeepcs.org/2001/

---
You are currently subscribed to techwr-l as: archive -at- raycomm -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.


References:
Technical Spec or Functional Spec?: From: skwpt

Previous by Author: RE: Looking for a one-day, Houston-area user manual workshop (for non -writers)
Next by Author: re: uninstalling DEVA tools for Dreamweaver?
Previous by Thread: RE: Technical Spec or Functional Spec?
Next by Thread: Re: Technical Spec or Functional Spec?


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


Sponsored Ads