Github user cestella commented on the issue:
https://github.com/apache/metron/pull/1242
Just chiming in here in support of taking some care around javadoc. I tend
to agree that it goes stale and it can become misleading. I think the metric
(and this is just personal opinion here) should be that any public API should
be well javadoc'd and otherwise documented (e.g. the REST API) and we should
seriously consider javadoc'ing classes which are used broadly.
I tend to prefer a compromise whereby the class itself has documentation
around the intent and use of the class in Javadoc and the methods are named
well and broken up well. From there, I'm ok if there's less effort put around
javadoc of individual methods.
Just my $0.02
---
