mchades opened a new pull request, #14667: URL: https://github.com/apache/gravitino/pull/14667
### What changes were proposed in this pull request? - Document fileset default-location selection, including inherited locations; add `removeComment`, missing-location errors and disabled-filesystem behavior. - Add shared 403/406 responses and operation-specific 501 responses with JSON error examples. - Clarify authorization-dependent 404 responses and partition purge support; remove the inapplicable `alterTopic` already-exists 409 response. ### Why are the changes needed? The OpenAPI definitions omit supported requests and error responses and contain incorrect defaults. Fixes #14666 ### Does this PR introduce _any_ user-facing change? Documentation/OpenAPI changes only. Server behavior is unchanged. ### How was this patch tested? - `./gradlew :docs:spotlessApply :docs:build`. - 42 existing tests passed: `TestVersioningFilter`, `TestWebApplicationExceptionMapper`, and selected `TestFilesetCatalogOperations` cases. - Validated 16 operations, 72 error-example references, two create examples and the `removeComment` schema. - `git diff --check`. Full server, Kafka and Hive integration tests were not run. -- 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]
