diff --git a/api/README.md b/api/README.md
index f3c7b79..e37e6be 100644
--- a/api/README.md
+++ b/api/README.md
@@ -1,6 +1,14 @@
-# YLEM API
-1. OAuth-server. Allows issuing OAuth tokens for customers' applications
-2. API gateway. Checks OAuth authorization token, checks for allowed scopes, proxies the request to backend APIs.
+# YLEM API MICROSERVICE
+
+
+
+
+
+
+
+It combines two functionalities
+1. OAuth-server that allows issuing OAuth tokens for customers' applications and provides an API for the UI to be used for it.
+2. API gateway responsible for checking OAuth authorization token validity, checking for allowed scopes, and proxying the request to backend APIs.
## Run tests
@@ -14,7 +22,7 @@ $ go test ./tests/... -v -vet=off
$ go test ./tests/... -coverpkg=./...
```
-Or if you want an advanced coverage report
+## Run tests with an advanced coverage report
``` bash
$ go test ./tests/... -coverpkg=./... -coverprofile cover.out