lhotari opened a new pull request, #970: URL: https://github.com/apache/pulsar-site/pull/970
Fixes apache/pulsar#21573 All REST API urls are incorrect in the documentation. This PR fixes the URLs for next, 4.0.x and 3.0.x. This PR adds a custom Remark plugin that handles logic to lookup the correct URL from the Swagger JSON file so that it's always correct. The plugin is written in Typescript and to do that, the docusaurus config was converted to `.ts` extension and made compatible. There's a remaining problem that the Swagger files contain a lot of duplicate operations even after apache/pulsar#19193. The links to Swagger documentation won't work when there are duplicates, which is very common. A replacement will be needed in apache/pulsar for the Swagger generation to fix it. The duplicate operation names required adding ways to find the correct operation in the custom Remark plugin. This PR replaces the previous draft PR #866. -- 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]
