docs: restructure sidebar with improved navigation

tyaga001 · tyaga001 · commit f55f85c63c03 · 2024-12-02T11:14:54.000+01:00
- Improve navigation hierarchy and structure
- Update sidebar styling
- Implement collapsible sections
- Add hover states and active indicators
diff --git a/docs/about/_category_.yml b/docs/about/_category_.yml
@@ -1,4 +1,4 @@
-label: Plateform
-position: 3
+label: Platform
+position: 8
 collapsible: true
 collapsed: false
diff --git a/docs/about/support.md b/docs/about/support.md
@@ -44,7 +44,7 @@ Regardless of the method or location through which CodeRabbit provides Support,
 :::tip
 
 To see more common issues faced by CodeRabbit users, visit our
-[FAQ section](../faq.md) for detailed answers and solutions to frequently
+[FAQ section](/faq)) for detailed answers and solutions to frequently
 encountered problems.
 
 :::
diff --git a/docs/faq.md b/docs/faq.md
@@ -80,15 +80,15 @@ Switch between organizations easily:
 - ⚡ **Older PRs**: Use `@coderabbitai review` to trigger manually
 
 :::tip Pro Tip
-Just created a PR right before installing CodeRabbit? or drop a `@coderabbitai full review` comment in old PR to get it reviewed.
+Just created a PR right before installing CodeRabbit? Drop a `@coderabbitai full review` comment in old PR to get it reviewed.
 :::
 
 ![CodeRabbit- Full-Review](/img/faq/full-review.png)
 
 ### Customization Options
 
 - **Language Settings**: Configure review language in repository settings
-- **Review Rules**: Customize via [Review Instructions](./guides/review-instructions.md)
+- **Review Rules**: Customize via [Review Instructions](/guides/review-instructions)
 - **Branch Selection**: Default branch reviews enabled by default (configurable)
 
 ### Access & Permissions
@@ -104,7 +104,7 @@ Interact with CodeRabbit by:
 1. Replying directly to CodeRabbit comments
 2. Tagging `@coderabbitai` in PR discussions
 3. Adding review comments for specific lines
-4. Customize via [Review Instructions](./guides/review-instructions.md)
+4. Customize via [Review Instructions](/guides/review-instructions)
 
 :::tip Collaboration Mode
 When team members are active in PRs, use `@coderabbitai` to engage the bot.
@@ -137,5 +137,79 @@ In-trial and open-source plans have lower rate limits than the paid plan. In all
 3. That's it. CodeRabbit will automatically start reviewing your PRs
 
 :::tip Need Help?
