本文强调了在技术文档中使用代码示例而非纯文字说明的重要性，尤其是对于动态类型语言如Python而言，通过代码-结果示例的方式能极大提高学习效率。
1.代码！代码！
哪怕是静态类型语言，简洁的代码示例都远比文字说明好，哪怕是母语说明，起码对于本人来讲，也不愿意
多看，特别是时间有限的情况下，更不论文字说明是非母语的情况下了。
特别对于python为例的动态类型语言，
十分适合代码–结果示例，如果不是所有方法、所有类都有对应的代码–结果说明的话，起码关键的方法、类一定要有说明。这样，对于学习文档，就是代码运行与对比文档说明的过程，其实是非常爽的
扫一扫
评论
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
查看更多评论
添加红包
