Comment Location?

[Chris Bicnal]

Howdy all,

So I'm in the final stages of packaging up my application and have a question on what folks have done about comments.

I have a ton of comments on my deployment diagram and am wondering whether it's better to leave them on the diagram or move them to index.html with a link to the "clean" diagram from there.

What did folks do?

Chris

[Jeanne Boyarsky]

Chris,
I put the majority of my comments in a bulletted list on the main page. I only put a UML comment in the diagram if it was EXTREMELY context specific.

[Chris Bicnal]

Thanks Jeanne - can I assume from your reply that you also included your risk list and assumptions within the index.html document as opposed to linking to separate files?

[Jeanne Boyarsky]

Yes, I put that on the main page and linked to the diagrams. I wanted to make it more likely that the assumptions and such would get read first.