gapic-generator-python icon indicating copy to clipboard operation
gapic-generator-python copied to clipboard

docs build failed in `google-apps-chat`

Open parthea opened this issue 1 year ago • 1 comments

See https://github.com/googleapis/googleapis/blob/2a40f63ea714c7f4c6856a5db4d1f3cc7d4c4b18/google/chat/v1/space.proto#L265 where there is an asterisk character which is not surrounded by backticks or escaped.

This caused the docs build to fail with

sphinx.errors.SphinxWarning: /usr/local/google/home/partheniou/git/google-cloud-python/packages/google-apps-chat/google/apps/chat_v1/services/chat_service/async_client.py:docstring of google.apps.chat_v1.services.chat_service.async_client.ChatServiceAsyncClient.get_space:39:Inline emphasis start-string without end-string.

Instead of

  // Required. Resource name of the space, in the form "spaces/*".
  //
  // Format: `spaces/{space}`

It should be

  // Required. Resource name of the space, in the form `spaces/*`.
  //
  // Format: `spaces/{space}`

See https://github.com/googleapis/google-cloud-python/actions/runs/8142939533/job/22253605510?pr=12379

We should add a linter rule to check for unsupported formatting in proto comments via https://github.com/googleapis/api-linter .

parthea avatar Mar 04 '24 17:03 parthea

Wait for cl/633534188

parthea avatar May 14 '24 11:05 parthea