a bunch of API design guidelines flow from Scott Meyer's famous maxim "Make interfaces easy to use correctly and hard to use incorrectly."

http://www.aristeia.com/Papers/IEEE_Software_JulAug_2004_rev...