Continuing in our weekly blog post series that highlights a few of the new additions to the Framework Design Guidelines 2 nd edition .. This content is found in the Principle of Self-Documenting Object Models section of Chapter 2: Framework Design Fundamentals. I love the war-stories that our annotators provide here. AVOID many abstractions in mainline scenario APIs. KRZYSZTOF CWALINA Abstractions are almost always necessary, but too many abstractions indicate over-engineered systems. Framework designers should be careful to design for customers, not for their own intellectual pleasure. JEFF PROSISE A design with too many abstractions can impact performance, too. I once worked with a customer who re-engineered its product to incorporate a heavily Read More...

Read the complete post at http://blogs.msdn.com/brada/archive/2008/12/01/framework-design-guidelines-avoiding-abstractions.aspx