org-info.yaml文件指导说明
简介
org-info.yaml 文件用于记录昇腾社区组织中各项目(如 MindIE)的管理配置和关键责任人信息。该文件位于组织目录下(例如:Ascend/community/MindIE/org-info.yaml)。
关键角色与权限
TC 成员 (Technical Committee Members)
- 对应字段: tc_members
- 权限范围:
- 负责维护和管理本组织的 org-info.yaml 文件。
- 角色说明: 由组织技术委员会成员担任。
SIG Maintainers (Special Interest Group Maintainers)
- 对应字段: sigs[].maintainers
- 权限范围:
- 负责管理其所属 SIG 的 sig-info.yaml 文件。
- 拥有该 SIG 名下所有仓库的一级(直接)Committer 权限。
- 角色说明: 由各 SIG 的核心维护者担任。
文件格式详解
org-info.yaml 是 YAML 格式文件,包含以下顶层字段:
| 字段 | 类型 | 层级 | 说明 |
|---|---|---|---|
| name | 字符串 | 一层 | 项目名称,如MindIE |
| description | 字符串 | 一层 | 项目描述信息 |
| tc_members | 列表 | 一层 | TC 成员列表 |
| sigs | 列表 | 一层 | 项目组内所有sig的信息清单 |
上述 tc_members 的每一条个人信息记录包含如下元素:
| 字段 | 类型 | 层级 | 说明 |
|---|---|---|---|
| gitcode_id | 字符串 | 二层 | GitCode ID, 必填 |
| name | 字符串 | 二层 | 姓名(或者网名), 可选 |
| 字符串 | 二层 | 个人邮箱地址, 可选 |
上述 sigs 的每一条个人信息记录包含如下元素:
| 字段 | 类型 | 层级 | 说明 |
|---|---|---|---|
| sig_name | 字符串 | 二层 | sig组的名称, 必填 |
| maintainers | 列表 | 二层 | 项目看护者成员清单 |
上述 maintainers 的每一条个人信息记录包含如下元素:
| 字段 | 类型 | 层级 | 说明 |
|---|---|---|---|
| gitcode_id | 字符串 | 三层 | GitCode ID, 必填 |
| name | 字符串 | 三层 | 姓名(或者网名), 可选 |
| 字符串 | 三层 | 个人邮箱地址, 可选 |
org-info.yaml 样例
# 组织/项目基本信息
name: MindIE # 组织/项目名称
description: 昇腾推理引擎,基于昇腾硬件的运行加速、调试调优、快速迁移部署的高性能深度学习推理框架,分层开放满足各类需求,统一接口使能极简开发,沉淀能力构筑极致性能 # 组织/项目描述
# TC 成员列表
tc_members:
- gitcode_id: aaa # GitCode ID (必填)
name: aaa # 姓名/网名 (可选)
email: aaa@company.com # 邮箱 (可选)
- gitcode_id: bbb
name: bbb
email: bbb@company.com
# SIG 列表
sigs:
# 第一个 SIG
- sig_name: MindIE-Service # SIG 名称 (必填)
maintainers: # 该 SIG 的 Maintainers
- gitcode_id: ccc
name: ccc
email: ccc@company.com
- gitcode_id: ddd
name: ddd
email: ddd@company.com
# 第二个 SIG
- sig_name: MindIE-SD
maintainers:
- gitcode_id: ccc # 同一个人可以在不同SIG担任Maintainer
name: ccc
email: ccc@company.com
- gitcode_id: ddd
name: ddd
email: ddd@company.com