1502shivam-singh commented on a change in pull request #6554:
URL: https://github.com/apache/apisix/pull/6554#discussion_r824110161



##########
File path: docs/en/latest/getting-started.md
##########
@@ -19,7 +19,41 @@ title: Getting Started
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
--->
+-->  
+
+## What is an API Gateway?
+An API gateway is an API management tool that acts as a mid layer service 
between a client and a number backend services. Typically, the API gateway 
receives the clients requests and processes it by summoning multiple 
microservices, aggregating the services & returning the appropriate results.
+
+## What is Apache APISIX
+Apache APISIX is an open source, dynamic, high-performance, and scalable 
7-layer proxy. It is a cloud-native API gateway, that delivers the ultimate 
performance for all your APIs and microservices. Think of APISIX as a service 
bus that connects APIs and microservices in your cloud-native architecture.

Review comment:
       This is fine, but the language here could be kept layman here I guess. 
Something like `7-layer proxy` might intimidate people when used with words 
like dynamic, high-performance etc. My suggestion would be to save it for later 
in the sentence (or maybe leave it out entirely) and just use `API Gateway` 
here. 
   
   ```suggestion
   Apache APISIX is an open source, dynamic and high-performance cloud-native 
API gateway that delivers the ultimate performance for all your APIs and 
microservices. Think of APISIX as a service bus that connects APIs and 
microservices in your cloud-native architecture.
   ```




-- 
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]


Reply via email to