Fix a handful of docstring-related issues in the codebase.
Review Request #10590 — Created June 14, 2019 and submitted — Latest diff uploaded
The introduction of generated class reference docs unveiled some syntax
errors in our docstrings, and a few places where we wanted to show some
docs but weren't. This fixes up some initial doc issues in the codebase.
Built the docs without errors.