fleshed out readme with notes and documentation
housekeeping