From 162251acb8e505ca6bb6d7824a6bac1771622e0a Mon Sep 17 00:00:00 2001
From: Eli Bosley <eli@bosley.dev>
Date: Mon, 9 Feb 2026 16:34:29 -0500
Subject: [PATCH] feat: add initial guides page

---
 docusaurus.config.ts | 21 +++++++++++++++++++++
 guides/intro.mdx     |  9 +++++++++
 sidebarsGuides.js    |  6 ++++++
 3 files changed, 36 insertions(+)
 create mode 100644 guides/intro.mdx
 create mode 100644 sidebarsGuides.js

diff --git a/docusaurus.config.ts b/docusaurus.config.ts
index 46c2e6904a..f9bfeb82d9 100644
--- a/docusaurus.config.ts
+++ b/docusaurus.config.ts
@@ -180,6 +180,11 @@ const config: Config = {
         style: { width: "30px" },
       },
       items: [
+        {
+          to: "/guides/",
+          label: "Guides",
+          position: "left",
+        },
         {
           items: [
             { href: "https://unraid.net", label: "Unraid Home" },
@@ -260,6 +265,22 @@ const config: Config = {
 
   plugins: [
     "docusaurus-plugin-image-zoom",
+    [
+      "@docusaurus/plugin-content-docs",
+      {
+        id: "guides",
+        path: "guides",
+        routeBasePath: "guides",
+        sidebarPath: "./sidebarsGuides.js",
+        editUrl: ({ locale, versionDocsDirPath, docPath }) => {
+          if (locale !== DEFAULT_LOCALE) {
+            return `https://translate.unraid.net/unraid-docs/${locale}`;
+          }
+          const branch = process.env.GITHUB_BRANCH || "main";
+          return `https://github.com/unraid/docs/edit/${branch}/${versionDocsDirPath}/${docPath}`;
+        },
+      },
+    ],
     [
       "@docusaurus/plugin-ideal-image",
       {
diff --git a/guides/intro.mdx b/guides/intro.mdx
new file mode 100644
index 0000000000..d3c21b14be
--- /dev/null
+++ b/guides/intro.mdx
@@ -0,0 +1,9 @@
+---
+sidebar_position: 1
+title: Welcome to Guides
+slug: /
+---
+
+# Unraid Guides
+
+Welcome to the Unraid Guides section. Here you'll find step-by-step tutorials and how-to guides for common Unraid tasks.
diff --git a/sidebarsGuides.js b/sidebarsGuides.js
new file mode 100644
index 0000000000..f1f70312b4
--- /dev/null
+++ b/sidebarsGuides.js
@@ -0,0 +1,6 @@
+/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
+const sidebars = {
+  guidesSidebar: [{ type: 'autogenerated', dirName: '.' }],
+};
+
+module.exports = sidebars;