comment tweaks
update class naming convention to conform with PEP
add examples and update README