betterthantomorrow / dram

Interactive Clojure REPL Guides

dram - An Interactive Clojure Beginner's Guide

The first sips of Calva, Clojure, Paredit, or anything Clojure-ish, really.

Made for Calva's Getting Started REPL

This is a repository for Getting Started files for Calva.

See: https://calva.io/getting-started/

How to Contribute

Fork the repo, jack-in, fix stuff while you test it interactively. Send PRs.

See the drams directory for the files. Make sure to edit the files inside the appropriate subdirectories of drams and not the files at the top level of drams.

Definitions

dram

noun • mainly Scottish a small drink of whisky or other spirits: a wee dram to ward off the winter chill.

License

The original author Peter Strömberg aka PEZ claims No Copyright:

• https://creativecommons.org/publicdomain/zero/1.0/

(Don't hesitate to credit me if you use the material, I do enjoy that.)

dram's Issues

welcome_to_clojure.clj: link to the file on Github has incorrect href

I've just installed Calva and opened welcome_to_clojure.clj in VSCode.

Thanks for excellent getting started docs!

That file has the following text:

;; NB: This is work in progress...
;; When you fire up the Getting Started REPL the next
;; time, you will be presented with the option to
;; download new files or continue with the files you
;; have. You can also always find the latest version here:
;; https://github.com/BetterThanTomorrow/dram/blob/dev/drams/welcome_to_clojure.clj

When I click the link on the last line, I get a 404.

Looking at the Github repository, it appears that the correct URL is:
https://github.com/BetterThanTomorrow/dram/blob/dev/drams/calva_getting_started/welcome_to_clojure.clj

Clarify about evaluating the `comment` ”symbol” itself

This issue on Calva BetterThanTomorrow/calva#1273 notes that you get an error when evaluating the comment word.

I think the solution is to try clarify that this is expected behaviour. Maybe somewhere here:

dram/drams/calva_getting_started/hello_repl.clj

Line 199 in f4266fd

;; == You Control what is Evaluated ==

Add interrupt command to hello repl guide

Mentioned in this thread: BetterThanTomorrow/calva#2068 (comment)

Wrong line addressed in hello_repl.clj

In the calva getting started hello_repl.clj at line 20 it is addressed line 15 as the line to evaluate in the repl, but the line to evaluate is actually at line 16.