Merge pull request #52021 from smunje1/RHDEVDOCS-4282

RHDEVDOCS-4282 - Doc: Pipelines Usability & Customer Happiness

Author: bburt-rh

images/op-pipeline-details1.png

@@ -20,10 +20,16 @@ The *Pipelines* view in the *Developer* perspective lists all the pipelines in a
 . In the *Pipelines* view of the *Developer* perspective, select a project from the *Project* drop-down list to see the pipelines in that project.
 . Click the required pipeline to see the *Pipeline details* page.
 +
-By default, the *Details* tab displays a visual representation of all the all the serial tasks, parallel tasks, `finally` tasks, and when expressions in the pipeline. The tasks and the `finally` tasks are listed in the lower right portion of the page. Click the listed *Tasks* and *Finally tasks* to view the task details.
+By default, the *Details* tab displays a visual representation of all the `serial` tasks, `parallel` tasks, `finally` tasks, and `when` expressions in the pipeline. The tasks and the `finally` tasks are listed in the lower right portion of the page. 
++
+To view the task details, click the listed *Tasks* and *Finally* tasks. In addition, you can do the following:
++
+* Use the zoom in, zoom out, fit to screen, and reset view features using the standard icons displayed in the lower left corner of the *Pipeline details* visualization.
+* Change the zoom factor of the pipeline visualization using the mouse wheel.
+* Hover over the tasks and see the task details.
 +
 .Pipeline details
-image::op-pipeline-details.png[Pipeline details]
+image::op-pipeline-details1.png[Pipeline details]
 +
 . Optional: On the *Pipeline details* page, click the *Metrics* tab to see the following information about pipelines:
 ** *Pipeline Success Ratio*

images/op_pipeline_run2.png

@@ -49,17 +49,20 @@ For basic authentication and SSH authentication, you can use annotations such as
 You can add multiple secrets based upon the number of resources in your pipeline.
 
 . Click *Start* to start the pipeline.
-. The *Pipeline Run Details* page displays the pipeline being executed. After the pipeline starts, the tasks and steps within each task are executed.
+. The *PipelineRun details* page displays the pipeline being executed. After the pipeline starts, the tasks and steps within each task are executed.
 You can:
-* Hover over the tasks to see the time taken to execute each step.
+* Use the zoom in, zoom out, fit to screen, and reset view features using the standard icons, which are in the lower left corner of the *PipelineRun details* page visualization.
+* Change the zoom factor of the pipelinerun visualization using the mouse wheel. At specific zoom factors, the background color of the tasks changes to indicate the error or warning status.
+* Hover over the tasks to see the details, such as the time taken to execute each step, task name, and task status.
+* Hover over the tasks badge to see the total number of tasks and tasks completed.
 * Click on a task to see the logs for each step in the task.
 * Click the *Logs* tab to see the logs relating to the execution sequence of the tasks. You can also expand the pane and download the logs individually or in bulk, by using the relevant button.
 * Click the *Events* tab to see the stream of events generated by a pipeline run.
 +
 You can use the *Task Runs*, *Logs*, and *Events* tabs to assist in debugging a failed pipeline run or a failed task run.
 +
 .Pipeline run details
-image::op_pipeline_run.png[Pipeline run details]
+image::op_pipeline_run2.png[Pipeline run details]
 +
 //Add workspace and credential steps in this section.
 //Probably need a sep section for logging and monitoring pipelines.

images/op_pipeline_topology1.png

@@ -19,6 +19,6 @@ To see the pipelines created using the *Pipeline Builder* in the *Topology* view
 . In *Pipeline Runs*, click *Start Last Run* to start a new pipeline run with the same parameters and resources as the previous one. This option is disabled if a pipeline run has not been initiated. You can also start a pipeline run when you create it.
 +
 .Pipelines in Topology view
-image::op_pipeline_topology.png[Pipelines in Topology view]
+image::op_pipeline_topology1.png[Pipelines in Topology view]
 
 In the *Topology* page, hover to the left of the application to see the status of its pipeline run. After a pipeline is added, a bottom left icon indicates that there is an associated pipeline.