update readme for new usage.
reorder README sections to put useful info at top
Fix text references for reordering