Differences between revisions 11 and 12
Revision 11 as of 2008-07-23 07:53:48
Size: 2683
Editor: ZoomQuiet
Comment:
Revision 12 as of 2008-07-23 08:03:25
Size: 2797
Editor: ZoomQuiet
Comment:
Deletions are marked like this. Additions are marked like this.
Line 46: Line 46:
      * 所有内外指引,都应该显要的指出比如说:`体的技术细节请参考PCS310 LEO` 以便图书阅读

TableOfContents

Include(ZPyUGnav)

图书内容修订讨论

080723 14:00~  BillXu + 所有相关编著

议题

  1. KDays 内容风格修订
  2. PCS 体例修订
  3. 整体交付标准

记要

4CDays
  • 审校原则就这么定了:”博文负责去口语化和语法错误等修订;liz和julien开始对cdays的内容本身进行审校,重点是句子的叙述要连贯等“
  • 如果CDays 提前交付,以后其它章节的修订,以此版本的CDays 内容(对应 Changeset)为准;不得随意修订了!
  • 到七月底,两周内,完成以上要求的复校!
4Kdays
  • 文字编辑认为不可读:
    1. 多地方跳跃性太大,句子太短~不懂技术但是她应该可以通过你的文字了解到你要表达的思路,但是她无法从文字总理清这些思路
    2. 图片和代码在文中的说明很模糊
    3. 口语化色彩过于浓厚,网络用语较多,行文很随意
  • 决议先集中精力修订 KDays 0,1 两章,确认修订模式后,快速完成其它整体修订!
  • 周5(080725) 18:00 前编辑收集齐 KDays 0,1 章的意见,以便在周末完成修订;周一时,交付修订版本,进行进一步修订的讨论
  • 建议在列表中通告相关的修订建议并开展针对性讨论,同时也成为图书的创作历史永久记录在案
4PCSs
  • 立旨:
    • 所有PCS的总和 ! 应该能够涵盖2个故事里所需要的全部知识要点;

其实,应该是更加多的,正是因为为了保持 故事的连续性,无法将过多的技术细节包含在故事章节,才使用了PCS

  • 修订要求:
    1. 去掉小白与行者
    2. 及时补齐缺少的内容
    3. 将内容的部分,补充的再丰富一些,不再是,例子名->解答

  • 编辑建议:
    1. PCS部分的体例需要统一
  • ZQ提议:
    1. 只有 http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/PCS208 特殊,因为是模块作者贡献的;可以追加 Limodou 的简介,以及,配合故事的其它体例化内容

    2. 精查所有PCS出现处的上下文,是否PCS 中有相关需要支持的知识点的说明?
  • 决议:
    • 编辑提供 Py CookBook 的体例分析报告

      • 建议,还是集中时间,按照体例理解,修订出一样板PCS来,清风和Liz 进行参考修订!
    • 所有内外指引,都应该显要的指出比如说:体的技术细节请参考PCS310 LEO 以便图书阅读

4Attas
  • ...
4MindMaps
  • ...


反馈

创建 by -- ZoomQuiet [DateTime(2008-07-23T06:28:17Z)]

PageComment2

[:/PageCommentData:PageCommentData]

ObpLovelyPyEditorRule/ContentDiscuss (last edited 2009-12-25 07:17:17 by localhost)