more docs and more patterns