File APIs for Java Developers
Manipulate DOC, XLS, PPT, PDF and many others from your application.
The moose likes Architect Certification (SCEA/OCMJEA) and the fly likes Assignment solution Packaging for Part 2 Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login

Win a copy of Java Interview Guide this week in the Jobs Discussion forum!
JavaRanch » Java Forums » Certification » Architect Certification (SCEA/OCMJEA)
Bookmark "Assignment solution Packaging for Part 2" Watch "Assignment solution Packaging for Part 2" New topic

Assignment solution Packaging for Part 2

Kumar Amit
Ranch Hand

Joined: Aug 13, 2001
Posts: 103
What is the best way amonth the following to show Assumptions, Risk, Design decision section in the index.html?

1) Have seperate html pages for each of these and link them from index page
2) Have all the three as seperate sections on index page itself

Also for details related to deplyment diagram, should they be documented in index.html itself with a link to deployment diagram on it
OR have deployment diagram.html containing both deployment diagram image as well textual details related to underneath

Very basic questions but can make a difference as sun/oracle has strict guidelines about packaging.

james edwin
Ranch Hand

Joined: Nov 22, 2001
Posts: 393
IMHO, I think you should create one index.html and link all your deliverable to that only.

Jeanne Boyarsky
author & internet detective

Joined: May 26, 2003
Posts: 33132

I put my deployment diagram comments in a deployment.html along with that diagram. Similarly, for all other diagrams. I linked to the page from the index.htm. I think as long as you can get to everything from the index.html, it is fine.

[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
Ranganathan Kaliyur Mannar

Joined: Oct 16, 2003
Posts: 1101

I am also having only links from index.html to other diagrams. I am not adding any text for my deployment diagrams (but I do have 2 'notes' within the diagram). Also, I have made assumptions as a separate html and provided as a link from index.

Sharma Ashutosh

Joined: Apr 06, 2001
Posts: 346
There is nothing called good or best practices for this. Do what you feel is right and easy to manage.
I had one monolithic html file created using SeaMonkey. All the text-everything-links, links for diagrams, notes...every thing was cross referenced and can easy to be navigated.
I created TOC from SeaMonkey only. All my diagrams were external to this HTML and had links to the HTML. I just categorized these diagrams into separate directories.

I have provided a lot of sections - which were nothing but various level of headings. My index.html was around 950KB and overall JAR file size as 1.7 MB.

Ashutosh Sharma
SCJP 1.2, SCEA 5, Brainbench certified J2EE Developer, Documentum Certified Professional
Blog :
I agree. Here's the link:
subject: Assignment solution Packaging for Part 2
jQuery in Action, 3rd edition