貢獻指南

總是需要開發人員來協助我們改進 SpongeAPI。沒有一個專案是完美的,總是會有可以改進的地方。如果你是有興趣提供協助的開發人員,請不要猶豫。只要確保你遵守我們的準則。

備註

對專案的貢獻中表現出決心和一致性的開發人員可能會被團隊領導主動邀請加入 Sponge Staff。沒有正式的申請程序。請不要要求當工作人員,我們會主動問你。

大致的步驟

  1. 根據 準備開發 的描述設定工作空間。

  2. 確保你熟悉 Git 和 GitHub。如果您的知識需要刷新,請參閱 如何 Git(hub)

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

備註

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

  1. 如果你想提交一個大的改變,在實際提交前請先提交Issue。這樣我們就能確認這個問題並知道是你正在修正它。你應該儘早創建一個以``[Wip]`` 開頭的WIP(Work In Progress, 工作進行中) Pull Request,這樣我們就能及時開始對其的檢查。

  2. Fork 這個專案,複製它並將你的改動放到一個額外的分支。

  3. 測試你的改動(至少能編譯),提交並推送到你自己的 fork 上。

  4. 提交一個 Pull Request,附帶一段介紹,解釋你更動了什麼與為什麼應該要那樣更動。

  5. 如果你做了額外的更動,請推送新提到到你的分支。不要把所有的更動 Squash 在一起,那會使你在查看與 Pull Request 中更早的版本的比較時異常困難。

  6. 確保你的 PR 已經 rebase 到你想合併到的分支的最新更動。如果你需要幫助來 rebase 它,請詢問!

小訣竅

如果您不確定該基於哪個分支工作,請在提交您的 PR 之前閱讀我們的 專案分支布局