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 2019/12/05 19:27:07 UTC

[GitHub] [pulsar] sijie edited a comment on issue #5791: [Issue 5638][docs] Add explanation about the v1 REST API

sijie edited a comment 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 problem 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:
users@infra.apache.org


With regards,
Apache Git Services