diff --git a/README.md b/README.md
index bcf6171..76f662d 100644
--- a/README.md
+++ b/README.md
@@ -2,13 +2,16 @@
 
 A rule parser for MicroWorld
 
-## Part of the overall Microworld system 
+## Part of the overall MicroWorld system 
 
 While this code works and is interesting on its own, you also need at least
 [mw-engine](https://github.com/simon-brooke/mw-engine) and 
 [mw-ui](https://github.com/simon-brooke/mw-ui). There will be other 
 modules in due course.
 
+You can see MicroWorld in action [here](http://www.journeyman.cc/microworld/) -
+but please don't be mean to my poor little server. If you want to run big maps
+or complex rule-sets, please run it on your own machines.
 
 ## Usage
 
diff --git a/src/mw_parser/insta.clj b/src/mw_parser/insta.clj
index 9d220f9..3c59ccf 100644
--- a/src/mw_parser/insta.clj
+++ b/src/mw_parser/insta.clj
@@ -3,6 +3,8 @@
         [clojure.string :only [split trim triml]])
   (:require [instaparse.core :as insta]))
 
+;; This is the 'next generation' parser - it is a much better parser than
+;; mw-parser.core, but it doesn't completely work yet.
 
 (def grammar
   ;; in order to simplify translation into other natural languages, all