FreeLists / webproducers / [webproducers] Re: tech spec help!

[Ari <bongwater@xxxxxxxxxxxxxx>]

yes, an internet search may help.

however, there's no standard way of writing one. some orgs have formalized
templates, which you are expected to use while others you roll your own.

whatever you do, make sure it:

1) contains illustrations where applicable (for example for sample output)

2) is concise (wordiness tends to get ignored as well as confuses)

3) is complete. make sure you cover all possible angles. for ex: if it's a
web app, make sure you cover the process of entering data, expected
output, mention business issues/rules, and address error conditions, etc.

4) get it tech checked and signed-off by someone who knows their shit
better than you.

this not only helps minimize potential issues (and covers your ass) but
the extra set of eyes will help you deliver a superior document.




---------------------------------------------------------------------------
"Set in our way, content with our decay, we wave the flag of freedom as
 we conquer and invade..."

                         -- Operation Ivy (Freeze Up)

On Wed, 8 Aug 2001, Maia Gemmill wrote:

> 
> On 8/8/01 5:08 PM, "Morry Galonoy" <galonoym@xxxxxxxxxxxxx> wrote:
> 
> > 
> > Anyone have a link or a templates for writing tech specs?
> 
> Have you tried Gantthead? They have tons of templates...
> 
> MG
> - - - - - - - - - - - - - - - - - - - - - -
> Maia Gemmill * Production Manager
> Hearst Interactive
> 959 eighth avenue
> new york ny 10019
> t:  212.649.2336   f:  212.957.8524
> mgemmill@xxxxxxxxxxxxxxxxxxxxx
> 
> 
> __________________________________________________________________________
> Check out www.webproducers.org to easily access list commands like subscribe, 
> unsubscribe, digest mode, vacation, and to read the list archive.
> 
> Questions and comments are welcome just e-mail me,
> webproducers-admins@xxxxxxxxxxxxx   -Morry
> 

__________________________________________________________________________
Check out www.webproducers.org to easily access list commands like subscribe, 
unsubscribe, digest mode, vacation, and to read the list archive.

Questions and comments are welcome just e-mail me,
webproducers-admins@xxxxxxxxxxxxx   -Morry