Jump to content

  • Log In with Google      Sign In   
  • Create Account


Please judge my design doc...


Old topic!
Guest, the last post of this topic is over 60 days old and at this point you may not reply in this topic. If you wish to continue this conversation start a new topic.

  • You cannot reply to this topic
7 replies to this topic

#1 Moe   Crossbones+   -  Reputation: 1248

Like
Likes
Like

Posted 17 May 2001 - 08:24 PM

I have a very rough draft of my Design document for my 3D engine up. I need you guys to read it and tell me what I need to add/change. All comments are welcome. www20.brinkster.com/tyrannica/lightworks design document.doc

Sponsor:

#2 Moe   Crossbones+   -  Reputation: 1248

Like
Likes
Like

Posted 19 May 2001 - 05:24 AM

Anyone? Its for a programming project thats worth 2 credits. All I need are a few opinions.

Edited by - Moe on May 21, 2001 4:33:43 PM

#3 Shannon Barber   Moderators   -  Reputation: 1362

Like
Likes
Like

Posted 21 May 2001 - 03:18 PM

A design document is a battle plan not a biography :p

P.S. A design document and a design pattern are extremely distinct and different things

Magmai Kai Holmlor
- The disgruntled & disillusioned


#4 Moe   Crossbones+   -  Reputation: 1248

Like
Likes
Like

Posted 21 May 2001 - 05:07 PM

Thanks,

Yes, I realize its pretty scetchy for a design doc, but if I go in depth too much more the people who are reading it will get confused. Its not really much of a design doc at all but more of a file explaining what the heck I did and how/why I did it.

So what is the difference between a design pattern and a design doc? Does a design doc describe every part of the code of the project or more generalized plan on how the program will work?

#5 Mithrandir   Members   -  Reputation: 607

Like
Likes
Like

Posted 22 May 2001 - 02:41 PM

quote:
Original post by Moe

Thanks,

Yes, I realize its pretty scetchy for a design doc, but if I go in depth too much more the people who are reading it will get confused. Its not really much of a design doc at all but more of a file explaining what the heck I did and how/why I did it.



i admit, i havent taken the time to read your doc yet, but im on a tight schedule.

A design document is supposed to clearly state the problems occured and their solutions and the general abstraction of the program, so that people who read it WONT get confused. If adding details makes it confusing... well, you're probably doing it wrong.

Don't worry, you're not alone, I still can't write a design doc for shit, heh.


quote:

So what is the difference between a design pattern and a design doc? Does a design doc describe every part of the code of the project or more generalized plan on how the program will work?


Well, the Design Patterns discussed in this forum are specific patterns that occur frequently in computer programming. The forum was designed to discuss the book Design Patterns, and all the related software patterns included within the book.

to put it shortly, a design pattern is a general abstract solution to a problem, and a design doc is a compilation of specific solutions to a large project.

===============================================
But as for me, hungry oblivion
Devour me quick, accept my orison
My earnest prayers Which do importune thee,
With gloomy shade of thy still empery,
To vail both me and my poesy

Edited by - Mithrandir on May 22, 2001 9:42:36 PM

#6 Moe   Crossbones+   -  Reputation: 1248

Like
Likes
Like

Posted 23 May 2001 - 09:48 AM

Thanks. I will be sure to get things straight next time I write a design doc. Does anyone know of any design docs out there on the internet that I could have a look at?

#7 the Dealy Lama   Members   -  Reputation: 122

Like
Likes
Like

Posted 23 May 2001 - 10:08 AM

Well, there''s a design document section here on GDNet, but I guess you''ve probably already found that..

=======================================
Matt Welch

"What sounds to you like a big bloat of trashy old noise
is in fact the brilliant music of a genius--myself" ~ Iggy Pop


#8 Moe   Crossbones+   -  Reputation: 1248

Like
Likes
Like

Posted 23 May 2001 - 12:47 PM

To tell you the truth I didn''t look there. I didn''t even think about it. Thanks!




Old topic!
Guest, the last post of this topic is over 60 days old and at this point you may not reply in this topic. If you wish to continue this conversation start a new topic.



PARTNERS