Merge pull request #42871 from HarshCasper/RHDEVDOCS-2330

RHDEVDOCS-2330: Enhancements to starting pipelines via Topology

Author: Preeticp

cicd/pipelines/working-with-pipelines-using-the-developer-perspective.adoc

@@ -40,7 +40,11 @@ include::modules/op-interacting-with-pipelines-using-the-developer-perspective.a
 
 include::modules/op-using-custom-pipeline-template-for-git-import.adoc[leveloffset=+1]
 
-include::modules/op-starting-pipelines.adoc[leveloffset=+1]
+include::modules/op-starting-pipelines-from-pipelines-view.adoc[leveloffset=+1]
+
+include::modules/op-starting-pipelines-from-topology-view.adoc[leveloffset=+1]
+
+include::modules/op-interacting-pipelines-from-topology-view.adoc[leveloffset=+1]
 
 include::modules/op-editing-pipelines.adoc[leveloffset=+1]
 

modules/op-interacting-pipelines-from-topology-view.adoc

@@ -0,0 +1,14 @@
+// This module is included in the following assembly:
+//
+// *openshift_pipelines/working-with-pipelines-using-the-developer-perspective.adoc
+
+:_content-type: CONCEPT
+[id="op-interacting-pipelines_from_topology_view{context}"]
+= Interacting with pipelines from Topology view
+
+The side panel of the application node in the *Topology* page displays the status of a pipeline run and you can interact with it. 
+
+* If a pipeline run does not start automatically, the side panel displays a message that the pipeline cannot be automatically started, hence it would need to be started manually. 
+* If a pipeline is created but the user has not started the pipeline, its status is not started. When the user clicks the *Not started* status icon, the start dialog box opens in the *Topology* view. 
+* If the pipeline has no build or build config, the *Builds* section is not visible. If there is a pipeline and build config, the *Builds section* is visible.
+* The side panel displays a *Log Snippet* when a pipeline run fails on a specific task run. You can view the *Log Snippet* in the *Pipeline Runs* section, under the *Resources* tab. It provides a general error message and a snippet of the log. A link to the *Logs* section provides quick access to the details about the failed run.

modules/op-starting-pipelines.adoc renamed to modules/op-starting-pipelines-from-pipelines-view.adoc

@@ -3,8 +3,8 @@
 // *openshift_pipelines/working-with-pipelines-using-the-developer-perspective.adoc
 
 :_content-type: PROCEDURE
-[id="op-starting-pipelines_{context}"]
-= Starting pipelines
+[id="op-starting-pipelines_from_pipelines_view_{context}"]
+= Starting pipelines from Pipelines view
 
 After you create a pipeline, you need to start it to execute the included tasks in the defined sequence. You can start a pipeline from the *Pipelines* view, the *Pipeline Details* page, or the *Topology* view.
 
@@ -63,22 +63,3 @@ image::op_pipeline_run.png[Pipeline run details]
 +
 //Add workspace and credential steps in this section.
 //Probably need a sep section for logging and monitoring pipelines.
-. For pipelines created using the *From Git* option, you can use the *Topology* view to interact with pipelines after you start them:
-+
-[NOTE]
-====
-To see the pipelines created using the *Pipeline Builder* in the *Topology* view, customize the pipeline labels to link the pipeline with the application workload.
-====
-+
-.. On the left navigation panel, click *Topology*, and click on the application to see the pipeline runs listed in the side panel.
-.. In the *Pipeline Runs* section, 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.
-+
-.Pipelines in Topology view
-image::op_pipeline_topology.png[Pipelines in Topology view]
-+
-.. In the *Topology* page, hover to the left of the application to see the status of the pipeline run for the application.
-+
-[NOTE]
-====
-The side panel of the application node in the *Topology* page displays a *Log Snippet* when a pipeline run fails on a specific task run. You can view the *Log Snippet* in the *Pipeline Runs* section, under the *Resources* tab. *Log Snippet* provides a general error message and a snippet of the log. A link to the *Logs* section provides quick access to the details about the failed run.
-====

modules/op-starting-pipelines-from-topology-view.adoc

@@ -0,0 +1,24 @@
+// This module is included in the following assembly:
+//
+// *openshift_pipelines/working-with-pipelines-using-the-developer-perspective.adoc
+
+:_content-type: PROCEDURE
+[id="op-starting-pipelines_from_topology_view{context}"]
+= Starting pipelines from Topology view
+
+For pipelines created using the *From Git* option, you can use the *Topology* view to interact with pipelines after you start them:
+
+[NOTE]
+====
+To see the pipelines created using the *Pipeline Builder* in the *Topology* view, customize the pipeline labels to link the pipeline with the application workload.
+====
+.Procedure
+
+. Click *Topology* in the left navigation panel.
+. Click the application to display *Pipeline Runs* in the side panel.
+. 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]
+
+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.