From 4fdba171a83b799d7840a7bff16414e99c714529 Mon Sep 17 00:00:00 2001
From: Neal Gompa <ngompa@centosproject.org>
Date: Aug 02 2024 16:12:53 +0000
Subject: docs/content/spins: Add cloud image documentation and unify content structure


We now publish a Cloud Spin for running CentOS Hyperscale in cloud infrastructure,
so now we have multiple types of spin images being produced. Additionally, the
containers are technically part of that, so move that documention under the
spins section along with the cloud and workstation documentation.

---

diff --git a/docs/content/containers.md b/docs/content/containers.md
deleted file mode 100644
index 9d33264..0000000
--- a/docs/content/containers.md
+++ /dev/null
@@ -1,16 +0,0 @@
-A minimal container image based on the Hyperscale SIG repos and packages is
-available on [Quay.io](https://quay.io/centoshyperscale/centos) and can be used
-via Docker or Podman.
-
-This container image is automatically
-[built from scratch](https://pagure.io/centos-sig-hyperscale/containers-releng) on the CentOS CI infrastructure and pushed weekly.
-
-# CentOS Stream 8
-```shell
-podman run -a stdin,stdout,stderr -t quay.io/centoshyperscale/centos:stream8
-```
-
-# CentOS Stream 9
-```shell
-podman run -a stdin,stdout,stderr -t quay.io/centoshyperscale/centos:stream9
-```
diff --git a/docs/content/spins/cloud.md b/docs/content/spins/cloud.md
new file mode 100644
index 0000000..85285b4
--- /dev/null
+++ b/docs/content/spins/cloud.md
@@ -0,0 +1,12 @@
+The CentOS Hyperscale SIG produces an experimental Hyperscale Cloud Spin
+to showcase the technologies we're working on to the broader community.
+
+The spins are available for download
+[from the mirrors](https://mirror.stream.centos.org/SIGs/9-stream/hyperscale/images/experimental/).
+
+The cloud images are built using [`kiwi`](https://osinside.github.io/kiwi)
+provided by the `kiwi` package in EPEL. We publish the
+[descriptions](https://pagure.io/centos-sig-hyperscale/kiwi-descriptions) as well.
+
+Please report any issues with these spins on our
+[spin-bugs](https://pagure.io/centos-sig-hyperscale/spin-bugs) tracker.
diff --git a/docs/content/spins/container.md b/docs/content/spins/container.md
new file mode 100644
index 0000000..9d33264
--- /dev/null
+++ b/docs/content/spins/container.md
@@ -0,0 +1,16 @@
+A minimal container image based on the Hyperscale SIG repos and packages is
+available on [Quay.io](https://quay.io/centoshyperscale/centos) and can be used
+via Docker or Podman.
+
+This container image is automatically
+[built from scratch](https://pagure.io/centos-sig-hyperscale/containers-releng) on the CentOS CI infrastructure and pushed weekly.
+
+# CentOS Stream 8
+```shell
+podman run -a stdin,stdout,stderr -t quay.io/centoshyperscale/centos:stream8
+```
+
+# CentOS Stream 9
+```shell
+podman run -a stdin,stdout,stderr -t quay.io/centoshyperscale/centos:stream9
+```
diff --git a/mkdocs.yml b/mkdocs.yml
index 3e578cd..4cdac22 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -15,9 +15,10 @@ nav:
       - content/repositories/hotfixes.md
       - content/repositories/experimental.md
       - content/repositories/intel.md
-    - Container images: content/containers.md
     - Spins:
-      - Workstation LiveDVD: content/spins/workstation.md
+      - Clouds: content/spins/cloud.md
+      - Containers: content/spins/container.md
+      - Workstations: content/spins/workstation.md
     - ELN Extras: content/eln_extras.md
   - Contributing:
     - Packaging: contributing/packaging.md
@@ -70,7 +71,8 @@ plugins:
         repositories/hotfixes.md: content/repositories/hotfixes.md
         repositories/experimental.md: content/repositories/experimental.md
         repositories/intel.md: content/repositories/intel.md
-        containers.md: content/containers.md
+        containers.md: content/spins/container.md
+        content/containers.md: content/spins/container.md
         spins/workstation.md: content/spins/workstation.md
         eln_extras.md: content/eln_extras.md
         internal/documentation.md: contributing/documentation.md