YIP: 0001
Title: YOYOW Improvement Proposals YOYOW治理与发展提案
Authors: vianull <vianull@yoyow.org>
Status: Draft
Type: Informational 信息类
Created: 2020-02-19
为促进YOYOW区块链不断迭代升级,生态不断壮大,规范和统一社区对YOYOW改进协议的提案文本的格式,提交,审议和公示的流程,YOYOW理事会发布了YOYOW治理与发展提案(YOYOW Improvement Proposals)规范的第一个版本。
YOYOW 治理与发展提案(YOYOW Improvement Proposals,以下简称YIP)是由社区发起讨论的议题在取得社区共识后的正式版本,YIP通常由议题相关人员撰写,提交编辑审查后公示。
YIP作为记录YOYOW设计决策、收集社区意见、提议新功能的主要机制,对YOYOW整个生态的健康发展发挥重要作用。
以下为YIP规范的详细规范:
目前YOYOW理事会提议的YIP存在两种类型:
社区规范类:社区规范类YIP主要用以发布经由社区内部投票达成共识的社区治理规范,如:社区的共识决议、理事会参数、系统的发展方向等。这类YIP可以是全新的社区决策,也可以是对以往YIP的修订。所有社区规范类YIP必须经过社区内部投票达成共识后才能提交公示。
信息类:信息类YIP 描述 YOYOW 的设计思想与理念,或向社区提供一般性的指南与信息。 信息类的YIP 不一定代表YOYOW社区的共识或建议,需要用户自行甄别。信息类YIP发布不需要经过社区投票,但是依然需要在社区内部先行公示,以确保社区内部人员对发布的正式公告无疑义。
所有YIP提交首先需要在issue正式提出问题及解决方案,并在YOYOW链上发起对该YIP的投票。当投票获得初步共识之后,可以撰写正式的YIP文档提交版。
YIP提交版需要向本git发起Pull request, 并同时通过邮件联系当前YIP编辑(们),经编辑确认YIP格式、描述和合规性均无误的情况下,编辑将该YIP收录入本git中。
YIP之间可以存在关联,当新的YIP影响到其他YIP时,应当在旧YIP中标注修改并规范引用关联版本。
除信息类YIP外,所有YIP均存在10天公示期(暂定),在公示期间任何社区用户都有权讨论该YIP、并鼓励提出有建设性的改进意见;在公示阶段所有人均可以在本git的issue区留言,从而对此YIP提出改进意见,该意见经社区投票后可提交为该YIP的修改版。仅列出观点而无改进意见的留言将会被视作无效信息直接关闭。
有价值的改进意见将会被标注为正在讨论,编辑将会在论坛开启此意见的讨论帖,并附上投票选项,如果投票通过,受影响的相关YIP将会会被修改;在公示期结束后提出的建设性修改经社区投票后可提交为新的关联YIP。
除信息类YIP外,原则上所有YIP公示期过后将不再修改,新的修改意见建议开启一项新YIP。
信息类YIP无公示期上限。
-
YIP均需包含文件头,简介,版权,正文四项。
-
文件头应包含编辑给予的YIP编号、YIP名称、作者(含正式联系方式)、YIP类型、状态、创建日期、历史版本修改日期、当前版本日期、受影响的相关YIP。
-
简介需要在200字以内简单介绍本YIP解决的问题、问题的意义和解决方式。
-
版权需要在文末标注,本YIP遵循与YOYOW项目相同的开源协议。
-
正文需要分段落描述YIP需要解决的问题,并给出切实可行的方案。
当前YIP编辑是 vianull。
YIP编辑没有权利决定YIP是否可以通过、是否应当继续公示,仅仅可以对YIP提交过程中的规范性和文字描述提出异议,要求作者做出修改。
场景:普通用户A希望改区块链参数
流程:
-
论坛发帖 或群内讨论,形成初步方案,引起一定反响。
-
由理事会发起社区投票,达成共识
-
投票通过后,用户A完成YIP草稿 ,提交编辑评估
-
编辑评估通过,YIP正式进入10天公示期
-
公示期后理事会成员推动用合适方式完成链上参数修改。
-
编辑标注YIP已生效