Add instructions [WIP]

Author: PEZ

Diff for: .gitignore

@@ -12,3 +12,6 @@ pom.xml.asc
 .lein-failures
 .nrepl-port
 .cpcache/
+
+.calva/**/*.calva-repl
+.lsp/sqlite*.db

Diff for: .gitpod.Dockerfile

@@ -1,5 +1,3 @@
 FROM gitpod/workspace-full
 
 RUN brew install clojure/tools/clojure
-RUN brew install leiningen
-

Diff for: .gitpod.yml

@@ -3,4 +3,14 @@ image:
 
 vscode:
   extensions:
-    - betterthantomorrow.calva
+    - betterthantomorrow.calva
+
+tasks:
+  - name: Prepare deps
+    init: clojure -Sdeps '{:deps {nrepl/nrepl {:mvn/version,"0.8.3"},cider/cider-nrepl {:mvn/version,"0.26.0"}}}' -P
+  - name: INSTRUCTIONS
+    command: code doc/INSTRUCTIONS.md
+
+github:
+  prebuilds:
+    main: true

Diff for: .vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "workbench.editorAssociations": {
+        "INSTRUCTIONS.md": "vscode.markdown.preview.editor"
+    }
+}

Diff for: README.md

@@ -2,10 +2,10 @@
 
 A zero-install, interactve, guide to get you started with [Clojure](https://clojure.org/) using [Calva](https://calva.io/)'s **Getting Started REPL**.
 
-<div style="margin: 30px 0 30px 0;; display: flex; justify-content: space-around;">
-<img src="doc/clj.png" height=300>
-<img src="doc/calva-symbol.png" height=300>
+![Clojure and Calva](doc/clojure-and-calva.png)
 
-</div>
+## OK, but how?
 
-Read about how to use it here: [calva.io/get-started-with-clojure](https://calva.io/get-started-with-clojure/).
+Read about what this is here: [calva.io/get-started-with-clojure](https://calva.io/get-started-with-clojure/).
+
+When you've read that, open [doc/INSTRUCTIONS.md](doc/INSTRUCTIONS.md)

Diff for: deps.edn

@@ -0,0 +1 @@
+{}

Diff for: doc/INSTRUCTIONS.md

@@ -0,0 +1,29 @@
+# How to use The Getting Started REPL
+
+The Getting Started REPL connects Calva to three files, which will serve as your interactive guides:
+
+- `hello_repl.clj` – The basics of how to evaluate code in Calva (i.e. using the REPL)
+- `hello_paredit.clj` - A super brief intro to Calva structural editing ([Paredit](https://calva.io/paredit))
+- `welcome_to_clojure.clj` - The very basics of the Clojure language
+
+The files contain a mix of guiding text and snippets of code. You will use the REPL to evaluate the code and sometimes you will be asked to write some code and evaluate that.
+
+If you haven't already, you should start with reading [calva.io/get-started-with-clojure](https://calva.io/get-started-with-clojure/). 
+
+## Let's go!
+
+First you need to fire up the Getting Started REPL:
+
+1. Click the **REPL** button in the status bar
+
+   ![VS Code Statusbar with Clojure REPL button](doc/status-bar-repl-button.png)
+   
+   <details><summary>Don't see the REPL button?</summary>
+    
+    This could be because some firewall or adblocker prevents the downloading of the Calva extension. See [issue #9](https://github.com/PEZ/rich4clojure/issues/9) for more clues on this.
+    
+    </details>
+1. Select **Fire up the ”Getting Started” REPL** from the quick pick menu.
+    ![The Calva REPL Menu](doc/repl-menu.png)
+
+