Weex 是一个属于 Apache 基金会的开源社区。Weex 社区推崇并遵守 社区比代码更重要的 的原则。
# 参与者公约
为了构建一个更加多元化与友善的社区环境,Weex 采用 Contributor Covenant 作为参与者公约。
# 邮件列表
加入Weex社区最简单的方式,是订阅 Weex 开发者邮件列表。
在 Apache 社区中,邮件列表是项目内部的主要沟通方式。Weex 作为 Apache 的一个项目,其新特性的讨论、开发流程、未来演进方等事宜会在邮件列表上进行讨论与决策。
Weex 开发者邮件列表是 "[email protected]",开发者可以通过订阅邮件列表的方式了解到 Weex 最近所发生的事情并表达自己的观点。
# 订阅
如果你想订阅 Weex 邮件列表,请发送邮件至[email protected],之后你会收到一封确认邮件,回复此确认邮件,即完成了 Weex 邮件组的订阅。
# 退订
若想退订,可发送邮件到退订[email protected]。
# 浏览
如果你不想订阅,那么通过浏览 https://mail-archives.apache.org/mod_mbox/weex-dev/,你可以看到邮件列表中的所有内容。但如果你想向邮件列表中发送邮件,你仍需订阅。
更多邮件相关事宜,可参考 Apache Mailing List指南。
TIP
在Weex邮件组中,请使用英文沟通,以便让来自全球的开发者知道你的观点。
# Members and Governance Model
Weex 目前的 Committer,PPMC 成员以及加入 Weex Committer 的方式都列在文档中。
# 提出与解决解答问题
- 如果你对weex的用法或基本概念有疑惑,可以在stackoverflow.com上提出相关问题。
- 如果你确定某个问题是一个bug,请参考Bug 反馈指南,并使用Github Issue来反馈。
TIP
尽管 StackOverflow 的内容由来自全球各地的开发者所贡献,但 StackOverflow 并不是 Weex 官方社区的一部分,如果您在 StackOverflow 上的问题超过 96 小时仍无人回复,可在 Github Issue 中发起问题讨论。
WARNING
Github Issue 仅用接收 Bug 反馈以及 StackOverflow 上超过 96 小时无人回复的问题,其他问题请通过邮件列表进行沟通。
# 研发流程
Weex 研发流程的文档被放置于 Confluence 上,这个文档对所有用户可以,文档的主要使用者是 Weex 的 Contributor 。
- Release Plan: 从 0.27 开始,Weex 使用 Github Milestone 管理版本计划。所有的 feature, bugfix 和已经解决的 issue 都和某个里程碑关联。由于 Weex 发布需要两轮投票,里程碑的发布日期仅供参考。
- Release Procedure
- Major feature
- System Design
- Road Map
# 贡献文档或代码
提交代码 Pull Request 并不是参与 Weex 贡献的唯一方式,在Weex社区中,文档和代码一样重要,并尊重所有开发者对 Weex 文档或代码的贡献。
TIP
Weex 采用了 Apache License 2.0,请确保你的贡献符合Apache License 2.0的约束。
# 贡献文档
质量好的文档对开发者是极大的帮助。如果有一个功能强大的 API 但不易于使用,它就会变得毫无用处。所以, 我们欢迎任何贡献以帮助 Weex 的文档变得精确和易于阅读。
可以通过如下方式参与到对文档的贡献中
- 在文档页面底部,点击Edit this page,即可为当前文档创建一个PR
- 在 weex-site 仓库创建或编辑 Markdown 文件。
TIP
文档相关的PR请提交到weex-site 仓库的master分支上。
# 贡献代码
贡献的代码可以是修复已知的 bug 或者 开发新 feature,参考代码提交指南了解更多细节。