Skip to content

chore: remove description_override (batch 8 - to google-cloud-security-publicca)#16893

Open
jskeet wants to merge 4 commits intogoogleapis:mainfrom
jskeet:description-batch-8
Open

chore: remove description_override (batch 8 - to google-cloud-security-publicca)#16893
jskeet wants to merge 4 commits intogoogleapis:mainfrom
jskeet:description-batch-8

Conversation

@jskeet
Copy link
Copy Markdown
Contributor

@jskeet jskeet commented Apr 30, 2026

No description provided.

@jskeet jskeet requested a review from parthea April 30, 2026 08:45
@jskeet jskeet requested review from a team as code owners April 30, 2026 08:45
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the API descriptions for numerous Google Cloud Python client libraries. It removes description_override fields in librarian.yaml and synchronizes the updated text across .repo-metadata.json and README.rst files. A technical issue was identified in the google-cloud-policysimulator documentation where Markdown-style link syntax was incorrectly used within reStructuredText (.rst) files, which will prevent the links from rendering correctly.


`Policy Simulator`_: Policy Simulator is a collection of endpoints for creating, running, and viewing a `Replay`. A `Replay` is a type of simulation that lets you see how your members' access to resources might change if you changed your IAM policy.
`Policy Simulator`_: Policy Simulator is a collection of endpoints for creating, running, and
viewing a [Replay][google.cloud.policysimulator.v1.Replay]. A `Replay` is
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The link syntax [Replay][google.cloud.policysimulator.v1.Replay] is Markdown-style and is not valid in a reStructuredText (.rst) file. It will render as literal text. Please use standard RST link syntax or just backticks for the term.

Suggested change
viewing a [Replay][google.cloud.policysimulator.v1.Replay]. A `Replay` is
viewing a Replay. A Replay is


`Policy Simulator`_: Policy Simulator is a collection of endpoints for creating, running, and viewing a `Replay`. A `Replay` is a type of simulation that lets you see how your members' access to resources might change if you changed your IAM policy.
`Policy Simulator`_: Policy Simulator is a collection of endpoints for creating, running, and
viewing a [Replay][google.cloud.policysimulator.v1.Replay]. A `Replay` is
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The link syntax [Replay][google.cloud.policysimulator.v1.Replay] is Markdown-style and is not valid in a reStructuredText (.rst) file. It will render as literal text. Please use standard RST link syntax or just backticks for the term.

Suggested change
viewing a [Replay][google.cloud.policysimulator.v1.Replay]. A `Replay` is
viewing a Replay. A Replay is

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant