juzhiyuan commented on issue #5535: URL: https://github.com/apache/apisix/issues/5535#issuecomment-971135124
Hi @lishaoshu1240, thanks for your comment about Apache APISIX's docs. Yes, some concepts are mixed together and will confuse not only you but also me in the beginning. First, let me explain this issue to you. Upstream and Route are two different entities in Apache APISIX, and the Route entity has 2 properties called `upstream` and `upstream_id`: - `Route.upstream`: You could pass a complete Upstream Entity's data to it; - `Route.upstream_id`: You could first create an Upstream Entity, and then use `Route.upstream_id` to **reference** it, so you don't need to create duplicated `Route.upstream` over and over again. Second, for now, Apache APISIX's documentation is not good and friendly as other products indeed, it mainly meets this case now: How to use Apache APISIX and What APIs it has? I and you and other users would focus on if it could be better for a long time, but I would like to know how to implement this destination? In my own opinion, it needs all of us including contributors and users to give feedbacks on how to improve those documentations like you, like this Issue does :) Third, welcome all kinds of contributions to Apache APISIX's codes, docs, and communities, etc. -- 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]
