Skip to content

feat(release): add --docs-only flag to perform tool - #445

Open
codyoss wants to merge 1 commit into
googleapis:mainfrom
codyoss:docs-only
Open

feat(release): add --docs-only flag to perform tool#445
codyoss wants to merge 1 commit into
googleapis:mainfrom
codyoss:docs-only

Conversation

@codyoss

@codyoss codyoss commented Aug 4, 2026

Copy link
Copy Markdown
Member

Add the --docs-only flag to toys release perform to support the Exit Gate two-stage release workflow, allowing documentation (YARD and Cloud RAD) to be built and published independently of releasing the gem.

Key changes:

  • Add --docs-only flag to toys/release/perform.rb.
  • Bypass version checking, skip gem publishing, and force doc publishing when --docs-only is set.
  • Remove include :gems from toys/release/perform.rb to resolve method name collision with the :gems CLI flag.
  • Improve transform_links exception safety to ensure markdown link transformations are reverted even if an error occurs midway.
  • Add integration tests in test/release_perform_test.rb.

@codyoss
codyoss force-pushed the docs-only branch 8 times, most recently from 41696ea to 54290d1 Compare August 10, 2026 16:28
Add the `--docs-only` flag to `toys release perform` to support the Exit
Gate two-stage release workflow, allowing documentation (YARD and Cloud RAD)
to be built and published independently of releasing the gem.

Key changes:
- Add `--docs-only` flag to `toys/release/perform.rb`.
- Bypass version checking, skip gem publishing, and force doc publishing
  when `--docs-only` is set.
- Remove `include :gems` from `toys/release/perform.rb` to resolve method
  name collision with the `:gems` CLI flag.
- Improve `transform_links` exception safety to ensure markdown link
  transformations are reverted even if an error occurs midway.
- Add integration tests in `test/release_perform_test.rb`.
- Add test dependencies (`toys`, `gems`, `jwt`) to `Gemfile`.
- Add `/vendor/` to `.gitignore`.
@codyoss
codyoss marked this pull request as ready for review August 10, 2026 17:10
@codyoss
codyoss requested a review from a team as a code owner August 10, 2026 17:10
@codyoss
codyoss requested a review from quartzmo August 10, 2026 17:10
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