diff --git a/README.md b/README.md
index c2f26af0f..80832f6ef 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
# Distributed version of the Spring PetClinic Sample Application built with Spring Cloud
-[](https://travis-ci.org/spring-petclinic/spring-petclinic-microservices/) [](https://opensource.org/licenses/Apache-2.0) [](https://www.versioneye.com/user/projects/58b2c56f9ceb450031272d6a)
+[](https://travis-ci.org/spring-petclinic/spring-petclinic-microservices/) [](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/
-
+
+
+
+**Architecture diagram of the Spring Petclinic Microservices**
+
+
+
## 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