Adjust mkdocs and about pages

Signed-off-by: Elliot Gunton <[email protected]>

examples/workflows/upstream/about.md

@@ -1,3 +1,7 @@
 # Upstream Examples
 
-* Explain what upstream examples are
+The "Upstream" collection contains examples
+[directly from the Argo Workflows repository](https://github.com/argoproj/argo-workflows/tree/6e97c7d/examples), such as
+the [DAG Diamond example](workflows/upstream/dag_diamond.md), to demonstrate how the YAML spec maps to Hera classes.
+These examples are generated and compared in Hera's CI/CD pipeline to ensure that all the examples are possible to
+recreate in Hera.

examples/workflows/use-cases/about.md

@@ -1,3 +1,4 @@
-# Project Examples
+# Use-Cases and Integrations Examples
 
-* Explain what project examples are
+These examples show how to use third-party technologies in your Workflows, along with use-cases to show more in-depth
+uses of Hera.

mkdocs.yml

@@ -34,16 +34,21 @@ nav:
     - Idiomatic Hera Examples:
       - Scripts:
         - ... | flat | examples/workflows/script/*.md
-      - DAGs and Steps:
+      - DAGs:
         - ... | flat | examples/workflows/dag/*.md
+      - Steps:
         - ... | flat | examples/workflows/steps/*.md
       - Loops:
         - ... | flat | examples/workflows/loops/*.md
+      - Artifacts:
+        - ... | flat | examples/workflows/artifacts/*.md
       - Experimental Features:
         - ... | flat | examples/workflows/experimental/*.md
-    - Project Examples:
-      - About: examples/workflows/projects/about.md
-      - ... | flat | examples/workflows/projects/*.md
+      - Unsorted Examples:
+        - ... | flat | examples/workflows/*.md
+    - Use-Cases and Integrations:
+      - About: examples/workflows/use-cases/about.md
+      - ... | flat | examples/workflows/use-cases/*.md
     - Upstream Examples:
       - About: examples/workflows/upstream/about.md
       - ... | flat | examples/workflows/upstream/*.md