Today, One of my colleague and I have a debate about "Should we put the specification documents in source control system such as SVN?". In my opinion, It should be. Everything relate to developing project should be controled carefully with source control system. Is it a wrong concept in software development process?
With hard disk space at pennies per gigabyte per month, there's no good reason not to put documents in the source control system, and it is likely to be useful. My personal preference is to write documents using inline markup, e.g. Wiki Markup or DocBook. This allows use of powerful tools for document comparison and revision.
Versioning specification documents is definitely a worthy goal.
However, are your specification documents text-only and in a plain text file? If so, this may be a good solution.
If not, source control is probably not the right place for them — source control is bad for binary files.
Usually, plain text files are neither as good for formatting or for quick viewing, so a wiki with versioning is probably a better idea.
All the documents should be in some form of archive (preferably with revision controls).
Source control systems is one solution. But usually these systems are designed for plain text documents. Thus things like Word or RTF documents etc do not fit so nicely (especially when you try and compare different version).
But There are other solutions specifically designed for documents. SharePoint springs to mind, but I am sure there are others.
Definitely. The problem that documents are stored as binaries (for example word documents) is annoying. A nice workaround is if you use one of the Tortoise tools (I have tried SVN and Mercurial) you can choose "Visual Diff" that allows you to choose docdiff. With docdiff you get to see all the changes with colours and stuff :-). The main disadvantage is that every time you make a change the whole document is commited again (not just the change). But considering that text documents aren't huge normally and that space probably isn't your main issue this is no problem.
I'm sure you can use docdiff without Tortoise, it's just that I haven't tried it.
There is an alternative approach that you should discuss: BDD
Please consider Behavior Driven Development with executable specifications. Your specifications get simplified into a series of Given - When - Then sets of statements that are stored in text files. A BDD tool such as Cucumber or SpecFlow converts those text files into executable tests, that your build tool can execute.
Cucumber: http://cukes.info/ - BDD for Ruby
SpecFlow: http://www.specflow.org/ - BDD for .Net
For a quick demo of workflow with a tool like SpecFlow, checkout Rob Conery's SpecFlow walk-through: http://tekpub.com/view/concepts/5
Now, not only are you versioning your code, but your specifications, and your Continuous Integration tool (think TeamCity, CruiseControl, Hudson, etc) is enforcing that all specifications are still valid on EVERY build... Is that valuable to you?