bug fixes, start of README documentation