put tests back in sensible order
update readme with (hopefully) useful information and links.
more explanatory material.