From 06011afc3e014a37bc5a54e6c7bafdbaec6f4f72 Mon Sep 17 00:00:00 2001
From: John Practicalli <250870+practicalli-john@users.noreply.github.com>
Date: Sun, 15 Oct 2023 21:08:39 +0100
Subject: [PATCH] intro: enhance learning path prose

---
 docs/introduction/learning-path.md | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/docs/introduction/learning-path.md b/docs/introduction/learning-path.md
index 1164dc2..b985758 100644
--- a/docs/introduction/learning-path.md
+++ b/docs/introduction/learning-path.md
@@ -1,6 +1,8 @@
 # Clojure Learning Path
 
-Practicalli recommended approach for learning Clojure, which can be done in parallel.
+Practicalli recommended approach for learning Clojure programming.
+
+A journey into Clojure should start with these foundational aspects
 
 - Become comfortable evaluating code in the [Clojure REPL](#clojure-repl)
 - Review the fundamental [syntax of Clojure](#experience-the-clojure-syntax) (its small and consistent)
@@ -9,6 +11,17 @@ Practicalli recommended approach for learning Clojure, which can be done in para
 - [Practice Clojure](#practice-practice-practice) by solving challenges and discover more about the Clojure Standard Library (hundreds of functions available)
 - Connect to the [Clojure community](#community-help) for advice and shared experiences
 
+The foundational aspects are inter-related so a slice through each of them is usually the most effective approach.
+
+Build on that foundation by understanding the design approach to effectively create solutions in Clojure
+
+- Designing for simplicity
+- Appreciating Immutability
+- Data centric design
+- Common Clojure idioms (patterns)
+- Common libraries
+
+
 
 ## Clojure REPL 
 
@@ -26,7 +39,9 @@ Take a quick look at the Syntax of Clojure.  The syntax is very small, so this w
 
 Build on the REPL experience by connecting a Clojure aware editor to the Clojure REPL process. 
 
-A REPL connected Editor provides an effective set of Clojure development tools to evaluate Clojure expressions.   
+A REPL connected Editor provides an effective set of Clojure development tools to evaluate Clojure expressions.
+
+Understanding common Clojure project structures (src, tests, namespaces) helps organise code effectively and consistently.
 
 Practicalli provides editor install and usage guides for 
 
@@ -76,7 +91,7 @@ Activities to help practice Clojure include:
 
 ## Community Help
 
-There are many ways to [:simple-livejournal: get help from the Clojure community](https://practical.li/blog/posts/cloure-community-getting-help/)
+There are many ways to [:fontawesome-solid-book-open: get help from the Clojure community](docs/)
 
 Often starting to ask questions of the community is an effective way of solving the problem yourself.  Asking specific questions helps the community help you.  Posting the specifics of the solution helps the community grow.