adding docs and a few more examples