How to Design Great APIs and Why it Matters


A co-worker of mine sent me this presentation Joshua Bloch (Effective Java)… Joshua was a key API designer for Java at Sun and is now working at some small search engine company. It is so great to learn from your competitors and Josh really is a smart guy with clear, crisp ideas that resonate well in the .NET world.

How to Design a Good API & Why it Matters

A few takes aways for me:

  1. If the names are nasty, you likely have bad design

  2. Agility trumps completeness

  3. When in doubt leave it out

  4. Not to mention the numerous java framework examples he uses of what NOT to do. 😉

BTW, you can of course find other great Framework design resources

MSDN Video Series on Designing .NET Class Libraries
BradA Design Guidelines Tag
Framework Design Guidelines : Conventions, Idioms, and Patterns for Reusable .NET Libraries

Comments (12)

  1. Isn’t Mater the tow truck in the Cars movie?



  2. BradA says:

    Thanks Dave.. fixed…

  3. I just noticed Mitch posted a review of the Framework Design Guidelines . .NET Framework Design Guidelines

  4. pradeepchellappan says:

    The last name is Bloch and not Block 🙂

  5. BradA says:

    Utz.. thanks! fixed.

  6. ... says:

    Luogo molto buon:) Buona fortuna!

  7. ... says:

    E evidente che il luogo e stato fatto dalla persona che realmente conosce il mestiere!

  8. ... says:

    luogo interessante, soddisfare interessante, buon!

  9. ... says:

    Lo trovo piuttosto impressionante. Lavoro grande fatto..)

  10. ... says:

    Stupore! ho una sensibilit molto buona circa il vostro luogo!!!!