文档校对

摘自 PostgreSQL wiki
跳转到导航跳转到搜索

为了提高官方 PostgreSQL 文档的质量,本小组将尝试通读文档的部分章节,改进措辞、澄清措辞和更正错误。以下是 Bruce Momjian 对前 500 个手册页所修改内容的范例 (diff 1, diff2 )。平均而言,diff 仅修改每页的两行内容,说明 PostgreSQL 文档已经很不错了。校对文档只是一个让已经不错的文档更趋完美的尝试。

目前的计划是让个人对剩余的章节进行校对。此流程中包括

  • 以易于标记的格式打印或下载文档
  • 阅读文档并调整以改进措辞、澄清句子和更正错误
  • 发送电子邮件,以任何电子格式发送您的更改或邮寄标记的打印件至 Bruce Momjian

Bruce 将审核您的更改,并确保更改已合并至官方文档中。如果您想在本地打印您的章节,Bruce 可让 EnterpriseDB 补偿您的费用---每个章节的费用通常约为 20 美元。提供开发文档的 PDF 版本 (A4, US)。如果您运气好的话,可以使用文档上的说明来构建更新版本——构建文档可能很困难。

请将您的姓名和日期放在您要校对的项目旁边,以认领该项目。校对既有成就感又能让人昏昏欲睡,所以按表格条目拆分,您可以随意认领一本书的部分。

书籍 页数 手册占比 备注 校对者 开始日期 结束日期
教程 24 1% Bruce Momjian 2008-03-01 2009-04-01
SQL 语言 325 15% Bruce Momjian 2008-03-01 2009-04-01
服务器管理 201 9% Bruce Momjian 2009-04-01 2010-02-03
客户端接口 105 5% 除了章节:31 libpq C 库
libpq 70 3% Leslie S Satenstein 2011-01-10
服务器编程 150 7% 除了章节:36. 规则系统,
39. PL/TCL 过程语言和
42. 服务器编程接口
Erik Rijkers 2010-01-22 2010-11-01
服务器编程 89 4% 有章节:36. 规则系统,
39. PL/TCL 过程语言和
42. 服务器编程接口
参考:SQL 命令 376 17% gabrielle 2011-01-13
客户端应用程序 85 4% 初稿完成,2009-02-16 gabrielle 2010-01-22 2010-03-23
服务器应用程序 22 1% gabrielle 2011-01-13 2011-03-09
内部 168 8% Greg Smith 2010-01-22
附录 536 25% 跳过发行说明