diff --git a/README.md b/README.md
index b2ce28f..c584d61 100644
--- a/README.md
+++ b/README.md
@@ -188,6 +188,15 @@ and _operator_ is one of the simple arithmetic operators '+', '-', '*' and '/'.
 Note that '...neighbours are...' is equivalent to '...neighbours have state equal to...',
 and 'some neighbours...' is equivalent to 'more than 0 neighbours...'
 
+### Roadmap
+
+The existing parser, *mw-parser.core*, works but is not well written. A much
+better parser which does not yet completely work, *mw-parser.insta*, is also
+included for the adventurous.
+
+I intend to replace *mw-parser.core* with *mw-parser.insta* as soon as 
+*mw-parser.insta* correctly parses all the test rules.
+
 ## License
 
 Copyright © 2014 [Simon Brooke](mailto:simon@journeyman.cc)
diff --git a/src/mw_parser/core.clj b/src/mw_parser/core.clj
index 4f1159e..aafd595 100644
--- a/src/mw_parser/core.clj
+++ b/src/mw_parser/core.clj
@@ -20,8 +20,10 @@
 ;; semantics - but that is buggy behaviour, which I'll try to fix over the next few weeks, not a
 ;; design fault.
 ;;
-;; More significantly it does not generate useful error messages on failure. This is, I think, a much
-;; more complex issue which I don't yet know how to address.
+;; More significantly it does not generate useful error messages on failure.
+;;
+;; This is the parser that is actually used currently; but see also insta.clj, 
+;; which is potentially a much better parser but does not quite work yet.
 
 (ns mw-parser.core
   (:use mw-engine.utils