readme further updates, prior to merge with clean