clojure-koans/README.md
2010-10-29 10:43:32 -05:00

68 lines
1.5 KiB
Markdown

# Clojure Koans
The Clojure Koans are a fun and easy way to get started with Clojure - no
experience assumed or required. Just follow the instructions below to start
making tests pass!
### Getting Started
The only things you need to run the Clojure Koans are:
- JRE 1.5 or higher
- clojure-1.3.0-alpha1.jar
clojure-1.3.0-alpha1.jar needs to be placed in a directory `lib` under this
project.
You can use Leiningen (http://github.com/technomancy/leiningen) to
automatically install the Clojure jar in the right place.
After you have leiningen installed, run
`lein deps`
which will download all dependencies you need to run the clojure koans.
### Running The Koans
To run the koans, simply run
`run.sh`
or, on Windows,
`run.bat`
### Contributing
Patches are encouraged! Make sure the answer sheet still passes (`test.sh`, or
`test.bat` on Windows), and send a pull request.
The file ideaboard.txt has lots of good places to start
### Contributors (in order of appearance)
- Aaron Bedra
- Colin Jones
- Eric Lavigne
- Nuno Marquez
### Credits
These exercises were started by [Aaron Bedra](http://github.com/abedra) of
[Relevance, Inc.](http://github.com/relevance) in early 2010, as a learning
tool for newcomers to functional programming. Aaron's macro-fu makes these
koans extremely simple and fun to use, and to improve upon, and Relevance's
initiative
Using the [koans](http://en.wikipedia.org/wiki/koan) metaphor as a tool for
learning a programming language started with the
[Ruby Koans](http://rubykoans.com) by [EdgeCase](http://github.com/edgecase).