Re: writing functional specs?
If you only talk with end-users when developing a functional spec,what you
end up with is a marketing document. You must then take that list of
demands (which is all you have at that point), hat in hand, to your
engineers, and ask them nicely if they could possibly see their way clear
to implementing it.
Not necessarily true (the part about ending up with a marketing document). It depends on who you have on your requirements-gathering team. Stock it with SMEs (lead programmer/engineer, systems architects, usability engineer, Web developer/designer, whatever), and the requirements spec won't have that odor of marketing fluff.
And yes, requirements/functional specs have a way of morphing into those other types of specifications, but so long as you keep separate instances to establish the parent-child document lineage, you'll be better off. If you're writing specs for an external customer, each separate spec will have a different reading audience, with some common crossover naturally. Another reason requirements-gathering teams and spec teams need an experienced tech writer on them.
"Why, yes, Ican
implement this. Right after I finish the project I've been working on for
the last twenty years, which is a mental-telepathy machine." <<
I've seen the beta of that machine.<g>
Get your FREE download of MSN Explorer at http://explorer.msn.com
*** 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
Sponsored by Information Mapping, Inc., a professional services firm
specializing in Knowledge Management and e-content solutions. See
http://www.infomap.com or 800-463-6627 for more about our solutions.
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.
Search our Technical Writing Archives & Magazine