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

[Zoom.Quiet]

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