add examples
update docs with links