Add instructions for beginners

[khinsen]

For somone unfamiliar with Clojure, it is not straightforward to get started with this code. The documentation should have a reference to Leiningen and explain at leat "lein test" and "lein repl" to get started.

[lungsi]

Thanks @khinsen for the recommendation. Being a Clojure project one assumes that potential users would know how to load respective diman libraries, however this view also limits diman to only audiences familiar with Clojure. I have therefore added a section in documentation for users new to Clojure.

[khinsen]

Very nice! Your project is small enough that it can be a good entry point to the Clojure universe.

BTW, something you might want to consider to encourage adoption is a demo notebook at https://nextjournal.com/, which is very Clojure-friendly (written in Clojure(Script) itself).

The difficulty with diman is that it faces two adoption barriers: a little-known language in science, and a little-known mathematical foundation. Since it's easier to reduce the first barrier than the second, I think it's worth some effort.

[lungsi]

The difficulty with diman is that it faces two adoption barriers: a little-known language in science, and a little-known mathematical foundation. Since it's easier to reduce the first barrier than the second, I think it's worth some effort.

This is an excellent advice. Since Clojure is not as well known as say, Python, showing examples in notebook form can be very useful.

I was not familiar with https://nextjournal.com Thank you for letting me know. I will have a look and see if I can post some examples in Nextjournal.

[khinsen]

See https://nextjournal.com/try/samritchie/sicmutils for a nice example of a Clojure notebook on Nextjournal.