Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

How specific to get on design document?

Tags:

People also ask

What should be included in a design document?

Design documentation is a collection of documents and resources that covers all aspects of your product design. Documentation should include information about users, product features, and project deadlines; all essential implementation details; and design decisions that your team and stakeholders have agreed on.

What is a design document used for?

Design documents are created to coordinate efforts of a large team, give them a stable reference point, and describe all parts of the software and how they will operate. It assures that the product is built to meet the needs and is on par with what was agreed upon prior to the inception of the product/software.


I'm creating a design document for a security subsystem, to be written in C++. I've created a class diagram and sequence diagrams for the major use cases. I've also specified the public attributes, associations and methods for each of the classes. But, I haven't drilled the method definitions down to the C++ level yet. Since I'm new to C++ , as is the other developer, I wonder if it might not make sense go ahead and specify to this level. Thoughts?

edit: Wow - completely against, unanimous. I was thinking about, for example, the whole business about specifying const vs. non-const, passing references, handling default constructor and assigns, and so forth. I do believe it's been quite helpful to spec this out to this level of detail so far. I definitely have gotten a clearer idea of how the system will work. Maybe if I just do a few methods, as an example, before diving into the code?