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
@@ -29,13 +29,152 @@ import type { SidebarsConfig } from "@docusaurus/plugin-content-docs"
 const sidebars: SidebarsConfig = {
 	docsSidebar: [
 		{
-			type: "autogenerated",
-			dirName: ".",
+			type: "category",
+			collapsed: false,
+			label: "Get started with CodeRabbit",
+			items: ["overview/introduction", "getting-started/quickstart"],
 		},
 		{
-			type: "link",
-			label: "API Reference",
-			href: "https://api.coderabbit.ai/api/swagger/",
+			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://api.coderabbit.ai/api/swagger/",
+				},
+				{
+					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",
+			],
 		},
 	],
 }