MonkeyCanCode opened a new pull request, #3951: URL: https://github.com/apache/polaris/pull/3951
<!-- ๐ Describe what changes you're proposing, especially breaking or user-facing changes. ๐ See https://github.com/apache/polaris/blob/main/CONTRIBUTING.md for more. --> With recent project graduation and released doc change, these break the API docs for older released version such as following when accessing API docs for 1.3.0: ``` -- https://polaris.apache.org/releases/1.3.0/polaris-api-specs/polaris-management-api/ https://editor.swagger.io/?url=https://raw.githubusercontent.com/apache/polaris/refs/tags/polaris-1.3.0/spec/polaris-management-service.yml -- https://polaris.apache.org/releases/1.3.0/polaris-api-specs/polaris-catalog-api/ https://editor.swagger.io/?url=https://raw.githubusercontent.com/apache/polaris/refs/tags/polaris-1.3.0/spec/generated/bundled-polaris-catalog-service.yaml ``` There are two problems here: 1. the older released are on `-incubating` tags but the current code will use the one without (is we want to remove incubating, we should create tags for the corresponding old tags) 2. the tag names are `apache-polaris-xxx` instead of `polaris-xxx` With above changes, we will then have following: ``` -- http://localhost:1313/releases/1.3.0/polaris-api-specs/polaris-management-api/ https://editor.swagger.io/?url=https://raw.githubusercontent.com/apache/polaris/refs/tags/apache-polaris-1.3.0-incubating/spec/polaris-management-service.yml -- http://localhost:1313/releases/1.3.0/polaris-api-specs/polaris-catalog-api/ https://editor.swagger.io/?url=https://raw.githubusercontent.com/apache/polaris/refs/tags/apache-polaris-1.3.0-incubating/spec/generated/bundled-polaris-catalog-service.yaml ``` <img width="2546" height="784" alt="image" src="https://github.com/user-attachments/assets/c11d9a84-3283-4331-9f91-dc6901528b98"; /> <img width="2546" height="784" alt="image" src="https://github.com/user-attachments/assets/a2b88008-aa6f-4216-9ddd-1a8b2b434b70"; /> ## Checklist - [x] ๐ก๏ธ Don't disclose security issues! (contact [email protected]) - [x] ๐ Clearly explained why the changes are needed, or linked related issues: Fixes # - [x] ๐งช Added/updated tests with good coverage, or manually tested (and explained how) - [x] ๐ก Added comments for complex logic - [x] ๐งพ Updated `CHANGELOG.md` (if needed) - [x] ๐ Updated documentation in `site/content/in-dev/unreleased` (if needed) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
