| extends ../layouts/basic |
| |
| block variables |
| - var pageTitle = 'ECharts FAQ' |
| |
| block extra_head |
| title 如何贡献 - Apache ECharts |
| |
| block content |
| nav(class='navbar navbar-default navbar-fixed-top', role="navigation") |
| include ../components/nav |
| |
| .page-main |
| .page-info |
| .container |
| h1 如何贡献 |
| p.page-info-echarts Apache ECharts<sup>TM</sup> |
| |
| |
| .page-content |
| .container |
| h2 如何为 Apache ECharts 项目贡献一份力量 |
| p ECharts 欢迎各种形式的贡献！ |
| |
| h3 Issues |
| p 查看 <a href="https://github.com/apache/echarts/issues" target="_blank">issue</a> 中是否有可以提供帮助的问题。 |
| ul |
| li 如果是一个报 bug 或者提问如何使用 ECharts 的 issue，可以帮忙提醒创建者提供一个可复现的在线例子。例子可以通过 <a href="https://codepen.io/Ovilia/pen/dyYWXWM" target="_blank">Codepen</a> 或者 <a href="https://gallery.echartsjs.com/editor.html" target="_blank">ECharts Gallery</a> 创建。 |
| li 如果是一个提新需求的 issue，可以帮忙确保创建者对预期的效果有清晰的表述。很多情况下，一个简单的设计图对清晰地表达需求是有必要的。 |
| li 帮助复现问题，并根据<a href="https://echarts.apache.org/zh/option.html" target="_blank">文档</a>判断这是否是一个 bug。 |
| li 没有标记 "pending" 标签的 issue，是我们明确是 bug 或新需求的 issue。欢迎提 pull request 帮忙修复这些问题。 |
| |
| h3 Pull Requests |
| p 我们非常欢迎社区贡献者以 PR 的形式作贡献！ |
| p 在开始之前，请先阅读我们的<a href="./coding-standard.html">代码规范</a>以及<a href="https://www.apache.org/foundation/policies/conduct.html" target="_blank">Apache 行为规范</a>。 |
| p 具体操作请参考 <a href="https://github.com/apache/echarts/wiki/How-to-setup-the-dev-environment" target="_blank">How to setup the dev environment</a> 以及 <a href="https://github.com/apache/echarts/wiki/How-to-make-a-pull-request" target="_blank">How to make a pull request</a>。 |
| p 如果在提 PR 过程中碰到问题，欢迎在 issue 或 PR 中评论，或者给 <a href="mailto:dev@echarts.apache.org">dev@echarts.apache.org</a> 发邮件咨询。 |
| |
| h3 邮件组 |
| p 欢迎订阅<a href="./maillist.html">邮件组</a>参与我们的讨论。 |
| |
| h3 文档 |
| p 文档的修缮可能是 Apache ECharts 最需要帮助的地方。如果你对此感兴趣，无论是对某个页面文字的小修改，还是纠正一个链接或者其他的小改动，我们都非常欢迎！ |
| p 文档的源代码可以在 <a href="https://github.com/apache/echarts-doc" target="_blank">GitHub</a> 找到。如果想要知道应该修改项目中的哪个文件，通常最简单的方式是在项目中搜索关键字。 |
| p 在 issue 列表中，<a href="https://github.com/apache/echarts/labels/doc" target="_blank">"doc"</a> 标签表示相关文档需要修改。我们非常欢迎提 PR 修改这些问题！ |
| |
| |
| |
| h2 成为 Committer 或 PMC 成员！ |
| p 正如上面所说，我们非常欢迎社区以任何形式为 ECharts 项目作贡献。当我们发现社区中长期持续贡献的伙伴，会邀请他们成为 Committer 或者 PMC 成员。 |
| p 成为 Committer 意味着你拥有对 ECharts 项目的“写”权限，可以更方便高效地为项目贡献。 |
| p PMC（Project Management Committee）是项目管理委员会的意思。PMC 成员负责帮助 ECharts 项目进行决策和管理。更多详细信息请参考 <a href="https://www.apache.org/dev/pmc.html">Project Management Committee</a>。 |
| p 成为 Committer 和 PMC 成员没有唯一固定的标准，因为我们鼓励不同形式的贡献。通常来说，现在的 PMC 成员会考察社区贡献者的表现，在发现有符合标准的人选后，会在内部发起讨论和投票，投票通过后将邀请其成为 Committer 或 PMC 成员。 |
| |
| include ../components/footer |
| |
| block extra_js |
| script(type='text/javascript'). |
| document.getElementById('nav-contribute').className = 'active'; |
