Refactor for release

This is a bunch of stuff that needed doing in advance of a formal release of this thing, and as we write a small technical paper to describe it. Some of the work is on the website docs - check it out: 

cni.github.io/MRS

Feel free to comment on any of this - please do not merge yet!