Improved docs and added implementation details

Author: niemyjski

README.md

@@ -54,7 +54,7 @@ ILockProvider locker = new CacheLockProvider(cache, messageBus);
 await using var handle = await locker.AcquireAsync("resource-key");
 ```
 
-## 📦 Implementations
+## 📦 Provider Implementations
 
 | Provider | Caching | Queues | Messaging | Storage | Locks |
 |----------|---------|--------|-----------|---------|-------|
@@ -73,12 +73,21 @@ await using var handle = await locker.AcquireAsync("resource-key");
 
 **👉 [Complete Documentation](https://foundatio.dev)**
 
-Key topics:
+### Core Features
 
 - [Getting Started](https://foundatio.dev/guide/getting-started) - Installation and setup
-- [Caching](https://foundatio.dev/guide/caching) - Cache implementations and patterns
-- [Queues](https://foundatio.dev/guide/queues) - Message queue processing
-- [Jobs](https://foundatio.dev/guide/jobs) - Background job execution
+- [Caching](https://foundatio.dev/guide/caching) - In-memory, Redis, and hybrid caching with invalidation
+- [Queues](https://foundatio.dev/guide/queues) - FIFO message delivery with lock renewal and retry policies
+- [Locks](https://foundatio.dev/guide/locks) - Distributed locking with null handling patterns
+- [Messaging](https://foundatio.dev/guide/messaging) - Pub/sub with size limits and notification patterns
+- [File Storage](https://foundatio.dev/guide/storage) - Unified file API across providers
+- [Jobs](https://foundatio.dev/guide/jobs) - Background job processing and hosted service integration
+
+### Advanced Topics
+
+- [Resilience](https://foundatio.dev/guide/resilience) - Retry policies, circuit breakers, and timeouts
+- [Serialization](https://foundatio.dev/guide/serialization) - Serializer configuration and performance
+- [Dependency Injection](https://foundatio.dev/guide/dependency-injection) - DI setup and patterns
 - [Configuration](https://foundatio.dev/guide/configuration) - Options and settings
 
 ## 📦 CI Packages (Feedz)

docs/.vitepress/config.ts

@@ -14,9 +14,6 @@ export default defineConfig({
       })
     ]
   },
-  mermaid: {
-    // Mermaid configuration
-  },
   head: [
     ['link', { rel: 'icon', href: 'https://raw.githubusercontent.com/FoundatioFx/Foundatio/main/media/foundatio-icon.png', type: 'image/png' }],
     ['meta', { name: 'theme-color', content: '#3c8772' }]
@@ -56,24 +53,35 @@ export default defineConfig({
         {
           text: 'Advanced Topics',
           items: [
-            { text: 'Resilience', link: '/guide/resilience' },
+            { text: 'Configuration', link: '/guide/configuration' },
             { text: 'Dependency Injection', link: '/guide/dependency-injection' },
-            { text: 'Configuration', link: '/guide/configuration' }
+            { text: 'Resilience', link: '/guide/resilience' },
+            { text: 'Serialization', link: '/guide/serialization' }
           ]
         },
         {
           text: 'Implementations',
           items: [
+            { text: 'Aliyun', link: '/guide/implementations/aliyun' },
+            { text: 'AWS', link: '/guide/implementations/aws' },
+            { text: 'Azure', link: '/guide/implementations/azure' },
+            { text: 'Hybrid Cache', link: '/guide/implementations/hybrid-cache' },
             { text: 'In-Memory', link: '/guide/implementations/in-memory' },
+            { text: 'Kafka', link: '/guide/implementations/kafka' },
+            { text: 'Minio', link: '/guide/implementations/minio' },
+            { text: 'RabbitMQ', link: '/guide/implementations/rabbitmq' },
             { text: 'Redis', link: '/guide/implementations/redis' },
-            { text: 'Azure', link: '/guide/implementations/azure' },
-            { text: 'AWS', link: '/guide/implementations/aws' }
+            { text: 'SshNet', link: '/guide/implementations/sshnet' }
           ]
         },
         {
           text: 'Related Projects',
           items: [
-            { text: 'Foundatio.Mediator', link: 'https://mediator.foundatio.dev' }
+            { text: 'Foundatio.CommandQuery', link: 'https://github.com/FoundatioFx/Foundatio.CommandQuery' },
+            { text: 'Foundatio.Lucene', link: 'https://lucene.foundatio.dev' },
+            { text: 'Foundatio.Mediator', link: 'https://mediator.foundatio.dev' },
+            { text: 'Foundatio.Parsers', link: 'https://github.com/FoundatioFx/Foundatio.Parsers' },
+            { text: 'Foundatio.Repositories', link: 'https://github.com/FoundatioFx/Foundatio.Repositories' }
           ]
         }
       ]

docs/README.md

@@ -45,7 +45,7 @@ npm run docs:preview
 
 ## Project Structure
 
-```
+```txt
 docs/
 ├── .vitepress/
 │   ├── config.ts          # VitePress configuration
@@ -79,11 +79,13 @@ docs/
 
 1. Create a new `.md` file in the appropriate directory
 2. Add frontmatter with title:
+
    ```yaml
    ---
    title: Your Page Title
    ---
    ```
+
 3. Add the page to the sidebar in `.vitepress/config.ts`
 
 ### Code Blocks
@@ -135,14 +137,19 @@ This documentation site uses:
 - **vitepress-plugin-llms**: Generates LLM-friendly documentation at `/llms.txt`
 - **vitepress-plugin-mermaid**: Enables Mermaid diagrams in markdown
 
-### Mermaid Diagrams
+### Diagrams
+
+The documentation uses diagrams for visual explanations:
 
 ```markdown
-```mermaid
-graph LR
-    A[Client] --> B[Cache]
-    B --> C[Redis]
-```
+​```txt
+┌─────────┐     ┌──────────────┐     ┌──────────────┐
+│ Request │────▶│ Local Cache  │────▶│ Redis Cache  │
+└─────────┘     └──────────────┘     └──────────────┘
+                      │                      │
+                      ▼                      ▼
+                 Cache Hit?            Cache Hit?
+​```
 ```
 
 ## Deployment
@@ -163,6 +170,7 @@ The documentation can be deployed to any static hosting service:
 ### Netlify / Vercel
 
 Connect your repository and configure:
+
 - Build command: `npm run docs:build`
 - Output directory: `.vitepress/dist`