jQuery in Action, 3rd edition
The moose likes Architect Certification (SCEA/OCMJEA) and the fly likes Explaining my design (part2) Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login
JavaRanch » Java Forums » Certification » Architect Certification (SCEA/OCMJEA)
Bookmark "Explaining my design (part2)" Watch "Explaining my design (part2)" New topic

Explaining my design (part2)

Antonio Fornie
Ranch Hand

Joined: Aug 07, 2008
Posts: 117

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!


I feel there must be far better ways to do what I do... that makes learning even funnier
Jeanne Boyarsky
author & internet detective

Joined: May 26, 2003
Posts: 33117

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.

[OCA 8 book] [Blog] [JavaRanch FAQ] [How To Ask Questions The Smart Way] [Book Promos]
Other Certs: SCEA Part 1, Part 2 & 3, Core Spring 3, TOGAF part 1 and part 2
Rupesh S. Kumar

Joined: Nov 17, 2010
Posts: 11
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.

Antonio Fornie
Ranch Hand

Joined: Aug 07, 2008
Posts: 117
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.

I agree. Here's the link: http://aspose.com/file-tools
subject: Explaining my design (part2)
jQuery in Action, 3rd edition