贡献指南

我们无时无刻不需要开发者来帮助改进 SpongeAPI。常言道，人无完人，金无足赤；然又有云，锲而不舍，金石可镂。如果你是一名愿意协助我们的开发者，请不要犹豫，我们随时欢迎，惟需注意请遵守我们的指南。

备注

我们会关注一些对我们的项目有贡献的开发者，并由项目管理层在一定的慎重考虑后邀请进入 Sponge 开发团队中来。我们并没有什么正式的申请流程，所以说不要向 Sponge 开发团队询问相关的事了，到时候我们会表态的。

大体步骤

1. 按照 为开发作准备 中的描述建立你的工作区。

2. 请确保你熟悉 Git 和 GitHub。如果你需要更新你的知识，看看这里： 如何使用 Git/GitHub

3. 在 SpongeAPI, SpongeCommon 及 SpongeDocs 仓库中检查现有议题。可能已经有其他人在做同样的事了，你还可以查看 被标为 “help wanted” 的议题 <https://github.com/SpongePowered/SpongeAPI/labels/help%20wanted> 来寻找需要帮助的问题。

备注

请不要提交类似改错别字、改变量名这样没有实际功能的小型 Pull Request。作为替代，你可以：

• 加入 ` IRC (irc.esper.net) 上的 #spongedev <https://webchat.esper.net/?channels=spongedev>`_ 频道，我们会连带其他小修改一起搞定。

• 加入我们的 Discord 服务器，然后在 #dev 频道里联系我们。我们的 Discord 和 IRC 频道是互联的，所以我们不会错过你的消息！

• 你也可以直接发到我们在 GitHub 上的小问题总表中。

4. 如果你想提交一个更大的改变，在实际提交前请先提交 Issue 。这样我们就能确认这个问题并知道是你正在修正它。同时，你应当创建一个草稿 Pull Request 或者以 ~wip 作为内容的普通 Pull Request，这样我们能及早开始复核。

5. Fork 这个项目，克隆它并将你的变动放置在一个额外的分支。

6. 测试你的改动（至少能编译），并将其提交到你自己的 Fork 上。

7. 提交一个 Pull Request 并附带一段介绍，解释你改动了什么和为什么要那么改动。

8. 如果你做了额外的改动，请产生一个新的提交。 不要把所有的改动挤（Squash）在一起 ，那会使跟踪你在不同时期所做的改动变得异常困难。

9. 确信你的 PR（Pull Request）已经衍合（Rebase）到当前你想要合并的分支的最新提交处。如果你不知道如何衍合，请直接问！

小技巧

如果你不确定你应该在哪个分支的基础上开始工作， 在提交你的 PR 之前读读我们的 仓库分支布局策略 。