ClojureScript

貢獻於 ClojureScript

貢獻的方式

有很多方式可以為 ClojureScript 社群做出有意義的貢獻

  • 在您的組織中倡導使用 ClojureScript

  • 使用 ClojureScript 並透過演講、部落格等方式分享您的經驗

  • 開始或加入當地的聚會

  • 在 Slack 或其他論壇上幫助新的 ClojureScript 使用者

  • 為開源函式庫建立或提供修補程式

  • 建立或改進 ClojureScript 工具

  • 為函式庫撰寫指南或參考文件

  • 為工具撰寫介紹或入門指南

  • 製作 ClojureScript 播客、螢幕錄影或影片

  • 在會議上發表演講

  • 撰寫文章或書籍

  • 開始一個 ClojureScript 播客

  • 在您的程式碼庫上測試 ClojureScript 的 alpha 或 beta 版本並提供回饋

編輯此網站

如果您正在撰寫指南、舉辦活動或建立資源,請考慮為此網站 clojurescript.org 做出貢獻。所有內容都儲存在 GitHub 中,並且接受 pull request 和問題回報。有關如何貢獻的更多資訊,請參閱貢獻於網站的頁面。每個頁面的右下角都有一個指向相應原始碼檔案的連結。如果您對新的指南或更新的文件有任何想法,請提交一個問題以供討論。

回報問題和請求增強

Clojure 團隊提供了一個論壇,使用者可以在這裡提問、提交潛在問題,並請求增強 Clojure、ClojureScript 或 Clojure contrib 函式庫。對於所有這些情況,請在論壇上提問。對於潛在問題,請將問題標記為 problem,對於增強功能,請標記為 request。社群和核心團隊將評估該問題,並確定是否在 jira 追蹤器中提交問題。如果提交了問題,連結將會被添加到問題中,並標記為 jira

如果您希望針對 jira 中的問題提供回饋,請在論壇中依標題搜尋等效的問題,並將您的回饋以「答案」的形式新增到該處。

這些語言和函式庫的開發團隊將使用問題投票來優先處理他們在 jira 中針對下一個版本的工項。

做出貢獻

如果您對 ClojureScript 有任何提案,請將其作為問題發佈在https://ask.clojure.org 上,使用 ClojureScript 類別並標記為 request。ClojureScript 開發人員將協助您判斷此想法是否適合 ClojureScript,以及是否需要修補程式。如果您希望在投入更多考量的提案之前進行即時討論,#cljs-dev Clojurians Slack 頻道非常活躍。

如果 ClojureScript 開發人員指出這是一件有用的事情,請遵循流程成為貢獻者。這需要簽署貢獻者協議並請求存取 ClojureScript jira 帳戶。

貢獻者協議

遵循其他開源專案的領導,ClojureScript 專案要求貢獻者共同轉讓其對貢獻程式碼的版權。貢獻者協議 (CA) 讓 Rich Hickey 和貢獻者共同擁有程式碼的版權利益:貢獻者保留版權,同時也將這些權利授予 Rich Hickey 作為開源專案贊助者。

CA 源自於 Oracle 貢獻者協議 (OCA),該協議用於 OpenJDK、Netbeans 和 OpenSolaris 專案等。有一個很好的OCA 常見問題解答許多問題。

CA 並未改變 Clojure 社群在 Eclipse Public License (EPL) 下的權利或責任。透過執行 CA,貢獻者可以保護 Clojure 程式碼庫,啟用替代授權模型,並保護專案的彈性以適應社群不斷變化的需求。為了使 CA 生效,Clojure 專案必須取得所有貢獻的轉讓。請審閱 CA 以完整了解其條款和條件。透過將原始碼或其他材料貢獻給 Clojure,您聲明您已與 Rich Hickey 簽署了針對此類貢獻的 CA。為了追蹤貢獻者,您了解您的全名和使用者名稱可能會發佈在可透過公共 URL 存取的授權貢獻者網頁列表中。

提交協議的說明

填寫並提交貢獻者協議 (線上電子表格)

請參閱貢獻頁面,以獲取關於工單、建置、修補程式、原始碼等的資源集合。如果您想提交修補程式,請遵循提交的首選流程中的這些準則。

非常感謝您對 ClojureScript 的貢獻!