2006-03-23. 约定校对记录
Liang Osmond <sinosmond at gmail.com>建议 建议在写 校对记要 时遵循以下原则(**讨论**)
1)尽量不使用 斜体字 ,中文斜体字 不便于阅读。
2)为了加快校对进度,节省大家的阅读时间,建议尽量使用 "编辑标记" 将修改的细微之处标出。
对编辑"编辑标记" 的约定:
1〉要将 "ABC" 删除,建议使用: ABC
2〉要将 "ABC" 替换为 "XYZ",建议使用: ABC
XYZ
3> 在校对者的说明文字前加标记
4> 当一段中有多处"ABC" 统一要替换为"XYZ" 时,首先在每次出现"ABC" 的地方使用标记 ABC <!>, 然后在段后的说明信息后使用{i}
ABC
XYZ
举例:
A. 要将:
在这一步中你需要定义每个函数的 API ,但是你不需要立刻编写他们,而是以 Python 关键字 pass 一笔带过。
改变为:
在这一步中你只是想定义每个函数的 API,而不想具体实现它们,因此你以 Python 的关键字 pass 一笔带过。
建议写为:
在这一步中你 需要
只是想
定义每个函数的 API ,
但是你不需要立刻编写他们
而不想具体实现它们
,
而是
因此你
以 Python 关键字 pass 一笔带过。