DOC: Use `:ref:` when referring to section headers

This PR makes a few minor changes to more consistently use the :ref: role to link to different sections in different parts of the numpydoc standard.

I also used the :pep: role to create a link to PEP 8.

Thank you for the review!