functional-specifications

How to write a functional specification?

We always write functions or classes and their logic is very complicated. If there is no specification for these structures, later it will be hard for even ourselves to grasp the ideas. How do you write specifications for complicated functions and classes? Please tell me something about your own experience, but not just some link, th...

Writing functional specifications for games

I've been reading Joel on Software recently and so I've become pretty sold on the idea of writing functional specifications before getting too involved in development. I'm about to have a go at creating a simple 2D game (not too simple mind), and I can really see the gain - in the past I've just jumped into writing extremely simple ga...

Functional Requirements vs. Solution Definition?

When writing up Functional requirements, is it best practice NOT to incorporate the solution definition into the document? Many of the site I work on have a solution already defined - such an open source CMS (WordPress or Drupal). Even though we have the solution, we still have to work out the fine details, for example what fields will b...