Improve documentation (#278)

* Improve documentation.

* More fixes.

plugins/inventory/docker_machine.py

@@ -42,11 +42,14 @@ DOCUMENTATION = '''
                 - skip
             default: require
         running_required:
-            description: when true, hosts which Docker Machine indicates are in a state other than C(running) will be skipped.
+            description:
+                - When C(true), hosts which Docker Machine indicates are in a state other than C(running) will be skipped.
             type: bool
             default: yes
         verbose_output:
-            description: when true, include all available nodes metadata (e.g. Image, Region, Size) as a JSON object named C(docker_machine_node_attributes).
+            description:
+                - When C(true), include all available nodes metadata (for exmaple C(Image), C(Region), C(Size)) as a JSON object
+                  named C(docker_machine_node_attributes).
             type: bool
             default: yes
 '''
@@ -56,7 +59,7 @@ EXAMPLES = '''
 plugin: community.docker.docker_machine
 
 # Example using constructed features to create a group per Docker Machine driver
-# (https://docs.docker.com/machine/drivers/), e.g.:
+# (https://docs.docker.com/machine/drivers/), for example:
 #   $ docker-machine create --driver digitalocean ... mymachine
 #   $ ansible-inventory -i ./path/to/docker-machine.yml --host=mymachine
 #   {