more thorough readme
work in progress notes