As with other types of interface design, the best way to write a good api is to get frequent feedback from the intended users. Liberal application of the WTF t

As with other types of interface design, the best way to write a good api is to get frequent feedback from the intended users. Liberal application of the WTF test is critical[1]. As the author of the api, you yourself will be too close to it to judge fairly. Poorly named functions and over-complicated architecture will appear perfectly reasonable to you if you don't seek outside opinions. 1: http://commadot.com/wp-content/uploads/2009/02/wtf.png http://commadot.com/wp-content/uploads/2009/02/wtf.png