how do I write a functional specification quickly and efficiently

Posted by giddy on Programmers See other posts from Programmers or by giddy
Published on 2011-01-06T18:58:43Z Indexed on 2011/01/07 13:59 UTC
Read the original article Hit count: 429

So I just read some fabulous articles by Joel on specs here. (Was written in 2000!!) I read all 4 parts, but Im looking for some methodical approaches to writing my specs.

Im the only lonely dev, working on this fairly complicated app (or family of apps) for a very well known finance company.

I've never made something this serious, I started out writing something like a bad spec, an overview of some sorts, and it has wasted a LOT of my time.

Ive also made 3 mockup-kinda-thingies for my client so I have a good understanding of what they want. Also released a preview (a throw away working app with the most basic workflow), and Ive only written and tested some of the very core/base systems.

I think the mistake Ive been making so far is not writing a detailed spec, so Im getting to it now.

So the whole thing comprises of

  • An MVC website (for admins & data viewing)
  • 2 Silverlight modules (For 2 specific tasks)
  • 1 Desktop Application

Im totally short on time, resources and need to get this done quick, also, need to make sure these guys read it up equally quick and painlessly.

  • So how do I go about it, Im looking for any tips, any real world stuff, how do you guys usually do it?
  • Do you make a mock screenie of every dialog/form/page?

Im thinking of making a dummy asp.net web forms project, then filling in html files in folders and making it look like my mvc url structure.

Then having a section in the spec for the website and write up a page for every URL Ive got with a screenie.

For my win forms app, Ive made somewhat of a demo Win Form project, would I then put in a dialog or stucture everything as I would in the real app and then screen shot it?

© Programmers or respective owner

Related posts about writing

Related posts about specifications