示例是最好的文档
作者指出,95%的情况下,一个简单的代码示例就足以满足开发者的文档需求,但官方文档往往缺乏实用示例。文章以Python的max函数为例,说明简洁的示例比复杂的语法描述更直观有效,并赞扬了Clojure社区clojuredocs.org这样的示例驱动文档平台。
作者指出,95%的情况下,一个简单的代码示例就足以满足开发者的文档需求,但官方文档往往缺乏实用示例。文章以Python的max函数为例,说明简洁的示例比复杂的语法描述更直观有效,并赞扬了Clojure社区clojuredocs.org这样的示例驱动文档平台。