title: 如何参与贡献 type: community has_chapter_content: false version: 2.1

如何参与贡献

Apache Weex 是一个活跃的开源项目,我们一直致力于简化贡献 Weex 生态的流程。开源社区的贡献方式包括但不限于可以报 bug,回答开源社区、邮件组中的问题, 参与讨论新 feature 的方案,纠正或者更改文档, 同时我们也很欢迎直接贡献代码来完善和丰富 Weex。

报 Bug

直接通过快速上手教程开始使用 Weex,如果在使用过程中遇到任何问题和不符合预期的现象,都可以通过写一个 bug 报告来反馈。

查找已知问题

目前我们使用 JIRA 来跟踪所有的 issue 和 feature,只要对已知问题有修复或者有新 feature 计划的时候,都会更新对应的 issue 或者 feature 状态。 在填写 issue 或者 feature 时候,可以翻阅下是否已经有对应的 issue 或者 feature 已经在跟踪中。

报告新 issue

打开 JIRA Issue ,点击最上方红色的 “Create” 按钮(如果还没有注册 JIRA 账号则需要先注册一下), Bug 报告指南 文档提供了一些关于 Bug 报告中最有用的信息的细节提示。你的 Bug 报告写得越好,我们就能越快地重现和修复它!

贡献代码

Weex 是一个开源的 Apache 社区项目,不管是核心团队或者外部开源社区的贡献者提交的 pull request 都需要通过同样的社区 code review 流程。 贡献代码可以通过修复已知的 bug 或者 开发新 feature,建议在贡献代码之前创建 JIRA issue(如果是修复 JIRA 中已经记录的 issue,可以直接使用该JIRA issue 的 ID),我们写了一份关于研发流程的文档,在开始之前可以先阅读一下。

提问或者回答问题

对于使用上的问题,建议你在 stackoverflow.com 平台上提问, 记得用 weex 标签标记它们。

你也可以查看所有的 Weex相关问题,如果可以的话,尽可能帮助回答一些问题,这些问题常常是新手需要了解的基本概念和常见问题, 这也将帮助你更好地熟悉和使用 Weex 。

参与邮件组讨论

在 Weex 社区,大多数讨论都发生在邮件列表上。

dev 邮件组 “dev@weex.incubator.apache.org” 是 Weex 开发人员交流和讨论新功能、新发布、开发流程的地方。

贡献者和开发者都应该订阅这个邮件组,以便了解到 Weex 项目所发生的事情以及表达自己的观点。 (订阅) (退订) (档案)

帮助提升文档质量

质量好的文档对开发者是极大的帮助。如果有一个功能强大的 API 但不易于使用,它就会变得毫无用处。所以, 我们欢迎任何贡献以帮助 Weex 的文档变得精确和易于阅读。

想要对文档进行更改,可以在 weex-site 仓库编辑对应的 Markdown 文件并创建一个 Pull Request.

如何成为 Committer

Apache committer 是社区的核心成员,他们可以访问项目的仓库,也可以自己修改代码、文档和网站,也可以接受其他开发者的贡献。

我们正在招募 committer,我们所寻找的是积极参与到社区贡献同时对 Weex 有持续兴趣的同学。如果你有兴趣成为一名 Weex committer,可以联系现有的 committer 或者直接联系 dev 邮件组,欢迎你的加入!

License

默认你对 Weex 的贡献是基于 Apache License 2.0。