Hi,
in a recent PR for the UnifiedPush server Bruno made a good point:
==> Add more JavaDoc!
IMO it helps others (contributors and project members) to understand the code better.
I think there is no need to submit a 'gigantic' "JavaDoc overhaul" PR, but I will do the following:
For every change that I make, I will add more/polished JavaDoc to the touched classes.