posted 17 years ago
Hi Rafael,
I think it is important to have some architecture documents. Though it is probably least challenging part of writing software, it is very important and will allow you and others to think about the architecture more clearly. A reverse-engineered class diagram is not very usefull. Think about diagrams that show what classes are cached, which classes are involved in showing a page, which tasks are performed by which packages, etc., and most of all, for each of these questions, why? Why is it implemented like that?
Moreover, why don't you put the javadoc online? It would allow potential developers to look into part of the architecture very quickly, without having them create their own javadoc. You can very easily write some script that updates the javadoc on new commits (or use tools for it like CruiseControl).
Hope you can do something with my info ;). I like JForum and I like JForum to grow.
Regards!
[originally posted on jforum.net by anoko]