@guilin … 我先去找个例子…
我的看法是直接上 API 的说明和用例… 还有用注释或文字提示运行结果,
像 buzz 的文档, 每段代码在环境里还直接帖到环境去运行, 就很清晰,
http://buzz.jaysalvat.com/documentation/buzz/
还有避开术语, 用例子, 比较容易看懂
作为新手我表示就想明确用里面的 API 我能做什么, 然后每个 API 怎么用,
如果文档暴露写更底层的东西, 我就很容易吸引过去觉得自己有什么搞不懂,
… 新手就这样, 陷到复杂的东西没人搭手就容易纠结很久, 切身体会啊