《.NET设计规范》——学习笔记(2.3)自说明对象原则
摘要: 在简单的使用场景中,一定要让框架无需文档就能使用。
* 要确保API是直观的,无需查阅参考文档就能用于基本场景
你总不希望写个“Hello World”都去查阅API文档吧。
* 要为所有的API提供优秀的文档。
一方面,并非所有的API都能自说明。不同的人会认为不同的API是自说明的;
另一方面,有些人想在开始使用API之前完全理解它们。
阅读全文
《.NET设计规范》——学习笔记(2.2)低门栏原则
摘要: 框架必须以易于使用的方式来为普通用户提供一个低门栏。
阅读全文