DOC: Add headers to docstring sections to add link anchors (#320)

* DOC: replace enumerated list with headings.

Creates anchor links for individual docstring sections.

* Add internal links to newly anchored section headings.

Author: rossbar