fix docs and add more examples