diff --git a/README.md b/README.md
index 767e122d784d35b2f440b785aa591a050fab4187..6f65f99d5f4d146ff4f055ad1dfe929c606b4bf1 100644
--- a/README.md
+++ b/README.md
@@ -27,34 +27,34 @@ Dependencies
 
 #### Checkout and build
 
-* ```git clone https://gitlab.esss.lu.se/ics-software/naming-backend.git```
-* ```cd directory```
-* ```mvn clean install```
+* `git clone https://gitlab.esss.lu.se/ics-software/naming-backend.git`
+* `cd directory`
+* `mvn clean install`
 
 #### Start application (with database)
 
 Either
 
 * start the application and database
-  * ```docker-compose up --build```
+    * `docker-compose up --build`
 
 or
 
-* make sure database available as in ```src/main/resources/application.properties```
+* make sure database available as in `src/main/resources/application.properties`
 * start the application
-  * ```java -jar target/naming-backend-*.jar```
+    * `java -jar target/naming-backend-*.jar`
 
 Then
 
-* browse to ```http://localhost:8080/swagger-ui.html```
+* browse to `http://localhost:8080/swagger-ui.html`
 
 #### Integration tests with Docker containers
 
-See ```src/test/java``` and packages
-* ```org.openepics.names.docker```
-* ```org.openepics.names.docker.complex```
+See `src/test/java` and packages
+* `org.openepics.names.docker`
+* `org.openepics.names.docker.complex`
 
-JUnit tests start a docker container for the application (Naming backend) and another docker container for the database (Postgresql) through ```docker-compose-integrationtest.yml```.
+JUnit tests start a docker container for the application (Naming backend) and another docker container for the database (Postgresql) through `docker-compose-integrationtest.yml`.
 
 ```
     @Container
@@ -67,11 +67,15 @@ Thereafter a number of http requests (GET) and curl commands (POST, PUT, PATCH,
 
 #### Note
 
-* Pre-populated database to be available if data to be available at start of application. Otherwise database may be populated through ```curl``` at command line or Swagger UI.
-  * See ```src/main/resources``` and sub folders for database scripts.
-  * If no prior database is available, see integration tests for examples on how to populate database. E.g. tests may be debugged and database content may be examined at any debug point. It's possible to backup database at such debug point and later restore it outside test. In such way, database may be set to state of choice.
+* Pre-populated database to be available if data to be available at start of application. Otherwise database may be populated through `curl` at command line or Swagger UI.
+    * See `src/main/resources` and sub folders for database scripts.
+    * If no prior database is available, see integration tests for examples on how to populate database. E.g. tests may be debugged and database content may be examined at any debug point. It's possible to backup database at such debug point and later restore it outside test. In such way, database may be set to state of choice.
 
 #### Recommentation
 
-* Have local docker-compose file for database alone if there is need to backup or restore database.
-
+* See `docs` folder to learn about about how ESS Naming Convention is implemented in Naming backend
+    * what an ESS name is and how to think about it (to better understand how to work with it)
+    * concept & terminology
+    * application architecture
+    * flow of code
+* Have local docker-compose file for database alone if there is need to backup or restore database