simplify examples for passing arguments
update docs mentioning using an instance
alter the readme with a helpful header