Update experimental examples (#1411)

**Pull Request Checklist**
- [x] 5 of 5. Closes #1408. Fixes #1403 
- [x] Tests added
- [x] Documentation/examples added
- [x] [Good commit messages](https://cbea.ms/git-commit/) and/or PR
title

**Description of PR**
* Add intro text
* Use Workflow throughout
* Ensure they are all runnable (except for template ref example which
requires setting up the WorkflowTemplates)

---------

Signed-off-by: Elliot Gunton <elliotgunton@gmail.com>

Author: elliotgunton

docs/examples/workflows/experimental/new_container_decorator.md

@@ -2,7 +2,7 @@
 
 
 
-
+This example shows the use of the container decorator and special Input/Output classes.
 
 
 === "Hera"
@@ -11,20 +11,21 @@
     from typing_extensions import Annotated
 
     from hera.shared import global_config
-    from hera.workflows import Input, Output, Parameter, WorkflowTemplate
+    from hera.workflows import Input, Output, Parameter, Workflow
 
     global_config.experimental_features["decorator_syntax"] = True
 
 
-    # We start by defining our Workflow Template
-    w = WorkflowTemplate(name="my-template")
+    # We start by defining our Workflow
+    w = Workflow(generate_name="container-workflow-")
 
 
     # This defines the template's inputs
     class MyInput(Input):
         user: str = "Hera"
 
 
+    # This defines the template's outputs
     class MyOutput(Output):
         container_greeting: Annotated[
             str,
@@ -35,6 +36,8 @@
         ]
 
 
+    # We then use the decorators of the `Workflow` object
+    # to set the entrypoint and create a Container template
     @w.set_entrypoint
     @w.container(
         image="busybox",
@@ -48,9 +51,9 @@
 
     ```yaml linenums="1"
     apiVersion: argoproj.io/v1alpha1
-    kind: WorkflowTemplate
+    kind: Workflow
     metadata:
-      name: my-template
+      generateName: container-workflow-
     spec:
       entrypoint: basic-hello-world
       templates:

docs/examples/workflows/experimental/new_dag_decorator_artifacts.md

@@ -2,7 +2,10 @@
 
 
 
+This example shows how to pass Artifacts between scripts in a dag, using the new decorators.
 
+The DAG decorator function can easily lift out an output artifact from a task as an output of the
+DAG itself by referencing it in an `Output` class.
 
 
 === "Hera"
@@ -11,21 +14,33 @@
     from typing_extensions import Annotated
 
     from hera.shared import global_config
-    from hera.workflows import Artifact, ArtifactLoader, Input, Output, Workflow
+    from hera.workflows import (
+        Artifact,
+        ArtifactLoader,
+        Input,
+        NoneArchiveStrategy,
+        Output,
+        Workflow,
+    )
 
     global_config.experimental_features["decorator_syntax"] = True
 
 
-    w = Workflow(generate_name="my-workflow-")
+    w = Workflow(generate_name="artifact-workflow-")
 
 
     class ArtifactOutput(Output):
-        an_artifact: Annotated[str, Artifact(name="an-artifact")]
+        an_artifact: Annotated[str, Artifact(name="an-artifact", archive=NoneArchiveStrategy())]
 
 
     class ConcatInput(Input):
-        word_a: Annotated[str, Artifact(name="word_a", loader=ArtifactLoader.json)]
-        word_b: Annotated[str, Artifact(name="word_b", loader=ArtifactLoader.json)]
+        word_a: Annotated[str, Artifact(name="word_a", loader=ArtifactLoader.file)]
+        word_b: Annotated[str, Artifact(name="word_b", loader=ArtifactLoader.file)]
+
+
+    @w.script()
+    def create_artifact() -> ArtifactOutput:
+        return ArtifactOutput(an_artifact="hello world")
 
 
     @w.script()
@@ -40,11 +55,12 @@
 
     @w.set_entrypoint
     @w.dag()
-    def worker(worker_input: WorkerInput) -> ArtifactOutput:
+    def worker() -> ArtifactOutput:
+        create = create_artifact()
         concat_1 = concat(
             ConcatInput(
-                word_a=worker_input.artifact_a,
-                word_b=worker_input.artifact_b,
+                word_a=create.an_artifact,
+                word_b=create.an_artifact,
             )
         )
 
@@ -65,10 +81,32 @@
     apiVersion: argoproj.io/v1alpha1
     kind: Workflow
     metadata:
-      generateName: my-workflow-
+      generateName: artifact-workflow-
     spec:
       entrypoint: worker
       templates:
+      - name: create-artifact
+        outputs:
+          artifacts:
+          - name: an-artifact
+            path: /tmp/hera-outputs/artifacts/an-artifact
+            archive:
+              none: {}
+        script:
+          image: python:3.9
+          source: '{{inputs.parameters}}'
+          args:
+          - -m
+          - hera.workflows.runner
+          - -e
+          - examples.workflows.experimental.new_dag_decorator_artifacts:create_artifact
+          command:
+          - python
+          env:
+          - name: hera__outputs_directory
+            value: /tmp/hera-outputs
+          - name: hera__script_pydantic_io
+            value: ''
       - name: concat
         inputs:
           artifacts:
@@ -80,6 +118,8 @@
           artifacts:
           - name: an-artifact
             path: /tmp/hera-outputs/artifacts/an-artifact
+            archive:
+              none: {}
         script:
           image: python:3.9
           source: '{{inputs.parameters}}'
@@ -98,14 +138,17 @@
       - name: worker
         dag:
           tasks:
+          - name: create
+            template: create-artifact
           - name: concat-1
+            depends: create
             template: concat
             arguments:
               artifacts:
               - name: word_a
-                from: '{{inputs.artifacts.artifact_a}}'
+                from: '{{tasks.create.outputs.artifacts.an-artifact}}'
               - name: word_b
-                from: '{{inputs.artifacts.artifact_b}}'
+                from: '{{tasks.create.outputs.artifacts.an-artifact}}'
           - name: concat-2-custom-name
             depends: concat-1
             template: concat
@@ -115,13 +158,11 @@
                 from: '{{tasks.concat-1.outputs.artifacts.an-artifact}}'
               - name: word_b
                 from: '{{tasks.concat-1.outputs.artifacts.an-artifact}}'
-        inputs:
-          artifacts:
-          - name: artifact_a
-          - name: artifact_b
         outputs:
           artifacts:
           - name: an-artifact
             from: '{{tasks.concat-2-custom-name.outputs.artifacts.an-artifact}}'
+            archive:
+              none: {}
     ```
 

docs/examples/workflows/experimental/new_dag_decorator_inner_dag.md

@@ -2,7 +2,7 @@
 
 
 
-
+This example shows how to run an inner DAG within another DAG.
 
 
 === "Hera"
@@ -14,7 +14,7 @@
     global_config.experimental_features["decorator_syntax"] = True
 
 
-    w = Workflow(generate_name="my-workflow-")
+    w = Workflow(generate_name="inner-dag-workflow-")
 
 
     class SetupOutput(Output):
@@ -57,9 +57,9 @@
 
     @w.set_entrypoint
     @w.dag()
-    def outer_dag(worker_input: WorkerInput) -> WorkerOutput:
-        sub_dag_a = worker(WorkerInput(value_a="dag_a", value_b=worker_input.value_a))
-        sub_dag_b = worker(WorkerInput(value_a="dag_b", value_b=worker_input.value_b))
+    def outer_dag() -> WorkerOutput:
+        sub_dag_a = worker(WorkerInput(value_a="dag_a1", value_b="dag_a2"))
+        sub_dag_b = worker(WorkerInput(value_a="dag_b1", value_b="dag_b2"))
 
         sub_dag_c = worker(WorkerInput(value_a=sub_dag_a.value, value_b=sub_dag_b.value))
 
@@ -72,7 +72,7 @@
     apiVersion: argoproj.io/v1alpha1
     kind: Workflow
     metadata:
-      generateName: my-workflow-
+      generateName: inner-dag-workflow-
     spec:
       entrypoint: outer-dag
       templates:
@@ -166,17 +166,17 @@
             arguments:
               parameters:
               - name: value_a
-                value: dag_a
+                value: dag_a1
               - name: value_b
-                value: '{{inputs.parameters.value_a}}'
+                value: dag_a2
           - name: sub-dag-b
             template: worker
             arguments:
               parameters:
               - name: value_a
-                value: dag_b
+                value: dag_b1
               - name: value_b
-                value: '{{inputs.parameters.value_b}}'
+                value: dag_b2
           - name: sub-dag-c
             depends: sub-dag-a && sub-dag-b
             template: worker
@@ -186,10 +186,6 @@
                 value: '{{tasks.sub-dag-a.outputs.parameters.value}}'
               - name: value_b
                 value: '{{tasks.sub-dag-b.outputs.parameters.value}}'
-        inputs:
-          parameters:
-          - name: value_a
-          - name: value_b
         outputs:
           parameters:
           - name: value

docs/examples/workflows/experimental/new_dag_decorator_params.md

@@ -2,7 +2,7 @@
 
 
 
-
+This example shows how parameters can be passed into, within and out of a DAG.
 
 
 === "Hera"
@@ -17,7 +17,12 @@
     global_config.experimental_features["decorator_syntax"] = True
 
 
-    w = Workflow(generate_name="my-workflow-")
+    # Create a Workflow - we pass arguments here for the
+    # entrypoint (designated by the `set_entrypoint` decorator)
+    w = Workflow(
+        generate_name="parameters-workflow-",
+        arguments={"value_b": "a value for b!"},
+    )
 
 
     class SetupConfig(BaseModel):
@@ -26,8 +31,10 @@
 
     class SetupOutput(Output):
         environment_parameter: str
-        an_annotated_parameter: Annotated[int, Parameter()]  # use an annotated non-str, infer name from field
-        setup_config: Annotated[SetupConfig, Parameter(name="setup-config")]  # use a pydantic BaseModel
+        an_annotated_parameter: Annotated[int, Parameter(description="infer name from field")]
+        setup_config: Annotated[
+            SetupConfig, Parameter(name="setup-config")
+        ]  # a Pydantic BaseModel can be a single input Parameter
 
 
     @w.script()
@@ -53,7 +60,7 @@
     @w.script()
     def concat(concat_input: ConcatInput) -> Output:
         res = f"{concat_input.word_a} {concat_input.word_b}"
-        if concat_input.reverse:
+        if concat_input.concat_config.reverse:
             res = res[::-1]
         return Output(result=res)
 
@@ -88,7 +95,10 @@
         task_b = concat(ConcatInput(word_a=worker_input.value_b, word_b=setup_task.result))
         final_task = concat(ConcatInput(word_a=task_a.result, word_b=task_b.result))
 
-        return WorkerOutput(result_value=final_task.result, another_value=setup_task.an_annotated_parameter)
+        return WorkerOutput(
+            result_value=final_task.result,
+            another_value=setup_task.an_annotated_parameter,
+        )
     ```
 
 === "YAML"
@@ -97,7 +107,7 @@
     apiVersion: argoproj.io/v1alpha1
     kind: Workflow
     metadata:
-      generateName: my-workflow-
+      generateName: parameters-workflow-
     spec:
       entrypoint: worker
       templates:
@@ -108,6 +118,7 @@
             valueFrom:
               path: /tmp/hera-outputs/parameters/environment_parameter
           - name: an_annotated_parameter
+            description: infer name from field
             valueFrom:
               path: /tmp/hera-outputs/parameters/an_annotated_parameter
           - name: setup-config
@@ -206,5 +217,9 @@
           - name: another_value
             valueFrom:
               parameter: '{{tasks.setup-task.outputs.parameters.an_annotated_parameter}}'
+      arguments:
+        parameters:
+        - name: value_b
+          value: a value for b!
     ```
 

docs/examples/workflows/experimental/new_decorators_auto_template_refs.md

@@ -2,7 +2,9 @@
 
 
 
+This example shows how a Workflow can reference WorkflowTemplates.
 
+Note this example will not run unless you create the WorkflowTemplates first.
 
 
 === "Hera"