better readme - refs #6