diff --git "a/sig/RISCV_SIG/assets/\344\270\252\344\272\272\350\264\241\347\214\256.png" "b/sig/RISCV_SIG/assets/\344\270\252\344\272\272\350\264\241\347\214\256.png" new file mode 100644 index 0000000000000000000000000000000000000000..48c8705eb31d70ba7080e728594898c5541c2035 Binary files /dev/null and "b/sig/RISCV_SIG/assets/\344\270\252\344\272\272\350\264\241\347\214\256.png" differ diff --git "a/sig/RISCV_SIG/assets/\344\274\201\344\270\232\350\264\241\347\214\256.png" "b/sig/RISCV_SIG/assets/\344\274\201\344\270\232\350\264\241\347\214\256.png" new file mode 100644 index 0000000000000000000000000000000000000000..15db0ab352a01f11f765189d2d1a4735f02d0bfd Binary files /dev/null and "b/sig/RISCV_SIG/assets/\344\274\201\344\270\232\350\264\241\347\214\256.png" differ diff --git "a/sig/RISCV_SIG/content/\345\246\202\346\204\217\347\244\276\345\214\272\350\264\241\347\214\256\347\273\237\350\256\241\350\247\204\350\214\203.md" "b/sig/RISCV_SIG/content/\345\246\202\346\204\217\347\244\276\345\214\272\350\264\241\347\214\256\347\273\237\350\256\241\350\247\204\350\214\203.md" new file mode 100644 index 0000000000000000000000000000000000000000..2b0cf2ba41ac35657408bda1b094404b18bd5b32 --- /dev/null +++ "b/sig/RISCV_SIG/content/\345\246\202\346\204\217\347\244\276\345\214\272\350\264\241\347\214\256\347\273\237\350\256\241\350\247\204\350\214\203.md" @@ -0,0 +1,57 @@ +# 如意社区贡献统计规范 + +# 背景 + +为建立龙蜥社区与如意 RISC-V 社区长期稳定、协同发展的共建机制,本文档将从龙蜥社区发行版研发流程的交付维度,规范复用如意社区工作成果时的可追溯标识标准。 + +注意:1)本文档规范考虑重点放在发行版非内核软件包共建。内核软件包以及其他共建会有其它文档说明。2)龙蜥社区若进行补丁回合到如意 RISC-V 社区,可通过 commit author 等标识,该统计规范也不在该文档讨论范围。 + +# 协同共建方式 + +从共建协同角度看,有两种方式(注意,方式可能共存,不存在任选一的逻辑),方式一,如意 RISC-V 社区工程师加入龙蜥社区进行代码提交和构建模式;方式二,龙蜥社区工程师复用如意社区贡献维度看。 + +## 社区贡献看板标识 + +关于方式一,如意 RISC-V 社区工程师直接加入龙蜥社区并做的贡献,如 commit 提交,构建提交,镜像制作等,均可通过  commit author 标识和构建用户标识来方便统计。并展示在社区贡献看板([https://openanolis.cn/dashboard](https://openanolis.cn/dashboard))的企业贡献和个人贡献。企业贡献和个人贡献会定期反馈给如意社区,同时会考虑在政府汇报和社区会议上透出。 + +![image.png](../assets/企业贡献.png) + +![image.png](../assets/个人贡献.png) + +## Commit Message 标识 + +关于方式二,龙蜥社区工程师复用如意社区软件包或者补丁贡献维度,有如下集中情况: + +* 包引入:整体直接引入如意社区已经过构建验证的软件包; + +* 补丁引入 + + * 补丁直接引入; + + * 补丁适配后重新引入; + + +根据上述可能的共建方式,复用软件所成果的 commit 需要包含以下字段,确保代码来源清晰可追溯。 + + +- \[RUIYI-RV-REUSE\] 简短描述 + +- 详细描述:详细说明变更内容和复用情况 + +- Reference:原始代码来源URL + +- Reuse-Type:复用类型 (patch-adaptation/patch-directly-reuse/package-directly-reuse) +::: + +示例: +```plaintext +[RUIYI-RV-REUSE] add RISC-V vector extension support from xxx + +Reuse the vector extension implementation from xxx project +with modifications for Anolis optimizations. + +Reference: xxxxx +Reuse-Type: patch-adaptation +``` + +Commit Message 标识,后续龙蜥社区会采用统计体系,确保软件所贡献成果得到精准追踪,并最终也展示在社区贡献看板([https://openanolis.cn/dashboard](https://openanolis.cn/dashboard))的企业贡献。企业贡献会定期反馈给如意社区,同时会考虑在政府汇报和社区会议上透出。 \ No newline at end of file