add docs links to gate

Author: hectorsector

responses/09.0_add-context.md

@@ -1,15 +1,17 @@
 ### Step 10: Add validation
-We need to validate against the learner's pull request title. This information is accessible to us from the payload that is sent with the API. In this case, the information was sent from a `pull_request.opened`  event.
+We need to validate against the learner's pull request title. This information is accessible to us [:book: from the payload](https://github.github.com/learning-lab-equipment/#/3-3-writing-steps?id=accessing-payload-data) that is sent with the event. In this case, the information was sent from a `pull_request.opened` event.
 
-We'll add the `left:` option to the gate, and set it to the pull request's title.
+You can see an example of all the information sent [in the GitHub Developer docs](https://developer.github.com/v3/activity/events/types/#webhook-payload-example-26). 
 
-A completed example of this would look like:
+We'll add the [:book: `left:` option](https://github.github.com/learning-lab-equipment/#/actions/gate/?id=options) to the gate, and compare its value to the expected pull request's title.
+
+A completed example of this would look as follows, with comments on the right starting with a hash `#`:
 ```yaml
 actions:
-- type: gate
-  left: '%payload.pull_request.title%'
-  operator: ===
-  right: Add name to README
+- type: gate                            # using the gate action
+  left: '%payload.pull_request.title%'  # get the title from the pull request object inside of the payload
+  operator: ===                         # check for strict equality, see more at https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Comparison_Operators#Identity
+  right: Add name to README             # this is the expected value
 ```
 
 ### :keyboard: Activity: Adding validation