sijie commented on issue #5791: [Issue 5638][docs] Add explanation about the v1 
REST API
URL: https://github.com/apache/pulsar/pull/5791#issuecomment-562262900
 
 
   @zymap I agree with @rdhabalia. Adding this note in user doc doesn't address 
the problem raised in #5683 . It is actually making documentation much confused.
   
   The fundamental is the restful API documentation lacks versioning. We need 
to generate the rest api documentation by versions. So people can select the 
right version when they are using restful API. Hence a better approach to 
address #5683 : 
   
   - figure out a way to generate swagger file by different versions.
   - change the website to display restful api by different versions.  

----------------------------------------------------------------
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:
[email protected]


With regards,
Apache Git Services

Reply via email to