updates readme
  renames and code additions / improvements