jak78 opened a new issue, #21561: URL: https://github.com/apache/pulsar/issues/21561
### Search before asking - [X] I searched in the [issues](https://github.com/apache/pulsar/issues) and found nothing similar. ### What issue do you find in Pulsar docs? Per the following discussion: https://github.com/apache/pulsar/discussions/21560 Uploading a valid schema can be challenging. The upload API does not provide much feedback when you upload an invalid schema. That does not help in figuring out why the schema is invalid. However, an endpoint exists, and it does precisely that. But this option is not mentioned on the primary doc that most developers read: https://pulsar.apache.org/docs/next/admin-api-schemas/ Developers might need some time to locate it, if they manage to find it at all. ### What is your suggestion? To improve developer experience, I would suggest adding a `test a schema` section on the following page: https://pulsar.apache.org/docs/next/admin-api-schemas/ I would recommend adding it just before the `upload a schema section`. ### Any reference? Discussion: https://github.com/apache/pulsar/discussions/21560 Endpoint spec: https://pulsar.apache.org/admin-rest-api/?version=3.1.1#operation/SchemasResource_testCompatibility ### Are you willing to submit a PR? - [X] I'm willing to submit a PR! -- 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]
