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

diff --git a/docs/platform/architecture.rst b/docs/platform/architecture.rst
index de36415..090536c 100644
--- a/docs/platform/architecture.rst
+++ b/docs/platform/architecture.rst
@@ -1,20 +1,23 @@
 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. _architecture:
 
 
 Architecture
 ------------
-MSB (Microservices Bus) provides 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.
+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 itself doesn’t depend on a specific environment. It can work in any bare metal, virtual machine or containerized environment.
+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 mainly comprises of three parts: Discovery, API Gateway and MSB Client SDK. MSB also provides a swagger SDK which could generate swagger REST service description files.
+
+
+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 leverages on the Consul as the service registry.
+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.
+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.