API Design

Joshua Bloch heeft een zeer mooie opsomming gemaakt van regels voor het ontwerpen van goede API. Lees zijn post op InfoQ: Bumper-Stick API Design.
Mooi voorbeeld uit zijn tekst:

If you get an API right, code will read like prose.