coderabbitai · jmacdotorg · May 6, 2025 · Apr 30, 2025 · Apr 30, 2025 · Apr 30, 2025
diff --git a/docs/finishing-touches/docstrings.md b/docs/finishing-touches/docstrings.md
@@ -1,6 +1,5 @@
 ---
-title: Docstrings generation with CodeRabbit
-sidebar_label: Docstrings
+title: Generate docstrings
 description: Automated docstrings pull requests with CodeRabbit
 ---
 

diff --git a/docs/getting-started/adding-organizations.md b/docs/getting-started/adding-organizations.md
@@ -1,8 +1,6 @@
 ---
-title: Adding Organizations
+title: Add organizations
 description: Learn how to add new organizations to CodeRabbit
-sidebar_label: Adding Organizations
-sidebar_position: 5
 ---
 
 To add new organizations to CodeRabbit, follow these steps:

diff --git a/docs/getting-started/configure-coderabbit.md b/docs/getting-started/configure-coderabbit.md
@@ -1,11 +1,9 @@
 ---
-title: Configure CodeRabbit
-sidebar_label: Configure
+title: Add a configuration file
 description:
   CodeRabbit offers various configuration options to tailor the reviews to your
   specific requirements. Configuration can be made using one of the below
   options.
-sidebar_position: 2
 ---
 
 ```mdx-code-block

diff --git a/docs/getting-started/quickstart.md b/docs/getting-started/quickstart.md
@@ -19,7 +19,7 @@ When you complete this tutorial, you'll have seen CodeRabbit's code-review featu
 For a more general overview of CodeRabbit, see [Introduction](/).
 
 :::note
-While this tutorial focuses on GitHub, CodeRabbit also works with GitLab, Azure DevOps, and Bitbucket. For more information, see [Supported Git Platforms](/platforms/).
+While this tutorial focuses on GitHub, CodeRabbit also works with GitLab, Azure DevOps, and Bitbucket. For more information, see [Integrate with Git platforms](/platforms/).
 :::
 
 ## Before you begin

diff --git a/docs/getting-started/subscription-management.md b/docs/getting-started/subscription-management.md
@@ -1,8 +1,6 @@
 ---
-title: Subscription Management
+title: Manage your subscription
 description: Learn how to manage your CodeRabbit subscription, including billing, plan changes, and seat management
-sidebar_label: Subscription Management
-sidebar_position: 7
 ---
 
 This guide covers how to manage your subscription, including accessing billing information, changing plans, and adjusting your seat count.

diff --git a/docs/getting-started/support.md b/docs/getting-started/support.md
@@ -1,8 +1,6 @@
 ---
-title: Support
-sidebar_label: Support
+title: Get support
 description: Get help with CodeRabbit and find answers to common questions.
-sidebar_position: 3
 ---
 
 Welcome to CodeRabbit Support. Please refer to the following sections for

diff --git a/docs/getting-started/upgrading-permissions.md b/docs/getting-started/upgrading-permissions.md
@@ -1,8 +1,6 @@
 ---
-title: Upgrading App Permissions
+title: Set permissions
 description: Learn how to upgrade CodeRabbit's GitHub App permissions when new features are added
-sidebar_label: Upgrading Permissions
-sidebar_position: 6
 ---
 
 Sometimes when we add new features to CodeRabbit, we need to request additional GitHub permissions. If you see a warning about permissions or resources not being accessible, you'll need to approve the new permissions. Here's how to do it:

diff --git a/docs/guides/agent_chat.md b/docs/guides/agent_chat.md
@@ -1,8 +1,6 @@
 ---
-title: Chat and Agentic Chat
-sidebar_label: Chat and Agentic Chat
+title: Discuss code reviews with CodeRabbit
 description: Learn about CodeRabbit Pro's chat and agentic chat system
-sidebar_position: 3
 ---
 
 # CodeRabbit Chat

diff --git a/docs/guides/commands.md b/docs/guides/commands.md
@@ -1,8 +1,6 @@
 ---
-title: Commands
-sidebar_label: Commands
+title: Control and manage code reviews
 description: Learn how to control CodeRabbit using commands in pull request comments
-sidebar_position: 1
 ---
 
 # CodeRabbit Commands

diff --git a/docs/guides/custom-reports.md b/docs/guides/custom-reports.md
@@ -1,8 +1,6 @@
 ---
-title: Custom Reports
-sidebar_label: Custom Reports
+title: Customize reports
 description: Learn how to create custom reports with CodeRabbit Pro's flexible reporting system
-sidebar_position: 8
 ---
 
 ```mdx-code-block

