google-cloud-python icon indicating copy to clipboard operation
google-cloud-python copied to clipboard

Docs build is failing due to known issues in proto comments

Open parthea opened this issue 1 year ago • 1 comments

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 avatar Feb 16 '24 18:02 parthea

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 ...
  • google-ai-generativelanguage (https://github.com/googleapis/google-cloud-python/pull/12335)
  • google-analytics-admin (https://github.com/googleapis/google-cloud-python/pull/12341)
  • google-cloud-alloydb (https://github.com/googleapis/google-cloud-python/pull/12342)
  • google-cloud-datacatalog (https://github.com/googleapis/google-cloud-python/pull/12343)
  • google-cloud-deploy (https://github.com/googleapis/google-cloud-python/pull/12338)
  • google-cloud-dialogflow-cx (https://github.com/googleapis/google-cloud-python/pull/12345)
  • google-cloud-dms (https://github.com/googleapis/google-cloud-python/pull/12337)
  • google-cloud-documentai (https://github.com/googleapis/google-cloud-python/pull/12346)
  • google-cloud-edgenetwork (https://github.com/googleapis/google-cloud-python/pull/12340)
  • google-cloud-enterpriseknowledgegraph (https://github.com/googleapis/google-cloud-python/pull/12347)
  • google-cloud-network-connectivity (https://github.com/googleapis/google-cloud-python/pull/12356)
  • google-cloud-network-management (https://github.com/googleapis/google-cloud-python/pull/12336)
  • google-cloud-securitycentermanagement (https://github.com/googleapis/google-cloud-python/pull/12339)
  • google-cloud-service-control (https://github.com/googleapis/google-cloud-python/pull/12349)
  • google-cloud-workflows (https://github.com/googleapis/google-cloud-python/pull/12350)
  • google-geo-type (https://github.com/googleapis/google-cloud-python/pull/12351)
  • google-maps-routing (https://github.com/googleapis/google-cloud-python/pull/12353)
  • google-shopping-merchant-reports (https://github.com/googleapis/google-cloud-python/pull/12352)

parthea avatar Feb 16 '24 18:02 parthea