Stop using undoc-members

[dhermes]

See https://github.com/GoogleCloudPlatform/gcloud-python/pull/1772/files#r63362850

[dhermes]

AFAIK we use undoc-members to make sure all public methods / attributes are documented even if we forget to provide a docstring. @tseaver I'm not sure what issue you were trying to raise, could you elaborate?

[tseaver]

If we don't provide docs, it isn't part of the API, even if it happens not to start with an _. This issue may be moot, as pylint may barf w/o a docstring.

[dhermes]

Yeah but the way we've built this library, everything that happens to not start with an _ is intended to be public. So undoc-members is a protection against human error (like I said, if we forgot to provide a docstring).

[tseaver]

I would say that exposing the syntax/signature without explaining the semantics isn't helping the user: it would be better to have tox -e docs barf due to lack of coverage.

[dhermes]

I'm totally fine with that.