Do Not Expose More Than You Want
From APIDesign
Have You Ever Wondered...?
Do you want to know some simple trick that will help you design better APIs? This chapter gives you one. It is very elementary, but very powerful. It also shows that the object oriented languages of today are not really optimized for API development and that there are many gotchas one needs to be aware of.