readme update and typos
More doc tweaks for RTFD