ClojureScript
为 ClojureScript 做贡献

为 ClojureScript 做贡献

贡献方式

有很多方法可以为 ClojureScript 社区做出有意义的贡献

  • 在您的组织中倡导使用 ClojureScript

  • 使用 ClojureScript 并通过演讲、博客等分享您的经验

  • 创建或加入当地聚会

  • 在 Slack 或其他论坛中帮助新的 ClojureScript 用户

  • 创建或提供开源库的补丁

  • 创建或改进 ClojureScript 工具

  • 为库编写指南或参考文档

  • 为工具编写介绍或入门指南

  • 创建 ClojureScript 播客、屏幕录制或视频

  • 在会议上做演讲

  • 撰写文章或书籍

  • 创建 ClojureScript 播客

  • 在您的代码库上测试 ClojureScript 的 alpha 或 beta 版本并提供反馈

编辑本网站

如果您正在编写指南、创建活动或创建资源,请考虑为本网站 clojurescript.org 做贡献。所有内容都存储在 GitHub 中,并且接受拉取请求和问题。有关如何贡献的更多信息,请参阅网站贡献页面。每个页面在右下角都有一个链接到相应源文件的链接。如果您有关于新指南或更新文档的想法,请提交一个问题以供讨论。

报告问题和请求增强

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 公共许可证 (EPL)下的权利或责任。通过执行 CA,贡献者保护了 Clojure 代码库,启用了替代许可模型,并保护了根据社区不断变化的需求调整项目的灵活性。为了使 CA 生效,Clojure 项目必须获得所有贡献的分配。请仔细阅读 CA,以全面了解其条款和条件。通过向 Clojure 贡献源代码或其他材料,您表明您已与 Rich Hickey 签署了有关此类贡献的 CA。为了跟踪贡献者,您理解您的全名和用户名可能会发布在公共 URL 可访问的列出授权贡献者的网页上。

提交协议的说明

填写并提交贡献者协议(在线电子表格)

请参阅贡献页面,了解有关票证、构建、补丁、源代码等的资源集合。如果您想提交补丁,请遵循提交的首选流程中的这些指南。

非常感谢您对 ClojureScript 的贡献!