On Dec 3, 2015, at 6:04 PM, Mandy Chung <mandy.ch...@oracle.com> wrote: > >> [Indeed, this whole section isn't strictly necessary; all of it can be >> inferred from information in other places.] > > Agree. This section is no longer necessary and maybe just remove it:
I wasn't actually intending to suggest removal. It seems like there is useful overview information to be had here, rather than requiring readers to make not necessarily obvious inferences. My impression is that readability is valued more highly than terseness in Java documentation.