-Visit our [Support](./about/support.md) page for additional assistance or reach out to our team on [discord](http://discord.gg/coderabbit).
+Visit our [Support](/about/support) page for additional assistance or reach out to our team on [Discord](http://discord.gg/coderabbit).
 :::
+
+## Account Management {#account-management}
+
+### How do I delete my CodeRabbit account?
+
+:::danger Irreversible Account Deletion
+Deleting your CodeRabbit account is permanent and cannot be undone. This action will permanently erase:
+
+- Organization and Repository data
+- AI Bot learnings and insights
+- Subscriptions and billing information
+- All settings and configurations
+- Reports and recurring reports
+- Third-party service integrations
+  :::
+
+<Tabs>
+  <TabItem value="deletion" label="Account Deletion Steps" default>
+    1. Sign into your CodeRabbit account
+    2. Navigate to the **Subscription** page
+    3. Click the orange **Delete Account** button
+    4. Review the deletion confirmation modal
+    5. Type "delete" to confirm
+    6. Complete platform-specific cleanup steps below
+
+    :::info
+    The Delete Account button is only visible to admin users.
+    :::
+
+A confirmation modal will appear explaining the consequences of account deletion. You can expand each section for detailed information:
+
+    <div align="center">
+    ![Delete Account](/img/guides/delete_account_light.png#gh-light-mode-only)
+    ![Delete Account](/img/guides/delete_account_dark.png#gh-dark-mode-only)
+    </div>
+
+  </TabItem>
+  <TabItem value="github" label="GitHub Cleanup">
+    After account deletion, you must:
+
+    **Remove OAuth App:**
+    1. Go to Organization settings
+    2. Click **OAuth Application Policy**
+    3. Find **coderabbitai** and click the pencil icon
+    4. Click **Revoke**
+
+    **Uninstall GitHub App:**
+    1. Go to Organization settings
+    2. Click **GitHub Apps**
+    3. Select **Configure**
+    4. Click **Uninstall**
+
+  </TabItem>
+  <TabItem value="gitlab" label="GitLab Cleanup">
+    Complete these steps:
+
+    1. Remove OAuth App from User Settings > Applications
+    2. Remove Webhook from Group > Project Settings > Webhooks
+    3. Remove Bot User from Group > Manage > Members
+
+  </TabItem>
+  <TabItem value="azure" label="Azure DevOps Cleanup">
+    1. Go to Project Settings > Service Hooks
+    2. Delete CodeRabbit webhooks
+    3. Remove CodeRabbit user or delete associated Personal Access Token
+  </TabItem>
+</Tabs>
+
+:::warning Post-Deletion Steps
+The platform-specific cleanup steps are necessary to completely remove CodeRabbit access. Without completing these steps:
+
+- CodeRabbit may retain some platform permissions
+- Signing back in will recreate minimal account data
+  :::
diff --git a/docs/getting-started/quickstart.md b/docs/getting-started/quickstart.md
@@ -19,15 +19,15 @@ Get started with CodeRabbit in three simple steps. No complex configuration need
 - Click "Sign in with GitHub"
 - Authorize CodeRabbit
 
-![Login with GitHub - CodeRabbit](/img/getting-started/login-with-github.png)
+![CodeRabbit Login](/img/integrations/login-self-hosted-github.png)
 
 2. **Add Your Repository**
 
 - Go to your [Dashboard](https://app.coderabbit.ai/dashboard)
 - Click "Add Repositories"
 - Select the repositories you want to enable
 
-![CodeRabbit Dashboard](/img/getting-started/coderabbit-dashboard.png)
+![CodeRabbit Dashboard](/img/getting-started/dashboard-coderabbit.png)
 
 3. **You're Done 🎉**
 
@@ -41,7 +41,7 @@ Get started with CodeRabbit in three simple steps. No complex configuration need
 
 Here's an example of CodeRabbit in action:
 
-![CodeRabbit PR Review Example](/img/getting-started/pr-example.png)
+![CodeRabbit PR Review Example](/img/getting-started/pr-examples.png)
 
 [View live example PR](https://github.com/tyaga001/devtoolsacademy/pull/39)
 
diff --git a/docs/guides/_category_.yml b/docs/guides/_category_.yml
@@ -1,4 +1,4 @@
 label: Guides
-position: 6
+position: 5
 collapsible: true
 collapsed: false
diff --git a/docs/guides/delete-account.md b/docs/guides/delete-account.md
diff --git a/docs/platforms/_category_.yaml b/docs/platforms/_category_.yaml
@@ -1,4 +1,4 @@
-label: Supported Git Platforms
-position: 4
+label: Git
+position: 3
 collapsible: true
 collapsed: false
diff --git a/docs/self-hosted/_category_.yaml b/docs/self-hosted/_category_.yaml
@@ -1,4 +1,4 @@
-label: Self-Hosted CodeRabbit
-position: 8
+label: Self-Hosted
+position: 4
 collapsible: true
 collapsed: false
diff --git a/docs/tools/_category_.yml b/docs/tools/_category_.yml
@@ -1,4 +1,4 @@
 label: Supported Tools
-position: 5
+position: 6
 collapsible: true
 collapsed: true
diff --git a/docusaurus.config.ts b/docusaurus.config.ts
@@ -173,17 +173,11 @@ const config: Config = {
 				target: "_self",
 			},
 			items: [
-				// Direct links to main sections
 				{
 					label: "Docs",
 					position: "left",
-					to: "/", // Root of documentation
-					className: "navbar-link-active", // Highlight current section
-				},
-				{
-					href: "https://api.coderabbit.ai/api/swagger/",
-					label: "API Reference",
-					position: "left",
+					to: "/",
+					className: "navbar-link-active",
 				},
 				{
 					href: "https://blog.coderabbit.ai/blog",
diff --git a/sidebars.ts b/sidebars.ts
@@ -16,6 +16,11 @@ const sidebars: SidebarsConfig = {
 			type: "autogenerated",
 			dirName: ".",
 		},
+		{
+			type: "link",
+			label: "API Reference",
+			href: "https://api.coderabbit.ai/api/swagger/",
+		},
 	],
 }
 
diff --git a/static/img/getting-started/dashboard-coderabbit.png b/static/img/getting-started/dashboard-coderabbit.png
diff --git a/static/img/getting-started/pr-examples.png b/static/img/getting-started/pr-examples.png
