Update sidebar positions for integrations documentation

hasit · hasit · commit 6f5f8e094cca · 2024-07-19T22:04:48.000-07:00
diff --git a/docs/about/_category_.yml b/docs/about/_category_.yml
@@ -1,4 +1,4 @@
 label: About
-position: 2
+sidebar_position: 2
 collapsible: true
 collapsed: true
diff --git a/docs/faq.md b/docs/faq.md
@@ -2,7 +2,7 @@
 title: FAQs
 sidebar_label: FAQs
 description: Frequently asked questions about CodeRabbit.
-position: 7
+sidebar_position: 7
 ---
 
 ### General
diff --git a/docs/guides/_category_.yml b/docs/guides/_category_.yml
@@ -1,4 +1,4 @@
 label: Guides
-position: 5
+sidebar_position: 5
 collapsible: true
 collapsed: true
diff --git a/docs/integrations/_category_.yml b/docs/integrations/_category_.yml
@@ -1,4 +1,4 @@
 label: Integrations
-position: 6
+sidebar_position: 6
 collapsible: true
 collapsed: true
diff --git a/docs/integrations/knowledge-base.md b/docs/integrations/knowledge-base.md
@@ -0,0 +1,36 @@
+---
+title: External Knowledge Base
+description: Integrate CodeRabbit with an external knowledge base for issue tracking.
+sidebar_label: Knowledge Base
+sidebar_position: 3
+---
+
+CodeRabbit integrates with external knowledge bases to provide a seamless experience for issue tracking. This guide will assist you in effectively integrating CodeRabbit with the following supported issue tracking tools.
+
+## Jira {#jira}
+
+### CodeRabbit App
+
+1. Navigate to [integrations][integrations] in the CodeRabbit app.
+2. Toggle the Jira switch to enable the integration.
+
+Upon enabling the Jira integration, CodeRabbit will redirect you to the Jira login page. Enter your Jira credentials to authenticate the integration.
+
+### CodeRabbit Configuration
+
+1. Add Jira's Project Keys to `knowledge_base.jira.project_keys` field in your project's CodeRabbit configuration file at `.coderabbit.yaml`.
+
+## Linear {#Linear}
+
+### CodeRabbit App
+
+1. Navigate to [integrations][integrations] in the CodeRabbit app.
+2. Toggle the Linear switch to enable the integration.
+
+Upon enabling the Linear integration, CodeRabbit will redirect you to the Linear login page. Enter your Linear credentials to authenticate the integration.
+
+### CodeRabbit Configuration
+
+1. Add Linear's Team Keys to `knowledge_base.linear.team_keys` field in your project's CodeRabbit configuration file at `.coderabbit.yaml`.
+
+[integrations]: https://app.coderabbit.ai/integrations
diff --git a/docs/integrations/saas-gitlab.md b/docs/integrations/saas-gitlab.md
@@ -2,6 +2,7 @@
 title: Integrating CodeRabbit with SaaS GitLab
 description: Integrate CodeRabbit with SaaS GitLab.
 sidebar_label: SaaS GitLab
+sidebar_position: 1
 ---
 
 This guide will assist you in effectively integrating CodeRabbit with SaaS GitLab.
diff --git a/docs/integrations/self-hosted-gitlab.md b/docs/integrations/self-hosted-gitlab.md
@@ -2,6 +2,7 @@
 title: CodeRabbit for Self-Managed GitLab
 description: Integrate CodeRabbit with your Self-Managed GitLab instance.
 sidebar_label: Self-Managed GitLab
+sidebar_position: 2
 ---
 
 This page guides you through the process of integrating your Self-Managed GitLab
diff --git a/docs/tools/_category_.yml b/docs/tools/_category_.yml
@@ -1,4 +1,4 @@
 label: Supported Tools
-position: 4
+sidebar_position: 4
 collapsible: true
 collapsed: true
