rebuilt docs
minor changes to major document, the README
more tweakettes to plan