delete stale README.rst file which contents was migrated to docs
small cleanup
DOC nuke old README; minor other documentation fixes.