From 7584adc7c4753b1aa10285e0b5a2c4285168d7d9 Mon Sep 17 00:00:00 2001
From: Ben Scott <bscott@redhat.com>
Date: Wed, 9 Sep 2026 10:45:28 -0400
Subject: [PATCH] Add JTBD map scaffolding for openshift-enterprise

Create maps/openshift-enterprise with a navigation map and one empty
category map per documentation category.

The 20 category maps correspond to the category tabs in "OCP categories
sliced for map import.xlsx" (excluding the Everything, Needs human
intervention, and Pruned tabs). Install and Migrate are added on top of
those, since both are categories in "Product documentation categories"
but have no tab in the spreadsheet.

Include order in navigation.adoc follows "Product documentation
categories". Validate, Networking, and Storage are not categories in
that document, so they trail Reference pending a decision on where they
belong.

Symlinks match the microshift map layout: _attributes and modules point
at the repository roots, and jobs points at the shared maps/jobs pool.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 maps/openshift-enterprise/_attributes         |  1 +
 maps/openshift-enterprise/administer.adoc     |  3 ++
 maps/openshift-enterprise/configure.adoc      |  3 ++
 maps/openshift-enterprise/deploy.adoc         |  3 ++
 maps/openshift-enterprise/develop.adoc        |  3 ++
 maps/openshift-enterprise/disconnected.adoc   |  3 ++
 maps/openshift-enterprise/discover.adoc       |  3 ++
 maps/openshift-enterprise/docinfo-footer.html | 32 +++++++++++
 maps/openshift-enterprise/extend.adoc         |  3 ++
 maps/openshift-enterprise/get-started.adoc    |  3 ++
 maps/openshift-enterprise/install.adoc        |  3 ++
 maps/openshift-enterprise/integrate.adoc      |  3 ++
 maps/openshift-enterprise/jobs                |  1 +
 maps/openshift-enterprise/migrate.adoc        |  3 ++
 maps/openshift-enterprise/modules             |  1 +
 maps/openshift-enterprise/navigation.adoc     | 54 +++++++++++++++++++
 maps/openshift-enterprise/networking.adoc     |  3 ++
 maps/openshift-enterprise/observe.adoc        |  3 ++
 maps/openshift-enterprise/optimize.adoc       |  3 ++
 maps/openshift-enterprise/plan.adoc           |  3 ++
 maps/openshift-enterprise/reference.adoc      |  3 ++
 maps/openshift-enterprise/secure.adoc         |  3 ++
 maps/openshift-enterprise/storage.adoc        |  3 ++
 maps/openshift-enterprise/troubleshoot.adoc   |  3 ++
 maps/openshift-enterprise/upgrade.adoc        |  3 ++
 maps/openshift-enterprise/validate.adoc       |  3 ++
 maps/openshift-enterprise/whats-new.adoc      |  3 ++
 27 files changed, 155 insertions(+)
 create mode 120000 maps/openshift-enterprise/_attributes
 create mode 100644 maps/openshift-enterprise/administer.adoc
 create mode 100644 maps/openshift-enterprise/configure.adoc
 create mode 100644 maps/openshift-enterprise/deploy.adoc
 create mode 100644 maps/openshift-enterprise/develop.adoc
 create mode 100644 maps/openshift-enterprise/disconnected.adoc
 create mode 100644 maps/openshift-enterprise/discover.adoc
 create mode 100644 maps/openshift-enterprise/docinfo-footer.html
 create mode 100644 maps/openshift-enterprise/extend.adoc
 create mode 100644 maps/openshift-enterprise/get-started.adoc
 create mode 100644 maps/openshift-enterprise/install.adoc
 create mode 100644 maps/openshift-enterprise/integrate.adoc
 create mode 120000 maps/openshift-enterprise/jobs
 create mode 100644 maps/openshift-enterprise/migrate.adoc
 create mode 120000 maps/openshift-enterprise/modules
 create mode 100644 maps/openshift-enterprise/navigation.adoc
 create mode 100644 maps/openshift-enterprise/networking.adoc
 create mode 100644 maps/openshift-enterprise/observe.adoc
 create mode 100644 maps/openshift-enterprise/optimize.adoc
 create mode 100644 maps/openshift-enterprise/plan.adoc
 create mode 100644 maps/openshift-enterprise/reference.adoc
 create mode 100644 maps/openshift-enterprise/secure.adoc
 create mode 100644 maps/openshift-enterprise/storage.adoc
 create mode 100644 maps/openshift-enterprise/troubleshoot.adoc
 create mode 100644 maps/openshift-enterprise/upgrade.adoc
 create mode 100644 maps/openshift-enterprise/validate.adoc
 create mode 100644 maps/openshift-enterprise/whats-new.adoc

