Anonymitaet commented on pull request #11106: URL: https://github.com/apache/pulsar/pull/11106#issuecomment-870415998
Hi @gmethvin thanks for your suggestions. I've submitted a PR (https://github.com/apache/pulsar/pull/11146) to fix the issues you mentioned as below, could you please help review the PR? Many thanks 1. On this page (https://pulsar.apache.org/docs/en/pulsar-admin/), I've added some explanations about this page is deprecated and the info about how users can get the latest and complete info. 2. Replace https://pulsar.apache.org/docs/en/pulsar-admin/ with http://pulsar.apache.org/tools/pulsar-admin/ in multiple docs to direct users to the correct place. 3. Admin API chapters (https://pulsar.apache.org/docs/en/next/admin-api-overview/) are in the same situation, I've added the explanations and direct users to the correct place. Adding contents to Admin API chapters manually is time-consuming and error-prone. Moreover, it is not easy and changeling for writers to catch up all code changes and sync them with docs. If the Admin API pages can be generated from code automatically, that would be more efficient. 4. Besides, I've updated some contents and fixed some wrong links. P.S. for your PR, it would be much appreciated if you can add explanations in the code files correspondingly. -- 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: commits-unsubscr...@pulsar.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
