readme cleanup
date handling corrected, but needs refactoring
doc update