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

Item 40: Design method signatures carefully

From

Cover of Effective Java, 2nd Edition

Note

This item is a grab bag of API design hints that don’t quite deserve items of their own. Taken together, they’ll help make your API easier to learn and use and less prone to errors.