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

Files
https://github.com/apache/beam/pull/7936/files

/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