diff --git a/lib/parfait/README.md b/lib/parfait/README.md
index 5f0062e3..c98bb342 100644
--- a/lib/parfait/README.md
+++ b/lib/parfait/README.md
@@ -9,10 +9,11 @@ And a large part of that functionality must actually be used at compile time too
 We reuse the Parfait code at compile-time, to create the data for the compiled code.
 To do this the compiler (re) defines the object memory (in parfait_adapter).
 
-A work in progress that started from here : http://ruby-x.org/2014/06/10/more-clarity.html
-went on here http://ruby-x.org/2014/07/05/layers-vs-passes.html
+A work in progress that started from here : http://ruby-x.org/blog/more-clarity
+went on here http://ruby-x.org/blog/layers-vs-passes.html
+and is now documented here http://ruby-x.org/rubyx/parfait.html
 
-A step back:  the code (program) we compile runs at run - time.
+A step back: the code (program) we compile runs at run - time.
 And so does parfait. So all we have to do is compile it with the program.
 
 And thus parfait can be used at run-time.
diff --git a/lib/risc.rb b/lib/risc.rb
index 60b8f3aa..edc82221 100644
--- a/lib/risc.rb
+++ b/lib/risc.rb
@@ -12,7 +12,7 @@ class Class
   end
 end
 
-# The RiscMachine, is an abstract machine with registers. Think of it as an arm machine with
+# The Risc Machine, is an abstract machine with registers. Think of it as an arm machine with
 # normal instruction names. It is not however an abstraction of existing hardware, but only
 # of that subset that we need.
 # See risc/Readme
diff --git a/lib/risc/README.md b/lib/risc/README.md
index 444c7887..2c4a5dce 100644
--- a/lib/risc/README.md
+++ b/lib/risc/README.md
@@ -1,6 +1,6 @@
 # Risc Machine
 
-The RiscMachine, is an abstract machine with registers. Think of it as an arm machine with
+The Risc Machine, is an abstract machine with registers. Think of it as an arm machine with
 normal instruction names. It is not however an abstraction of existing hardware, but only
 of that subset that we need.
 
@@ -9,7 +9,7 @@ Our primary objective is to compile typed code to this level, so the register ma
 - object load
 - object oriented call semantics
 - extended (and extensible) branching
-- normal integer operators (but no sub word instructions)
+- normal integer operators
 
 All data is in objects.
 
@@ -18,7 +18,7 @@ express call semantics.
 
 ## Calls and syscalls
 
-The RiscMachine only uses 1 fixed register, the currently worked on Message. (and assumes a
+The Risc Machine only uses 1 fixed register, the currently worked on Message. (and assumes a
 program counter and flags, neither of which are directly manipulated)
 
 There is no stack, rather messages form a linked list, and preparing to call, the data is
@@ -30,7 +30,7 @@ the meaning or number of syscalls. This is implemented by the level below, eg th
 
 ## Interpreter
 
-There is an interpreter that can interpret compiled register machine programs.
+There is an interpreter that can interpret programs compiled to the risc instruction set.
 This is very handy for debugging (and nothing else).
 
 Even more handy is the graphical interface for the interpreter, which is in it's own repository: