docs: correct broken links

This also contains some whitespace corrections by my editor.