diff --git a/README.md b/README.md
index 3bbc55f28..57bed69db 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
# Distributed version of the Spring PetClinic Sample Application built with Spring Cloud
-[![Build Status](https://travis-ci.org/spring-petclinic/spring-petclinic-microservices.svg?branch=master)](https://travis-ci.org/spring-petclinic/spring-petclinic-microservices/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![Dependency Status](https://www.versioneye.com/user/projects/58b2c56f9ceb450031272d6a/badge.svg?style=flat-square)](https://www.versioneye.com/user/projects/58b2c56f9ceb450031272d6a)
+[![Build Status](https://travis-ci.org/spring-petclinic/spring-petclinic-microservices.svg?branch=master)](https://travis-ci.org/spring-petclinic/spring-petclinic-microservices/) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
This microservices branch was initially derived from [AngularJS version](https://github.com/spring-petclinic/spring-petclinic-angular1) to demonstrate how to split sample Spring application into [microservices](http://www.martinfowler.com/articles/microservices.html). To achieve that goal we used [Spring Cloud Netflix](https://github.com/spring-cloud/spring-cloud-netflix) technology stack.
@@ -30,12 +30,21 @@ available by default at http://localhost:8761.
*NOTE: Under MacOSX or Windows, make sure that the Docker VM has enough memory to run the microservices. The default settings
are usually not enough and make the `docker-compose up` painfully slow.*
-## Understanding the Spring Petclinic application with a few diagrams
-See the presentation here
+## Understanding the Spring Petclinic application
+
+[See the presentation of the Spring Petclinic Framework version](http://fr.slideshare.net/AntoineRey/spring-framework-petclinic-sample-application)
+
+[A blog bost introducing the Spring Petclinic Microsevices](http://javaetmoi.com/2018/10/architecture-microservices-avec-spring-cloud/) (french language)
You can then access petclinic here: http://localhost:8080/
-
+![Spring Petclinic Microservices screenshot](docs/application-screenshot.png)
+
+
+**Architecture diagram of the Spring Petclinic Microservices**
+
+![Spring Petclinic Microservices architecture](docs/microservices-architecture-diagram.jpg)
+
## In case you find a bug/suggested improvement for Spring Petclinic Microservices
diff --git a/docs/application-screenshot.png b/docs/application-screenshot.png
new file mode 100644
index 000000000..e60a403e2
Binary files /dev/null and b/docs/application-screenshot.png differ
diff --git a/docs/microservices-architecture-diagram.jpg b/docs/microservices-architecture-diagram.jpg
new file mode 100644
index 000000000..a3b842e81
Binary files /dev/null and b/docs/microservices-architecture-diagram.jpg differ