DOC: clean up io docs and fix up links