feat: adding category intro page

Author: samber

docs/docs/comparison/channels-vs-ro.md

@@ -1,5 +1,5 @@
 ---
-title: 📡 channels vs ro
+title: channels vs ro
 description: Compare Go channels vs samber/ro reactive streams
 sidebar_position: 3
 ---

docs/docs/comparison/iter-vs-ro.md

@@ -1,5 +1,5 @@
 ---
-title: 🔁 iter vs ro
+title: iter vs ro
 description: Compare Go's iter package vs samber/ro reactive streams
 sidebar_position: 4
 ---

docs/docs/comparison/lo-vs-ro.md

@@ -1,5 +1,5 @@
 ---
-title: ⚖️ samber/lo vs samber/ro
+title: samber/lo vs samber/ro
 description: Compare samber/lo (functional utils) vs samber/ro (reactive streams)
 sidebar_position: 5
 ---

docs/docs/operator/creation.md

@@ -1,7 +1,7 @@
 ---
 title: Creation operators
 description: Create observables from values, iterables, timers, channels, and events.
-sidebar_position: 0
+sidebar_position: 1
 hide_table_of_contents: true
 ---
 

docs/docs/operator/index.md

@@ -1,6 +1,7 @@
 ---
-title: Operators
+title: Introduction
 description: Declarative and composable API
+sidebar_position: 0
 hide_table_of_contents: true
 ---
 

docs/docs/plugins/bytes.md

@@ -1,7 +1,7 @@
 ---
 title: Bytes
 description: Byte manipulation and conversion utilities for observable streams.
-sidebar_position: 0
+sidebar_position: 1
 hide_table_of_contents: true
 ---
 

docs/docs/plugins/index.md

@@ -0,0 +1,18 @@
+---
+title: Introduction
+description: Extend ro with powerful plugins for bytes, encoding, HTTP, observability, and more
+sidebar_position: 0
+hide_table_of_contents: true
+---
+
+# Plugins
+
+The `samber/ro` library comes with a rich ecosystem of plugins that extend its core functionality. These plugins provide specialized operators and utilities for common use cases like data encoding, HTTP requests, observability, file system operations, and much more.
+
+Each plugin is designed to be lightweight and focused on a specific domain, making it easy to add just the functionality you need to your reactive streams.
+
+## Reference
+
+import DocCardList from '@theme/DocCardList';
+
+<DocCardList />

docs/sidebars.ts

@@ -14,6 +14,9 @@ import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
  */
 const sidebars: SidebarsConfig = {
   // Enhanced sidebar with better organization and features from 3.8+
+
+  // docSidebar: [{type: 'autogenerated', dirName: '.'}],
+
   docSidebar: [
     'about',
     'getting-started',
@@ -29,6 +32,10 @@ const sidebars: SidebarsConfig = {
     {
       type: 'category',
       label: '👷 Operators',
+      link: {
+        type: 'doc',
+        id: 'operator/index',
+      },
       collapsible: true,
       collapsed: true,
       items: [
@@ -38,6 +45,10 @@ const sidebars: SidebarsConfig = {
     {
       type: 'category',
       label: '🔍 Plugins',
+      link: {
+        type: 'doc',
+        id: 'plugins/index',
+      },
       collapsible: true,
       collapsed: true,
       items: [
@@ -53,6 +64,15 @@ const sidebars: SidebarsConfig = {
         {type: 'autogenerated', dirName: 'troubleshooting'},
       ],
     },
+    {
+      type: 'category',
+      label: '📊 Comparison',
+      collapsible: true,
+      collapsed: true,
+      items: [
+        {type: 'autogenerated', dirName: 'comparison'},
+      ],
+    },
     'testing',
     'hacking',
     'contributing',