Hi all! Question for the devs - Ive rasied an issue about the pulsar REST documentation being incorrectly rendered ages ago (and I presume its somewhere lost in github issues), and just want to see if theres a better place to raise it again. TLDR: the correct documentation at https://pulsar.apache.org/admin-rest-api is actually accessed by most users through pulsar.apache.org/docs/, it is imported from the former site incorrectly and provides incorrect URLs. As an example, pulsar keeps telling me about Incompatible Schemas, so I'm just trying to turn off schema validation. According to here I should POST to

"schemaValidationEnforced": "false"

over to

/admin/v2/namespaces/:tenant/:namespace/schemaValidationEnforced/Namespaces_setSchemaValidationEnforced

According to the second link I should POST

false

to

/admin/v2/namespaces/{tenant}/{namespace}/schemaValidationEnforced

Not only is the URL different, (and indeed the first link is almost immediately wrong), but the json payload is different too. It'd be great if the main page documentation could get fixed to spare others the pain me and my team have experienced by trusting the docs

Hi @Samuel Hinton, You’re right, the docs look incorrect. I created a new tracking issue: https://github.com/apache/pulsar/issues/22289 I described the ways I see we could fix that, but it requires an investigation of how to better deal with it. I’ll take a look later on this week. You mentioned that you’ve already opened an issue on GitHub, but were unable to find it. Please filter the issue list by your GitHub username and send me a link.

Hmm the only issue I see attached to my username is https://github.com/apache/pulsar/issues/22129, so I wonder if I've been a dunce and raised it on a client repo by accident, as Ive raised a few on the C++ and python repos. I'll see if I can hunt it down

If you have something to add to the issue itself, please do it on GitHub for better visibility.