X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Fplatform%2Farchitecture.rst;h=090536c91f194bd5f738ed495c56dbf15a4e6180;hb=4099f574f7e2495ee2d98ef46e6270cde8d10d49;hp=9fd6b0abd03669c679b3168201824ecde8194efa;hpb=059a62b44e4edbec2f24c5edfe1000088816babd;p=msb%2Fapigateway.git

diff --git a/docs/platform/architecture.rst b/docs/platform/architecture.rst
index 9fd6b0a..090536c 100644
--- a/docs/platform/architecture.rst
+++ b/docs/platform/architecture.rst
@@ -1,15 +1,23 @@
 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. _architecture:
 
 
 Architecture
 ------------
-MSB(Microservices Bus) provide a comprehensive, end to end solution to support ONAP microservice architecture including service registration/discovery, external gateway, internal gateway, client SDK. It's a pluggable architecture so it can integrate with auth service provider to provide centralized Authentication & Authorization. MSB also provides a service portal to manage the REST APIs.
-MSB itself doesn’t depend on a specific environment. It can work in any bare metal, virtual machine or containerized environment.  	
-MSB mainly comprises three parts: Discovery, API Gateway and MSB Client SDK. MSB also provide a swagger SDK which could generate swagger REST service description files.
+Microservices Bus(MSB) provides a reliable, resilient and scalable communication and governance infrastructure to support ONAP Microservice Architecture including service registration/discovery, external API gateway, internal API gateway, client SDK, Swagger SDK, etc. It's a pluggable architecture, plugins can be added to MSB to provide whatever functionalities you need, such as an auth plugin can be used to provide centralized authentication & authorization. MSB also provides a service portal to manage the REST APIs.
+
+MSB is platform independent, while it is integrated with Kubernetes(OOM) to provide transparent service registration for ONAP microservices, MSB also supports OpenStack(Heat) and bare metal deployment.
+
+
+
+MSB is mainly comprised of three parts: Discovery, API Gateway and MSB Client SDK. MSB also provide a swagger SDK which could generate swagger REST service description files..
 
 .. image:: images/msb-architecture.png
 
 Registry is the storage of service information, MSB leverage Consul as the service registry.
+
 MSB Discovery provides REST APIs for service discovery and registration.
-Service Gateway provides service request routing, load balancing and centralized Auth. It can be deployed as external Gateway or Internal Gateway.
-MSB SDK is a client-side Java SDK which can be used for point to point communication of microservices.
\ No newline at end of file
+
+API Gateway provides service request routing, load balancing and service governance. It can be deployed as external Gateway or Internal Gateway.
+
+MSB SDK is a client-side Java SDK which can be used for point to point communication of microservices.