fixing some docstring formatting

Some very minor fix to the docstring to have a nicer formatting on the generated docs pages, and fixing one broken link.