Auto-Generation Examples

Real-world examples showing auto-generation in action.

Example 1: Simple Feature List

Setup

{
    id: "features",
    label: "Features",
    autoGenerated: true,
}

Files

content/my-docs/features/
├── authentication.md
├── breadcrumbs.md
├── dark-mode.md
├── export-data.md
└── icons.md

Result

✨ Features
├── Authentication
├── Breadcrumbs
├── Dark Mode
├── Export Data
└── Icons

(Alphabetical order)

Example 2: Large API Reference

Setup

{
    id: "endpoints",
    label: "Endpoints",
    groups: [
        { id: "users", label: "Users", autoGenerated: true },
        { id: "posts", label: "Posts", autoGenerated: true },
        { id: "comments", label: "Comments", autoGenerated: true },
    ],
}

Files

content/api/endpoints/users/
├── create.md
├── delete.md
├── get-by-id.md
├── list.md
└── update.md

content/api/endpoints/posts/
├── create.md
├── delete.md
├── list.md
└── update.md

content/api/endpoints/comments/
├── create.md
└── list.md

Result

📡 API Reference
├── Comments
│   ├── Create
│   └── List
├── Posts
│   ├── Create
│   ├── Delete
│   ├── List
│   └── Update
└── Users
    ├── Create
    ├── Delete
    ├── Get By Id
    ├── List
    └── Update

Example 3: Numeric Ordering

Setup

{
    id: "course",
    label: "Course",
    autoGenerated: true,
}

Files (with numeric prefixes)

content/learning/course/
├── 01-introduction.md
├── 02-setup.md
├── 03-hello-world.md
├── 04-variables.md
├── 05-functions.md
├── 06-advanced.md
└── 07-conclusion.md

Result

🎓 Course
├── Introduction
├── Setup
├── Hello World
├── Variables
├── Functions
├── Advanced
└── Conclusion

(Numbered order preserved!)

Example 4: Filtering with navHidden

Setup

{
    id: "guides",
    label: "Guides",
    autoGenerated: true,
}

Files

content/docs/guides/
├── getting-started.md (normal)
├── installation.md (normal)
├── internal-notes.md (navHidden: true)
├── performance-tips.md (normal)
└── wip-section.md (draft: true)

Result

📖 Guides
├── Getting Started
├── Installation
├── Performance Tips
(Internal Notes and WIP hidden)

Example 5: Growth Over Time

Month 1 (Initial Setup)

configuration:
autoGenerated: true

Files:
├── overview.md

Sidebar:
├── Overview

Month 3 (Growing)

(Same configuration, no changes)

Files:
├── overview.md
├── authentication.md
├── caching.md
├── database-setup.md

Sidebar:
├── Authentication
├── Caching
├── Database Setup
├── Overview

Month 6 (Large)

(Still same configuration!)

Files:
├── overview.md
├── authentication.md
├── caching.md
├── database-setup.md
├── deployment.md
├── error-handling.md
├── logging.md
├── monitoring.md
├── performance.md
├── security.md
└── troubleshooting.md

Sidebar:
├── Authentication
├── Caching
├── Database Setup
├── Deployment
├── Error Handling
├── Logging
├── Monitoring
├── Overview
├── Performance
├── Security
└── Troubleshooting

Key point: Configuration hasn’t changed at all, yet docs grew 10x!

Example 6: Mixed with Hidden Files

Setup

{
    id: "docs",
    label: "Documentation",
    autoGenerated: true,
}

Files

content/main-docs/
├── api.md
├── architecture.md
├── changelog.md
├── deprecated-old-api.md (navHidden: true)
├── features.md
├── performance.md
├── readme.md
├── support.md
└── wip-new-feature.md (draft: true)

Result

📚 Documentation
├── Api
├── Architecture
├── Changelog
├── Features
├── Performance
├── Readme
└── Support
(Deprecated and WIP excluded)

Example 7: Nested Auto-Generation

Setup

{
    id: "docs",
    label: "Documentation",
    groups: [
        {
            id: "core",
            label: "Core",
            groups: [
                {
                    id: "concepts",
                    label: "Concepts",
                    autoGenerated: true,  // Scans docs/core/concepts/
                },
                {
                    id: "guides",
                    label: "Guides",
                    autoGenerated: true,  // Scans docs/core/guides/
                },
            ],
        },
        {
            id: "advanced",
            label: "Advanced",
            autoGenerated: true,  // Scans docs/advanced/
        },
    ],
}

Files

content/main-docs/
├── core/
│   ├── concepts/
│   │   ├── entries.md
│   │   ├── groups.md
│   │   └── tabs.md
│   └── guides/
│       ├── getting-started.md
│       └── setup.md
└── advanced/
    ├── performance.md
    ├── security.md
    └── testing.md

Result

📚 Documentation
├── Advanced
│   ├── Performance
│   ├── Security
│   └── Testing
└── Core
    ├── Concepts
    │   ├── Entries
    │   ├── Groups
    │   └── Tabs
    └── Guides
        ├── Getting Started
        └── Setup

Best Practices

1. Use numeric prefixes for tutorials

   01-intro.md
   02-setup.md
   03-first-app.md

2. Use navLabel for custom sidebar text

   ---
   title: "Frequently Asked Questions"
   navLabel: "FAQ"
   ---

3. Use navHidden for drafts

   ---
   draft: true
   navHidden: true
   ---

4. Combine with hybrid for control

   entries: [{ slug: "overview" }],
   autoGenerated: true,  // Rest auto-discovered

Next Steps

Learn about alternatives:

• Manual Creation
• Hybrid Approach