目录
wbavon

docs(incubator): adopt ‘contribution’ terminology; refine proposal template (#67)

  • docs(incubator): adopt ‘contribution’ terminology; refine proposal template

Rename donation/donor to contribution/contributing organization across all English content, following the terminology used by peer foundations (CNCF’s legal instrument is the Contribution Agreement; Apache’s is the Software Grant). ‘Contribution’ also matches our legal reality: the default SGA model is license-not-assignment, so the contributing organization keeps copyright — nothing is ‘donated’ in the property-transfer sense. Chinese text keeps 捐赠, which carries no such weight in domestic usage (consistent with OpenAtom).

Renames: Donation Proposal -> Contribution Proposal; Donor -> contributing organization; Donation scope -> Contribution scope; Quick Start for Donors -> Quick Start for Contributing Projects; Donation & Formal Acceptance Process -> Contribution & Formal Acceptance Process. The SGA (Software Grant Agreement) name is unchanged — ‘grant’ is the neutral legal term of art.

Also fold in four template refinements from comparing against the Apache Incubator podling proposal template:

  • Project Description now asks for a single-sentence summary first, reusable in the acceptance announcement and project list
  • New ‘Developer independence’ field: salaried-vs-independent developer ratio and the organization’s commitment if priorities shift (addresses the salaried-developer risk; feeds the reduced-single-party-dependence graduation dimension)
  • Known risks now explicitly lists cryptographic functionality, so export-compliance surfaces at proposal time instead of during IP clearance
  • Template note: write N/A where a field does not apply
  • docs(incubator): contributing party as umbrella term; scope project contribution

Address review findings on the terminology rename:

  1. ‘contributing organization’ silently excluded individual contributors from operative texts (COI recusal, SGA representations, checklist, runbooks, trademark return). Replace with the defined umbrella term ‘contributing party’ (organization or individual); ‘contributing organization’ remains only in organization-specific rules. COI recusal now also covers a TSC member who is the individual contributing party. The developer-independence prompt is conditioned on an organizational contributing party (N/A for individuals).
  2. Bare ‘contribution matter/acceptance/process’ could be read as covering ordinary code contributions. Add a Terminology note to both READMEs defining ‘project contribution’ vs day-to-day contributions, and use ‘project contribution …’ phrasing in governance-sensitive passages.
  3. Quick Start heading: ‘Quick Start: Contribute a Project’.
  4. Acceptance runbook account wording: alliance service account as owner; retain/downgrade/remove existing organization and individual accounts per the approved migration plan.
  • docs(incubator): cover individual contributing parties in three residual spots
  • ip-checklist: SGA signed by the contributing party (by its authorized signatory where the party is a legal entity) — an individual signs directly and has no separate legal entity
  • mentor-guide (EN/CN): the contributing party does not mentor its own project; for organizational parties, members of the organization or its affiliates do not serve — mirrors the COI rule and closes the self-mentoring gap for individuals
  • README (EN/CN) graduation dimension 6: maintainership and critical project knowledge not concentrated in a single individual or organization — covers individually contributed projects and the single-maintainer bus factor generally
  • docs(incubator): sync acceptance-runbook_CN account-migration wording

The Chinese runbook still prescribed downgrading/removing personal accounts by default, omitting existing organization accounts and the approved migration plan as the controlling basis. Align with the English rule: add the alliance service account as owner; retain, downgrade, or remove existing organization and individual accounts per the approved migration plan.

1天前103次提交

FlagOS 社区

FlagOS 2.1 FlagOS 2.2 版本追踪

语言 | Language

中文 | English


欢迎来到 FlagOS 社区 👋

FlagOS 是一个统一的、开源的 AI 系统软件栈,专为多芯片场景设计。本社区仓库是以下工作的中心枢纽:

  • 🤝 为 FlagOS 项目贡献代码
  • 💬 社区讨论和协作
  • 📚 分享知识和最佳实践
  • 🎯 参与 FlagOS 生态

🧭 按角色找路

初来乍到?从你的角色出发——每一行都是从”我想做什么”到”该去哪”的最短路径。

我想… 角色 从这里开始
提交新特性(跨模块、新芯片、新仓库) 特性开发者 / FEP Owner FEP 流程编写指引 → 注意 2.2 FEP 冻结:2026-08-14
让我的芯片接入 FlagOS 芯片厂商 芯片厂商指南 → 范例 FEP-0033(SpacemiT)
修 bug / 提小 PR 代码贡献者 CONTRIBUTING.md → 目标仓库自己的 CONTRIBUTING.md
评审 FEP SIG Approver / TSC 评审指南FEP Tracker 看板
参与版本测试 测试者 / QA 2.2 时间表追踪 issue #47(测试矩阵在 FEP 冻结日汇编)
了解版本进度 Release Manager / 任何人 🚩 版本追踪 · milestone/2
加入或创建 SIG 新成员 / 组织 sigs/角色定义
了解治理机制 所有人 GOVERNANCE.md · MAINTAINERS.md

全局一张图

FlagOS 的开发同时跑在三条轨道上——FEP 的设计状态版本周期、以及各角色何时行动:

flowchart LR
    subgraph Design["FEP 状态(设计轨道)"]
        P[Provisional] --> IA[Implementable] --> IM[Implemented]
    end
    subgraph Cycle["版本周期(每个版本循环一次)"]
        S[提交与评审] --> FF[FEP 冻结] --> CF[代码冻结] --> T[测试期] --> R[发布]
    end
    P -.作者撰写.-> S
    IA -.冻结前须批准.-> FF
    CF -.实现合入各模块仓库.-> T
    IM -.发布时验收达成.-> R

    OW([FEP Owner]):::role -.负责.-> P
    AP([SIG Approver / TSC]):::role -.批准.-> IA
    RM([Release Manager]):::role -.把关与追踪.-> FF
    QA([测试者]):::role -.验证.-> T
    classDef role fill:#eef,stroke:#88a
  • FEP Owner:推动提案从 Provisional 走到 Implemented,并申报 Target Version
  • SIG Approver / TSC:评审设计,批准至 Implementable(要求 Test Plan 完整)。
  • Release Manager:执行冻结日期,通过 milestone 追踪进度。
  • 测试者:在测试期依据各 FEP 的 Test Plan 验证已合入的功能。

完整规则:FEP 生命周期。当前周期的具体日期见:release/2.2/schedule_CN.md

社区导航

上面的角色路由是快捷路径,下表是完整的目录索引。

入口 说明
GOVERNANCE_CN.md 社区治理规则与决策机制
MAINTAINERS.md TSC + SIG Chair 名单
sigs/ SIG — 所有 SIG 列表、章程、创建流程、OWNERS 规范、会议日历
contributors/ 贡献者指南、角色定义、FEP 编写指引
fep/ FEP 流程与模板
release/ 版本发布管理流程与各版本时间表
wg/ 孵化工作组
CONTRIBUTING.md 贡献者快速导航

目录

关于 FlagOS 社区

FlagOS 由十多家国内外组织联合建立,包括芯片公司、系统制造商、算法和软件实体、非营利组织和研究机构。FlagOS 社区的目标是:

  • 打破生态壁垒 - 消除不同芯片软件栈之间的障碍
  • 降低迁移成本 - 帮助开发者轻松切换芯片平台
  • 促进创新 - 推动 AI 系统软件的发展
  • 构建包容生态 - 欢迎所有贡献者参与
  • 分享知识 - 推广最佳实践和经验

FlagOS 项目包含多个专业化的代码仓库:

  • FlagGems - 高性能通用 AI 算子库
  • FlagTree - 统一 AI 编译器
  • FlagScale - 统一并行训练推理框架
  • FlagCX - 统一通信库
  • FlagPerf - 多芯片评测工具
  • 以及更多项目…

如何贡献

我们欢迎所有人的贡献!参与的方式有很多:

💻 代码贡献

通过贡献代码、修复 bug 和实现新功能来改进 FlagOS。详见贡献指南

  • 如何提交 Pull Request
  • 代码规范和格式
  • 运行测试
  • 代码审查流程

📖 文档贡献

改进和完善文档、示例、教程和翻译。您的贡献有助于让更多开发者了解 FlagOS。

🐛 Bug 报告和功能建议

报告您发现的问题或提出改进建议:

  • Bug 报告 - 通过详细的复现步骤帮助我们修复问题
  • 功能请求 - 分享您对改进 FlagOS 的想法
  • 详见贡献指南中的模板和指南

🤝 社区支持

加入讨论并帮助其他贡献者:

  • 在交流渠道中回答问题
  • 审查 Pull Request 并提供反馈
  • 分享知识和最佳实践
  • 指导新贡献者

🏛️ 加入或创建 SIG

SIG(特别兴趣小组)是技术工作的核心组织。每个 SIG 覆盖一个特定技术领域——算子、编译器、通信、训练等。

  • 浏览现有 SIG 找到你感兴趣的方向,参加例会
  • 创建新 SIG — 需 ≥1 名 Chair、≥1 名 Tech Lead、≥3 名初始成员、Charter 草案。向 TSC 提交 PR 即可发起

交流渠道

与 FlagOS 社区保持联系和互动:

渠道 目的 联系方式
📧 邮箱 一般咨询和沟通 contact@flagos.io
📱 微信公众号 更新和新闻 智源FlagOpen
📺 微信视频号 视频更新和公告 智源FlagOpen
💬 GitHub Discussions 技术讨论和问答 flagos-ai/community/discussions
📋 邮件列表 公告和社区更新 [即将推出]

行为准则

我们致力于为所有社区成员提供热情和包容的环境。所有参与者都应遵守我们的行为准则:

通过参与本社区,您同意遵守这些标准,并帮助我们维持一个尊重和高效的环境。

社区资源

获取帮助

我是 FlagOS 的新手。从哪里开始?

  1. 阅读本 README 了解项目
  2. 查看 FlagOS Wiki 获取详细文档
  3. 阅读贡献指南了解如何参与
  4. 在我们的任何交流渠道上联系我们

我想贡献代码。应该怎么做?

  1. 找到与您的贡献相关的 FlagOS 仓库
  2. 阅读该仓库特定的 CONTRIBUTING.md 文件
  3. 查看社区贡献指南了解一般准则
  4. Fork 该仓库并按照贡献工作流操作
  5. 提交您的 Pull Request 接受审查

我发现了一个 bug 或有功能建议。如何报告?

  1. 检查现有问题以避免重复
  2. 创建新 issue,包括:
    • 问题/建议的清晰描述
    • 复现步骤(针对 bug)
    • 相关的环境信息
  3. 详见贡献指南中的详细报告指南

我想创建或加入 SIG

  1. 浏览 SIG 总览 查看现有 SIG,找到你感兴趣的方向
  2. 加入:参加 SIG 例会(日历见 sigs/)并做自我介绍
  3. 创建新 SIG:阅读 SIG 创建条件,然后提交 PR(含 Charter 草案 + 初始成员名单)。TSC 在 2 周内投票决定
  4. 查看 角色定义 了解 Chair / Tech Lead / Approver 等角色的职责

我有问题或想讨论某个话题

加入我们的任何交流渠道提问!我们有一个热心的社区随时准备帮助。

仓库结构

community/
├── README.md                    # 英文版本
├── README_CN.md                # 中文版本(本文件)
├── GOVERNANCE.md               # 治理规则与决策机制
├── MAINTAINERS.md              # TSC + SIG Chair 名单
├── CODE_OF_CONDUCT.md          # 社区行为准则(英文)
├── CODE_OF_CONDUCT_CN.md       # 社区行为准则(中文)
├── CONTRIBUTING.md             # 贡献者快速导航(英文)
├── CONTRIBUTING_CN.md          # 贡献者快速导航(中文)
├── LICENSE                     # Apache License 2.0
├── sigs/                       # SIG 章程、OWNERS、会议记录
├── fep/                        # FEP 流程、模板、评审指南
├── contributors/               # 贡献者指南(角色、环境搭建等)
├── release/                    # 发布管理流程与工具
└── wg/                         # 孵化工作组

许可证

本仓库采用 Apache License 2.0 许可。详见 LICENSE 文件。


感谢您! 💖

我们感谢所有的贡献,无论大小。无论您是报告 bug、提交功能建议、改进文档还是编写代码——每个贡献都在帮助 FlagOS 变得更好。

准备好加入我们了吗?贡献指南开始吧!


英文版本:English Version

关于

FlagOS community governance, developer contribution guide, contribution agreement, and community communication | 包含FlagOS社区治理、开发者贡献指南、开发者贡献协议、社区交流等内容

10.9 MB
邀请码
    Gitlink(确实开源)
  • 加入我们
  • 官网邮箱:gitlink@ccf.org.cn
  • QQ群
  • QQ群
  • 公众号
  • 公众号

版权所有:中国计算机学会技术支持:开源发展技术委员会
京ICP备13000930号-9 京公网安备 11010802047560号