googleapis / google-cloud-python

Google Cloud Client Library for Python
https://googleapis.github.io/google-cloud-python/
Apache License 2.0
4.85k stars 1.53k forks source link

Docs build is failing due to known issues in proto comments #12326

Open parthea opened 9 months ago

parthea commented 9 months ago

In release PR https://github.com/googleapis/google-cloud-python/pull/12314, the docs build is failing. See the build log here.

There are known issues with the docs generated in certain clients which can be found here.

While we work to resolve the issue in gapic-generator-python, we could improve the process of applying patches to the release PR to reduce the toil of manually fixing docs issues.

parthea commented 9 months ago

I'll use this comment to keep track of all of the steps required to resolve the docs build.

This is a work in progress

Cherry pick these commits

git cherry-pick ...