more examples
adding another test case
more work on the docs