updating docs and adding matching example