-
Notifications
You must be signed in to change notification settings - Fork 79
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[OpenAPI] Add list of tags in overlay #2905
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Couple of comments on funny things, otherwise LGTM
also noting for posterity that trying to preview this with make overlay-docs
didn't work for me locally and might need some love to get runnable
Following you can find the validation results for the APIs you have changed.
You can validate these APIs yourself by using the |
Following you can find the validation results for the APIs you have changed.
You can validate these APIs yourself by using the |
Following you can find the validation results for the APIs you have changed.
You can validate these APIs yourself by using the |
The backport to
To backport manually, run these commands in your terminal: # Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-8.x 8.x
# Navigate to the new working tree
cd .worktrees/backport-8.x
# Create a new branch
git switch --create backport-2905-to-8.x
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick -x --mainline 1 4a0eaef2ce8604220d5e089a69a0c2744a00077d
# Push it to GitHub
git push --set-upstream origin backport-2905-to-8.x
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-8.x Then, create a pull request where the |
Relates to #2310
As a follow-on to #2961, this PR adds
@doc_tag
values where we want to override the default tags. There are a few remaining (e.g.health_report
,mget
,mtermvectors
) that we can't override yet because the typescript files for those APIs don't exist yet.This PR also adds the missing document-level list of tags via an overlay. Doing this in an overlay is not perfect since it means that new tags must be manually added. Any endpoints associated with tags that do not appear in this list will not be published on Bump.sh. I've therefore also changed the operation-tag-defined linting rule to an error instead of a warning.
I've also changed the make commands to only lint the OpenAPI documents that have overlays applied, since the others will contain errors that are fixed by the overlays.
NOTE: Even though the list of tags used differs in the two OpenAPI documents (e.g. some endpoints do not exist in the serverless context), it seems okay to use a single tag list since I've tested in Bump.sh and any tags for which there aren't any endpoints are simply omitted.