[GitHub] [apisix] nfrankel commented on a diff in pull request #7568: docs: update Architecture docs

[GitBox <gi...@apache.org>]

nfrankel commented on code in PR #7568:
URL: https://github.com/apache/apisix/pull/7568#discussion_r943488849


##########
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:
   Agreed with @juzhiyuan. Though architecture and deployment may be related, they are different concerns.
   
   As a first-time visitor, I'm much more interested in the architecture (_e.g._, plugin-based) than in how to deploy. Only when my interest is piqued will I review the different deployment options.



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