From 0f2807cc1282dd2bb773448fc578f1f9ef3a8b06 Mon Sep 17 00:00:00 2001
From: John Practicalli <250870+practicalli-john@users.noreply.github.com>
Date: Sun, 15 Oct 2023 21:49:31 +0100
Subject: [PATCH] repl: summarise REPL purpose

---
 docs/clojure-repl/index.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/clojure-repl/index.md b/docs/clojure-repl/index.md
index 2bba1cf..2437571 100644
--- a/docs/clojure-repl/index.md
+++ b/docs/clojure-repl/index.md
@@ -1,5 +1,14 @@
 # Clojure REPL
 
+Use the Clojure repl to
+
+- call functions from clojure core
+- create symbol names (def) that represent a value
+- write custom functions (defn) and call them with data
+- see immediate results when evaluating code
+
+## Getting Started
+
 [:fontawesome-solid-book-open: Install Clojure CLI and Practicalli Clojure CLI Config](https://practical.li/clojure/install/){target=_blank} for a comprehensive set of developmet tools.
 
 Use a [:fontawesome-solid-book-open: terminal UI REPL](#terminal-ui-repl) as a quick way to get started, or set up a preferred [:fontawesome-solid-book-open: Clojure editor](#clojure-editors).