• Post Reply
  • Bookmark Topic Watch Topic
  • New Topic

Explaining my design (part2)

 
Antonio Fornie
Ranch Hand
Posts: 117
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Hello,

I'm about to finish my part 2 deliverables and I would like to explain the reasons that made the design the way it is, I mean, why I used an EJB for one case and not for another, why I need to use paging when returning a long list, and so on. Can I include a text with this information in the deliverables or am I supposed to deliver ONLY the diagram images, the 3 top risks and the assumptions? I just feel it would be easier to understand my decisions if I could explain them.

By the way, should I include in my assumptions, technical matters or only my assumptions about the essay?

Thank you very much!

antonio
 
Jeanne Boyarsky
author & internet detective
Marshal
Posts: 34851
369
Eclipse IDE Java VI Editor
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Antonio,
I wrote a lot about my design in text. I erred on the side of giving them too much info rather than not enough. See my blog for more details on this.
 
Rupesh S. Kumar
Greenhorn
Posts: 11
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
I provided only the diagrams including risks and overrall assumptions on the project. Any other reasoning behind what was used and not is part 3 where you can provide the justifications if asked.

Thanks
Rupesh
 
Antonio Fornie
Ranch Hand
Posts: 117
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Thank you both. I think I'll finally give some text right behind the image. In fact, I think I'll have a Class Diagram for the whole model with little detail (no methods) and them I will have a couple of Class Diagrams with more detail, one for each part. Otherwise I'd end up giving a single HUGE Class Diagram.

antonio
 
  • Post Reply
  • Bookmark Topic Watch Topic
  • New Topic