[GitHub] [pulsar] visortelle opened a new issue, #19406: [Doc] "pulsar-admin schemas delete" description is confusing

[via GitHub]

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

   ### 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?
   
   Documentation tells me that all schema versions will be deleted. That's 
indeed how it works now.
   
   <img width="845" alt="Screenshot 2023-02-02 at 4 58 09 PM" 
src="https://user-images.githubusercontent.com/9302460/216375269-690c8d1f-1259-45cc-9bf8-703eb2a2f166.png";>
   
   Pulsar admin tells me that only the latest schema will be deleted.
   
   <img width="481" alt="Screenshot 2023-02-02 at 4 57 15 PM" 
src="https://user-images.githubusercontent.com/9302460/216374991-f8a1e0db-d230-4235-beff-dcef89eb9543.png";>
   
   
https://github.com/apache/pulsar/blob/81af293c842c1fc7f42e13ac4203f287e4b619bb/pulsar-client-tools/src/main/java/org/apache/pulsar/admin/cli/CmdSchemas.java#L77
   
   I'm confused. Is it a mistake, or does "latest schema" doesn't mean "latest 
schema version"?
   
   It's easy to misunderstand it and delete all schemas accidentally.
   
   
   
   ### What is your suggestion?
   
   Make the pulsar-admin flag description more descriptive.
   
   ### 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: commits-unsubscr...@pulsar.apache.org.apache.org

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