From 888fdf9ca7fa2d3f14a69792efd76f11c9cd8520 Mon Sep 17 00:00:00 2001
From: Gerald Pinder <gmpinder@gmail.com>
Date: Tue, 11 Nov 2025 19:34:56 -0500
Subject: [PATCH] docs: Add behavior documentation

---
 astro.config.mjs                              | 19 ++++++++++++++-----
 src/content/docs/learn/{ => behavior}/how.mdx |  4 +---
 src/content/docs/learn/behavior/tags.mdx      |  6 ++++++
 3 files changed, 21 insertions(+), 8 deletions(-)
 rename src/content/docs/learn/{ => behavior}/how.mdx (82%)
 create mode 100644 src/content/docs/learn/behavior/tags.mdx

diff --git a/astro.config.mjs b/astro.config.mjs
index 9c9eccf..2a7c730 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -42,10 +42,6 @@ export default defineConfig({
                           label: "Building on Universal Blue",
                           link: "/learn/universal-blue/",
                       },
-                      {
-                          label: "How BlueBuild works",
-                          link: "/learn/how/",
-                      },
                       {
                           label: "Troubleshooting, reporting bugs, and common issues",
                           link: "/learn/troubleshooting/",
@@ -58,6 +54,19 @@ export default defineConfig({
                           label: "Scope",
                           link: "/learn/scope/",
                       },
+                      {
+                          label: "Behavior",
+                          items: [
+                              {
+                                  label: "How BlueBuild works",
+                                  link: "/learn/behavior/how/",
+                              },
+                              {
+                                  label: "How BlueBuild tags",
+                                  link: "/learn/behavior/tags/",
+                              }
+                          ]
+                      },
                   ],
               },
               {
@@ -145,4 +154,4 @@ export default defineConfig({
   vite: {
     plugins: [tailwindcss()],
   },
-});
\ No newline at end of file
+});
diff --git a/src/content/docs/learn/how.mdx b/src/content/docs/learn/behavior/how.mdx
similarity index 82%
rename from src/content/docs/learn/how.mdx
rename to src/content/docs/learn/behavior/how.mdx
index cbe7e22..e429dc6 100644
--- a/src/content/docs/learn/how.mdx
+++ b/src/content/docs/learn/behavior/how.mdx
@@ -1,14 +1,12 @@
 ---
 title: How BlueBuild works
-description: A guide in my new Starlight docs site.
+description: A high level understanding of the BlueBuild workflow.
 ---
 
 :::caution
 This page is a draft, so contents are unfinished or nonexistent.
 :::
 
-https://diataxis.fr/explanation/
-
 -   recipe transformed into containerfile with cli
     -   link to recipe reference
 -   containerfile built
diff --git a/src/content/docs/learn/behavior/tags.mdx b/src/content/docs/learn/behavior/tags.mdx
new file mode 100644
index 0000000..802c39d
--- /dev/null
+++ b/src/content/docs/learn/behavior/tags.mdx
@@ -0,0 +1,6 @@
+---
+title: How BlueBuild Tags Images
+description: Examples and explanation of tagging in BlueBuild
+---
+
+# Tagging