[zeuux-press] [LovPy]KDays 故事修订

[Zoom.Quiet]

2008/8/20 liz <shengyan1985 at gmail.com>:
>> 距离交稿不到两周了哪！！！！大家的进度？
>> 7天前的邮件好象没有人收到，回复？
>> 今天快速修订了一下 KDay2 故事，发现涉及了很多代码的问题...
>> http://code.google.com/p/openbookproject/source/detail?r=1389
>>
>> 当前的紧急问题:
>> 0. KDay1 中在发现必须补充截屏时，不得不 在 KDay1-1 之后插入了 KDay1-5，因为 KDay1-2~4 是预先有的图片了,,,
>>  这明显不合理，所以，是否应该修订图片的命名？
>>  KDay1-index-pih.png  这样有意义的命名？
>> 1. KDay2 开始，各种实际运行的截屏有必要同代码想吻合，就必须全部重新截屏，不知道Liz 是否愿意统一进行？也算是 review 代码?
>
>
> 不好意思各位，因为目前不在学校，不怎么方便上网，所以得再过几天才能回去掺和，当然我会尽量校验内容代码。不过没明白的是，为什么要重新截屏？以前的截屏为什么和代码不吻合？为什么一定要吻合，截屏图片不就是为了展示程序目前状态么，只要向读者说明清楚就可以了吧？若一定要改的话，需要什么要求和格式么？
>
嗯嗯嗯! Liz 一直是非常积极的! 对应的一一回答:
0. 因为之前的截屏是N久以前,俺在M$环境中截屏的,和现在的发布代码不统一
1. 因为之前的 KDays 故事不叫 KDays 而且是 kwebdev 什么的工程,目的和目标都不同
2. 一定要吻合,是为了给读者正确的参照,否则:
  文字里说 访问 http://localhost/q/index.ks
  但是截屏是 http://localhost:9001/k/index.ks
  而代码中运行时,访问的应该是 http://localhost:8081/kwebdev/index.ks
 那就乱套了! 保证图书内容和可下载的样例代码的一致性,是我们的基本质量要求吧!
3. 如果要向读者说明,而不修订好一致性问题,那么,无法保证在所有不一致发生时,读者可以平滑的得到提示~不给读者以惊奇~最好的说明方式,就是不用说明;)
4. 这和一直约定的图片要求是相同的:
 + 命名要规范和统一
 + 格式使用 png
 + 截屏时,要有访问URL,游览器最好使用 FireFox ,不要有多余的导航菜单等等
但是,开始重构内容时,必然会发现新的需要图片相佐之处,依照原先图片命名约定:按照图片出现在章节中的顺序来命名就非常非常的麻烦了,
每增加一个图片,就可能引起对一批图片重命名的操作!
所以,俺建议: KDay1-index-pih.png  这样有意义的命名...

大家看是否合理?





-- 

http://zoomquiet.org'''
过程改进乃是催生可促生靠谱的人的组织!
PE keeps evolving organizations which promoting people be good!'''