README.md 3.5 KB
Newer Older
N
NEEN 已提交
1
# SIG管理章程
2
## 背景
N
NEEN 已提交
3
SIG(Special Interest Group)是指特别兴趣小组,SIG在PMC项目管理委员会指导下,负责OpenHarmony社区特定子领域及创新项目的架构设计、开源开发及项目维护等工作。
N
NEEN 已提交
4
本目录用于存放OpenHamony社区所有 “特别兴趣小组”(Special Interest Group,以下简称 SIG)的运作信息。
5

6
## 申请新建SIG
L
liuguo 已提交
7
1. 开发者在社区中寻找2-3个有共同兴趣及目标的人,确定SIG Leader。参考[新建SIG Charter](sig-template/sig-charter-template_cn.md)模板,创建SIG Charter提案。
8
2. SIG Leader以[SIG-Charter-Proposal-XXX]为邮件标题,需先订阅[dev@openharmony.io](https://lists.openatom.io/postorius/lists/dev.openharmony.io/),然后向dev@openharmony.io发送邮件,提交新建SIG申请。
9
3. PMC项目管理委员会批准通过后,可创建新的SIG。
10

11
## 加入已有SIG
N
NEEN 已提交
12
开发者可通过SIG列表查看感兴趣的SIG,通过订阅邮件列表、参与SIG会议等形式,参与对应SIG项目的技术讨论、社区维护及开源开发。
13 14

## 运营维护SIG
N
NEEN 已提交
15
1. SIG Leader Fork OpenHamony/community分支,在SIG文件夹下,以新SIG名称新建文件夹,并参考[SIG模板](sig-template/),创建对应的SIG配置文件,提交PR合入申请。
16 17 18 19 20 21 22 23
2. SIG孵化子项目,统一存放在[OpenHarmony SIG组织](https://gitee.com/openharmony-sig),待孵化成熟后,可合入OpenHarmony组织代码主库。
3. SIG Leader及Committer负责对应SIG的运营及维护。
4. SIG Leader定期在PMC项目管理委员会汇报SIG孵化项目及SIG运营进展,PMC基于SIG运作情况给出指导建议。

## SIG孵化项目毕业
1. SIG孵化项目成熟并满足项目毕业要求后,可申请合入OpenHarmony组织代码主库。
2. SIG Leader通过向dev@openharmony.io发送邮件,提交孵化项目毕业申请。
3. PMC项目管理委员会通过项目毕业申请后,社区接纳孵化项目合入OpenHarmony主干。
24

N
NEEN 已提交
25 26 27 28 29 30 31 32
## SIG数据存放和管理方式
SIG信息记录统一归档在OpenHamony/community仓库的sig目录内:
- sig_xxx.md/sig_xxx_cn.md:包括SIG组工作目标和范围、SIG管理的repository及描述、SIG组织会议、SIG成员。
- sigs.json:为了便于工具自动提取,其中SIG的maintainer/committer信息单独备份一份至OWNER文件内,每个SIG所维护的仓库名称列表/目录结构位于sigs.json文件中。
  1. OpenHarmony/community仓的sig目录下存在一个sigs.json文件,这个文件中管理从PMC看到的所有SIG的信息。
  2. sigs 由 PMC 修改和维护,新sig申请由对应的 maintainer 提交PR,经过PMC审视后合入。
  3. sig 独立目录下的sig_xxx_cn.md/sig_xxx.md 为 sig 的信息展示区。其中SIG基本信息需按模板留空,新建SIG时填写完整。
  4. sig 独立目录下的OWNER存放相应sig的maintainer。
33 34


N
NEEN 已提交
35
###  sigs.json 文件格式
36 37 38
| 字段 | 说明 |
|:---|:---|
|  sig-name | SIG名称 |
39
|  projects| gitee仓名 |
N
NEEN 已提交
40
|  project-path | OpenHarmony下的归档路径,若不涉及回合OpenHarmony填写NONE |
41

N
NEEN 已提交
42
### sigs.json 样例
43
```
44 45 46 47 48 49 50 51 52 53 54 55 56
"sigs-List":[
      {
         "sig-name":"sig-docs",
         "projects":"https://gitee.com/openharmony-sig/docs",
         "project-path":"docs/"
      },
      {
         "sig-name ":"sig-updates",
         "projects":["https://gitee.com/openharmony/startup_appspawn_lite", "https://gitee.com/openharmony/startup_bootstrap_lite"]
         "project-path":["base/startup/appspawn_lite", "base/startup/bootstrap_lite"]
      },
   ]
}
57
```