小白的使命是以大众的医疗健康数据造福大众,是一个基于"众"的形式进行建立并运行的社区。 为此我们决定探索一种全新的基于奖励的社区组织模式来推动达成目标。小白是一个采用众和方式推动的青色组织。
众和的核心思想是:
以尊重和信任为基础,自主参与为形式,公正奖励为机制,以实现高效、可持续、可预期的商业目标的众人和合形式。
- 尊重、信任;
- 愿以悲悯之心为公众的健康做贡献
- 严格的执行标准;
- 协作和为协作提供便利;
- 当你没有时间时,请告诉大家;
- 保障信息的安全;
- 个人,不得是组织、团队;
- 认同小白众和的理念和价值观;
发邮件到:[email protected],格式:
题目:申请成为小白众和社区贡献者
内容:
个人简介:说明技术相关特长,并希望进行的贡献(前端、后端、产品、项目管理等等)
说明:
- 收到申请后社区会视情况安排进行icp流程认证,见《贡献者认证流程》,在通过认证后成为认证贡献者。
- 建议你仔细阅读 https://github.com/sibbay-ai/public 下的issue(包括close的issue)
- 建议你观摩小白社区的早会,地址是:https://zoom.us/j/9552592803 ,以了解团队的工作方式
作为小白健康的认证贡献者,原则上你可以申请任何有益于小白的贡献内容,可以是已经提出的icp issue,也可以由自己提出。同时认证贡献者每月应该完成一定的贡献size。
说明:
- “自己找”是你贡献的主要方式
- 由committer安排的任务
- 参与讨论和会议可以快速了解项目的现状和方向
- 小白社区会在法定工作日的每早9点进行早会,地址是:https://zoom.us/j/9552592803 欢迎你随时参加
有三种角色:
- Contributor:是指参与开发的同学
- Committer:项目或者模块的管理者,对质量和进度负责
- Maintainer:是社区的组织者和协调者,并有权对icp执行过程进行纠正
说明:
- contributer对应的committer可以有一个或多个
- 在不同的repo中,contributer对应的committer可以不同
- 在同一个repo中可以同时是contributer和committer
为了实现社区的目标设计了icp操作方式
icp(issue、commit/comment、pr)机制的核心原则是:
凡没有在 issue 中记录的,都没有发生。
一切有价值的贡献均应有对应提交物(可以是代码、设计、文档等等),并以此为衡量工作量的唯一依据;
说明:
- 提交物可以是pr中内容,也可以在issue中包含并说明,只要EI的reviewer看得清楚即可
issue的size是否合理由社区成员进行投票评价
操作流程下图:
图中的小人图表说明contributor、Committer的操作权限。
社区建议并鼓励贡献者在做任何事情时均以创建issue为开始,并@给相关committer或者contributor。
只有committer才能确定某个issue应该进入开发流程,并打上 icp 的 label 作为标记。
contributor或committer均可自由申请icp任务的开发,在icp issue的comment中提交下面的文字:
申请开发 deadline:yyyy-mm-dd [size:xx] [@xxx] [文字]
注意点:
- 请严格按照这个格式填写,否则可能会无法计入统计;
- deadline是以引用pr merge的日期为准,所以建议留有一定余量进行review及修改;
- size可以在这确定,也可以后面单独申请;
- 一般不建议一个issue的size太大,如果本来工作量就很大那么建议拆分为多个issue;
- @给committer
- 申请开发comment提交的时间就是starttime
committer在确定接受contributor的申请后,将assigness指定为该contributor,并打上size的标签。并表示该issue的任务进入开发流程。 注意:
- 一个issue只能指定一个assigness
issue在执行过程中,在规定允许范围内contributer可向committer中提出变更申请,并由committer同意后:
- deadline变更:由committer在一个独立的comment中写
变更 deadline:yyyy-mm-dd [@xx] 变更原因
- size变更:由committer删除原来的size label后打上新的label
在pr中应该引用已经完成的issue,引用方式:在pr的正文或comment中撰写如下文字:
fix|for:issue-url [文字]
注意:
- 每一行写一个issue
不是所有的pr的merge都表示对提交物的认可,考虑到有些merge的目的是为了使得代码以进行测试,所以社区规定只有committer才有权利打上icp label,也只有打上icp label的pr才是有效pr。
pr的assigness由committer进行指定,并且merge只能由assigness进行操作。 说明:
- 一个pr只能指定一个assigness
committer可以在pr打上size的label,以表示assigness的merge工作(一般是指review)的size。
任何pr都必须由非提交者进行review。 说明:
- reviewer可以由contributer或committer更需要进行指定
- pr的size可以用于表示review的size
- review工作量很大的情况下,可以创建专门的review issue并在该pr中引用(同3.6)
- 理论上社区认为review耗费的size越大,提交的成果质量则越差
假设贡献者为需求方,其愿意为实现提交物而支付的发包金额。 单位:1 size=500rmb 说明:
- 不考虑执行的中间过程,size仅仅只与提交物有关系;
- 发包:就是通过众包平台发包的
- 一般建议不要提交size很大的issue,如果任务工作量较多则建议拆分;
由contributer或committer提出,经协商同意后,由committer打上size label。
如果实际工作量与预估要较大的出入,contributer可根据实际情况向committer提出size变更:
变更申请需写明原因和size调整的数量,并经committer确认。
deadline一经确认,原则上不能变更,应该在期限内完成。
当出现下面情况时,contributer可以提出变更申请:
- 出现较大的技术障碍
- 协作关联方出现严重阻塞,且不可能独立解决
- 出现不可抗力的原因 变更申请需写明原因和新的deadline,并经committer确认。
ti = (deadline-starttime)/(mergetime-starttime)<=1?1:(0.7*(deadline-starttime)/(mergetime-starttime))
说明:
- starttime是以提出申请的comment的时间为准,如果contributer认为committer的确认回复太晚会影响deadline的完成,应该马上申请修改deadline。
- mergetime表示pr被merge的时间
- deadline是指定日期的24:00
- ti的计算精度是hour
推动社区有序 小白有三个评价指数:贡献指数(CI),效率指数(EI)和效率分数(ES) 具体指数小白会每月进行一次更新,并公开发布。
是 contributor 和 committer 的在单位size贡献效率的评估,该指标核心由所有contributer投票产生,是一个仅仅具有比较意义的指标。 说明:
- 由系统以本月所有的icp issue为基础,生成issue对比pair
- 由系统将这些issue pair分配给本月的贡献者,进行比较确定其中效率更高者,则该issue获得1*size的EI点
- 如果在规定时间内未提交评判结果,则reviewer会被扣除 1*(size1+size2) 的ES点,并公开reviewer
- 每月19日00:00公布ES表在:icp.sibbay.ai
- 每月17日00:00-每月19日00:00 为评价时间
说明:
- 贡献指数(CI) 每月统计一次并公布在:icp.sibbay.ai
- 贡献指数(CI) 是未来小白进行 IPO 或者 ICO 时给予奖励的唯一指标;
计算方法:
只有每月 EI >= 1 的贡献者,才统计其贡献指数(CI)
当某月某贡献者 EI < 1 时,其当月 CI 为 0
当某月某贡献者 EI >= 1 时,其 CI 计算方式如下:
- 逐个判断该贡献者当月的所有 ICP issue
- 当 ICP issue 满足以下两个条件时:
- 该 issue 没有更改过 deadline
- 该 issue 在 EI 投票环节至少得到 1 票 将该 ICP issue 的 size 累加到 CI
- 若不满足上述条件,则不累加该 ICP issue 的 size
效率指数(Efficiency Index) 指的是 当月该贡献者的 效率分数(ES) 除以 当月该贡献者的 icp size 说明:
- 每月19日00:00公布EI表在:icp.sibbay.ai
- 每月17日00:00-每月19日00:00 为评价时间
社区给会以有效的issue和有效pr的size为依据进行size奖励,并根据任务完成和用户使用(挖矿)的情况进行贡献奖励。
sum(size*500*ti)
- 统计时间 上个月16日00:00-本月16日00:00时间段进行pr merge的pr和引用issue -社区所有的icp issue和pr的具体情况均在 icp.sibbay.ai 中有详细的显示。
所有贡献者可选择接受奖励的方式:
- 现金形式
每月 15 日统计已经 merge 的 pr
现金通过众包平台发放(可以自行选择),税费自负。 - token 贡献者也可选择代表贡献奖励的token,兑换比例以www.sibbay.ai网上公布的赎回价格为准。
- 本月EI>=0.8的贡献者有权利参与本月贡献奖励的分配。
- 每个月由社区根据任务完成和用户使用(挖矿)的情况确定token奖励的总数T;
- 每个人分配的数量:以个人CI*贡献者级别指数在本月总CI的比例乘以T
- 发放方式:三分一是立即可兑现token、三分之一为一年锁定期token和三分之一为二年锁定期token;
上个月16日00:00-本月16日00:00时间段进行pr merge的pr和引用issue -社区所有的icp issue和pr的具体情况均在 icp.sibbay.ai 中有详细的显示。 说明:
- 每个贡献者应将个人的详细信息提供给社区
- 在相关的平台上登记相应的账号
每个月20日发放,如遇节假日顺延。
- 10.1.1、连续第二个月EI小于0.8(不包含),则该贡献者仅发放当月size奖励的50%;
- 10.1.2、连续第二个月EI小于0.4(不包含),则对其主管committer处以该贡献者当月size金额的处罚;
- 10.2.1、申诉
申诉是贡献者的权利 A、条件:在连续二、三、四个月的EI小于0.8后的20自然天内可以在public上提交申诉issue(原因是不支持远期申诉)
B、@committer和人事
C、简单陈述原因,原则上不超过5条 - 10.2.2、复核程序
对所有涉及的issue评价对进行加倍评审:
A、对每个issue pair同时交个两个人进行评价
B、issue pair的复核人员不得与原评价人员相同
C、安排在下一个贡献发放的评审流程中进行 D、每复核一个issue pair将获得50SHT的奖励(一个issue会有4次) E、如复核人员未按时提交复核则扣除复核人员单月的EI(同8.2的规定),由committer代为复核 - 10.2.3、复核结果及处理
根据复核结果计算的size奖励比原来有增加,则认为申诉成功。 复核结果是最终结果,并根据申诉决策的对称性原则,其处理规则如下:
A、申诉成功:
*根据复核结果进行重新计算,由社区补发差额部分size奖励 *根据复核结果进行重新计算,由社区补发差额部分token奖励(按照已发放的当月CI分配比例计算)
*且以后的0.8连续性也以复核结果为准
*复核工作SHT由社区支付(以防止复核人员的利益倾向性)
*提交复核结果与原投票结果进行误差分析,人事可根据情况对误差过大的原评审者提起质询
B、申诉失败:
*对申诉者第一个EI小于0.8月份的size奖励追索扣除50%(这个月的size贡献没有扣除过) *申诉者承担复核工作SHT *半年内不得再提起申诉
社区要求每个贡献者均要遵循前社区的六条价值观,一旦出现一下行为:
- 坚决杜绝EI窜投行为,小白视为最恶劣之行径,一经发现以直接冻结SHT账户
- 没有时间时,未能及时告知社区
- 违反小白的版权管理规定
- 数据保密规定
- 虚报工作量
- 删除他人的issue留言
- 以及一切违反小白价值观的行为
一经证实,小白有权停止其贡献资格,并减少甚至取消其 CI 值。
采取 MGM(Meritocratic Governance Model) 采取 apache 的精英治理模型,细则另定。
我们的产品:
文档名称 | 文档链接 |
---|---|
icp概念解释视频 | icp概念解释-刘宇 |
icp操作解释视频 | icp操作解释-李飞 |
icp FAQ | ICP入门FAQ文档链接 |
贡献者认证流程 | 贡献者认证流程文档链接 |
ICP标准流程图 | ICP标准流程图文档链接 |
pull request规范 | pull request规范文档链接 |
里程碑规范 | 里程碑规范文档链接 |
Github网页版操作步骤 | Github网页版操作步骤文档链接 |