Refactor Klipse curriculum to Clojure essentials

Author: practicalli-johnny

clojure-essentials.md

@@ -1,9 +1,9 @@
-# Using this workshop
+# Clojure Essentials
 
-A quick guide to using this workshop.
+This learning path will teach you some of the essentials of the Clojure programming language.  You do not need to install any Clojure tools to use it, however, you may want to copy your code examples into an editor.
 
 
-## Navigating the workshop
+### Navigating the workshop
 
 The pages in the workshop can be navigated using the left-hand menu.  To move a page forwards or backwards use the right or left arrow keys, or press the arrows at the side of each page (or bottom of the page if on a small display).
 
@@ -12,7 +12,7 @@ The pages in the workshop can be navigated using the left-hand menu.  To move a
 
 ### Evaluating Clojure
 
-You can try out Clojure code directly in the pages of this workshop.  The code boxes below allow you to edit the code in the top of the box, with the results evaluated automatically and updated in the results in the bottom of the box.
+Code can be written directly in the pages of this workshop.  The code boxes below allow you to edit the code in the top of the box, with the results evaluated automatically and updated in the results in the bottom of the box.
 
 
 ```eval-clojure
@@ -22,29 +22,21 @@ You can try out Clojure code directly in the pages of this workshop.  The code b
 (live-evaluation "awesomenessness")
 ```
 
-These code boxes are powered by a ClojureScript library called [Klipse]().
-
-> #### Hint::Klipse Hints
-> Alternatively you may use [Klipse as a stand-alone editor](http://app.klipse.tech/?eval_only=1) or as [a stand-alone editor with Javascript output](http://app.klipse.tech/)
->
-> Klipse can evaluate code from a public [Github Gists](https://gist.github.com/)
-
 ### Exercises
 
 Exercises are denoted by using the Note [callout plugin](https://www.npmjs.com/package/gitbook-plugin-callouts) for gitbook.  Exercises look like:
 
 > #### Note::Create a Clojure project
 > Use the Leiningen tool to create a project called **clojure-is-awesomenessness**
 
-There are other [callout](https://www.npmjs.com/package/gitbook-plugin-callouts) styles available, including: Info, Hint, Warning, Tag, Comment, Success, Caution, Quote and Danger.
-
 
 ### Answers
 
+Suggested answers are included directly in the workshop in hidden sections.  To get the most out of the workshop you should try to solve the answers first and try several alternative approaches to solving each exercise.
 
-Suggested answers are included directly in the workshop in hidden sections.  An example of an answer in a hidden section is as follows:
+An example of an answer in a hidden section is as follows:
 
-<!--sec data-title="Suggested answer. Press arrow button to reveal" data-id="answer001" data-collapse=true ces-->
+<!--sec data-title="Suggested answer. Press the button to reveal" data-id="answer001" data-collapse=true ces-->
 
 ```clj
 (defn who-has-the-answer [name])
@@ -54,8 +46,6 @@ Suggested answers are included directly in the workshop in hidden sections.  An
 ```
 Cultural reference to an [award winning TV advertisement](https://www.youtube.com/watch?v=UA5aLfM9N0E) in 1984 that was created using computer graphics.
 
-We do not endorse that anyone has all the answers :)
+We do not endorse smarties or suggest that anyone has all the answers :)
 
 <!--endsec-->
-
-To get the most out of the workshop you should try to solve the answers first and try several alternative approaches to solving each exercise.