diff --git a/docs/guides/issue-chat.md b/docs/guides/issue-chat.md
@@ -1,8 +1,6 @@
 ---
-title: Issue Chat
-sidebar_label: Issue Chat
+title: Discuss issues and plan solutions
 description: Learn how to use CodeRabbit's chat capabilities within issues
-sidebar_position: 4
 ---
 
 ```mdx-code-block

diff --git a/docs/guides/issue-creation.md b/docs/guides/issue-creation.md
@@ -1,8 +1,6 @@
 ---
-title: Issue Creation
-sidebar_label: Issue Creation
+title: Create issues
 description: Learn how to create issues directly through CodeRabbit
-sidebar_position: 5
 ---
 
 ```mdx-code-block

diff --git a/docs/guides/linked-issues.md b/docs/guides/linked-issues.md
@@ -1,8 +1,6 @@
 ---
-title: Linked Issues
-sidebar_label: Linked Issues
+title: Work with linked Issues
 description: Learn how to effectively use linked issues with CodeRabbit for better pull request assessments
-sidebar_position: 6
 ---
 
 # Linked Issues

diff --git a/docs/guides/ondemand-reports.md b/docs/guides/ondemand-reports.md
@@ -1,8 +1,6 @@
 ---
-title: On-demand Reports
-sidebar_label: On-demand Reports
+title: Generate reports
 description: CodeRabbit offers a way to generate on-demand reports using a simple API request
-sidebar_position: 9
 ---
 
 ```mdx-code-block

diff --git a/docs/guides/scheduled-reports.md b/docs/guides/scheduled-reports.md
@@ -1,8 +1,6 @@
 ---
-title: Scheduled Reports
-sidebar_label: Scheduled Reports
+title: Schedule reports
 description: Learn how to set up automated recurring reports with CodeRabbit Pro
-sidebar_position: 7
 ---
 
 ```mdx-code-block

diff --git a/docs/integrations/code-graph-analysis.md b/docs/integrations/code-graph-analysis.md
@@ -1,8 +1,6 @@
 ---
-title: Code Graph Analysis
+title: Analyze your code changes
 description: Learn about CodeRabbit's intelligent graph-based code analysis.
-sidebar_label: Code Graph Analysis
-sidebar_position: 6
 ---
 
 # CodeRabbit Code Graph Analysis

diff --git a/docs/integrations/issue-integrations.md b/docs/integrations/issue-integrations.md
@@ -1,8 +1,6 @@
 ---
-title: Issue Integrations
+title: Integrate issue tracking
 description: Learn about CodeRabbit's integrations with issue tracking systems like Jira and Linear.
-sidebar_label: Issue Integrations
-sidebar_position: 5
 ---
 
 CodeRabbit integrates with popular issue tracking systems to provide context from linked and related issues while reviewing code.

diff --git a/docs/integrations/knowledge-base.md b/docs/integrations/knowledge-base.md
@@ -1,8 +1,6 @@
 ---
-title: Knowledge Base
+title: Apply your code review preferences
 description: Learn about CodeRabbit's internal knowledge base and its integrations with external services.
-sidebar_label: Knowledge Base
-sidebar_position: 4
 ---
 
 CodeRabbit utilizes an internal knowledge base that integrates with several external services to provide a seamless review and issue management experience.

diff --git a/docs/platforms/platforms.md b/docs/platforms/platforms.md
@@ -1,8 +1,6 @@
 ---
-title: Supported Git Platforms
-sidebar_label: Supported Git Platforms
+title: Integrate with Git platforms
 description: Overview of CodeRabbit's supported Git platforms.
-sidebar_position: 1
 ---
 
 CodeRabbit supports various Git platforms to provide code review for your repositories. For the cloud-hosted Git platforms, you can [login][login] to CodeRabbit and add your repositories. The following platforms are supported:

diff --git a/docs/tools/tools.md b/docs/tools/tools.md
@@ -1,8 +1,6 @@
 ---
-title: Supported Tools
-sidebar_label: Supported Tools
+title: Configure third-party tool use
 description: Overview of CodeRabbit's supported linters and security analysis tools.
