《.NET设计规范》——学习笔记(2.3)自说明对象原则
摘要: 在简单的使用场景中,一定要让框架无需文档就能使用。
* 要确保API是直观的,无需查阅参考文档就能用于基本场景
你总不希望写个“Hello World”都去查阅API文档吧。
* 要为所有的API提供优秀的文档。
一方面,并非所有的API都能自说明。不同的人会认为不同的API是自说明的;
另一方面,有些人想在开始使用API之前完全理解它们。
阅读全文
《.NET设计规范》——学习笔记(2.2)低门栏原则
摘要: 框架必须以易于使用的方式来为普通用户提供一个低门栏。
阅读全文
《.NET设计规范》——学习笔记(2)框架设计的基本原则
摘要: 对用户而言,真正的开发效率来自能够轻易地创造出非凡的产品,而并非来自能够轻易地创造垃圾。
阅读全文
《.NET设计规范》——学习笔记(1)
摘要: 如果框架的设计者能够站在使用者背后解释应该如何使用框架,那么就不需要同规范了。
阅读全文