Pydoc is giving criptic error messages

This is blocking my PR at the moment, the output doesn't seem to match the file and I am not sure how to proceed

pydoc Output
[https://scans.gradle.com/s/im6t66hhy4bdq/console-log?task=:beam-sdks-python:docs#L3](https://www.google.com/url?q=https://scans.gradle.com/s/im6t66hhy4bdq/console-log?task%3D:beam-sdks-python:docs%23L3&sa=D&source=hangouts&ust=1551564233723000&usg=AFQjCNEblSgvJ5E5k_TxqgGujKeUGfuIOw)

Files
[https://github.com/apache/beam/pull/7936/files](https://www.google.com/url?q=https://github.com/apache/beam/pull/7936/files&sa=D&source=hangouts&ust=1551564233724000&usg=AFQjCNGXSwba2Q4Aod3FAVcYhQXOkQgYvQ)

/usr/local/google/home/ajamato/go/src/github.com/apache/beam/sdks/python/apache_beam/testing/metric_result_matchers.py:docstring of apache_beam.testing.metric_result_matchers:13: WARNING: Unexpected indentation.
/usr/local/google/home/ajamato/go/src/github.com/apache/beam/sdks/python/apache_beam/testing/metric_result_matchers.py:docstring of apache_beam.testing.metric_result_matchers:15: WARNING: Block quote ends without a blank line; unexpected unindent.
/usr/local/google/home/ajamato/go/src/github.com/apache/beam/sdks/python/apache_beam/testing/metric_result_matchers.py:docstring of apache_beam.testing.metric_result_matchers:18: WARNING: Definition list ends without a blank line; unexpected unindent.
/usr/local/google/home/ajamato/go/src/github.com/apache/beam/sdks/python/apache_beam/testing/metric_result_matchers.py:docstring of apache_beam.testing.metric_result_matchers:19: WARNING: Definition list ends without a blank line; unexpected unindent.
/usr/local/google/home/ajamato/go/src/github.com/apache/beam/sdks/python/apache_beam/testing/metric_result_matchers.py:docstring of apache_beam.testing.metric_result_matchers:21: WARNING: Unexpected indentation.
/usr/local/google/home/ajamato/go/src/github.com/apache/beam/sdks/python/apache_beam/testing/metric_result_matchers.py:docstring of apache_beam.testing.metric_result_matchers:22: WARNING: Block quote ends without a blank line; unexpected unindent.

\==\=== copy of the file in its current state (I will probably modify the PR \==\==

[https://pastebin.com/8bWrPZVJ](https://pastebin.com/8bWrPZVJ)

Imported from Jira [BEAM-6761](https://issues.apache.org/jira/browse/BEAM-6761). Original Jira may contain additional context.
Reported by: ajamato@google.com.