diff --git a/16-ro-northbound-rest-api.md b/16-ro-northbound-rest-api.md
index 18e4562af7e7a545d9482db1c5bf96bed5f1fffe..9dfa7ca042ef29d61eccade58db9b2ceaee70591 100644
--- a/16-ro-northbound-rest-api.md
+++ b/16-ro-northbound-rest-api.md
@@ -476,7 +476,7 @@ Get a list of vnfs. The parameter `tenant_id` can be replaced by `any` to obtain
                "physical": false
            },
            {
-               "description": "VNF1 description"",
+               "description": "VNF1 description",
                "created_at": "2015-09-15T13:22:24",
                "uuid": "09d14bf0-5b9c-11e5-a873-5254004aea96",
                "name": "VNF2",
@@ -498,14 +498,14 @@ Get vnf details. The parameter `tenant_id` can be replaced by `any` to obtain al
 
 - VNFC: Array of virtual machines which compose the vnf
 - External-connections: array of vnf's connections
+  - `vm_name`: name of the internal virtual machine which this connections is connected
+  - `external_name`: name of the conection to show in the interface
+  - `type`: type of connection
+  - `vpci`: Virtual PCI address
+  - `bw`: bandwidth
+  - `internal_name`: local iface name of the VM
 
 ```json
-   * vm_name: name of the internal virtual machine which this connections is connected
-   * external_name: name of the conection to show in the interface
-   * type: type of connection
-   * vpci: Virtual PCI address
-   * bw: bandwidth
-   * internal_name: local iface name of the VM
    {
        "vnf": {
            "VNFC": [
@@ -675,12 +675,13 @@ see at code `/scenarios/scenario-template.yaml`
 ```
 
 - Start a scenario: Equivalent to deploy
+  - instance_name (required): name of the scenario to start
+  - description (optional): a description
+  - datacenter (optional): name of the datacenter where the scenario will be started.
+
+`Content-type: application/json`:
 
 ```json
-   * instance_name (required): name of the scenario to start
-   * description (optional): a description
-   * datacenter (optional): name of the datacenter where the scenario will be started.
-   Content-type: application/json:
        {
            "start": {
                "instance_name": "scenario1",
@@ -961,7 +962,7 @@ Creates a new instance scenario
 
 **Params**: `Content-type: application/yaml`
 
-```json
+```yaml
    ---
    instance:
        datacenter: 2dd83432-6604-11e6-950f-0800273e724c
@@ -1054,7 +1055,7 @@ take an action over a scenario instance. Actions can be `{start,pause,resume,shu
 
 Must contain ONLY ONE action (from the bellow list), and optionally a VNF list and/or a VM list. If a VNF list is provided the action is applied only to all VMs of this VNF. If a VM list is provided the actions is applied also to these VMs. If neither VNF, nor VM list are provided the action is applied to all the VMs of the instance scenario. These lists conatin the identifier obtained in creating the scenario response(and also GET instance scenario details); concretely the at the `"vnfs":"uuid"` field for the VNFs, and at `"vnfs":"vms":"uuid"` field for the VMs.
 
-```json
+```yaml
    ---
    "start": null  #To start an instance
    "pause": null  #To pause an instance