O'Reilly logo
  • Shayne Riley thinks this is interesting:

But doesn’t this violate the dictum that good API documentation should describe what a given method does and not how it does it? Yes, it does! This is an unfortunate consequence of the fact that inheritance violates encapsulation.

From

Cover of Effective Java, 2nd Edition

Note

yep