图书内容修订讨论

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

议题

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

决议

1. 每日 21:30~21:45 在 #zeuux-press IRC房间 进行站立会议,沟通每日进度

   • 每人简要说明今进度,主要困难,就好!

1. 080725 18:00 前,编辑提供 KDays 0,1 章节的修订意见,ZQ 在周末完成对应修订,080728 周一交付,进行KDays 故事改进策略讨论
2. 080728 周一 编辑咨询上锋,确认前言和附录中,相关内容的可出版尺度,以便进行进一步调整,撰写!

3. 080725 18:00 前,清风&Liz 完成PCS两则的条例化修订,由编辑进行审核,以便形成样板,支持批量修订!

所有意见通过OBP工程环境的ISSUE进行收集/追踪:

• Issue使用教程

  • Issue工作流程

  • Issue标签详解

记要

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 以吻合图书阅读习惯

4MindMaps

• 故事的内容关联图谱和KDays 的整体图谱，是否可行？由谁美化修改？
  • 画图没有问题，我们这里有美工，不过如何放到书里还需要作者们费心了

• 另外,建议设计:本书的导读和思维图谱 ~ 引导读者思考和阅读此书的导图

4Others

• 下周一(080728)１８：００前就前言给出修订意见吧。至于什么话不能出，我也说不上，只是感觉有点问题

反馈

创建 by -- ZoomQuiet [2008-07-23 06:28:17]