> 译文仅供阅读便利。具有规范效力的是英文原文。 # 为元宇宙作贡献 感谢你来帮着建一份开放标准。各式各样的贡献 - 议题、评审、提案、示例、工具 - 都 欢迎。 ## 动手之前 1. 读一读[原则](00-foundation/Principles.md)与 [宪章](01-constitution/Meta-Universe-Constitution.md)。每一处改动都必须与这两者 保持一致。 2. 略览 [STATUS.md](STATUS.md) 与[治理](GOVERNANCE.md)模型。 ## 变更是怎样走的 一切变更都以**变更请求(CR)**的形式流经 [变更流程](01-constitution/Change-Process.md) - 也就是一个写明下列各项的 pull request: - **类型:** 编辑性 · 纠正性 · 演进性 · 破坏性(凡适用之处,再加上 [语义变更分类](01-constitution/Change-Process.md))。 - **涉及的需求编号**(取自 [REQUIREMENTS-INDEX.md](REQUIREMENTS-INDEX.md))。 - **对兼容性的影响**;若属破坏性变更,还要给出迁移指点。 针对规范性文档的 CR,由掌管它的机构(见 [GOVERNANCE.md](GOVERNANCE.md))评审,并 经一段公开评审期。 ## 撰写的规矩 - **只用英文。** 与周遭文字一样,保持 RFC / ISO 那种从容的语域。 - 用**标准文首**(随便看一份既有文档即可),小节标题一律用扁平的 `#`。 - RFC 2119 的关键词(`SHALL`/`SHOULD`/`MAY`)**只**在规范性文档里用。 - 让所有 JSON 都有效,所有示例都可由机器核验。 ## 开 PR 之前 用参考工具跑一遍本地检查(怎样调用,见 [`tools/`](tools/) 与 [`tests/`](tests/)): - **`mu-test`** - 语义测试套件必须通过。 - **`mu-requirements`** - 若你改动了规范性文字,重新生成 `REQUIREMENTS-INDEX.md`。 - **`mu-spec-index`** - 若你新增或改名了文档,重新生成 `spec-index.yaml`。 若你改动了某份模型,用 **`mu-fingerprint <文件>`** 确认它的指纹,并用 **`mu-validate <文件>`** 校验它。 ## Developer Certificate of Origin 提交贡献,即表示你确认这是你写的(或你有权提交),并且它可以在本项目的 [Apache-2.0](LICENSE) 许可之下分发,包括其中的专利授予。 ## 报告安全问题 对于漏洞,**不要**开公开的 issue。见 [SECURITY.md](SECURITY.md)。 ## 行为 一切参与都受[行为准则](CODE_OF_CONDUCT.md)管束。