Skip to content

fix(gapic-generator): Indent note in the Config#credentials attribute properly - #1319

Open
dazuma wants to merge 2 commits into
googleapis:mainfrom
dazuma:pr/note
Open

fix(gapic-generator): Indent note in the Config#credentials attribute properly#1319
dazuma wants to merge 2 commits into
googleapis:mainfrom
dazuma:pr/note

Conversation

@dazuma

@dazuma dazuma commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Fixes the indentation on a multi-line @note yard tag. Without proper indentation, only the first line gets included in the note, while the remaining lines are orphaned into the general description of the method. (For an example of what this looks like, see https://rubydoc.info/gems/google-cloud-secret_manager-v1/Google/Cloud/SecretManager/V1/SecretManagerService/Client/Configuration#credentials-instance_method — the second warning note on the credentials method is cut off mid-sentence, and the remainder of the note appears below just above the examples.)

I found this as I was using secret_manager-v1 as a test case in a YARD plugin I'm working on.

Hope y'all are doing well!

@dazuma
dazuma requested a review from a team as a code owner July 21, 2026 19:43
@aandreassa

Copy link
Copy Markdown
Contributor

/gcbrun

Thanks @dazuma, we appreciate the contribution! We will likely hold-off until next week at least, since we have a couple changes in-flight. Adding do not merge for now!

@aandreassa aandreassa added the do not merge Indicates a pull request not ready for merge, due to either quality or timing. label Jul 21, 2026
@dazuma

dazuma commented Jul 22, 2026

Copy link
Copy Markdown
Contributor Author

/gcbrun

Thanks @dazuma, we appreciate the contribution! We will likely hold-off until next week at least, since we have a couple changes in-flight. Adding do not merge for now!

@aandreassa No worries. This would trigger a regen of every gapic, so y'all would want to manage it carefully.

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

Labels

do not merge Indicates a pull request not ready for merge, due to either quality or timing.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants