You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@apisix.apache.org by GitBox <gi...@apache.org> on 2021/07/03 18:51:57 UTC

[GitHub] [apisix] KishaniKandasamy opened a new issue #4526: [DISCUSS] Make parts of API URL much simpler

KishaniKandasamy opened a new issue #4526:
URL: https://github.com/apache/apisix/issues/4526


   # Improve Docs
   Hi everyone, 
   I'm currently working on [this project](https://summer.iscas.ac.cn/#/org/orgdetail/apacheapisix/proid210050255?lang=en) under the mentorship of @juzhiyuan .
   Before making any changes, It would be great with your opinions.
   
   ## Please describe which part of docs should be improved or typo fixed
   we could make the parts of API URL (in https://apisix.apache.org/docs/apisix/getting-started) in a simple view that can be easily understandable .
   
   
   ![Screenshot 2021-07-03 003026](https://user-images.githubusercontent.com/53715187/124364122-06422700-dc5d-11eb-81d2-588133b41832.jpg)
   
   
   ## Describe the solution you'd like
   We could change the above description  into something  similar to  this.
   ![marketers-guide-to-apis-api-breakdown](https://user-images.githubusercontent.com/53715187/124364163-45707800-dc5d-11eb-8768-cd954df0acdf.png)
   What do you think?
   
   
   


-- 
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: notifications-unsubscribe@apisix.apache.org

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



[GitHub] [apisix] tzssangglass commented on issue #4526: [DISCUSS] Make parts of API URL much simpler

Posted by GitBox <gi...@apache.org>.
tzssangglass commented on issue #4526:
URL: https://github.com/apache/apisix/issues/4526#issuecomment-876109359


   > Hi @tzssangglass , Thanks for the feedback but I thought we could omit port number in URLs, As if it is not given then the User may know that By default, HTTP uses port 80🤔.What do you think?
   > ![url](https://user-images.githubusercontent.com/53715187/124855058-02e4cd80-dfc6-11eb-81ad-b1975f93f209.jpg)
   
   I am afraid of ambiguity. I think adding the default port 80 to the image will remove the ambiguity.


-- 
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: notifications-unsubscribe@apisix.apache.org

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



[GitHub] [apisix] KishaniKandasamy commented on issue #4526: [DISCUSS] Make parts of API URL much simpler

Posted by GitBox <gi...@apache.org>.
KishaniKandasamy commented on issue #4526:
URL: https://github.com/apache/apisix/issues/4526#issuecomment-876079483


   > > Hi everyone What about this?
   > > ![requesturl](https://user-images.githubusercontent.com/53715187/124796106-6c38f200-df6e-11eb-9338-1707559c0eb0.jpg)
   > 
   > the port part is missing from the image
   
   Hi  @tzssangglass , Thanks for the feedback but I thought we could omit port number in URLs, As if it is not given  then the  User may know that By default, HTTP uses port 80🤔.What do you think?


-- 
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: notifications-unsubscribe@apisix.apache.org

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



[GitHub] [apisix] KishaniKandasamy edited a comment on issue #4526: [DISCUSS] Make parts of API URL much simpler

Posted by GitBox <gi...@apache.org>.
KishaniKandasamy edited a comment on issue #4526:
URL: https://github.com/apache/apisix/issues/4526#issuecomment-876079483


   > > Hi everyone What about this?
   > > ![requesturl](https://user-images.githubusercontent.com/53715187/124796106-6c38f200-df6e-11eb-9338-1707559c0eb0.jpg)
   > 
   > the port part is missing from the image
   
   Hi  @tzssangglass , Thanks for the feedback but I thought we could omit port number in URLs, As if it is not given  then the  User may know that By default, HTTP uses port 80🤔.What do you think?
   ![url](https://user-images.githubusercontent.com/53715187/124855058-02e4cd80-dfc6-11eb-81ad-b1975f93f209.jpg)
   


-- 
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: notifications-unsubscribe@apisix.apache.org

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



[GitHub] [apisix] tzssangglass commented on issue #4526: [DISCUSS] Make parts of API URL much simpler

Posted by GitBox <gi...@apache.org>.
tzssangglass commented on issue #4526:
URL: https://github.com/apache/apisix/issues/4526#issuecomment-875849483


   > Hi everyone What about this?
   > ![requesturl](https://user-images.githubusercontent.com/53715187/124796106-6c38f200-df6e-11eb-9338-1707559c0eb0.jpg)
   
   the port part is missing from the image


-- 
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: notifications-unsubscribe@apisix.apache.org

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



[GitHub] [apisix] KishaniKandasamy edited a comment on issue #4526: [DISCUSS] Make parts of API URL much simpler

Posted by GitBox <gi...@apache.org>.
KishaniKandasamy edited a comment on issue #4526:
URL: https://github.com/apache/apisix/issues/4526#issuecomment-876079483


   
   Hi  @tzssangglass , Thanks for the feedback but I thought we could omit port number in URLs, As if it is not given  then the  User may know that By default, HTTP uses port 80🤔.What do you think?
   ![url](https://user-images.githubusercontent.com/53715187/124855058-02e4cd80-dfc6-11eb-81ad-b1975f93f209.jpg)
   


-- 
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: notifications-unsubscribe@apisix.apache.org

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



[GitHub] [apisix] KishaniKandasamy commented on issue #4526: [DISCUSS] Make parts of API URL much simpler

Posted by GitBox <gi...@apache.org>.
KishaniKandasamy commented on issue #4526:
URL: https://github.com/apache/apisix/issues/4526#issuecomment-875753215


   Hi everyone What about this?
   ![requesturl](https://user-images.githubusercontent.com/53715187/124796106-6c38f200-df6e-11eb-9338-1707559c0eb0.jpg)
   


-- 
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: notifications-unsubscribe@apisix.apache.org

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



[GitHub] [apisix] KishaniKandasamy commented on issue #4526: [DISCUSS] Make parts of API URL much simpler

Posted by GitBox <gi...@apache.org>.
KishaniKandasamy commented on issue #4526:
URL: https://github.com/apache/apisix/issues/4526#issuecomment-876164390


   Yesss then It would be better doing  so:)


-- 
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: notifications-unsubscribe@apisix.apache.org

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



[GitHub] [apisix] Yiyiyimu commented on issue #4526: [DISCUSS] Make parts of API URL much simpler

Posted by GitBox <gi...@apache.org>.
Yiyiyimu commented on issue #4526:
URL: https://github.com/apache/apisix/issues/4526#issuecomment-875790579


   Hi @KishaniKandasamy sorry I failed to get which place should we change


-- 
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: notifications-unsubscribe@apisix.apache.org

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



[GitHub] [apisix] spacewander closed issue #4526: [DISCUSS] Make parts of API URL much simpler

Posted by GitBox <gi...@apache.org>.
spacewander closed issue #4526:
URL: https://github.com/apache/apisix/issues/4526


   


-- 
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: notifications-unsubscribe@apisix.apache.org

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



[GitHub] [apisix] tzssangglass commented on issue #4526: [DISCUSS] Make parts of API URL much simpler

Posted by GitBox <gi...@apache.org>.
tzssangglass commented on issue #4526:
URL: https://github.com/apache/apisix/issues/4526#issuecomment-875849131


   > Hi @KishaniKandasamy sorry I failed to get which place should we change
   
   I think he meant to turn the text description of the url, such as protocl, host, etc., into the form of an image, more intuitive.


-- 
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: notifications-unsubscribe@apisix.apache.org

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