re-write intro

Author: monkstone

README.md

@@ -1,15 +1,12 @@
 # JRubyArt-examples for JRubyArt-1.3.0+
-JRubyArt-examples
+Description
 ================
 
-Rakefiles amended to use `-r` in place of `run`
-
-Many of the vanilla processing example sketches have been translated to ruby-processing, and they are mainly written as 'bare' sketches (ie not class wrapped) in keeping with the original processing.  At runtime these sketches the get wrapped into a Sketch class. Should you prefer you can still write class wrapped sketches, these will work equally well with jruby_art. You should also checkout the [Nature of Code Examples in ruby][] and for the beginner [Learning Processing with Ruby][] for even more examples.
-Includes autorun Rakefiles:-
+Like the original `ruby-processing`, `JRubyArt` is like a DSL for vanilla `processing`, so sketches can be written as **bare** sketches (ie they do not require class wrapper, JRubyArt does that for you as does vanilla processing cf [propane][propane]). Here you will find many of the processing example sketches have been translated to ruby as **bare** sketches cf [propane][propane]) but you can add the **class** wrapper if that suits you. You should also checkout the [Nature of Code Examples in ruby][] and for the beginner [Learning Processing with Ruby][] for even more examples. Many sketches folders includes autorun Rakefiles, and some of these can be run from the root directory as a demo:-
 
 1. in a console cd `k9_samples` directory
 2. and `rake` to run all the core examples (excludes gem examples etc)
-3. `rake hype` to just run the hype library examples (depends on an installed hype library). 
+3. `rake hype` to just run the hype library examples (depends on an installed hype library).
 4. `rake wordcram` to just run the wordcram gem examples (depends on an installed ruby_wordcram gem).
 5. `rake pbox2d` to just run the pbox2d gem examples (depends on an installed gem).
 
@@ -18,7 +15,7 @@ Includes autorun Rakefiles:-
 1. [Basic][]
 
     1. [structure][]
-    2. [objects][] 
+    2. [objects][]
     3. [arrays][]
     4. [input][]
     5. [shape][]
@@ -30,7 +27,7 @@ Includes autorun Rakefiles:-
     1. [shaders][]
     2. [lsystems][]
     3. [advanced data][]
-    
+
 3. [Libraries][]
     1. [fastmath][]
     2. [vecmath][]
@@ -43,7 +40,7 @@ Includes autorun Rakefiles:-
    3. [Toxiclibs][toxiclibs]
    4. [Wordcram][wordcram]
    5. [Sunflow raytracing][joons]
-   
+
 5. Java Libraries
    1. [Hype-processing][hype]
    2. [Hemesh][hemesh]
@@ -82,3 +79,4 @@ Includes autorun Rakefiles:-
 [geomerative]:https://github.com/ruby-processing/JRubyArt-examples/tree/master/external_library/gem/geomerative
 [toxiclibs]:https://github.com/ruby-processing/JRubyArt-examples/tree/master/external_library/gem/toxiclibs
 [wordcram]:https://github.com/ruby-processing/JRubyArt-examples/tree/master/external_library/gem/ruby_wordcram
+[propane]:https://ruby-processing.github.io/propane/