diff --git a/maps/openshift-enterprise/_attributes b/maps/openshift-enterprise/_attributes
new file mode 120000
index 00000000000..5b32de1e01e
--- /dev/null
+++ b/maps/openshift-enterprise/_attributes
@@ -0,0 +1 @@
+../../_attributes
\ No newline at end of file
diff --git a/maps/openshift-enterprise/administer.adoc b/maps/openshift-enterprise/administer.adoc
new file mode 100644
index 00000000000..633691d9f9d
--- /dev/null
+++ b/maps/openshift-enterprise/administer.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Administer
diff --git a/maps/openshift-enterprise/configure.adoc b/maps/openshift-enterprise/configure.adoc
new file mode 100644
index 00000000000..e24b528d0c6
--- /dev/null
+++ b/maps/openshift-enterprise/configure.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Configure
diff --git a/maps/openshift-enterprise/deploy.adoc b/maps/openshift-enterprise/deploy.adoc
new file mode 100644
index 00000000000..ce6ddb0a683
--- /dev/null
+++ b/maps/openshift-enterprise/deploy.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Deploy
diff --git a/maps/openshift-enterprise/develop.adoc b/maps/openshift-enterprise/develop.adoc
new file mode 100644
index 00000000000..d0a590de7ea
--- /dev/null
+++ b/maps/openshift-enterprise/develop.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Develop
diff --git a/maps/openshift-enterprise/disconnected.adoc b/maps/openshift-enterprise/disconnected.adoc
new file mode 100644
index 00000000000..f86c8da70c2
--- /dev/null
+++ b/maps/openshift-enterprise/disconnected.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Disconnected
diff --git a/maps/openshift-enterprise/discover.adoc b/maps/openshift-enterprise/discover.adoc
new file mode 100644
index 00000000000..e28ee39908e
--- /dev/null
+++ b/maps/openshift-enterprise/discover.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Discover
diff --git a/maps/openshift-enterprise/docinfo-footer.html b/maps/openshift-enterprise/docinfo-footer.html
new file mode 100644
index 00000000000..91f9115a90d
--- /dev/null
+++ b/maps/openshift-enterprise/docinfo-footer.html
@@ -0,0 +1,32 @@
+<style>
+  #toc ul li.has-children > ul {
+    display: none;
+  }
+  #toc ul li.has-children.open > ul {
+    display: block;
+  }
+  .toc-toggle {
+    cursor: pointer;
+    margin-right: 4px;
+    font-size: 0.75em;
+    user-select: none;
+  }
+</style>
+<script>
+  document.addEventListener('DOMContentLoaded', function() {
+    document.querySelectorAll('#toc li').forEach(function(li) {
+      var sublist = li.querySelector(':scope > ul');
+      if (sublist) {
+        li.classList.add('has-children');
+        var toggle = document.createElement('span');
+        toggle.className = 'toc-toggle';
+        toggle.textContent = '▶';
+        li.insertBefore(toggle, li.firstChild);
+        toggle.addEventListener('click', function() {
+          li.classList.toggle('open');
+          toggle.textContent = li.classList.contains('open') ? '▼' : '▶';
+        });
+      }
+    });
+  });
+</script>
\ No newline at end of file
diff --git a/maps/openshift-enterprise/extend.adoc b/maps/openshift-enterprise/extend.adoc
new file mode 100644
index 00000000000..8f2fc486754
--- /dev/null
+++ b/maps/openshift-enterprise/extend.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Extend
diff --git a/maps/openshift-enterprise/get-started.adoc b/maps/openshift-enterprise/get-started.adoc
new file mode 100644
index 00000000000..469a40894cb
--- /dev/null
+++ b/maps/openshift-enterprise/get-started.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Get Started
diff --git a/maps/openshift-enterprise/install.adoc b/maps/openshift-enterprise/install.adoc
new file mode 100644
index 00000000000..ad06855915a
--- /dev/null
+++ b/maps/openshift-enterprise/install.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Install
diff --git a/maps/openshift-enterprise/integrate.adoc b/maps/openshift-enterprise/integrate.adoc
new file mode 100644
index 00000000000..5774d014f86
--- /dev/null
+++ b/maps/openshift-enterprise/integrate.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Integrate
diff --git a/maps/openshift-enterprise/jobs b/maps/openshift-enterprise/jobs
new file mode 120000
index 00000000000..cedefc975ea
--- /dev/null
+++ b/maps/openshift-enterprise/jobs
@@ -0,0 +1 @@
+../jobs
\ No newline at end of file
diff --git a/maps/openshift-enterprise/migrate.adoc b/maps/openshift-enterprise/migrate.adoc
new file mode 100644
index 00000000000..6b1a552d519
--- /dev/null
+++ b/maps/openshift-enterprise/migrate.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Migrate
diff --git a/maps/openshift-enterprise/modules b/maps/openshift-enterprise/modules
new file mode 120000
index 00000000000..8b0e8540076
--- /dev/null
+++ b/maps/openshift-enterprise/modules
@@ -0,0 +1 @@
+../../modules
\ No newline at end of file
diff --git a/maps/openshift-enterprise/navigation.adoc b/maps/openshift-enterprise/navigation.adoc
new file mode 100644
index 00000000000..331d3d55f23
--- /dev/null
+++ b/maps/openshift-enterprise/navigation.adoc
@@ -0,0 +1,54 @@
+:_mod-docs-content-type: MAP
+
+include::_attributes/common-attributes.adoc[]
+
+:toc:
+:toclevels: 4
+:product-title: OpenShift Container Platform
+:openshift-enterprise:
+
+= OpenShift Container Platform
+
+include::whats-new.adoc[leveloffset=+1]
+
+include::discover.adoc[leveloffset=+1]
+
+include::get-started.adoc[leveloffset=+1]
+
+include::plan.adoc[leveloffset=+1]
+
+include::install.adoc[leveloffset=+1]
+
+include::deploy.adoc[leveloffset=+1]
+
+include::upgrade.adoc[leveloffset=+1]
+
+include::migrate.adoc[leveloffset=+1]
+
+include::disconnected.adoc[leveloffset=+1]
+
+include::administer.adoc[leveloffset=+1]
+
+include::develop.adoc[leveloffset=+1]
+
+include::configure.adoc[leveloffset=+1]
+
+include::secure.adoc[leveloffset=+1]
+
+include::observe.adoc[leveloffset=+1]
+
+include::integrate.adoc[leveloffset=+1]
+
+include::optimize.adoc[leveloffset=+1]
+
+include::extend.adoc[leveloffset=+1]
+
+include::troubleshoot.adoc[leveloffset=+1]
+
+include::reference.adoc[leveloffset=+1]
+
+include::validate.adoc[leveloffset=+1]
+
+include::networking.adoc[leveloffset=+1]
+
+include::storage.adoc[leveloffset=+1]
diff --git a/maps/openshift-enterprise/networking.adoc b/maps/openshift-enterprise/networking.adoc
new file mode 100644
index 00000000000..7a819ac741b
--- /dev/null
+++ b/maps/openshift-enterprise/networking.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Networking
diff --git a/maps/openshift-enterprise/observe.adoc b/maps/openshift-enterprise/observe.adoc
new file mode 100644
index 00000000000..8dcc427bd1a
--- /dev/null
+++ b/maps/openshift-enterprise/observe.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Observe
diff --git a/maps/openshift-enterprise/optimize.adoc b/maps/openshift-enterprise/optimize.adoc
new file mode 100644
index 00000000000..d4935dd92d5
--- /dev/null
+++ b/maps/openshift-enterprise/optimize.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Optimize
diff --git a/maps/openshift-enterprise/plan.adoc b/maps/openshift-enterprise/plan.adoc
new file mode 100644
index 00000000000..3f8c9e7c9df
--- /dev/null
+++ b/maps/openshift-enterprise/plan.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Plan
diff --git a/maps/openshift-enterprise/reference.adoc b/maps/openshift-enterprise/reference.adoc
new file mode 100644
index 00000000000..8d1def32f87
--- /dev/null
+++ b/maps/openshift-enterprise/reference.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Reference
diff --git a/maps/openshift-enterprise/secure.adoc b/maps/openshift-enterprise/secure.adoc
new file mode 100644
index 00000000000..9f5c43b7d3d
--- /dev/null
+++ b/maps/openshift-enterprise/secure.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Secure
diff --git a/maps/openshift-enterprise/storage.adoc b/maps/openshift-enterprise/storage.adoc
new file mode 100644
index 00000000000..6fd80c6593d
--- /dev/null
+++ b/maps/openshift-enterprise/storage.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Storage
diff --git a/maps/openshift-enterprise/troubleshoot.adoc b/maps/openshift-enterprise/troubleshoot.adoc
new file mode 100644
index 00000000000..93170fb596a
--- /dev/null
+++ b/maps/openshift-enterprise/troubleshoot.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Troubleshoot
diff --git a/maps/openshift-enterprise/upgrade.adoc b/maps/openshift-enterprise/upgrade.adoc
new file mode 100644
index 00000000000..fd98aa2af80
--- /dev/null
+++ b/maps/openshift-enterprise/upgrade.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Upgrade
diff --git a/maps/openshift-enterprise/validate.adoc b/maps/openshift-enterprise/validate.adoc
new file mode 100644
index 00000000000..89315c4fbe6
--- /dev/null
+++ b/maps/openshift-enterprise/validate.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= Validate
diff --git a/maps/openshift-enterprise/whats-new.adoc b/maps/openshift-enterprise/whats-new.adoc
new file mode 100644
index 00000000000..1c3315ebfd3
--- /dev/null
+++ b/maps/openshift-enterprise/whats-new.adoc
@@ -0,0 +1,3 @@
+:_mod-docs-content-type: MAP
+
+= What's new