• 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
  • Tim Cooke
  • paul wheaton
  • Jeanne Boyarsky
  • Ron McLeod
Sheriffs:
  • Paul Clapham
  • Liutauras Vilda
  • Devaka Cooray
Saloon Keepers:
  • Tim Holloway
  • Roland Mueller
Bartenders:

Part 2 - Adding description for diagrams

 
Ranch Hand
Posts: 56
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Hello Ranchers,

Does it make sense to add extra description for class diagram, component diagram and deployment diagram?

I feel that sequence diagrams are good candidate for adding description for explaining flow, but it will not make much sense to add description beneath class diagram.

Please share your views.

Thanks!
 
Ranch Hand
Posts: 196
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
It makes sense to clarify all diagrams created. You can use the search functionality of this forum for potential points of interest.
The are quite a few hints on this.
 
author & internet detective
Posts: 42102
933
Eclipse IDE VI Editor Java
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Yes. You want to give the reviewer as much information as possible to work with.
 
Bartender
Posts: 1104
10
Netbeans IDE Java Ubuntu
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Yes, you can make use of the 'Note' in UML to do this too. And you can have a free note and also a note that is attached to a specific object.
 
Gurukant Desai
Ranch Hand
Posts: 56
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Thanks a lot!! I will add descriptions for every diagrams now.
 
Gurukant Desai
Ranch Hand
Posts: 56
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Hi,

I have added descriptions in all other diagrams except class diagram and I am not able to write more than 5 line description for class diagram as my system overall design has been included in component diagram. Shall I explain cardinality between business objects as description?
Although it is very much displayed in diagram?

Please provide some topics that should be specifically part of class diagram desciption.

Thanks!
 
Jeanne Boyarsky
author & internet detective
Posts: 42102
933
Eclipse IDE VI Editor Java
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Assume the reviewer knows how to read the diagram (such as cardinality.) Repeating just wastes his/her time. Use text/comments for explaining why you did something. Why did you choose a tricky multiplicity? Why did you deviate from the business diagram in the assignment? Anything non-standard you want to call attention to.
 
Greenhorn
Posts: 15
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
I did add description for each class by textual under the class digram
 
Ranch Hand
Posts: 127
1
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Instead of adding description in the diagram it self, Is it not better to put in the html.

While submitting index.html as to be prepared and every other diagram is referenced again with one more html in which diagram as well as text information below it. Will this would be fine.
 
It is no measure of health to be well adjusted to a profoundly sick society. -Krishnamurti Tiny ad:
We need your help - Coderanch server fundraiser
https://coderanch.com/wiki/782867/Coderanch-server-fundraiser
reply
    Bookmark Topic Watch Topic
  • New Topic