Updated docs

Author: avara1986

docs/configuration.md

@@ -0,0 +1,39 @@
+# Configuration
+
+Each microservice needs a config file in yaml or json format to work with it. This configuration contain
+the Flask configuration of your project and the [Services](services.md).
+
+a simple configuration file could be a config.yaml:
+
+```yaml
+pyms:
+  requests: true
+  swagger:
+    path: ""
+    file: "swagger.yaml"
+my-ms:
+  DEBUG: true
+  TESTING: false
+  APP_NAME: "Python Microservice"
+  APPLICATION_ROOT: ""
+```
+
+or in a config.json:
+
+```json
+{
+"pyms":{
+  "requests": true,
+  "swagger": {
+    "path": "",
+    "file": "swagger.yaml"
+    }
+  },
+"my-ms": {
+  "DEBUG": true,
+  "TESTIN": false,
+  "APP_NAME": "Python Microservice",
+  "APPLICATION_ROOT": ""
+  }
+}
+```

docs/index.md

@@ -4,7 +4,10 @@ PyMS, Python MicroService, is a collections of libraries, best practices and rec
 microservices with Python.
 
 ## Index:
-* [Tutorials](structure.md)
+* [PyMS structure](structure.md)
+* [Configuration](configuration.md)
+* [Services](services.md)
+* [Microservice class](ms_class.md)
   * Quick start - minimum project
   * Structure of a microservice project
   * Swagger and connexion

docs/ms_class.md

@@ -0,0 +1,33 @@
+# Microservices class
+
+The class Microservice is the core of all microservices built with PyMS. 
+
+
+You can create a simple microservices like:
+
+```python
+from flask import jsonify
+
+from pyms.flask.app import Microservice
+
+ms = Microservice(service="my-minimal-microservice", path=__file__)
+app = ms.create_app()
+
+
+@app.route("/")
+def example():
+    return jsonify({"main": "hello world"})
+
+
+if __name__ == '__main__':
+    app.run()
+```
+
+And a config file like this config.yml
+
+```yaml
+my-minimal-microservice:
+  APP_NAME: "Python Microservice"
+```
+
+See more examples in TODO: add link

docs/services.md

@@ -0,0 +1,15 @@
+# Services
+
+Services are libraries, resources and extensions added to the Microservice in the configuration file.
+This services are created as attribute of the [Microservice class](s_class.md) to use in the code.
+
+To add a service see the [configuration section](configuration.md).
+
+The actual services are:
+
+## Swagger / connexion
+Extends the Microservice with [Connexion](https://github.com/zalando/connexion)
+
+## Requests
+Extends the [requests library](http://docs.python-requests.org/en/master/) with trace headers
+and parsing JSON objects