Github user mmiklavc commented on the issue:
https://github.com/apache/metron/pull/1242
Thanks for the feedback/viewpoint @cestella . I think @nickwallen has some
good points, in particular about why/when to choose one client or the other.
I'm adding some of that detail now, and am linking aggressively to the ES docs
so that we're not simply reproducing their documentation. In general, I do NOT
think we should be writing javadoc like this -
https://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html. It is
certainly detailed, but arguably pedantic for our purposes. Oh, and we should
also be documenting Stellar functions - which is a feature we already support
via the annotations you added some time ago.
---
