Updated docs

Author: avara1986

docs/index.md

@@ -1,6 +1,6 @@
 # Welcome to PyMS
 
-PyMS, Python MicroService, is a collections of libraries, best practices and recommended ways to build 
+PyMS, Python MicroService, is a collection of libraries, best practices and recommended ways to build 
 microservices with Python.
 
 ## Index:

docs/ms_class.md

@@ -3,7 +3,7 @@
 The class Microservice is the core of all microservices built with PyMS. 
 
 
-You can create a simple microservices like:
+You can create a simple microservice such as:
 
 ```python
 from flask import jsonify
@@ -29,9 +29,9 @@ And a config file like this config.yml
 my-minimal-microservice:
   APP_NAME: "Python Microservice"
 ```
-See [Configuration](configuration.md) section to know how create a configuration file.
+Check [Configuration](configuration.md) section to know how to create a configuration file.
 
-Each keyworkd in our configuration block, could be accessed in our Microservice object througth the attribute `config`.
+Each keyword in our configuration block, can be accessed in our Microservice object through the attribute `config`.
 
 ```yaml
 # Config.yml
@@ -61,10 +61,10 @@ print(ms.config.multiplevars.config2)
 
 
 # Looking for Configuration file
-By default, Microservice class search a config.yml in the same path. You can set a diferent route or set a json file.
+By default, Microservice class search a config.yml in the same path. You can set a different route or set a json file.
 To change this path, define a environment variable `CONFIGMAP_FILE`.
 
-This way of search the configuration is useful when you work with Docker and Kubernetes. For example, you can integrate
+This way of looking for the configuration is useful when you work with Docker and Kubernetes. For example, you can integrate
 a configmap of Kubernetes, with this microservice and a deployment with:
 
 ```yaml
@@ -92,4 +92,4 @@ spec:
             name: my-microservice-configmap
 ```
 
-See more examples in [this Github page](https://github.com/python-microservices/pyms/tree/master/examples)
+Check more examples in [this Github page](https://github.com/python-microservices/pyms/tree/master/examples)

docs/services.md

@@ -1,15 +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](ms_class.md) to use in the code.
+This services are created as an attribute of the [Microservice class](ms_class.md) to use in the code.
 
-To add a service see the [configuration section](configuration.md).
+To add a service check the [configuration section](configuration.md).
 
-The actual services are:
+Current 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.
-Encapsulate common rest operations between business services propagating trace headers if configured.
+Extend the [requests library](http://docs.python-requests.org/en/master/) with trace headers and parsing JSON objects.
+Encapsulate common rest operations between business services propagating trace headers if set up.

docs/structure.md

@@ -4,14 +4,14 @@
 Module to read yaml or json configuration from a dictionary or a path.
 
 ### pyms/flask/app
-With the funcion `create_app` initialize the Flask app, register [blueprints](http://flask.pocoo.org/docs/0.12/blueprints/)
-and intialize all libraries like Swagger, database, trace system, custom logger format, etc.
+With the function `create_app` initialize the Flask app, register [blueprints](http://flask.pocoo.org/docs/0.12/blueprints/)
+and initialize all libraries such as Swagger, database, trace system, custom logger format, etc.
 
 ### pyms/flask/healthcheck
-This views is usually used by Kubernetes, Eureka and other systems to check if our application is up and running.
+This view is usually used by Kubernetes, Eureka and other systems to check if our application is running.
 
 ### pyms/logger
 Print logger in JSON format to send to server like Elasticsearch. Inject span traces in logger.
 
 ### pyms/tracer
-Create an injector `flask_opentracing.FlaskTracer` to use in our projects
+Create an injector `flask_opentracing.FlaskTracer` to use in our projects.