From 27cba2d4a07b07384188b40ca98555dd52e72cbc Mon Sep 17 00:00:00 2001
From: soyboy <soyboy@oplabs.co>
Date: Tue, 18 Nov 2025 23:09:34 -0500
Subject: [PATCH] skeleton

---
 docs.json                                    | 14 ++++++++++++++
 governance/capital-allocation.mdx            |  5 +++++
 governance/evolution-and-experimentation.mdx |  4 ++++
 governance/gov-faq.mdx                       |  4 ++++
 governance/protocol-upgrades.mdx             |  4 ++++
 5 files changed, 31 insertions(+)
 create mode 100644 governance/capital-allocation.mdx
 create mode 100644 governance/evolution-and-experimentation.mdx
 create mode 100644 governance/gov-faq.mdx
 create mode 100644 governance/protocol-upgrades.mdx

diff --git a/docs.json b/docs.json
index bf2e33c33..a64d1c319 100644
--- a/docs.json
+++ b/docs.json
@@ -2158,6 +2158,20 @@
           }
         ]
       },
+      {
+        "tab": "How Optimism Evolves",
+        "groups": [
+          {
+            "group": "How Optimism Evolves",
+            "pages": [
+              "governance/protocol-upgrades",
+              "governance/capital-allocation",
+              "governance/gov-faq",
+              "governance/evolution-and-experimentation"
+            ]
+          }
+        ]
+      },
       {
         "tab": "Notices",
         "groups": [
diff --git a/governance/capital-allocation.mdx b/governance/capital-allocation.mdx
new file mode 100644
index 000000000..257d86c0f
--- /dev/null
+++ b/governance/capital-allocation.mdx
@@ -0,0 +1,5 @@
+---
+title: Capital Allocation
+description: Learn how Optimism allocates capital for long-term success.
+---
+
diff --git a/governance/evolution-and-experimentation.mdx b/governance/evolution-and-experimentation.mdx
new file mode 100644
index 000000000..e6c805617
--- /dev/null
+++ b/governance/evolution-and-experimentation.mdx
@@ -0,0 +1,4 @@
+---
+title: Evolution & Experimentation
+description: Learn about Optimism's commitment to iterative improvement and experimentation.
+---
\ No newline at end of file
diff --git a/governance/gov-faq.mdx b/governance/gov-faq.mdx
new file mode 100644
index 000000000..55ace794a
--- /dev/null
+++ b/governance/gov-faq.mdx
@@ -0,0 +1,4 @@
+---
+title: FAQs
+description: Frequently Asked Questions about how Optimism evolves.
+---
\ No newline at end of file
diff --git a/governance/protocol-upgrades.mdx b/governance/protocol-upgrades.mdx
new file mode 100644
index 000000000..de3ac700d
--- /dev/null
+++ b/governance/protocol-upgrades.mdx
@@ -0,0 +1,4 @@
+---
+title: Protocol Upgrades
+description: Learn how the OP Stack stay up to date with the latest innovations.
+---
\ No newline at end of file