update docs with a more concrete example, change 'state' type requirements
a few readme tweaks
some more readme tweaks
fix image name