navendu-pottekkat commented on code in PR #7568:
URL: https://github.com/apache/apisix/pull/7568#discussion_r943579108


##########
docs/en/latest/architecture-design/apisix.md:
##########
@@ -21,25 +25,160 @@ title: APISIX
 #
 -->
 
-## Apache APISIX : Software Architecture
+APISIX is built on top of Nginx and 
[ngx_lua](https://github.com/openresty/lua-nginx-module) leveraging the power 
offered by LuaJIT. See [Why Apache APISIX chose Nginx and Lua to build API 
Gateway?](https://apisix.apache.org/blog/2021/08/25/why-apache-apisix-chose-nginx-and-lua/).
+
+![flow-software-architecture](https://raw.githubusercontent.com/apache/apisix/master/docs/assets/images/flow-software-architecture.png)
+
+APISIX has two main parts:
+
+1. APISIX core, Lua plugin, multi-language Plugin runtime, and the WASM plugin 
runtime.
+2. Built-in Plugins that adds features for observability, security, traffic 
control, etc.
+
+The APISIX core handles the important functions like matching Routes, load 
balancing, service discovery, configuration management, and provides a 
management API. It also includes APISIX Plugin runtime supporting Lua and 
multilingual Plugins (Go, Java , Python, JavaScript, etc) including the 
experimental WASM Plugin runtime.
+
+APISIX also has a set of [built-in 
Plugins](https://apisix.apache.org/docs/apisix/plugins/batch-requests) that 
adds features like authentication, security, observability, etc. They are 
written in Lua.
+
+## Deployment modes

Review Comment:
   Should we then move the entire deployment modes section to the root of the 
docs? Or should we move it to the installation docs.
   
   Since this feature is not enabled by default, we should consider that as 
well. Maybe refactor installation docs in v3 release mentioning deployment 
modes by default? We can add it in the next steps section after configuring 
APISIX. What do you guys 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: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to