Skip to content

chore: preview YARD formatting fixes from gapic-generator-ruby #1337 - #36487

Closed
suztomo wants to merge 1 commit into
googleapis:mainfrom
suztomo:chore/preview-yard-formatting-fixes
Closed

chore: preview YARD formatting fixes from gapic-generator-ruby #1337#36487
suztomo wants to merge 1 commit into
googleapis:mainfrom
suztomo:chore/preview-yard-formatting-fixes

Conversation

@suztomo

@suztomo suztomo commented Aug 31, 2026

Copy link
Copy Markdown
Member

Summary

This draft PR previews code regeneration across libraries generated with the fixes in googleapis/gapic-generator-ruby#1337.

Changes

  • Escapes multi-line braces ((?<!\\)\{(?=[^\s]) -> \\{) outside backtick spans in proto docstrings, preventing multiline JSON examples and ranges (e.g. {min: ...\n...} or {100, 200, ...}) from being misparsed by YARD as broken object links.
  • Sanitizes unknown doc tags ((?<=\A|\s)@tag outside backtick spans -> `@tag`) so tags like @pattern and @required in proto comments are rendered as literal text rather than unrecognized YARD tags.

Verification

  • Ran librarian generate --all with locally installed gapic-generator gem.
  • Verified toys ci --yard --gems google-cloud-compute-v1 passes with 0 warnings and 0 errors.
  • Verified toys ci --test --rubocop --doctest --gems google-cloud-compute-v1 passes with 0 errors/failures.

Related:

@suztomo

suztomo commented Aug 31, 2026

Copy link
Copy Markdown
Member Author

Closing draft preview PR as changes are tracked in googleapis/gapic-generator-ruby#1337.

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