reworking everyone's messages.
update the readme
finalizing new feature
merging in new feature from volitile experiment branch