updated docs on using `yy` option. fixes #367