add validation step

Author: hectorsector

config.yml

@@ -197,14 +197,89 @@ steps:
     position: 35
 
 # 8
-# - title: Trigger your first step with a GitHub event
-#   description: Trigger your first step with a GitHub event
-#   event: pull_request.synchronize
-#   actions:
-#   - type: respond
-#     with: respond
-# 9. Respond to a learner's pull request
-# 10. Validate a learner's pull request
+- title: Trigger your first step with a GitHub event
+  description: Trigger your first step with a GitHub event
+  event: pull_request.synchronize
+  actions:
+  - type: respond
+    with: respond-to-pr.md
+  - type: octokit
+    method: pullRequests.createComment
+    owner: '%payload.repository.owner.login%'
+    repo: '%payload.repository.name%'
+    number: '%payload.number%'
+    commit_id: '%payload.pull_request.head.sha%'
+    path: config.yml
+    body: |
+      ```suggestion
+        event: pull_request.opened
+      ```
+    position: 35
+
+# 9
+- title: Respond to a learner's pull request
+  description: Respond to a learner's pull request
+  event: pull_request.synchronize
+  actions:
+  - type: respond
+    with: validate.md
+  - type: octokit
+    method: pullRequests.createComment
+    owner: '%payload.repository.owner.login%'
+    repo: '%payload.repository.name%'
+    number: '%payload.number%'
+    commit_id: '%payload.pull_request.head.sha%'
+    path: config.yml
+    body: |
+      ```suggestion
+        - type: gate
+      ```
+    position: 40
+
+# 10
+- title: Validate a learner's pull request
+  description: Validate a learner's pull request
+  event: pull_request.synchronize
+  actions:
+  - type: respond
+    with: add-context.md
+  - type: octokit
+    method: pullRequests.createComment
+    owner: '%payload.repository.owner.login%'
+    repo: '%payload.repository.name%'
+    number: '%payload.number%'
+    commit_id: '%payload.pull_request.head.sha%'
+    path: config.yml
+    body: |
+      ```suggestion
+          left: '%payload.pull_request.title%'
+      ```
+    position: 41
+  - type: octokit
+    method: pullRequests.createComment
+    owner: '%payload.repository.owner.login%'
+    repo: '%payload.repository.name%'
+    number: '%payload.number%'
+    commit_id: '%payload.pull_request.head.sha%'
+    path: config.yml
+    body: |
+      ```suggestion
+          operator: ===
+      ```
+    position: 42
+  - type: octokit
+    method: pullRequests.createComment
+    owner: '%payload.repository.owner.login%'
+    repo: '%payload.repository.name%'
+    number: '%payload.number%'
+    commit_id: '%payload.pull_request.head.sha%'
+    path: config.yml
+    body: |
+      ```suggestion
+          right: Add name to README
+      ```
+    position: 43
+
 # 11. Pass contextual information to a response
 # 12. Add some descriptions to your course
 # 13. Add a README to your course

responses/add-context.md

@@ -0,0 +1,11 @@
+We need to validate against the learner's pull request title. This information is accessible to us because it is a pull request that triggered this step's execution (specifically, a `pull_request.opened` event).
+
+We'll add the `left:` option to the gate, and set it to the pull request's title.
+
+Activity:
+1. Add a `left:` option to the gate
+1. Set the gate's `left:` option to the pull request's title which is `'%payload.pull_request.title%'`.
+1. Set the gate's `operator:` to `===`
+1. Set the gate's `right:` to the title we expect which is `Add name to README`
+
+You can also accept the suggested changes below. They're in batch, so you'll have to go to Files Changed. 

responses/add-response.md

@@ -3,4 +3,5 @@ Great, we referenced a file title `welcome-text.md`, but it doesn't exist. Learn
 Activity: add a response
 
 1. In the `/responses/` folder, create a new file titled `welcome-text.md`
-1. In that file, add some content that will appear to the learner in the welcome issue. 
+1. In that file, add some content that will appear to the learner in the welcome issue. 
+1. Add an instruction for the learner to open a new PR titled "Add name to README" in which they add their name to the README file. 

responses/respond-to-pr.md

@@ -0,0 +1,5 @@
+You'll now respond to a new PR!
+
+Activity: 
+1. In the same step, add a respond action.
+1. Add the response file. 

responses/validate.md

@@ -0,0 +1,7 @@
+Let's now validate the learner's PR. We asked them to title the PR "Add name to README" so that's what we need to validate against.
+
+The action that will help us validate the learner's PR is a `gate`. Gates are conditionals, and they behave much like a conditional in Javascript. Let's add a `gate`, we'll specify its options in a later step.
+
+Activity: add a gate
+
+1. Add a gate or accept the suggested change below.