I'm looking for a general format for a technical design specification. I read somewhere that the IEEE proposed some formats for what to document in a design document however, I can't find any information on the ieee.org site. Can anyone propose a good general template I can use to document the design and specification of my project? I could also use some information about a good requirements document format. Even a recommended book would help. Thanks in advance.
Robyn Haas<br />Sun Certified Programmer for the Java� 2 Platform
shailesh sonavadekar
Ranch Hand
Joined: Oct 12, 2000
Posts: 1874
posted
0
the book by ian somerville on " requirement engineering " is considered as very good book. I think he has written two books on the said subject. IEEE has got various standards on software engineering & software project management, which are not availble online. canadian tresury board have developed some templates . I am not getting the link now. it can give very good overview. plus , military site is good for the things you require. I feel so. I may be wrong. i hope this helps. [ May 25, 2002: Message edited by: shailesh sonavadekar ]
Ilja Preuss
author
Sheriff
Joined: Jul 11, 2001
Posts: 14112
posted
0
Originally posted by Robyn Haas: I'm looking for a general format for a technical design specification. [...] Can anyone propose a good general template I can use to document the design and specification of my project? I could also use some information about a good requirements document format.
Whom are you producing the documentation for? What do they need to know? How much of this information can be communicated using more informal communication channels? The answers to these questions, besides others, will heavily influence which documentation format will be appropriate - I don't think there really can be a sensible generic answer. So please elaborate on the specifics of your needs. Taking a look at http://www.agilemodeling.com might also help...
The soul is dyed the color of its thoughts. Think only on those things that are in line with your principles and can bear the light of day. The content of your character is your choice. Day by day, what you do is who you become. Your integrity is your destiny - it is the light that guides your way. - Heraclitus