On 07.11.2007 12:40:24 Miguel Angel Blanch Lardin wrote:
> I have never been friend of placing that kind of things online as they are
> not really helpful in my honest opinion.
> It may make sense to add it for Marauroa, but most of the times the javadocs
> are not complete and you need to refer to source code ( speaking of my
> personal experience ). When that happens I have tried to update the javadoc.
> Anyway, feel free to place them online if you wish.
Well I configured Doxygen to parse the source code and output information regardless of existing JavaDoc comments, and the source is inlined into the HTML pages, so you can find information about any function.
But personally I also tend to use Eclipse's "find reference" and "find in source" features if digging in source code. The main reason for such a documentation is, it looks quite pretty and can be used to say "Look here - there is documentation about all and anything!". So yes, you are right: If there is none of the developer being used to work with that kind of documentation, the usefulness is questionable and it may not be worth that 100 MB web space.