DOC: clean up io docs and fix up links

closes #3718.