Hi Michael,
Since we have a CLI website
<http://pulsar.apache.org/tools/pulsar-admin/2.8.0-SNAPSHOT/> to display
all the `pulsar-admin` commands and usage, we'd like to remove the Pulsar
Admin CLI tool page from the Pulsar Reference page. For details, refer to
PR-9813 <https://github.com/apache/pulsar/pull/9813>.

Thank you very much for your support. If you have any other concern, feel
free to let us know.

Best Regards,
Jennifer


On Wed, Mar 3, 2021 at 6:27 PM Jinfeng Huang <[email protected]> wrote:

> Hi Michael,
> Thank you very much for bringing this to our attention.
>
> You've made a very good point here. Currently, we keep Admin API and
> pulsar-admin reference as two parts: The Admin API tells users that they
> can interact with admin interface via pulsar-admin, REST API and client. It
> lists some generic operations and part of examples. It’s not complete, and
> some features supported by pulsar-admin are not supported by clients. So on
> the Admin API overview page
> <https://pulsar.apache.org/docs/en/next/admin-api-overview/>, we add a
> reference link and tell users to check the pulsar-admin reference page for
> detailed usage. The pulsar-admin reference page
> <https://pulsar.apache.org/docs/en/pulsar-admin/> can be used as
> wikipedia, which tries to collect all different command usage. (We're
> trying to abstract command usage from the code automatically, if someone is
> interested in it, looking forward to your contribution~)
>
> In the long run, if the Pulsar community has a plan to support all
> features equally by pulsar-admin, REST API and client, we can consider
> listing all different usage  supported by the pulsar-admin, REST API and
> java client in the Admin API section, and remove the pulsar-admin
> reference.
>
> Best Regards,
> Jennifer
>
>
> On Fri, Feb 26, 2021 at 11:44 PM Michael Marshall <[email protected]>
> wrote:
>
>> Just want to clarify that I was confused because there are two sections
>> on the pulsar website that document the Admin API for namespaces, and one
>> has more information than the other.
>>
>> Admin API Namespaces:
>> https://pulsar.apache.org/docs/en/admin-api-namespaces/
>>
>> Pulsar Admin CLI tool:
>> https://pulsar.apache.org/docs/en/pulsar-admin/#namespaces-1
>>
>> The first appears to be client agnostic, as it documents REST, the
>> pulsar-admin cli tool, and the Java api, and the second is just documenting
>> the pulsar-admin cli tool. While the first seems to be more generic, the
>> second is the one that documents more features, including the one for which
>> I was looking.
>>
>> I know there is already an effort to improve the documentation on the
>> website, and I just want to make sure to call this out as a bit confusing.
>> I definitely didn't realize these pages would have different information.
>>
>> Thanks,
>> Michael
>>
>> On Fri, Feb 26, 2021 at 12:11 AM Michael Marshall <[email protected]>
>> wrote:
>>
>>> I just double checked the documentation, and I had missed the admin
>>> command that solves my question. No need for any help or replies at this
>>> point.
>>>
>>> It’s defined at the following link, in case anyone needs the reference.
>>>
>>> http://pulsar.apache.org/docs/en/pulsar-admin/#set-auto-topic-creation
>>>
>>> Thanks,
>>> Michael
>>>
>>> On Feb 25, 2021, at 11:31 PM, Michael Marshall <[email protected]>
>>> wrote:
>>>
>>> 
>>> Hello,
>>>
>>> I'm looking to set namespace level overrides for auto topic creation,
>>> but I can't seem to find any documentation on how to do so. I see the
>>> "AutoTopicCreationOverride" class in the project, so it looks like it
>>> should be possible to override the default settings. Can anyone point me to
>>> documentation or share a way to update these overrides?
>>>
>>> Thanks!
>>> Michael Marshall
>>>
>>>

Reply via email to