哲思官方群认证群组  - 讨论区

标题:[zeuux-press] [OBP:2754] Re: 关于PCS的问题

2008年08月14日 星期四 09:42

Zoom.Quiet zoom.quiet在gmail.com
星期四 八月 14 09:42:27 CST 2008

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!'''

[导入自Mailman归档:http://www.zeuux.org/pipermail/zeuux-press]

如下红色区域有误,请重新填写。

    你的回复:

    请 登录 后回复。还没有在Zeuux哲思注册吗?现在 注册 !

    Zeuux © 2024

    京ICP备05028076号