You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/community/contributing.adoc
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,9 +19,9 @@ The CA does not change the rights or responsibilities of the Clojure community u
19
19
20
20
== Making a contribution
21
21
22
-
Before you invest time working on a change, discuss what you're trying to do with others on the https://groups.google.com/group/clojure-dev[Clojure Dev Google group]. They're likely to be able to offer comments and suggestions that will result in a higher-quality change and a smoother submission process. Announcing that you're working on a particular item can also help to avoid wasted effort in case someone else is already working on it. Once you've submitted the CA, you can http://dev.clojure.org/jira/browse/CLJ[submit patches via JIRA]. Frequent and trusted contributors of more substantial libraries may be granted committer membership in the Clojure contrib projects.
22
+
Before you invest time working on a change, discuss what you're trying to do with others on the https://groups.google.com/group/clojure-dev[Clojure Dev Google group]. They're likely to be able to offer comments and suggestions that will result in a higher-quality change and a smoother submission process. Announcing that you're working on a particular item can also help to avoid wasted effort in case someone else is already working on it. Once you've submitted the CA, you can https://dev.clojure.org/jira/browse/CLJ[submit patches via JIRA]. Frequent and trusted contributors of more substantial libraries may be granted committer membership in the Clojure contrib projects.
23
23
24
-
Please see the http://dev.clojure.org/display/community/Contributing[Contributing] wiki for a collection of resources on tickets, builds, patches, source, and more. If you'd like to submit a patch, please follow these guidelines on the http://dev.clojure.org/display/community/JIRA+workflow[preferred process for submitting].
24
+
Please see the https://dev.clojure.org/display/community/Contributing[Contributing] wiki for a collection of resources on tickets, builds, patches, source, and more. If you'd like to submit a patch, please follow these guidelines on the https://dev.clojure.org/display/community/JIRA+workflow[preferred process for submitting].
Clojure source code is hosted at https://github.com/clojure/clojure[github.com/clojure/clojure]. Builds of the very latest version of Clojure's master branch are available at https://oss.sonatype.org/content/repositories/snapshots/org/clojure/clojure/1.9.0-master-SNAPSHOT/[build.clojure.org].
24
+
Clojure source code is hosted at https://github.com/clojure/clojure[github.com/clojure/clojure]. Builds of the very latest version of Clojure's master branch are available at https://oss.sonatype.org/content/repositories/snapshots/org/clojure/clojure/1.9.0-master-SNAPSHOT/[oss.sonatype.org].
25
25
26
26
== Get Clojure via Leiningen
27
27
@@ -34,6 +34,6 @@ Modify the dependencies and repositories sections of your https://leiningen.org/
34
34
----
35
35
== Where did Clojure Contrib go?
36
36
37
-
If you are migrating from a pre-1.3 version of Clojure, please see http://dev.clojure.org/display/community/Where+Did+Clojure.Contrib+Go[this page] for migration help regarding old contrib libraries.
37
+
If you are migrating from a pre-1.3 version of Clojure, please see https://dev.clojure.org/display/community/Where+Did+Clojure.Contrib+Go[this page] for migration help regarding old contrib libraries.
Clojure Contrib is a collection of libraries managed with the same Contributor Agreement, license, and development workflow as Clojure itself. Code in Clojure Contrib can be considered for inclusion in newer versions of Clojure.
13
13
14
-
Clojure Contrib library code is hosted on https://github.com/clojure[Github]. Design and issue tracking are via http://dev.clojure.org/display/doc/Clojure+Contrib[Confluence] and JIRA.
14
+
Clojure Contrib library code is hosted on https://github.com/clojure[Github]. Design and issue tracking are via https://dev.clojure.org/display/doc/Clojure+Contrib[Confluence] and JIRA.
15
15
16
-
Prior to Clojure 1.3, Contrib was packaged as a single monolithic JAR. If you are migrating from a pre-1.3 version of Clojure, please see http://dev.clojure.org/display/community/Where+Did+Clojure.Contrib+Go[this page] for migration help regarding old contrib libraries.
16
+
Prior to Clojure 1.3, Contrib was packaged as a single monolithic JAR. If you are migrating from a pre-1.3 version of Clojure, please see https://dev.clojure.org/display/community/Where+Did+Clojure.Contrib+Go[this page] for migration help regarding old contrib libraries.
17
17
18
18
== Leiningen
19
19
20
20
The vast majority of Clojure developers use https://github.com/technomancy/leiningen[Leiningen] to create and manage Clojure projects.
21
21
22
22
== IDEs and Developer Tools
23
23
24
-
Community volunteers maintain http://dev.clojure.org/display/doc/getting+started[Getting Started] documentation for a number of different developer tools.
24
+
Community volunteers maintain https://dev.clojure.org/display/doc/getting+started[Getting Started] documentation for a number of different developer tools.
Community volunteers maintain http://dev.clojure.org/display/doc/getting+started[Getting Started] documentation for a number of different tools and approaches. Some of the most commonly used tools include:
79
+
Community volunteers maintain https://dev.clojure.org/display/doc/getting+started[Getting Started] documentation for a number of different tools and approaches. Some of the most commonly used tools include:
80
80
81
81
* https://leiningen.org/[Leiningen] - an extensible build tool that provides dependency management, REPL support, testing, packaging, deployment, and many other capabilities.
82
82
* http://boot-clj.com/[Boot] - build tooling for Clojure: instead of a special-purpose DSL, Boot supplies abstractions and libraries you can use to automate nearly any build scenario with the full power of the Clojure language
Copy file name to clipboardExpand all lines: content/news/2011/07/22/introducing-clojurescript.adoc
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -45,7 +45,7 @@ Some parts of the Clojure language have no direct analog in ClojureScript, in pa
45
45
46
46
Obviously, any code making interop calls to Java, as most existing Clojure libraries do, will not work in ClojureScript. Code written in pure Clojure will **probably** work in ClojureScript with minor adjustments. For example, https://github.com/clojure/clojure/blob/master/src/clj/clojure/zip.clj[clojure.zip in Clojure] and https://github.com/clojure/clojurescript/blob/master/src/cljs/clojure/zip.cljs[clojure.zip in ClojureScript] are nearly identical. With a little effort, purely algorithmic code can be made portable between implementations. However, trying to abstract over all the differences among host platforms has never been a goal of Clojure, nor will it be a goal of ClojureScript.
47
47
48
-
We have a http://dev.clojure.org/jira/browse/CLJS[ClojureScript JIRA instance] set up to track bugs. As with Clojure itself, submitting patches requires signing the <<xref/../../../../../community/contributing#,Clojure Contributor Agreement>>. We can only accept patches through JIRA, not GitHub pull requests.
48
+
We have a https://dev.clojure.org/jira/browse/CLJS[ClojureScript JIRA instance] set up to track bugs. As with Clojure itself, submitting patches requires signing the <<xref/../../../../../community/contributing#,Clojure Contributor Agreement>>. We can only accept patches through JIRA, not GitHub pull requests.
Copy file name to clipboardExpand all lines: content/news/2012/02/17/clojure-governance.adoc
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -43,7 +43,7 @@ The first big issue Clojure/core had to confront was the distribution of clojure
43
43
44
44
My attempts at https://github.com/clojure/clojure-contrib/commit/a6a92b9b3d2bfd9a56e1e5e9cfba706d1aeeaae5[modularizing clojure-contrib within a single Git repository] failed to improve the situation. Eventually, we settled on the solution of separate Git repositories for each library. This was a huge amount of work: dozens of repositories to create and hundreds of files to move. Many of the contrib libraries were stagnant, their original authors lacking time to continue working on them.
45
45
46
-
Finally, almost a year later, the situation has stabilized: http://dev.clojure.org/display/doc/Clojure%2BContrib[28 libraries], each with its own Git repository, test suite, http://build.clojure.org/[continuous integration], and independent release cycle. The overall code quality is higher and development is moving forward again.
46
+
Finally, almost a year later, the situation has stabilized: https://dev.clojure.org/display/doc/Clojure%2BContrib[28 libraries], each with its own Git repository, test suite, https://build.clojure.org/[continuous integration], and independent release cycle. The overall code quality is higher and development is moving forward again.
47
47
48
48
It was a painful transition for everyone, not least for those of us trying to manage it all and bear the brunt of the inevitable carping. On top of everything else, the whole process overlapped with the release of Clojure 1.3, the first release to break backwards-compatibility in noticeable ways (non-dynamic Vars as a default, long/double as default numeric types).
49
49
@@ -64,11 +64,11 @@ Conversely, the decision to move some libraries into the language, notably my te
64
64
65
65
If there was one mistake that I personally made during the 1.3 migration, it was speaking as if Clojure/core *owned* Clojure and clojure-contrib. We don't: Clojure is owned by Rich Hickey, and clojure-contrib is owned jointly by Rich Hickey and contributors. But we *are* the appointed stewards (and Stuarts!) of the open-source Clojure ecosystem. In that role, we have to make decisions about what we choose to invest time in supporting. Given limited time, and following Rich's conservative position on new features, that decision is usually "no."
66
66
67
-
It's a difficult position to be in. Most of Clojure/core's members come from the free-wheeling, fast-paced open-source world of Ruby on Rails. We really don't enjoy saying "no" all the time. But a conservative attitude toward new features is exactly the reason Clojure is so stable. Patches don't get into the language until they have been http://dev.clojure.org/display/design/JIRA%2Bworkflow[reviewed by at least three people], one of them Rich Hickey. New libraries don't get added to http://dev.clojure.org/display/design/Clojure%2BContrib[clojure-contrib] without multiple mailing-list discussions. None of the new contrib libraries has reached the http://dev.clojure.org/display/design/Contrib%2B1.0.0%2BReleases[1.0.0 milestone], and probably won't for some time. These hurdles are not arbitrary; they are an attempt to guarantee that new additions to Clojure reflect the same consideration and careful design that Rich invested in the original implementation.
67
+
It's a difficult position to be in. Most of Clojure/core's members come from the free-wheeling, fast-paced open-source world of Ruby on Rails. We really don't enjoy saying "no" all the time. But a conservative attitude toward new features is exactly the reason Clojure is so stable. Patches don't get into the language until they have been https://dev.clojure.org/display/design/JIRA%2Bworkflow[reviewed by at least three people], one of them Rich Hickey. New libraries don't get added to https://dev.clojure.org/display/design/Clojure%2BContrib[clojure-contrib] without multiple mailing-list discussions. None of the new contrib libraries has reached the https://dev.clojure.org/display/design/Contrib%2B1.0.0%2BReleases[1.0.0 milestone], and probably won't for some time. These hurdles are not arbitrary; they are an attempt to guarantee that new additions to Clojure reflect the same consideration and careful design that Rich invested in the original implementation.
68
68
69
69
So what is clojure-contrib today? It's a curated set of libraries whose ownership and licensing is governed by the Clojure Contributor Agreement. It could also serve as a proving ground for new features in the language, but this does not imply that every contrib library will eventually make it into the language.
70
70
71
-
With the expansion of contrib, we've given name to another layer of organization: *Clojure/dev*. Clojure/dev is the set of all people who have signed the Clojure Contributor Agreement. This entitles them to participate in discussions on the http://groups.google.com/group/clojure-dev[clojure-dev mailing list], submit patches on http://dev.clojure.org/jira[JIRA], and become committers on contrib libraries. Within Clojure/dev is the smaller set of people who have been tasked with screening Clojure language tickets. Clojure/core overlaps with both groups.
71
+
With the expansion of contrib, we've given name to another layer of organization: *Clojure/dev*. Clojure/dev is the set of all people who have signed the Clojure Contributor Agreement. This entitles them to participate in discussions on the http://groups.google.com/group/clojure-dev[clojure-dev mailing list], submit patches on https://dev.clojure.org/jira[JIRA], and become committers on contrib libraries. Within Clojure/dev is the smaller set of people who have been tasked with screening Clojure language tickets. Clojure/core overlaps with both groups.
72
72
73
73
image::/images/content/news/2012-02-17/clojure-community-layers.png[Diagram showing layers of the Clojure community]
0 commit comments