零点课堂 | 比特币改进提案的运作流程(2)

一个合格的 BIP 草案还需要注意格式

序言格式需要注意:

  • BIP: //BIP 编号,如果是草案阶段就填写「?」
  • * Layer: // 记录 BIP 作用于哪个层级,在 BIP123 有不同层级的定义
  • Title: //BIP 的标题,最多是 44 个字符
  • Author: // 作者的名字与电子邮件地址
  • * Discussions-To: // 讨论 BIP 的邮件列表地址
  • * Comments-Summary: //BIP 得到的评论的总结
  • Comments-URI: // 查看 BIP 评论的 wiki 地址
  • Status:
  • Withdrawn | Final | Replaced | Obsolete> // 标明当前的 BIP 处于什么状态
  • Type: // 标明 BIP 所属类型
  • Created: //BIP 被分配标号的日期
  • License: // 使用的许可证书
  • * License-Code: // 许可码
  • * Post-History: // 发布的时间(发布到比特币邮件列表)
  • * Requires: // 所依赖的 BIP 编号
  • * Replaces: // 代替了的 BIP 编号
  • * Superseded-By: // 被哪个 BIP 所替代了

除带 *号的内容其他都是必需的

BIP 的附件格式需要注意。BIP 可能包括图表等附件,附件应包含在该 BIP 的子目录中,且必须命名为 BIP-XXXX-Y.ext,其中「 XXXX」是 BIP 编号,「 Y」是序列号(从 1 开始),「 ext」被实际的文件扩展名替换(例如「 png」 」)。

BIP 的审核流程

BIP 草案撰写完毕后,就需要将完整的文档提交到比特币开发邮件列表,所有订阅了该邮件列表的人都能接收到你的提案。

在社区中将 BIP 草案公开,对完整提案再次进行讨论。此时你需要针对这个 BIP 草案再次在社区进行公开讨论。上次进行的公开讨论仅仅是一个想法,本次是针对完整的提案进行讨论。

对 BIP 草案进行再次修订,发送给编辑。尝试引导社区成员成为你的 BIP 的拥护者并积极听取社区成员的意见,然后对你的 BIP 进行再次修订。当你感觉准备好了,就可以把你的 BIP 发送给 BIP 编辑了。当前的 BIP 编辑是 Luke Dashjr,可以通过 luke_bipeditor@dashjr.org 联系到他。

BIP 编辑的职能

当 BIP 编辑收到新的 BIP 草案之后,他会执行以下操作:

  • 检查 BIP 整体是否准备就绪。已经准备就绪的 BIP 有两个特性:完整与健全。就是说草案的内容是完整的满足规范的且没有漏洞、经得起推敲的。
  • 检查标题是否准确描述了内容
  • 检查是否有事前发到比特币开发邮件列表进行公开讨论
  • 检查动机是否有被完整描述、向后兼容性是否有被解决
  • 检查是否按照规范正确分配序言中的 Layer 标签
  • 检查许可证是否在规定范围内

如果 BIP 编辑认为你的 BIP 还没有准备好,会说明原因并发回给你,你针对 BIP 编辑给的说明重新编辑修订后,再次发送即可。

经过完善后,你可以拉取请求提交到 BIPs git 仓库中。收到拉取请求后,BIP 编辑将会进行以下操作:

  • 给你的 BIP 分配一个 BIP 编号,这样你的 BIP 算是正式诞生了!
  • 标记你的 BIP 类型(标准跟踪、信息性、流程)
  • 合并你的拉取请求,此时 BIP 就加入了 BIP 仓库
  • 在 README.mediawiki 中列出你的 BIP,大家都能方便查看动态

到此为止,你的 BIP 会再次公开,从而得到进一步的社区反馈。

本文由 零点财经 作者:tao 发表,其版权均为 零点财经 所有,文章内容系作者个人观点,不代表 零点财经 对观点赞同或支持。如需转载,请注明文章来源。
分享生成图片
37

发表回复

零点课堂 | 比特币改进提案的运作流程(2)

2021-06-21 10:12:27

一个合格的 BIP 草案还需要注意格式

序言格式需要注意:

  • BIP: //BIP 编号,如果是草案阶段就填写「?」
  • * Layer: // 记录 BIP 作用于哪个层级,在 BIP123 有不同层级的定义
  • Title: //BIP 的标题,最多是 44 个字符
  • Author: // 作者的名字与电子邮件地址
  • * Discussions-To: // 讨论 BIP 的邮件列表地址
  • * Comments-Summary: //BIP 得到的评论的总结
  • Comments-URI: // 查看 BIP 评论的 wiki 地址
  • Status:
  • Withdrawn | Final | Replaced | Obsolete> // 标明当前的 BIP 处于什么状态
  • Type: // 标明 BIP 所属类型
  • Created: //BIP 被分配标号的日期
  • License: // 使用的许可证书
  • * License-Code: // 许可码
  • * Post-History: // 发布的时间(发布到比特币邮件列表)
  • * Requires: // 所依赖的 BIP 编号
  • * Replaces: // 代替了的 BIP 编号
  • * Superseded-By: // 被哪个 BIP 所替代了

除带 *号的内容其他都是必需的

BIP 的附件格式需要注意。BIP 可能包括图表等附件,附件应包含在该 BIP 的子目录中,且必须命名为 BIP-XXXX-Y.ext,其中「 XXXX」是 BIP 编号,「 Y」是序列号(从 1 开始),「 ext」被实际的文件扩展名替换(例如「 png」 」)。

BIP 的审核流程

BIP 草案撰写完毕后,就需要将完整的文档提交到比特币开发邮件列表,所有订阅了该邮件列表的人都能接收到你的提案。

在社区中将 BIP 草案公开,对完整提案再次进行讨论。此时你需要针对这个 BIP 草案再次在社区进行公开讨论。上次进行的公开讨论仅仅是一个想法,本次是针对完整的提案进行讨论。

对 BIP 草案进行再次修订,发送给编辑。尝试引导社区成员成为你的 BIP 的拥护者并积极听取社区成员的意见,然后对你的 BIP 进行再次修订。当你感觉准备好了,就可以把你的 BIP 发送给 BIP 编辑了。当前的 BIP 编辑是 Luke Dashjr,可以通过 luke_bipeditor@dashjr.org 联系到他。

BIP 编辑的职能

当 BIP 编辑收到新的 BIP 草案之后,他会执行以下操作:

  • 检查 BIP 整体是否准备就绪。已经准备就绪的 BIP 有两个特性:完整与健全。就是说草案的内容是完整的满足规范的且没有漏洞、经得起推敲的。
  • 检查标题是否准确描述了内容
  • 检查是否有事前发到比特币开发邮件列表进行公开讨论
  • 检查动机是否有被完整描述、向后兼容性是否有被解决
  • 检查是否按照规范正确分配序言中的 Layer 标签
  • 检查许可证是否在规定范围内

如果 BIP 编辑认为你的 BIP 还没有准备好,会说明原因并发回给你,你针对 BIP 编辑给的说明重新编辑修订后,再次发送即可。

经过完善后,你可以拉取请求提交到 BIPs git 仓库中。收到拉取请求后,BIP 编辑将会进行以下操作:

  • 给你的 BIP 分配一个 BIP 编号,这样你的 BIP 算是正式诞生了!
  • 标记你的 BIP 类型(标准跟踪、信息性、流程)
  • 合并你的拉取请求,此时 BIP 就加入了 BIP 仓库
  • 在 README.mediawiki 中列出你的 BIP,大家都能方便查看动态

到此为止,你的 BIP 会再次公开,从而得到进一步的社区反馈。