You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pulsar.apache.org by GitBox <gi...@apache.org> on 2021/03/23 23:06:53 UTC

[GitHub] [pulsar] michaeljmarshall opened a new issue #10023: [Docs] Missing Valid Namespaces Subcommand in Pulsar admin CLI Documentation

michaeljmarshall opened a new issue #10023:
URL: https://github.com/apache/pulsar/issues/10023


   **Describe the bug**
   The `set-inactive-topic-policies` subcommand is only shown as a `topics` command and not as a `namespaces` command in the pulsar-admin docs: https://pulsar.apache.org/docs/en/pulsar-admin/.
   
   I know it is a valid subcommand by looking at the source code as well as looking at the available `bin/pulsar-admin namespaces` commands.
   
   **To Reproduce**
   Steps to reproduce the behavior:
   1. Go to https://pulsar.apache.org/docs/en/pulsar-admin/
   2. Search for `set-inactive-topic-policies`
   3. Observer that it is only listed for the `topics` command
   
   **Expected behavior**
   I would expect the pulsar-admin docs to include all available sub commands.
   
   **Additional context**
   I believe these docs are generated, so perhaps something is wrong with the generation.
   
   I'm happy to help look into this issue sometime this week, but I'm unable to do so today.


-- 
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.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [pulsar] michaeljmarshall commented on issue #10023: [Docs] Missing Valid Namespaces Subcommand in Pulsar admin CLI Documentation

Posted by GitBox <gi...@apache.org>.
michaeljmarshall commented on issue #10023:
URL: https://github.com/apache/pulsar/issues/10023#issuecomment-807002931


   > I think we should add some type of banner or notice at the top of that page to redirect users to the new resource.
   
   I posted a review on https://github.com/apache/pulsar/pull/10037, so no need to respond here.


-- 
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.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [pulsar] michaeljmarshall commented on issue #10023: [Docs] Missing Valid Namespaces Subcommand in Pulsar admin CLI Documentation

Posted by GitBox <gi...@apache.org>.
michaeljmarshall commented on issue #10023:
URL: https://github.com/apache/pulsar/issues/10023#issuecomment-806944862


   @Anonymitaet - I didn't realize there was a difference. Thank you for pointing that out. I think we should add some type of banner or notice at the top of that page to redirect users to the new resource. What do you think about that?


-- 
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.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [pulsar] Anonymitaet commented on issue #10023: [Docs] Missing Valid Namespaces Subcommand in Pulsar admin CLI Documentation

Posted by GitBox <gi...@apache.org>.
Anonymitaet commented on issue #10023:
URL: https://github.com/apache/pulsar/issues/10023#issuecomment-806530823


   @michaeljmarshall The Pulsar Admin CLI page is deprecated (2.8.0: https://github.com/apache/pulsar/pull/9813, 2.7.1: https://github.com/apache/pulsar/pull/10037) since the contents of this page lag far behind code. The latest commands and descriptions of Pulsar Admin are shown on the [pulsar-admin website](http://pulsar.apache.org/tools/pulsar-admin/2.8.0-SNAPSHOT/). Users can navigate to that site to get accurate and complete info.


-- 
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.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [pulsar] Anonymitaet closed issue #10023: [Docs] Missing Valid Namespaces Subcommand in Pulsar admin CLI Documentation

Posted by GitBox <gi...@apache.org>.
Anonymitaet closed issue #10023:
URL: https://github.com/apache/pulsar/issues/10023


   


-- 
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.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org