update vignette and vignette index
add S3 print methods
add examples and return values to docs
fix class handling
fix typo x2
fix response objects
update vignette