tweaking debug output, adding more docs to readme