This week's book giveaway is in the OO, Patterns, UML and Refactoring forum.
We're giving away four copies of Refactoring for Software Design Smells: Managing Technical Debt and have Girish Suryanarayana, Ganesh Samarthyam & Tushar Sharma on-line!
See this thread for details.
The moose likes Developer Certification (SCJD/OCMJD) and the fly likes Design Decisions Document - What is too much? Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login

JavaRanch » Java Forums » Certification » Developer Certification (SCJD/OCMJD)
Bookmark "Design Decisions Document - What is too much?" Watch "Design Decisions Document - What is too much?" New topic

Design Decisions Document - What is too much?

Robin Underwood
Ranch Hand

Joined: May 01, 2002
Posts: 117
My first draft of the design decisions document is already over six pages and I haven't finished saying everything I want to say. I know I need to rewrite it to tidy it up. There's alot on pros, cons, and alternatives.
Did anyone feel that they were hurt by having too much information in this document? Is it OK to cover minor design decisions as well as major ones? What is a typical length for this document?
Thanks in advance,
Mark Spritzler

Joined: Feb 05, 2001
Posts: 17271

I think it sounds fine. Mine was 5 pages. So to me 7 isn't too much, and as you said you will probably edit some of it out.

Perfect World Programming, LLC - Two Laptop Bag - Tube Organizer
How to Ask Questions the Smart Way FAQ
Have you checked out Aspose?
subject: Design Decisions Document - What is too much?
It's not a secret anymore!