Paradoxes of API Design
Apress eBooks · 2008
API design is different from regular in-house system design. That is why when we apply the same principles to it, we might come up with surprising results. These results maybe slightly difficult to believe, because they might contradict our expectations. However, they need not be wrong. The scale makes the difference here. Just like there is a difference between describing a house and describing the whole universe, there is a slight difference when we talk about in-house software systems and those with APIs.