Writing an api is hard there’s no doubt, ACM have a good article with some best practice rules to follow.
focus on the caller.
Why throwing exceptions is a good thing
Document before you implement
It’s always hard building one and deciding who your target audience is. Obviously once you’ve built in the problem is deciding when to stop refactoring and polishing it 
Building APIs
This entry was posted
on Friday, July 13th, 2007 at 8:17 am and is filed under software.
You can follow any responses to this entry through the RSS 2.0 feed.
You can leave a response, or trackback from your own site.