Hi David,
You need to write down the
major design decisions you made while writing your assignment.
This includes things like whether you chose RMI or Serialised Objects over Sockets, and why. Whether you allow your create to overwrite a previously deleted record and why/why not. Did you choose to have users enter the customer number inside the JTable, or in a popup, or on a separate screen. And so on.
You may be interested in "
how verbose should be design desision document?" (pay particular attention to Patrick Cobbett's question to Sun and their response), and "
My Design Choices!" (based on the older Fly By Night Services assignment, but it may give you some ideas).
There are a lot of choices that we make without really thinking about it. I noticed some of my automatic choices by looking at other people's posts here, and realising that other people were doing things which I had dismissed out of hand without making a conscious design decision. Unfortunately I documented all those as well, making my choices file overly large
.
Alain Trottier has some articles (also based on the Fly By Night Services assignment) published on the web. The one on "
The Java 2 Developer Essay Exam" gives some ideas of things you might want to have in your choices text as well.
Regards, Andrew