update readme to reflect changes in status file
some additional comments.