Updated docs

Author: avara1986

README.md

@@ -9,6 +9,10 @@
 [![Total alerts](https://img.shields.io/lgtm/alerts/g/python-microservices/pyms.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/python-microservices/pyms/alerts/)
 [![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/python-microservices/pyms.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/python-microservices/pyms/context:python)
 
+PyMS, Python MicroService, is a collections of libraries, best practices and recommended ways to build 
+microservices with Python.
+
+To know how use, install or build a porject see the docs (TODO: add url to readthedocs)
 
 ## Installation 
 ```bash
@@ -35,3 +39,20 @@ Encapsulate common rest operations between business services propagating trace h
 
 ### pyms/tracer
 Create an injector `flask_opentracing.FlaskTracer` to use in our projects
+
+## Documentation
+
+This project use MkDocs
+
+* `mkdocs new [dir-name]` - Create a new project.
+* `mkdocs serve` - Start the live-reloading docs server.
+* `mkdocs build` - Build the documentation site.
+* `mkdocs help` - Print this help message.
+
+### Project layout
+
+    mkdocs.yml    # The configuration file.
+    docs/
+        index.md  # The documentation homepage.
+        ...       # Other markdown pages, images and other files.
+

docs/index.md

@@ -1,20 +1,12 @@
-# Welcome to MkDocs
+# Welcome to PyMS
 
-For full documentation visit [mkdocs.org](https://mkdocs.org).
+PyMS, Python MicroService, is a collections of libraries, best practices and recommended ways to build 
+microservices with Python.
 
 ## Index:
-* [Structure](structure.md)
-
-
-
-* `mkdocs new [dir-name]` - Create a new project.
-* `mkdocs serve` - Start the live-reloading docs server.
-* `mkdocs build` - Build the documentation site.
-* `mkdocs help` - Print this help message.
-
-## Project layout
-
-    mkdocs.yml    # The configuration file.
-    docs/
-        index.md  # The documentation homepage.
-        ...       # Other markdown pages, images and other files.
+* [Tutorials](structure.md)
+  * Quick start - minimum project
+  * Structure of a microservice project
+  * Swagger and connexion
+  * Tracing requests
+* [Services of Py](structure.md)