Hi, I just joined a team of developers working on a product which has a huge code base. However the documentation of the design related to the components in pretty negligble. I need to create high level design documents for each of the subsystem/components in the product wanted to hear from the people here as to their experience and what are the ways to approach this problem
My experience is a few years old, but reverse engineering into Rational Rose gave way too much detail. When humans model we leave out the unnecessary details to reveal the necessary details. I didn't need all the methods for String in my model. I (usually) don't need to see all the little utility classes that manage the protocols between my major components. If you evaluate tools, see if they've addressed this, maybe with a list of classes to include or ignore.
A good question is never answered. It is not a bolt to be tightened into place but a seed to be planted and to bear more seed toward the hope of greening the landscape of the idea. John Ciardi
posted 15 years ago
well that's what I am faced with.. Rose and even TogetherJ give way too much detail..