changes

Author: Musiker15

docusaurus.config.ts

@@ -2,47 +2,47 @@ import {themes as prismThemes} from 'prism-react-renderer';
 import type {Config} from '@docusaurus/types';
 import type * as Preset from '@docusaurus/preset-classic';
 
-// This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)
-
 const config: Config = {
   title: 'Chezza Documentation',
   tagline: 'Dokumentation & Guides',
   favicon: 'img/favicon.ico',
 
-  // Future flags, see https://docusaurus.io/docs/api/docusaurus-config#future
   future: {
-    v4: true, // Improve compatibility with the upcoming Docusaurus v4
+    v4: true,
   },
 
-  // Set the production url of your site here
   url: 'https://docu-chezza.musiker15.de',
-  // Set the /<baseUrl>/ pathname under which your site is served
-  // For GitHub pages deployment, it is often '/<projectName>/'
   baseUrl: '/',
 
-  // GitHub pages deployment config.
-  // If you aren't using GitHub pages, you don't need these.
-  organizationName: 'Chezza-Rework', // Usually your GitHub org/user name.
-  projectName: 'chezza-documentation', // Usually your repo name.
+  organizationName: 'Chezza-Rework',
+  projectName: 'chezza-documentation',
 
   onBrokenLinks: 'throw',
 
-  // Even if you don't use internationalization, you can use this field to set
-  // useful metadata like html lang. For example, if your site is Chinese, you
-  // may want to replace "en" with "zh-Hans".
   i18n: {
     defaultLocale: 'en',
     locales: ['en'],
   },
 
+  plugins: [
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'guides',
+        path: 'guides',
+        routeBasePath: 'guides',
+        sidebarPath: './sidebars-guides.ts',
+        editUrl: 'https://github.com/Chezza-Rework/chezza-documentation/tree/main/',
+      },
+    ],
+  ],
+
   presets: [
     [
       'classic',
       {
         docs: {
           sidebarPath: './sidebars.ts',
-          // Please change this to your repo.
-          // Remove this to remove the "edit this page" links.
           editUrl:
             'https://github.com/Chezza-Rework/chezza-documentation/tree/main/',
         },
@@ -55,7 +55,6 @@ const config: Config = {
   ],
 
   themeConfig: {
-    // Replace with your project's social card
     image: 'img/chezza-social-card.jpg',
     colorMode: {
       defaultMode: 'dark',
@@ -75,11 +74,23 @@ const config: Config = {
           position: 'left',
           label: 'Dokumentation',
         },
+        {
+          type: 'docSidebar',
+          sidebarId: 'guidesSidebar',
+          docsPluginId: 'guides',
+          position: 'left',
+          label: 'Guides',
+        },
         {
           href: 'https://www.chezza.dev',
           label: 'Dashboard',
           position: 'right',
         },
+        {
+          href: 'https://discord.com/invite/Cm9NNk2486',
+          label: 'Discord',
+          position: 'right',
+        },
       ],
     },
     footer: {
@@ -92,6 +103,10 @@ const config: Config = {
               label: 'Dokumentation',
               to: '/docs',
             },
+            {
+              label: 'Guides',
+              to: '/guides',
+            },
           ],
         },
         {
@@ -104,9 +119,9 @@ const config: Config = {
             {
               label: 'Discord',
               href: 'https://discord.com/invite/Cm9NNk2486',
-            }
+            },
           ],
-        }
+        },
       ],
       copyright: `Copyright © ${new Date().getFullYear()} Chezza Rework`,
     },

guides/intro.md

@@ -0,0 +1,26 @@
+---
+sidebar_position: 1
+slug: /
+---
+
+# Guides
+
+Welcome to the Guides section of the Chezza Documentation.
+
+Here you'll find step-by-step instructions, tips and best practices for Chezza resources — from initial setup to advanced customisation.
+
+---
+
+## What to expect
+
+Guides go deeper than the pure API reference. Instead of individual events and exports, they show you how to accomplish common tasks from start to finish:
+
+- **Setup & Configuration** — Get resources running and tailor them to your server
+- **Integration** — Connect Chezza scripts with other resources
+- **Customisation** — Icons, sounds, backgrounds and more
+
+---
+
+:::info
+New guides are added continuously. For questions and suggestions, join the [Discord](https://discord.com/invite/Cm9NNk2486).
+:::

sidebars-guides.ts

@@ -0,0 +1,7 @@
+import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
+
+const sidebars: SidebarsConfig = {
+  guidesSidebar: [{ type: 'autogenerated', dirName: '.' }],
+};
+
+export default sidebars;

sidebars.ts

@@ -1,33 +1,7 @@
 import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
 
-// This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)
-
-/**
- * Creating a sidebar enables you to:
- - create an ordered group of docs
- - render a sidebar for each doc of that group
- - provide next/previous navigation
-
- The sidebars can be generated from the filesystem, or explicitly defined here.
-
- Create as many sidebars as you want.
- */
 const sidebars: SidebarsConfig = {
-  // By default, Docusaurus generates a sidebar from the docs folder structure
-  tutorialSidebar: [{type: 'autogenerated', dirName: '.'}],
-
-  // But you can create a sidebar manually
-  /*
-  tutorialSidebar: [
-    'intro',
-    'hello',
-    {
-      type: 'category',
-      label: 'Tutorial',
-      items: ['tutorial-basics/create-a-document'],
-    },
-  ],
-   */
+  tutorialSidebar: [{ type: 'autogenerated', dirName: '.' }],
 };
 
 export default sidebars;