The 2007 article "API: Design Matters" by Michi Henning gave insights on how to better design APIs. However, people I have shared it with don't seem to be excited about it.

Should the authors of lousy APIs be held accountable for their crimes? Why changing APIs might become a criminal offense Why changing APIs might become a criminal offense - Should the authors of lousy APIs be held accountable for their crimes?