2008年08月14日 星期四 09:42
2008/8/14 赵士威 <zhaoshiwei at broadview.com.cn>: > liz: > 谢谢这么快的反馈,我看了一下,总体感觉有问题,我们的PCS结构是基于模块方面的,说明模块的使用和内部函数的使用,硬性套到这 PCS 的作用,一直有定义的: http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/PCS "将本书实例故事讲述过程中涉及到的相关知识点,以简洁易用的形式组织起来; 一方面,给前述故事对应部分提供进一步解说; 另一方面,也可以作为独立辞典快速查用; " 从来没有限定到 模块哪?!?!?! > 文档化工具似乎不妥,关于模块的使用和内部函数的使用我们可以通过代码来表示,因为本书模块就是比较生硬的,但是这种方法用于说明文档化工具应该不合适。也许用文字描述会好一些。至于模块方面的PCS,我认为可以按照代码来说明。其他方面,考虑文字表述吧。 > epydoc 是个特殊的模块,其内部函式,是从来不会直接使用到的, PCS 203 就是相对完整的将 epydoc 的使用和一般技巧分享一下而已, 这样写,我感觉可以的,, > > 2008/8/13 liz <shengyan1985 at gmail.com> >> >> 编辑: >> 修改了下,看这样是否可以了?http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/PCS203 >> >> 2008/8/13 liz <shengyan1985 at gmail.com> >>> >>> ok, 我看到了,非常抱歉的是那两个包含链接部分的内容是我加上的,过会马上修改。 >>> >>>> >>>> 2008/8/13 清风 <paradise.qingfeng at gmail.com> >>>>> >>>>> 很清楚,好的.继续修改,liz也看一下 >>>>> >>>>> 2008/8/13 赵士威 <zhaoshiwei at broadview.com.cn>: >>>>> > 清风,liz: >>>>> > http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/PCS203 >>>>> > 这个写的有点草率,可以换位思考下,如果你是读者,看到书中有这样的内容,有何感想呢? >>>>> > >>>>> > >>>>> > 之前的PCS200,虽然写的内容不多,不过已经形成了一个良好的结构,通过代码演示已经可以将内容展现出来,需要增加的是代码注释,提高可读性,这点请清风继续做下去啊,明天可以完成吧? >>>>> > >>>>> > >>>>> > PCS203有结构,但是没有内容,PCS200是通过代码来展示内容的,而PCS203我却只看到一句话和链接,内容我是看不到的,(打个比方:就好象是我看新闻联播的一句话新闻一样,我就了解了有这么个东西,但是我对具体内容一点也不知道,书的作用是告诉读者具体内容的),也不可能要求我去相关链接看了内容告诉你们应该如何写,什么该写什么不该写,这些工作应该是作者做的.我提供的建议是框架性的东西,也仅仅是建议. >>>>> > >>>>> > PCS203本周五改写完毕应该没有问题吧!其它的PCS部分也要同步进行了,各位参与者要抓紧了,看来我催稿邮件不久的将来会堆满你们的邮箱了. >>>>> > >>>>> > -- http://zoomquiet.org''' 过程改进乃是催生可促生靠谱的人的组织! PE keeps evolving organizations which promoting people be good!'''
Zeuux © 2024
京ICP备05028076号