为什么我欣赏 pocoo

我欣赏 pocoo 小组,不仅仅是因为 pocoo 出品的众多的优秀的项目,而是其对待代码的态度。

当你阅读 pocoo 的项目的代码时,你发现每一段代码都有良好的注释,而且排版精美。我试着这样写代码时,我发现很消耗时间,一段代码可能十几分钟的事,但是一段排版精美说明细致的注释却可能花掉半个小时。

除了代码里的注释, pocoo 的每一个产品都有精美的文档,同时 pocoo 创造的 sphinx 已成为 python 界默认的文档生成器。

写文档比写代码难,写文档比写代码花时间。这也是最近写 July 的体会。本来代码已经写完了,文档却远远没有,所以一时也不能发布。

好的文档,不只是内容充实,同时要排版精美。目前我最喜欢的是 flask 这个主题,也在 July 中用的这个主题。

像 pocoo 学习。像 Armin Ronacher 学习。

4 comments