It's not a secret anymore!*
The moose likes Architect Certification (SCEA/OCMJEA) and the fly likes Part 2: Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login


Win a copy of Android Security Essentials Live Lessons this week in the Android forum!
JavaRanch » Java Forums » Certification » Architect Certification (SCEA/OCMJEA)
Bookmark "Part 2: "self-contained" diagrams ?" Watch "Part 2: "self-contained" diagrams ?" New topic
Author

Part 2: "self-contained" diagrams ?

Benoît de Chateauvieux
Ranch Hand

Joined: Aug 10, 2007
Posts: 183
Hi All,

When writing my Software Architecture Documentation, I generally use this template.

It contains an element catalog for every diagram where one can add a description for:
- Components and Properties
- Relationship and Properties
- Components Interface
and Rationale.

Do you think it's a good idea to include it in the submission or must be the diagrams "self-contained" ?

Thanks for your help,

Benoît


SCJP5 | SCBCD5 | SCEA5 Part 1
James Owen
Greenhorn

Joined: May 29, 2009
Posts: 18
I personaly think some notes on diagram itself and a good description in word document (after Assumptions section maybe) would be good enough.
J J Wright
Ranch Hand

Joined: Jul 02, 2008
Posts: 254
By self contained I take it you mean the diagram alone should contain all the information necessary to move from design to implementation.

I don't think this is realistic. I see nothing wrong with providing supplementary documentation to support diagram elements. For example, notes on your diagram may link to an expanded explanation in your supplementary documentation. Adding verbose notes to a diagram does nothing for it's readability.

Also, if you look at processes like RUP, there's more to Analysis and Design than simply producing a Design Model. The template your proposing seems to be along the lines of a RUP Software Architecture Document, so I think it's fine to include it. You won't get extra marks for it, but if it helps the examiner understand your design it can't be bad. Just make sure it's not an excuse to produce poor diagrams.


SCJP, SCWCD, SCBCD, SCEA 5
Rajashekar Akula
Greenhorn

Joined: Dec 06, 2007
Posts: 8
I have a question regarding the documentation part of the assignment submission -
The deliverables part of the assignment says that "all the deliverables will be accepted as HTMLs only".
Risk list and supporting documentation(assumptions, decisions etc.,) should be included in htmls only OR we can include in word document and provide links from HTML.

Thanks in advance,

Raj


SCEA 5 Certified
J J Wright
Ranch Hand

Joined: Jul 02, 2008
Posts: 254
The deliverables part of the assignment says that "all the deliverables will be accepted as HTMLs only".


Where's the ambiguity in that?
Rajashekar Akula
Greenhorn

Joined: Dec 06, 2007
Posts: 8
Let me re·phrase the question..
Can the supported documentation be submitted as "word document"?
J J Wright
Ranch Hand

Joined: Jul 02, 2008
Posts: 254
OK, if the ambiguity is based on whether or not supporting documentation is classified as a deliverable. I would most definitely err on the side of caution. My understanding of the word deliverable includes any work product, regardless of whether it's required or supporting. Besides I don't see any reason to separate the two. What would be the motivation for sending your work in two different formats?

From Sun's perspective there are undoubtedly very good reasons for only accepting HTML, i.e. it's ubiquitous and doesn't contain macro viruses. If you take the line that it's OK to send supporting documentation in Word format, then what about every other document format? Where do you draw the line?

If after all that you still feel strongly about sending your supporting documentation in a format other than HTML then at least it send it in non-proprietary format, e.g. OpenDocument Format.
Unnikrishnan Nair
Ranch Hand

Joined: Mar 12, 2003
Posts: 42
I feel it is not good to send any other formats than what Sun explicitly mentioned. Created HTML pages with the design components added as images with few write ups should resolve your issue. Why do you think you need a word doc?


SCJP, SCWCD, SCBCD, SCDJWS, SCSNI, SCEA 5, PMP, Six Sigma Green Belt, Certified Scrum Master
 
I agree. Here's the link: http://aspose.com/file-tools
 
subject: Part 2: "self-contained" diagrams ?
 
Similar Threads
jQuery.getJSON callback not executing
Not able to receive mouse events on JPanel
[Ann] Java Date Picker v3.0 Released
Verifcation
filtering N number of leaf nodes per parent node