JavaDoc can be good, there's nothing to stop you including short usage examples for a class. Not that it's that common...