貢獻
如果您正考慮為 DataTables 貢獻程式碼,首先,非常感謝您!我們非常歡迎對 DataTables 的所有修正、修補和增強功能。為了保持可管理性,有一些準則應該遵循,以確保您的修改能盡快納入 DataTables。
- 請在 DataTables/DataTablesSrc 儲存庫中,為 DataTables 核心做出貢獻。
- 請遵循現有檔案中的程式碼樣式。它們可能不符合每個人的喜好,但對於像 DataTables 這樣成熟的專案來說,一致性至關重要。DataTables 沒有程式碼標準文件,但遵循現有檔案中的相同樣式是理想的簡單常識。例如,使用 tab 鍵而不是空格(您會看到所有原始碼檔案都使用 tab 鍵)。
- 連結到顯示您正在修正的錯誤或正在新增的功能的測試頁面。這讓我可以快速識別正在變更的內容以及原因。不要擔心在 pull request 中寫太多 - 確切知道正在變更什麼以及為什麼要變更,會更好!
- DataTables 是一個大型且複雜的專案,並非總是可能或適合加入每個建議的變更。如果 pull request 沒有合併,請不要感到冒犯,我們會解釋原因。此外,由於其他事務繁忙,我無法總是盡快完整檢查和測試 pull request。再次說明,這並非反映您的 pull request 有問題,只是我們都很忙碌!如果您對您的潛在貢獻及其在 DataTables 專案結構中的位置有任何疑問,請提前在 DataTables 論壇中提問。
- 只有在您承認您的貢獻是依據專案的現有許可證 (MIT) 提供且將會依據其授權發布,才會接受 pull request。如果您的初始 pull request 沒有明確承認這一點,我會在合併之前提出要求。