From a409a62eb895a484d16b1e764daad24d3423970a Mon Sep 17 00:00:00 2001
From: Tiffany Kyi <tiffanykyi@gmail.com>
Date: Fri, 3 Nov 2017 14:44:16 -0700
Subject: [PATCH 1/3] fix(770): Update configuration doc with new workflow

---
 docs/user-guide/configuration/index.md   | 34 +++++++++++++++---------
 docs/user-guide/environment-variables.md |  4 +--
 docs/user-guide/templates.md             |  2 +-
 3 files changed, 24 insertions(+), 16 deletions(-)

diff --git a/docs/user-guide/configuration/index.md b/docs/user-guide/configuration/index.md
index b9b70e53..d83bda56 100644
--- a/docs/user-guide/configuration/index.md
+++ b/docs/user-guide/configuration/index.md
@@ -18,10 +18,6 @@ You can access information about properties by hovering over the property name.
 <div class="yaml-docs">
 
 <pre class="example">
-<a href="#workflow"><span class="key">workflow</span>:
-    - <span class="value">publish</span>
-    - <span class="value">deploy-west</span>
-</a>
 <a href="#shared"><span class="key">shared</span>:</a>
     <a href="#environment"><span class="key">environment</span>:
     <span class="key">NODE_ENV</span>: <span class="value">test</span></a>
@@ -32,28 +28,44 @@ You can access information about properties by hovering over the property name.
     <a href="#annotations"><span class="key">annotations</span>:
     <span class="key">beta.screwdriver.cd/my-annotation</span>: <span class="value">my-data</span></a>
 <a href="#jobs"><span class="key">jobs</span>:</a>
-    <a href="#main-job"><span class="key">main</span>:</a>
+      <span class="key">main</span>:
+        <a href="#requires"><span class="key">requires</span>: <span class="value">[~pr, ~commit, ~sd@123:main]</span></a>
         <a href="#image"><span class="key">image</span>: <span class="value">node:6</span></a>
         <a href="#steps"><span class="key">steps</span>:
     - <span class="key">init</span>: <span class="value">npm install</span>
     - <span class="key">test</span>: <span class="value">npm test</span></a>
     <a href="#jobs"><span class="key">publish</span>:
+    <span class="key">requires</span>: <span class="value">main</span>
     <span class="key">image</span>: <span class="value">node:6</span>
     <span class="key">steps</span>:
         - <span class="key">publish</span>: <span class="value">npm publish</span></a>
     <a href="#jobs"><span class="key">deploy-west</span>:
+    <span class="key">requires</span>: <span class="value">publish</span>
     <span class="key">image</span>: <span class="value">node:6</span>
     <span class="key">environment</span>:
         <span class="key">DEPLOY_ENV</span>: <span class="value">west</span>
     <span class="key">steps</span>:
         - <span class="key">init</span>: <span class="value">npm install</span>
-        - <span class="key">publish</span>: <span class="value">npm deploy</span></a>
+        - <span class="key">deploy</span>: <span class="value">npm deploy</span></a>
+    <a href="#jobs"><span class="key">deploy-east</span>:
+    <span class="key">requires</span>: <span class="value">publish</span>
+    <span class="key">image</span>: <span class="value">node:6</span>
+    <span class="key">environment</span>:
+        <span class="key">DEPLOY_ENV</span>: <span class="value">east</span>
+    <span class="key">steps</span>:
+        - <span class="key">init</span>: <span class="value">npm install</span>
+        - <span class="key">deploy</span>: <span class="value">npm deploy</span></a>
+    <a href="#jobs"><span class="key">finished</span>:
+    <span class="key">requires</span>: <span class="value">[deploy-west, deploy-east]</span>
+    <span class="key">image</span>: <span class="value">node:6</span>
+    <span class="key">steps</span>:
+        - <span class="key">echo</span>: <span class="value">echo done</span></a>
     <a href="#jobs">...</a>
 </pre>
     <div class="yaml-side">
-        <div id="workflow" class="hidden">
-            <h4>Workflow</h4>
-            <p>Defines the order of jobs that are executed for the project. All jobs referenced by the workflow must be defined in the jobs section.</p>
+        <div id="requires" class="hidden">
+            <h4>Requires</h4>
+            <p>A single job name or array of jobs that will trigger the job to run. Defines the order in which the jobs in the pipeline are run. Jobs defined with "requires: ~pr" are started by pull-request events. Jobs defined with "requires: ~commit" are started by push events. Jobs defined with "requires: ~sd@123:main" are started by job "main" from pipeline "123". Jobs defined with "requires: [deploy-west, deploy-east] are started after "deploy-west" and "deploy-east" are both done running successfully. "Note: ~ jobs denote an OR functionality, jobs without a ~ denote join functionality.</p>
         </div>
         <div id="shared" class="hidden">
             <h4>Shared</h4>
