399 |
|
|
400 |
* separated as navidoc |
* separated as navidoc |
401 |
|
|
402 |
Experiences |
.. Experiences |
403 |
=========== |
=========== |
404 |
|
|
405 |
Statistics from the WWW server of our project show that the |
Statistics from the WWW server of our project show that the |
406 |
UML diagrams |
UML diagrams |
407 |
have been used to traverse between javadoc and design documentation. |
have been used to traverse between javadoc and design documentation. |
408 |
During three months (Jan 03 till end of Mar 03), 9% of all |
During three months (Jan 03 till end of Mar 03), 9% of all |
409 |
design documentation page requests resulted from traversing from the Javadoc pages to |
design documentation page requests resulted from traversing from the Javadoc pages to |
410 |
design documentation via UML diagrams, and 11% of all |
design documentation via UML diagrams, and 11% of all |
411 |
Javadoc page requests resulted from traversing from design documentation to the Javadoc pages |
Javadoc page requests resulted from traversing from design documentation to the Javadoc pages |
412 |
using the imagemapped |
using the imagemapped |
413 |
diagrams. |
diagrams. |
414 |
Unfortunately, the referrer logs did not allow us to |
Unfortunately, the referrer logs did not allow us to |
415 |
identify the use of UML diagrams for navigation |
identify the use of UML diagrams for navigation |
416 |
within javadoc pages or within design documents, because there |
within javadoc pages or within design documents, because there |
417 |
are other links besides the UML diagrams between those pages. |
are other links besides the UML diagrams between those pages. |
418 |
Also, we are unable to say how much of the traffic came from testing |
Also, we are unable to say how much of the traffic came from testing |
419 |
and debugging Navidoc itself and how much from real use. |
and debugging Navidoc itself and how much from real use. |
420 |
Anecdotally, finding the context *is* easier with the UML diagrams. |
Anecdotally, finding the context *is* easier with the UML diagrams. |
421 |
|
|
422 |
|
|
423 |
.. We expect those number would be even higher. |
.. We expect those number would be even higher. |
436 |
- javadoc pages reached from design docs 179 times |
- javadoc pages reached from design docs 179 times |
437 |
- summa summarum: at leasts 10% all hits came via diagrams |
- summa summarum: at leasts 10% all hits came via diagrams |
438 |
|
|
|
* anecdotes - has someone used it? |
|
439 |
|
|
440 |
Conclusion |
Conclusion |
441 |
========== |
========== |