1.代码!代码!
哪怕是静态类型语言,简洁的代码示例都远比文字说明好,哪怕是母语说明,起码对于本人来讲,也不愿意
多看,特别是时间有限的情况下,更不论文字说明是非母语的情况下了。
特别对于python为例的动态类型语言,
十分适合代码–结果示例,如果不是所有方法、所有类都有对应的代码–结果说明的话,起码关键的方法、类一定要有说明。这样,对于学习文档,就是代码运行与对比文档说明的过程,其实是非常爽的
哪怕是静态类型语言,简洁的代码示例都远比文字说明好,哪怕是母语说明,起码对于本人来讲,也不愿意
多看,特别是时间有限的情况下,更不论文字说明是非母语的情况下了。
特别对于python为例的动态类型语言,
十分适合代码–结果示例,如果不是所有方法、所有类都有对应的代码–结果说明的话,起码关键的方法、类一定要有说明。这样,对于学习文档,就是代码运行与对比文档说明的过程,其实是非常爽的