readme: add links to yard docs; fix typos