@@ -79,10 +91,6 @@ You can access information about properties by hovering over the property name.
             <h4>Jobs</h4>
             <p>A series of jobs that define the behavior of your builds.</p>
         </div>
-        <div id="main-job" class="hidden">
-            <h4>Main</h4>
-            <p>The only required job. This job is executed automatically whenever there is a code change.</p>
-        </div>
         <div id="image" class="hidden">
             <h4>Image</h4>
             <p>This defines the Docker image used for the builds. This value should be the same as you would use for a "docker pull" command.</p>
diff --git a/docs/user-guide/environment-variables.md b/docs/user-guide/environment-variables.md
index 2e9b5ba5..1d7ae8f8 100644
--- a/docs/user-guide/environment-variables.md
+++ b/docs/user-guide/environment-variables.md
@@ -3,7 +3,7 @@ layout: main
 title: Environment Variables
 category: User Guide
 menu: menu
-toc: 
+toc:
     - title: Environment Variables
       url: "#environment-variables"
       active: true
@@ -22,7 +22,7 @@ toc:
 ---
 # Environment Variables
 
-Screwdriver exports a set of environment variables that you can rely on during the course of a build.
+Screwdriver exports a set of environment variables that you can rely on during build runtime.
 
 _Note: Environment variables set in one job cannot be accessed in another job. To pass variables between jobs, use [metadata](./configuration/metadata)._
 
diff --git a/docs/user-guide/templates.md b/docs/user-guide/templates.md
index 6564849f..c8f8d70e 100644
--- a/docs/user-guide/templates.md
+++ b/docs/user-guide/templates.md
@@ -134,4 +134,4 @@ To update a Screwdriver template, make changes in your SCM repository and rerun
 
 ## Finding templates
 
-To figure out which templates already exist, you can make a `GET` call to the `/templates` endpoint. See the [API documentation](./api) for more information.
+To figure out which templates already exist, you can make a `GET` call to the `/templates` endpoint. See the [API documentation](./api) for more information. There should also be a `/templates` endpoint in the UI.

From 3c0fd0f67df27c18d45846f1b3205f82192b36f4 Mon Sep 17 00:00:00 2001
From: Tiffany Kyi <tiffanykyi@gmail.com>
Date: Fri, 3 Nov 2017 16:43:21 -0700
Subject: [PATCH 2/3] fix: Add new git env vars

---
 docs/user-guide/environment-variables.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/user-guide/environment-variables.md b/docs/user-guide/environment-variables.md
index 1d7ae8f8..e6159eec 100644
--- a/docs/user-guide/environment-variables.md
+++ b/docs/user-guide/environment-variables.md
@@ -54,6 +54,8 @@ _Note: Environment variables set in one job cannot be accessed in another job. T
 | Name | Value |
 |------|-------|
 | SCM_URL | SCM URL that was checked out |
+| GIT_URL | SCM URL that was checked out with .git appended |
+| GIT_BRANCH | Reference for PR or the branch (e.g.: `origin/refs/${PRREF}` or `origin/${BRANCH}`) |
 
 ## URLs
 

From 1b58aff2e377fdb6626c0faf3f4cb2596dece561 Mon Sep 17 00:00:00 2001
From: Tiffany Kyi <tiffanykyi@gmail.com>
Date: Mon, 6 Nov 2017 10:13:51 -0800
Subject: [PATCH 3/3] fix: Remove extra sentence

---
 docs/user-guide/configuration/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/user-guide/configuration/index.md b/docs/user-guide/configuration/index.md
index d83bda56..66ea9f16 100644
--- a/docs/user-guide/configuration/index.md
+++ b/docs/user-guide/configuration/index.md
@@ -65,7 +65,7 @@ You can access information about properties by hovering over the property name.
     <div class="yaml-side">
         <div id="requires" class="hidden">
             <h4>Requires</h4>
-            <p>A single job name or array of jobs that will trigger the job to run. Defines the order in which the jobs in the pipeline are run. Jobs defined with "requires: ~pr" are started by pull-request events. Jobs defined with "requires: ~commit" are started by push events. Jobs defined with "requires: ~sd@123:main" are started by job "main" from pipeline "123". Jobs defined with "requires: [deploy-west, deploy-east] are started after "deploy-west" and "deploy-east" are both done running successfully. "Note: ~ jobs denote an OR functionality, jobs without a ~ denote join functionality.</p>
+            <p>A single job name or array of jobs that will trigger the job to run. Jobs defined with "requires: ~pr" are started by pull-request events. Jobs defined with "requires: ~commit" are started by push events. Jobs defined with "requires: ~sd@123:main" are started by job "main" from pipeline "123". Jobs defined with "requires: [deploy-west, deploy-east] are started after "deploy-west" and "deploy-east" are both done running successfully. "Note: ~ jobs denote an OR functionality, jobs without a ~ denote join functionality.</p>
         </div>
         <div id="shared" class="hidden">
             <h4>Shared</h4>