diff --git a/README.md b/README.md
index 7b2e605..90d8c44 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,9 @@
-# metadata-proxy-deployment
+# About the proxy deployment project
+
+It is a pilot project idea running deployment in a microservice.
+The meta data frontend proxy is a web related gateway to reach backend services from the public internet via http/https.
+
+The proxy service is complex and has many parameters to configure by users.
+
+There is two important parts