Update docs, How To contribute, Create your own service (#176)

Author: avara1986

CONTRIBUTING.md

@@ -94,4 +94,60 @@ This project use MkDocs
     mkdocs.yml    # The configuration file.
     docs/
         index.md  # The documentation homepage.
-        ...       # Other markdown pages, images and other files.
+        ...       # Other markdown pages, images and other files.
+
+## Tutorial: Create your own service
+
+* First, you must create a file with the name of your service inside of `pyms.flask.service`, for example, 
+"myawesomesrv":
+
+pyms/flask/services/myawesomesrv.py
+```python
+from pyms.flask.services.driver import DriverService
+
+
+class Service(DriverService):
+    service = "myawesomesrv"
+    default_values = {
+        "myvalue": 0,
+        "myvalue2": 1
+    }
+```
+
+* Now, you can configure your service from `config.yml`
+```yaml
+pyms:
+  config:
+    myawesomesrv:
+      myvalue: 5
+```
+
+* Your service will be instanced inside the `ms` object in `flask.current_app` object. For example, with the last config,
+you could print the folowing code:
+
+```python
+from flask import jsonify, current_app
+
+from pyms.flask.app import Microservice
+
+ms = Microservice(service="my-minimal-microservice", path=__file__)
+app = ms.create_app()
+
+
+@app.route("/")
+def example():
+    return jsonify({
+    	"myvalue": current_app.ms.myawesomesrv.myvalue, 
+    	"myvalue2": current_app.ms.myawesomesrv.myvalue2
+    })
+
+
+if __name__ == '__main__':
+    app.run()
+```
+
+This would be the output in `http://localhost:5000/`:
+
+```json
+{"myvalue": 5, "myvalue2": 1}
+```

docs/services.md

@@ -132,58 +132,6 @@ pyms:
 This will add the endpoint `/metrics` to your microservice, which will expose
 the metrics.
 
-## How to contrib: create your own service
+## How to contrib: 
 
-* First, you must create a file with the name of your service inside of `pyms.flask.service`, for example, 
-"myawesomesrv":
-
-pyms/flask/services/myawesomesrv.py
-```python
-from pyms.flask.services.driver import DriverService
-
-
-class Service(DriverService):
-    service = "myawesomesrv"
-    default_values = {
-        "myvalue": 0,
-        "myvalue2": 1
-    }
-```
-
-* Now, you can configure your service from `config.yml`
-```yaml
-pyms:
-	config:
-		myawesomesrv:
-			myvalue: 5
-```
-
-* Your service will be instanced inside the `ms` object in `flask.current_app` object. For example, with the last config,
-you could print the folowing code:
-
-```python
-from flask import jsonify, current_app
-
-from pyms.flask.app import Microservice
-
-ms = Microservice(service="my-minimal-microservice", path=__file__)
-app = ms.create_app()
-
-
-@app.route("/")
-def example():
-    return jsonify({
-    	"myvalue": current_app.ms.myawesomesrv.myvalue, 
-    	"myvalue2": current_app.ms.myawesomesrv.myvalue2
-    })
-
-
-if __name__ == '__main__':
-    app.run()
-```
-
-This would be the output in `http://localhost:5000/`:
-
-```json
-{"myvalue": 5, "myvalue2": 1}
-```
+[See tutorial](tutorial_create_services.md)

docs/tutorial_create_services.md

@@ -0,0 +1,55 @@
+# Tutorial 2: How To contribute, Create your own service
+
+* First, you must create a file with the name of your service inside of `pyms.flask.service`, for example, 
+"myawesomesrv":
+
+pyms/flask/services/myawesomesrv.py
+```python
+from pyms.flask.services.driver import DriverService
+
+
+class Service(DriverService):
+    service = "myawesomesrv"
+    default_values = {
+        "myvalue": 0,
+        "myvalue2": 1
+    }
+```
+
+* Now, you can configure your service from `config.yml`
+```yaml
+pyms:
+  config:
+    myawesomesrv:
+      myvalue: 5
+```
+
+* Your service will be instanced inside the `ms` object in `flask.current_app` object. For example, with the last config,
+you could print the folowing code:
+
+```python
+from flask import jsonify, current_app
+
+from pyms.flask.app import Microservice
+
+ms = Microservice(service="my-minimal-microservice", path=__file__)
+app = ms.create_app()
+
+
+@app.route("/")
+def example():
+    return jsonify({
+    	"myvalue": current_app.ms.myawesomesrv.myvalue, 
+    	"myvalue2": current_app.ms.myawesomesrv.myvalue2
+    })
+
+
+if __name__ == '__main__':
+    app.run()
+```
+
+This would be the output in `http://localhost:5000/`:
+
+```json
+{"myvalue": 5, "myvalue2": 1}
+```

docs/tutorials.md

@@ -3,5 +3,11 @@
 This section shows tutorials to avanced use of PyMS. See [Examples](examples.md) for simple tutorials
 
 ## Tutorial 1: Propagate Traces
+With this tutorial you can solve the problem of [distributed tracing](https://microservices.io/patterns/observability/distributed-tracing.html)
 
-[Examples](tutorial_propagate_traces.md)
+[See tutorial](tutorial_propagate_traces.md)
+
+
+## Tutorial 2: How To contribute, Create your own service
+
+[See tutorial](tutorial_create_services.md)