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 字符串 二层 姓名(或者网名), 可选
email 字符串 二层 个人邮箱地址, 可选

上述 sigs 的每一条个人信息记录包含如下元素:

字段 类型 层级 说明
sig_name 字符串 二层 sig组的名称, 必填
maintainers 列表 二层 项目看护者成员清单

上述 maintainers 的每一条个人信息记录包含如下元素:

字段 类型 层级 说明
gitcode_id 字符串 三层 GitCode ID, 必填
name 字符串 三层 姓名(或者网名), 可选
email 字符串 三层 个人邮箱地址, 可选

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