[Doc] The rendering of REST APIs is wrong

[BewareMyPower]

Search before asking

• I searched in the issues and found nothing similar.

What issue do you find in Pulsar docs?

For example, see https://pulsar.apache.org/docs/3.0.x/admin-api-schemas/#set-schema-compatibility-check-strategy

The original document is:

Send a `GET` request to this endpoint: {@inject: endpoint|GET|/admin/v2/namespaces/:tenant/:namespace|operation/schemaCompatibilityStrategy?version=@pulsar:version_number@}

However, the website only shows GET|/admin/v2/namespaces/:tenant/:namespace. The complete URL path should be GET|/admin/v2/namespaces/:tenant/:namespace/schemaCompatibilityStrategy.

Besides, the query params are ignored as well but I think they are not important.

What is your suggestion?

We should parse the REST API after the @inject annotation with a correct way.

Any reference?

No response

Are you willing to submit a PR?

• I'm willing to submit a PR!

[tisonkun]

I don't have too much time to fix it and I postpone it previously for waiting to the website redesign. Now the redesign is landed we can proceed this issue.

It's related about this code snippet when I first take a look at it:

You can try to propose a solution or I'm hopefully handle it in days.

[sunheyi6]

@tisonkun cc my pr

[tisonkun]

Thanks for your contribution @shy-share! Merged.