various docstring fixes for web docs
Merge pull request #3921 from trevorstephens/docstring-format-fixes

[MRG+1] Various docstring fixes for web docs