-sidebar_position: 1
 ---
 
 ```mdx-code-block

diff --git a/sidebars.ts b/sidebars.ts
@@ -27,17 +27,159 @@ import type { SidebarsConfig } from "@docusaurus/plugin-content-docs"
  Create as many sidebars as you want.
  */
 const sidebars: SidebarsConfig = {
-	docsSidebar: [
-		{
-			type: "autogenerated",
-			dirName: ".",
-		},
-		{
-			type: "link",
-			label: "API Reference",
-			href: "https://api.coderabbit.ai/api/swagger/",
-		},
-	],
-}
+    docsSidebar: [
+        {
+            type: 'category',
+            collapsed: false,
+            label: 'Get started with CodeRabbit',
+            items: [
+                'overview/introduction',
+                'getting-started/quickstart',
+            ],
+        },
+        {
+            type: 'category',
+            collapsed: false,
+            label: 'Add CodeRabbit to your repository',
+            items: [
+                'platforms/platforms',
+                {
+                    type: 'category',
+                    collapsed: true,
+                    label: 'Supported Git platforms',
+                    items: [
+                        'platforms/github-com',
+                        'platforms/github-enterprise-server',
+                        'platforms/gitlab-com',
+                        'platforms/self-hosted-gitlab',
+                        'platforms/azure-devops',
+                        'platforms/bitbucket-cloud',
+                    ],
+                },
+                'getting-started/adding-organizations',
+                'getting-started/upgrading-permissions',
+                {
+                    type: 'category',
+                    collapsed: true,
+                    label: 'Self-host CodeRabbit',
+                    items: [
+                        'self-hosted/github',
+                        'self-hosted/gitlab',
+                        'self-hosted/azure-devops',
+                        'self-hosted/bitbucket',
+                    ],
+                },
+            ],
+        },
+        {
+            type: 'category',
+            collapsed: false,
+            label: 'Configure CodeRabbit',
+            items: [
+                'getting-started/configure-coderabbit',
+                'integrations/knowledge-base',
+                'tools/tools',
+            ],
+        },
+        {
+            type: 'category',
+            collapsed: false,
+            label: 'Review pull requests',
+            items: [
+                'guides/commands',
+                'guides/agent_chat',
+                {
+                    type: 'category',
+                    collapsed: false,
+                    label: 'Analyze and improve your code',
+                    items: [
+                        'integrations/code-graph-analysis',
+                        'finishing-touches/docstrings',
+                    ],
+                },
+            ],
+        },
+        {
+            type: 'category',
+            collapsed: false,
+            label: 'Create and resolve issues',
+            items: [
+                'integrations/issue-integrations',
+                'guides/issue-chat',
+                'guides/issue-creation',
+                'guides/linked-issues',
+            ],
+        },
+        {
+            type: 'category',
+            collapsed: false,
+            label: 'Generate reports',
+            items: [
+                'guides/ondemand-reports',
+                'guides/custom-reports',
+                'guides/scheduled-reports',
+            ],
+        },
+        {
+            type: 'category',
+            collapsed: false,
+            label: 'Reference',
+            items: [
+                {
+                    type: 'link',
+                    label: 'CodeRabbit API',
+                    href: 'https:
+                },
+                {
+                    type: 'category',
+                    label: 'Supported tools',
+                    collapsed: true,
+                    items: [
+                        'tools/actionlint',
+                        'tools/biome',
+                        'tools/buf',
+                        'tools/checkov',
+                        'tools/circleci',
+                        'tools/cppcheck',
+                        'tools/detekt',
+                        'tools/eslint',
+                        'tools/gitleaks',
+                        'tools/golangci-lint',
+                        'tools/hadolint',
+                        'tools/languagetool',
+                        'tools/markdownlint',
+                        'tools/oxlint',
+                        'tools/phpstan',
+                        'tools/pipeline-remediation',
+                        'tools/pmd',
+                        'tools/prisma-lint',
+                        'tools/regal',
+                        'tools/rubocop',
+                        'tools/ruff',
+                        'tools/semgrep',
+                        'tools/shellcheck',
+                        'tools/sqlfluff',
+                        'tools/swiftlint',
+                        'tools/yamllint',
+                    ],
+                },
+            ],
+        },
+        {
+            type: 'category',
+            collapsed: false,
+            label: 'Resources',
+            items: [
+                'getting-started/support',
+                'getting-started/subscription-management',
+                'overview/why-coderabbit',
+                'faq',
+                'early-access',
+                'future-development',
+                'changelog',
+            ],
+        },
+    ],
+};
 
 export default sidebars