• Post Reply Bookmark Topic Watch Topic
  • New Topic
programming forums Java Mobile Certification Databases Caching Books Engineering Micro Controllers OS Languages Paradigms IDEs Build Tools Frameworks Application Servers Open Source This Site Careers Other Pie Elite all forums
this forum made possible by our volunteer staff, including ...
Marshals:
  • Campbell Ritchie
  • Jeanne Boyarsky
  • Ron McLeod
  • Paul Clapham
  • Liutauras Vilda
Sheriffs:
  • paul wheaton
  • Rob Spoor
  • Devaka Cooray
Saloon Keepers:
  • Stephan van Hulst
  • Tim Holloway
  • Carey Brown
  • Frits Walraven
  • Tim Moores
Bartenders:
  • Mikalai Zaikin

Documentation what is needed ?

 
Ranch Hand
Posts: 378
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
I think about starting my SCJD in one months .....

But whats the level of documentation, is javadoc enough ?, schould i create some uml diagrams, and convert it to jpg´s
so im sure that sun can look at my diagrams.....

If i use some design patterns, schould i describe it in word somewhere or ???

Frank

SCJP
SCWCD
 
Bartender
Posts: 2292
3
Eclipse IDE Spring Java
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Howdy, Frank!

Even though you have to provide JavaDoc documentation for all classes you create, you still have to justify your most relevant choices, since the assignment has lots of ambiguities. You'll have to create a choices.txt file for that, as well as the user guide, which can be embedded in your application, or can be a plain text/HTML file. And you don't really have to provide any UML diagram. And that should be about it
 
Sheriff
Posts: 11604
178
Hibernate jQuery Eclipse IDE Spring MySQL Database AngularJS Tomcat Server Chrome Java
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Hi Frank,

you should provide following things (beside your code of course):
- Javadoc documentation for all classes and interfaces you are submitting.
- choices.txt: containing pure ASCII (not a word processor format) text describing the significant design choices you made.
- userguide: User documentation for the database server and the gui client.

No UML is needed (you could always submit it, but you don't receive extra points for doing so -but maybe loose some points because it is not correct) and the design patterns you could describe in choices.txt

Kind regards,
Roel
 
Frank Jacobsen
Ranch Hand
Posts: 378
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Thanks
 
reply
    Bookmark Topic Watch Topic
  • New Topic