Merge branch 'main' into config-editor-gh-app

Author: rosieyohannan

docs/guides/modules/orchestrate/pages/workflows.adoc

@@ -184,6 +184,31 @@ image::guides:ROOT:workflow-using-requires-example-1.png[Flexible Job Execution
 image::guides:ROOT:workflow-using-requires-example-2.png[Flexible Job Execution Workflow - Example 2]
 
 
+You may want to configure job dependencies that ignore the status/outcome of an upstream job.
+
+In the following example, the dependent job will run once the upstream job attains a terminal state, regardless of the status/outcome:
+
+.Use flexible requires to ignore outcome of a job
+[source,yaml]
+----
+workflows:
+  test-and-cleanup:
+    jobs:
+      - build
+      - test:
+          requires:
+            - build
+      - cleanup:
+          requires:
+            - test:
+              - success
+              - failed
+              - canceled
+----
+
+* The `test` job waits for the `build` job, and only runs if the `build` job is successful.
+* The `cleanup` job waits for the `test` job, and runs regardless of whether the `test` job succeeds, fails, or is canceled.
+
 TIP: Refer to the xref:reference:ROOT:configuration-reference.adoc#requires[Requires] section of the configuration reference.
 
 [#holding-a-workflow-for-a-manual-approval]