small updates to docs and linking