zbentley opened a new issue, #19466:
URL: https://github.com/apache/pulsar/issues/19466

   ### Search before asking
   
   - [X] I searched in the [issues](https://github.com/apache/pulsar/issues) 
and found nothing similar.
   
   
   ### What issue do you find in Pulsar docs?
   
   Two issues:
   
   1. The API docs for 
[`https://pulsar.apache.org/admin/v2/namespaces/{tenant}/{namespace}/properties`](Get
 key value pair properties for a given namespace.
   ) say:
   
   > Get key value pair properties for a given namespace.
   
   But that's not quite what that endpoint does; that endpoint gets the *entire 
namespace config*, including properties and everything else. Which is very 
useful, but unrelated to the "properties" APIs listed below that.
   
    2. The API docs for [namespace property 
deletion](https://pulsar.apache.org/admin-rest-api/#operation/removeProperty) 
say:
    
    > Get property value for a given key on a namespace.
   
   This is inaccurate; that API deletes things, and does not get them.
   
   ### What is your suggestion?
   
   1. Update the docs for `/properties` to be clearer that it returns the 
entire namespace config including properties.
   2. Update the description string for the properties-delete API to be 
accurate.
   
   ### Any reference?
   
   _No response_
   
   ### Are you willing to submit a PR?
   
   - [ ] I'm willing to submit a PR!


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

Reply via email to