465 |
documentation and the Javadoc pages as well as giving the user an |
documentation and the Javadoc pages as well as giving the user an |
466 |
idea of the context of the current class. |
idea of the context of the current class. |
467 |
|
|
468 |
|
So far in our experience Navidoc has proven to be a most useful tool; |
469 |
|
not only for improving the Javadoc navigability but also giving the design |
470 |
|
documentation writer an added incentive to create UML diagrams. |
471 |
|
|
472 |
.. Of course, generated documentation may give well detailed information |
.. Of course, generated documentation may give well detailed information |
473 |
from the current implementation, but the design documentation should |
from the current implementation, but the design documentation should |
474 |
also cover the future and be rather well abstracted than well |
also cover the future and be rather well abstracted than well |