Feedback from Graham Dumpleton #37

Feedback from Graham Dumpleton

Author: danielhelfand

workshop/content/concepts.adoc

@@ -13,6 +13,10 @@ The custom resources needed to define a pipeline are listed below:
 
 image:images/tekton-architecture.svg[Tekton Architecture]
 
+Having trouble viewing the screenshot above? Simply drag the divider that separates the workshop content
+you are reading now from the terminal towards the right. This will expand screenshots to make
+them easier to see.
+
 In short, in order to create a pipeline, one does the following:
 
 * Create custom or install link:https://github.com/tektoncd/catalog[existing] reusable tasks

workshop/content/exercises/trigger-pipeline.adoc

@@ -74,21 +74,21 @@ Tekton CLI Logs
 ---------------
 
 To view the logs for the pipelinerun, you need the unique name assigned to it
-when you ran `tkn pipeline start`. This is the same name as `tkn pr ls` outputs
-and actually corresponds to the name of the pod for the pipelinerun.
+when you ran `tkn pipeline start`. This is the same name as `tkn pr ls` outputs.
 
 To grab the name of this into an environment variable, run:
 
 [source,bash,role=execute-1]
 ----
-POD=`tkn pr ls -o jsonpath='{$.items[?(@.status.conditions[0].reason=="Running")].metadata.name}' | tr ' ' '\n' | head -1`; echo $POD
+RUN=`tkn pr ls -o jsonpath='{$.items[?(@.status.conditions[0].reason=="Running")].metadata.name}' | tr ' ' '\n' | head -1`; echo $RUN
 ----
 
-Then run:
+Then run the following `tkn` command to access the logs of the pipelinerun using the environment
+variable to specify the name of the pipelinerun:
 
 [source,bash,role=execute-1]
 ----
-tkn pr logs $POD -f
+tkn pr logs $RUN -f
 ----
 
 The logs output tells you what tasks are running as well as what step it is running.

workshop/content/exercises/verify-deployment.adoc

@@ -6,7 +6,8 @@ The first thing you should notice is the successful task completions under the
 
 image:../images/web-console-tasks-success.png[Web Console Tasks Success]
 
-Next, click on the **Topology** tab on the left side of the web console.
+Next, click on the **Topology** tab on the left side of the web console. You should
+see what is in the screenshot below:
 
 image:../images/topology-view-deployed.png[Topology View Deployed]
 

workshop/content/install-tekton-operator.adoc

@@ -22,10 +22,6 @@ Next, you would click on the **Integration & Delivery** category to find the
 
 image:images/operatorhub.png[OpenShift OperatorHub]
 
-Having trouble viewing the photo above? Simply drag the divider that separates the workshop content 
-you are reading now from the terminal towards the right. This will expand photos to make
-them easier to see.
-
 Click on **OpenShift Pipelines Operator**, **Continue**, and then **Install** as
 shown below:
 

workshop/content/workshop-introduction.adoc

@@ -14,6 +14,6 @@ Kubernetes
 Kubernetes is an open-source system for automating deployment, scaling, and management
 of containerized applications.
 
-As OpenShift is a platform based on Kubernetes, there will be Kubernetes concepts
+As OpenShift is a distribution of Kubernetes, there will be Kubernetes concepts
 used throughout this workshop. The workshop assumes that attendees will have knowledge
 of Kubernetes fundamental concepts.