Paradoxes of API Design

From APIDesign

Revision as of 06:20, 14 June 2008 (edit) Apidesign (Talk | contribs) (Removing all content from page) ← Previous diff		Revision as of 20:19, 13 August 2008 (edit) (undo) JaroslavTulach (Talk | contribs) Next diff →
Line 1:		Line 1:
		+	== Have You Ever Wondered...? ==
		+	Are you asking now why some API design advices feel so unnatural? Why they are so different compared to the best practices that we learned while working on our small projects or on in-house projects of any size? The reason is that even a small shift in the initial conditions may result in completely opposite advice which may seem paradoxical. However that does not mean such advice is not useful and the [[Paradoxes of API Design|chapter 14]] describes some of them and explains why adhering to them may be beneficial for any software project.

---

Revision as of 20:19, 13 August 2008

Have You Ever Wondered...?

Are you asking now why some API design advices feel so unnatural? Why they are so different compared to the best practices that we learned while working on our small projects or on in-house projects of any size? The reason is that even a small shift in the initial conditions may result in completely opposite advice which may seem paradoxical. However that does not mean such advice is not useful and the chapter 14 describes some of them and explains why adhering to them may be beneficial for any software project.