Address review comments

API Blueprint Specification.md

@@ -687,7 +687,7 @@ This section **should** include at least one nested [Action section](#def-action
 
 - [`0-1` URI parameters section](#def-uriparameters-section)
 
-    URI parameters defined in the scope of a Resource section apply to _any and all_ nested Action sections.
+    URI parameters defined in the scope of a Resource section apply to _any and all_ nested Action sections except when an [URI template][uritemplate] has been defined for the Action.
 
 - [`0-1` Attributes section][]
 

examples/12. Advanced Action.md

@@ -1,53 +1,20 @@
 FORMAT: 1A
 
 # Advanced Action API
-An action in a resource in the API Blueprint can be considered as a state transition. This API example demonstrates that a resource can contain a state transition to another resource. This allows us to show that the resource `Task` can afford an action that is not limited to the resource `Task`.
+A resource action is – in fact – a state transition. This API example demonstrates an action - state transition - to another resource.
 
 ## API Blueprint
 + [Previous: Resource Model](11.%20Resource%20Model.md)
 + [This: Raw API Blueprint](https://raw.github.com/apiaryio/api-blueprint/master/examples/11.%20Advanced%20Action.md)
 
-# Task [/tasks/{id}]
-
-+ Parameters
-    + id (string)
-
-## Retrieve Task [GET]
-
-+ Response 200 (application/json)
-
-        {
-            "id": 123,
-            "name": "Go to gym",
-            "done": false,
-            "type": "task"
-        }
-
-## Update Task [PATCH]
-This is a state transition within the same resource
-
-+ Request (application/json)
-
-        {
-            "name": "Exercise in gym"
-        }
-
-+ Response 200 (application/json)
-
-        {
-            "id": 123,
-            "name": "Exercise in gym",
-            "done": false,
-            "type": "task"
-        }
-
-## List All Tasks [GET /tasks{?status,priority}]
-This is a state transition to another resource
+# Tasks [/tasks/tasks{?status,priority}]
 
 + Parameters
     + status (string)
     + priority (number)
 
+## List All Tasks [GET]
+
 + Response 200 (application/json)
 
         [
@@ -64,3 +31,25 @@ This is a state transition to another resource
                 "type": "task"
             }
         ]
+
+## Retrieve Task [GET /task/{id}]
+This is a state transition to another resource
+
++ Parameters
+    + id (string)
+
++ Response 200 (application/json)
+
+        {
+            "id": 123,
+            "name": "Go to gym",
+            "done": false,
+            "type": "task"
+        }
+
+## Delete Task [DELETE /task/{id}]
+
++ Parameters
+    + id (string)
+
++ Response 204