diff --git a/docs/about/features.md b/docs/about/features.md
index 9959e553..75aa77f0 100644
--- a/docs/about/features.md
+++ b/docs/about/features.md
@@ -13,13 +13,13 @@ High-Level Summary: This offers a concise overview of the changes in the pull
request. It helps the team, including those without technical expertise, to
quickly understand the changes and the impact on the product.
-
+
Walkthrough: A detailed code walkthrough to understand the changes in each file
that is part of the pull request, followed by a celebratory poem about the
changes.
-
+
### 2. Code Review feedback {#code-review-feedback}
@@ -27,14 +27,14 @@ Review feedback is posted as review comments on the lines of the code that
changed for each file. Code suggestions are given in a Diff format, which either
be copied or committed within the pull request with a single click.
-
+
A review status is generated for each commit that is reviewed. It displays the
commit IDs that were reviewed, the files examined and ignored, as well as the
additional comments generated for each review, and so on. Review status is
useful for understanding the auxiliary context of the review.
-
+
### 3. Chat with CodeRabbit {#chat-with-coderabbit}
@@ -44,11 +44,11 @@ changes. Just comment on the CodeRabbit review to start the conversation.
CodeRabbit learns from your interactions and gets smarter over time. The more
you chat, the better it gets.
-
+
### 4. Issue Validation {#issue-validation}
Pull request changes are validated against the linked GitHub or GitLab issue and
identifies all other issues which might be affected by this change.
-
+
diff --git a/docs/about/images/CodeRabbitFlow.png b/docs/about/images/CodeRabbitFlow.png
deleted file mode 100644
index 81cce737..00000000
Binary files a/docs/about/images/CodeRabbitFlow.png and /dev/null differ
diff --git a/docs/about/pricing.md b/docs/about/pricing.md
index 470c8fe2..4d71de6f 100644
--- a/docs/about/pricing.md
+++ b/docs/about/pricing.md
@@ -74,15 +74,15 @@ These are the hourly usage limits for each developer per repository:
- During the trial period, seat assignment is automatic, but the number of seats
can be adjusted when purchasing the subscription.
-
-
+
+
### Free Plan
- Seats are assigned to new developers immediately
-
-
+
+
**Note:** The subscription is limited to human users; bot users are not
supported. Thus, pull requests or merge requests created by bots will not be
diff --git a/docs/about/support.md b/docs/about/support.md
index 5a4bad40..c3d8b19f 100644
--- a/docs/about/support.md
+++ b/docs/about/support.md
@@ -22,8 +22,8 @@ Complete the support ticket by providing your name, email, a description of your
issue, and attaching any necessary files. If you are reporting a bug, please
provide the GitHub or GitLab organization name.
-
-
+
+
## Email Support
@@ -33,7 +33,7 @@ You can also reach out to us at
:::tip
To see more common issues faced by CodeRabbit users, visit our
-[FAQ section](../faq/faq.md) for detailed answers and solutions to frequently
+[FAQ section](../faq.md) for detailed answers and solutions to frequently
encountered problems.
:::
diff --git a/docs/guides/configure-coderabbit.md b/docs/configure-coderabbit.md
similarity index 99%
rename from docs/guides/configure-coderabbit.md
rename to docs/configure-coderabbit.md
index 0d43af59..a2b35f10 100644
--- a/docs/guides/configure-coderabbit.md
+++ b/docs/configure-coderabbit.md
@@ -5,7 +5,7 @@ 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: 1
+sidebar_position: 3
---
```mdx-code-block
diff --git a/docs/faq/faq.md b/docs/faq.md
similarity index 78%
rename from docs/faq/faq.md
rename to docs/faq.md
index 3bfae21c..c77ab4ec 100644
--- a/docs/faq/faq.md
+++ b/docs/faq.md
@@ -2,6 +2,7 @@
title: FAQs
sidebar_label: FAQs
description: Frequently asked questions about CodeRabbit.
+sidebar_position: 7
---
### General
@@ -37,8 +38,8 @@ uses proprietary code from private repositories for training purposes.
Yes, you can switch between different organizations on CodeRabbit. To do so,
click on the organization name in the top-left corner of the CodeRabbit UI.
-
-
+
+
#### What Large Language Models does CodeRabbit use?
@@ -46,6 +47,24 @@ CodeRabbit currently utilizes OpenAI's `gpt-4-turbo` and `gpt-3.5-turbo`. We're
researching and testing upcoming LLMs to ensure we're offering the most precise
reviews possible.
+#### How does CodeRabbit compare to other AI code generators?
+
+Code reviews remain essential, whether the code is written by a human or a bot.
+This is mainly because the perspective of the reviewer differs from that of the
+code generator, whether human or machine. This distinction is precisely why
+human peer reviews have been effective for so long. While AI-powered
+code-generation tools like GitHub Copilot hold immense potential, it's important to recognize that
+these generators are still in their early stages and may not be equipped to
+auto-generate meaningful code for moderately complex applications.
+
+#### How is CodeRabbit different from other code review tools?
+
+Traditional code review tools excel in linting and static analysis, but they
+fall short in providing context-aware, conversational feedback with actionable
+suggestions for changes that can be directly committed. On the other hand,
+**CodeRabbit** leverages AI to understand the intent behind the code changes and
+provide human-like feedback for applying the best practices.
+
### Subscription
#### Can a CodeRabbit subscription be used across multiple organizations?
@@ -74,7 +93,7 @@ commit after the app is installed. You can, however, use the
#### Can I customize CodeRabbit?
Reviews are customizable. For information, check out our
-[Customization](../guides/review-instructions.md) guide.
+[Customization](./guides/review-instructions.md) guide.
#### Can I choose a language other than English for the reviews?
@@ -123,7 +142,7 @@ cases, we re-allow further reviews/conversations after a brief timeout.
#### Who can install CodeRabbit on the repositories?
-You need to be an admin of the orgnizaation to add the repositories.
+You need to be an admin of the organization to add the repositories.
#### I can't add CodeRabbit to my GitLab Repositories. What should I do?
@@ -133,6 +152,6 @@ If there are any access restrictions by domain, then you will need to add
:::tip
If you have further questions or need additional information, please check out
-our [Support](../about/support.md) page for more details.
+our [Support](./about/support.md) page for more details.
:::
diff --git a/docs/guides/_category_.yml b/docs/guides/_category_.yml
index 5db22a7a..05797a2e 100644
--- a/docs/guides/_category_.yml
+++ b/docs/guides/_category_.yml
@@ -1,4 +1,4 @@
label: Guides
-position: 3
+position: 5
collapsible: true
collapsed: true
diff --git a/docs/guides/delete-account.md b/docs/guides/delete-account.md
index c7493f48..a50bf343 100644
--- a/docs/guides/delete-account.md
+++ b/docs/guides/delete-account.md
@@ -43,8 +43,8 @@ upon selecting **Delete Account**. You can open the dropdowns for more
information.
<div align="center">
-
-
+
+
</div>
Deletion will only occur once the admin specifically types in "delete" in the
diff --git a/docs/guides/ondemand-reports.md b/docs/guides/ondemand-reports.md
index a2bcf236..cdd7a9b8 100644
--- a/docs/guides/ondemand-reports.md
+++ b/docs/guides/ondemand-reports.md
@@ -25,7 +25,7 @@ Sign in to your CodeRabbit account and navigate to the [**API Keys**](https://ap
Click on the **Create API Key** button and enter a name for the API Key.
Copy the API key, and keep it safe as it won't be visible again.
-
+
## Generate an On-demand report
diff --git a/docs/guides/review-instructions.md b/docs/guides/review-instructions.md
index 8c71b86e..6098fd6d 100644
--- a/docs/guides/review-instructions.md
+++ b/docs/guides/review-instructions.md
@@ -9,7 +9,7 @@ sidebar_position: 3
---
The guide explains how to add custom review instructions for the entire project.
-Also, see the guide on how to [configure CodeRabbit](./configure-coderabbit.md).
+Also, see the guide on how to [configure CodeRabbit](../configure-coderabbit.md).
### Path-based instructions {#path-based}
diff --git a/docs/guides/tools/_category_.yml b/docs/guides/tools/_category_.yml
deleted file mode 100644
index 50634ea9..00000000
--- a/docs/guides/tools/_category_.yml
+++ /dev/null
@@ -1,4 +0,0 @@
-label: Tools
-position: 2
-collapsible: true
-collapsed: true
diff --git a/docs/integrations/_category_.yml b/docs/integrations/_category_.yml
index 17af8110..af2fcbe0 100644
--- a/docs/integrations/_category_.yml
+++ b/docs/integrations/_category_.yml
@@ -1,4 +1,4 @@
label: Integrations
-position: 4
+position: 6
collapsible: true
collapsed: true
diff --git a/docs/integrations/knowledge-base.md b/docs/integrations/knowledge-base.md
new file mode 100644
index 00000000..20014f32
--- /dev/null
+++ 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 will allow CodeRabbit to use the context from the linked issues while reviewing the code.
+
+## 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 the `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 the `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
index 57754da8..aeb6dd4e 100644
--- 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.
@@ -26,22 +27,22 @@ To interact with the GitLab API, a **Personal Access Token** is required. This t
Upon first login to the application (immediately after the onboarding screen), you will need to choose based on your organization's requirements.
-
+
-**We recommend using the default CodeRabbit user** for most organizations as it is pre-configured. However, we understand that some organizations may prefer more control over the user or have restrictions regarding user inclusion within their organization.
+**We recommend using the default CodeRabbit user** for most organizations, as it is pre-configured. However, we understand that some organizations may prefer more control over the user or have restrictions regarding user inclusion within their organization.
### Personal Access Tokens
If your organization opts to use another user within the organization, you can do so by [generating a personal access token](#generating-a-personal-access-token).
-
+
#### Recommendations
* **Create a dedicated user for CodeRabbit** - This ensures the user is exclusively for CodeRabbit, allowing better access control.
* **Use "CodeRabbit" as the username** - This makes the user easily recognizable for future reference.
* **Use a dedicated email address** - This helps in easy identification and management.
-* **Use the CodeRabbit logo as the profile picture** - This further ensures easy recognition. You can download our logo from [here](./images/logo.svg "download").
+* **Use the CodeRabbit logo as the profile picture** - This further ensures easy recognition. You can download our logo from [here](/img/integrations/logo.svg "download").
#### Key Points to Remember
@@ -66,4 +67,4 @@ GitLab provides an option to generate a personal access token for a new user. Fo
9. Click "Create Personal Access Token."
10. Note down the token as it will only be displayed once.
-
+
diff --git a/docs/integrations/self-hosted-gitlab.md b/docs/integrations/self-hosted-gitlab.md
index f5b09aab..aa531fb7 100644
--- 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
@@ -16,7 +17,7 @@ complete, you can log in directly using the OAuth2 flow.
**Visit CodeRabbit:** Visit our [Login](https://coderabbit.ai/login) page and
select Self-Hosted GitLab
-
+
### Step 2: Enter your Self-Managed GitLab URL
@@ -24,7 +25,7 @@ On this page, enter the URL of your self-managed GitLab instance and click
submit. Once, you submit, we check our database for a record of your
organization and if we find an existing one, we are starting the login process.
-
+
If the self-managed GitLab instance is not found, we initiate the onboarding process, which can be either manual or automated.
@@ -32,7 +33,7 @@ If the self-managed GitLab instance is not found, we initiate the onboarding pro
#### 1. Automated onboarding
-
+
#### **Why do we need the Admin Access Token?**
@@ -47,7 +48,7 @@ wish, as the next step.
#### 2. Manual onboarding
For the manual onboarding process we need to create the [CodeRabbit user](#creating-coderabbit-user) and the [OAuth2 GitLab application](#creating-oauth2-application).
-
+
#### **Creating CodeRabbit user**
@@ -89,14 +90,14 @@ the token, please follow the process outlined below:
9. Select Create personal access token.
10. Please note down this token as this will be visible one time only
-
+
### **Step 4: Paste the details and click submit**
- Submit the form.
- We will handle the setup process for you.
- On subsequent visits, your setup will be automatically detected, allowing for
- direct login. 
+ direct login. 
### **Step 5: Whitelist CodeRabbit IP address**
diff --git a/docs/introduction.md b/docs/introduction.md
index e65b1f9f..43e5a0d1 100644
--- a/docs/introduction.md
+++ b/docs/introduction.md
@@ -1,6 +1,6 @@
---
id: introduction
-title: What is CodeRabbit?
+title: Introduction
sidebar_label: Introduction
sidebar_position: 1
description:
@@ -10,6 +10,8 @@ description:
slug: "/"
---
+<iframe width="560" height="315" src="https://www.youtube.com/embed/3SyUOSebG7E?si=i0oT9RAnH0PW81lY" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerPolicy="strict-origin-when-cross-origin" allowFullScreen></iframe>
+
**CodeRabbit** is an innovative, AI-first code reviewer. It provides
context-aware review feedback on a pull request within minutes, thereby
significantly reducing the time and effort associated with manual code reviews.
@@ -23,15 +25,13 @@ performing continuous, incremental reviews for each commit within a pull
request. Review feedback is sent back to the pull requests and can be directly
committed.
-<iframe width="560" height="315" src="https://www.youtube.com/embed/3SyUOSebG7E?si=i0oT9RAnH0PW81lY" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerPolicy="strict-origin-when-cross-origin" allowFullScreen></iframe>
-
**CodeRabbit** integrates into code repositories using GitHub or GitLab webhooks
and monitors events related to Pull Request (PR) and Merge Request (MR) changes.
A comprehensive review is performed when a PR or MR is created, and for
incremental commits and comments addressed to the bot. The feedback is then sent
directly back to the PR or MR.
-
+
## Data, Privacy, and Security
@@ -53,21 +53,3 @@ complies with SOC2 Type II and GDPR standards.
Opting Out: You can choose to opt out of data storage at any time. Opting out
won't affect your access but will limit the personalization of the reviews.
-
-## CodeRabbit with other AI code generators
-
-Code reviews remain essential, whether the code is written by a human or a bot.
-This is mainly because the perspective of the reviewer differs from that of the
-code generator, whether human or machine. This distinction is precisely why
-human peer reviews have been effective for so long. While AI-powered
-code-generation tools like GitHub Copilot hold immense potential, it's important to recognize that
-these generators are still in their early stages and may not be equipped to
-auto-generate meaningful code for moderately complex applications.
-
-## CodeRabbit is different
-
-Traditional code review tools excel in linting and static analysis, but they
-fall short in providing context-aware, conversational feedback with actionable
-suggestions for changes that can be directly committed. On the other hand,
-**CodeRabbit** leverages AI to understand the intent behind the code changes and
-provide human-like feedback for applying the best practices.
diff --git a/docs/tools/_category_.yml b/docs/tools/_category_.yml
new file mode 100644
index 00000000..0ea58591
--- /dev/null
+++ b/docs/tools/_category_.yml
@@ -0,0 +1,4 @@
+label: Supported Tools
+position: 4
+collapsible: true
+collapsed: true
diff --git a/docs/guides/tools/biome.md b/docs/tools/biome.md
similarity index 100%
rename from docs/guides/tools/biome.md
rename to docs/tools/biome.md
diff --git a/docs/guides/tools/checkov.md b/docs/tools/checkov.md
similarity index 100%
rename from docs/guides/tools/checkov.md
rename to docs/tools/checkov.md
diff --git a/docs/guides/tools/detekt.md b/docs/tools/detekt.md
similarity index 100%
rename from docs/guides/tools/detekt.md
rename to docs/tools/detekt.md
diff --git a/docs/guides/tools/eslint.md b/docs/tools/eslint.md
similarity index 100%
rename from docs/guides/tools/eslint.md
rename to docs/tools/eslint.md
diff --git a/docs/guides/tools/gitleaks.md b/docs/tools/gitleaks.md
similarity index 100%
rename from docs/guides/tools/gitleaks.md
rename to docs/tools/gitleaks.md
diff --git a/docs/guides/tools/golangci-lint.md b/docs/tools/golangci-lint.md
similarity index 100%
rename from docs/guides/tools/golangci-lint.md
rename to docs/tools/golangci-lint.md
diff --git a/docs/guides/tools/hadolint.md b/docs/tools/hadolint.md
similarity index 100%
rename from docs/guides/tools/hadolint.md
rename to docs/tools/hadolint.md
diff --git a/docs/guides/tools/languagetool.md b/docs/tools/languagetool.md
similarity index 100%
rename from docs/guides/tools/languagetool.md
rename to docs/tools/languagetool.md
diff --git a/docs/guides/tools/markdownlint.md b/docs/tools/markdownlint.md
similarity index 100%
rename from docs/guides/tools/markdownlint.md
rename to docs/tools/markdownlint.md
diff --git a/docs/guides/tools/phpstan.md b/docs/tools/phpstan.md
similarity index 100%
rename from docs/guides/tools/phpstan.md
rename to docs/tools/phpstan.md
diff --git a/docs/guides/tools/ruff.md b/docs/tools/ruff.md
similarity index 100%
rename from docs/guides/tools/ruff.md
rename to docs/tools/ruff.md
diff --git a/docs/guides/tools/shellcheck.md b/docs/tools/shellcheck.md
similarity index 100%
rename from docs/guides/tools/shellcheck.md
rename to docs/tools/shellcheck.md
diff --git a/docs/guides/tools/swiftlint.md b/docs/tools/swiftlint.md
similarity index 100%
rename from docs/guides/tools/swiftlint.md
rename to docs/tools/swiftlint.md
diff --git a/docs/guides/tools/tools.md b/docs/tools/tools.md
similarity index 98%
rename from docs/guides/tools/tools.md
rename to docs/tools/tools.md
index ef3ad2d0..578e9039 100644
--- a/docs/guides/tools/tools.md
+++ b/docs/tools/tools.md
@@ -1,6 +1,6 @@
---
-title: Tools
-sidebar_label: Tools
+title: Supported Tools
+sidebar_label: Supported Tools
description: Overview of CodeRabbit's supported linters and security analysis tools.
sidebar_position: 1
---
diff --git a/docs/guides/tools/yamllint.md b/docs/tools/yamllint.md
similarity index 100%
rename from docs/guides/tools/yamllint.md
rename to docs/tools/yamllint.md
diff --git a/docusaurus.config.ts b/docusaurus.config.ts
index 83344150..f308639d 100644
--- a/docusaurus.config.ts
+++ b/docusaurus.config.ts
@@ -58,11 +58,11 @@ const config: Config = {
redirects: [
{
from: "/get-started",
- to: "/guides/configure-coderabbit",
+ to: "/configure-coderabbit",
},
{
from: "/guides/customize-coderabbit",
- to: "/guides/configure-coderabbit",
+ to: "/configure-coderabbit",
},
{
from: "/guides/prompt-customization",
diff --git a/docs/about/images/ReviewFeedback.png b/static/img/about/ReviewFeedback.png
similarity index 100%
rename from docs/about/images/ReviewFeedback.png
rename to static/img/about/ReviewFeedback.png
diff --git a/docs/about/images/ReviewStatus.png b/static/img/about/ReviewStatus.png
similarity index 100%
rename from docs/about/images/ReviewStatus.png
rename to static/img/about/ReviewStatus.png
diff --git a/docs/about/images/Summary-Overview.png b/static/img/about/Summary-Overview.png
similarity index 100%
rename from docs/about/images/Summary-Overview.png
rename to static/img/about/Summary-Overview.png
diff --git a/docs/about/images/Summary-Walkthrough.png b/static/img/about/Summary-Walkthrough.png
similarity index 100%
rename from docs/about/images/Summary-Walkthrough.png
rename to static/img/about/Summary-Walkthrough.png
diff --git a/docs/about/images/app-logo.svg b/static/img/about/app-logo.svg
similarity index 100%
rename from docs/about/images/app-logo.svg
rename to static/img/about/app-logo.svg
diff --git a/docs/about/images/chat.png b/static/img/about/chat.png
similarity index 100%
rename from docs/about/images/chat.png
rename to static/img/about/chat.png
diff --git a/static/img/about/coderabbit-flow.png b/static/img/about/coderabbit-flow.png
new file mode 100644
index 00000000..47f8fd2d
Binary files /dev/null and b/static/img/about/coderabbit-flow.png differ
diff --git a/docs/about/images/committable-suggestion.png b/static/img/about/committable-suggestion.png
similarity index 100%
rename from docs/about/images/committable-suggestion.png
rename to static/img/about/committable-suggestion.png
diff --git a/docs/about/images/cr_seat_free_dark.png b/static/img/about/cr_seat_free_dark.png
similarity index 100%
rename from docs/about/images/cr_seat_free_dark.png
rename to static/img/about/cr_seat_free_dark.png
diff --git a/docs/about/images/cr_seat_free_light.png b/static/img/about/cr_seat_free_light.png
similarity index 100%
rename from docs/about/images/cr_seat_free_light.png
rename to static/img/about/cr_seat_free_light.png
diff --git a/docs/about/images/cr_seat_manage_dark.png b/static/img/about/cr_seat_manage_dark.png
similarity index 100%
rename from docs/about/images/cr_seat_manage_dark.png
rename to static/img/about/cr_seat_manage_dark.png
diff --git a/docs/about/images/cr_seat_manage_light.png b/static/img/about/cr_seat_manage_light.png
similarity index 100%
rename from docs/about/images/cr_seat_manage_light.png
rename to static/img/about/cr_seat_manage_light.png
diff --git a/docs/about/images/cr_support_help_dark.png b/static/img/about/cr_support_help_dark.png
similarity index 100%
rename from docs/about/images/cr_support_help_dark.png
rename to static/img/about/cr_support_help_dark.png
diff --git a/docs/about/images/cr_support_help_light.png b/static/img/about/cr_support_help_light.png
similarity index 100%
rename from docs/about/images/cr_support_help_light.png
rename to static/img/about/cr_support_help_light.png
diff --git a/docs/about/images/help1.png b/static/img/about/help1.png
similarity index 100%
rename from docs/about/images/help1.png
rename to static/img/about/help1.png
diff --git a/docs/about/images/help2.png b/static/img/about/help2.png
similarity index 100%
rename from docs/about/images/help2.png
rename to static/img/about/help2.png
diff --git a/docs/about/images/help3.png b/static/img/about/help3.png
similarity index 100%
rename from docs/about/images/help3.png
rename to static/img/about/help3.png
diff --git a/docs/about/images/issue-validation.png b/static/img/about/issue-validation.png
similarity index 100%
rename from docs/about/images/issue-validation.png
rename to static/img/about/issue-validation.png
diff --git a/docs/faq/images/cr_support_orgs_dark.png b/static/img/faq/cr_support_orgs_dark.png
similarity index 100%
rename from docs/faq/images/cr_support_orgs_dark.png
rename to static/img/faq/cr_support_orgs_dark.png
diff --git a/docs/faq/images/cr_support_orgs_light.png b/static/img/faq/cr_support_orgs_light.png
similarity index 100%
rename from docs/faq/images/cr_support_orgs_light.png
rename to static/img/faq/cr_support_orgs_light.png
diff --git a/docs/guides/images/api_keys.png b/static/img/guides/api_keys.png
similarity index 100%
rename from docs/guides/images/api_keys.png
rename to static/img/guides/api_keys.png
diff --git a/docs/guides/images/delete_account_dark.png b/static/img/guides/delete_account_dark.png
similarity index 100%
rename from docs/guides/images/delete_account_dark.png
rename to static/img/guides/delete_account_dark.png
diff --git a/docs/guides/images/delete_account_light.png b/static/img/guides/delete_account_light.png
similarity index 100%
rename from docs/guides/images/delete_account_light.png
rename to static/img/guides/delete_account_light.png
diff --git a/docs/integrations/images/admin-access-token.png b/static/img/integrations/admin-access-token.png
similarity index 100%
rename from docs/integrations/images/admin-access-token.png
rename to static/img/integrations/admin-access-token.png
diff --git a/docs/integrations/images/automated-onboarding.png b/static/img/integrations/automated-onboarding.png
similarity index 100%
rename from docs/integrations/images/automated-onboarding.png
rename to static/img/integrations/automated-onboarding.png
diff --git a/docs/integrations/images/gitlab_organization_user.png b/static/img/integrations/gitlab_organization_user.png
similarity index 100%
rename from docs/integrations/images/gitlab_organization_user.png
rename to static/img/integrations/gitlab_organization_user.png
diff --git a/docs/integrations/images/gitlab_user_choice.png b/static/img/integrations/gitlab_user_choice.png
similarity index 100%
rename from docs/integrations/images/gitlab_user_choice.png
rename to static/img/integrations/gitlab_user_choice.png
diff --git a/docs/integrations/images/login-page.png b/static/img/integrations/login-page.png
similarity index 100%
rename from docs/integrations/images/login-page.png
rename to static/img/integrations/login-page.png
diff --git a/docs/integrations/images/logo.svg b/static/img/integrations/logo.svg
similarity index 100%
rename from docs/integrations/images/logo.svg
rename to static/img/integrations/logo.svg
diff --git a/docs/integrations/images/manual-onboarding.png b/static/img/integrations/manual-onboarding.png
similarity index 100%
rename from docs/integrations/images/manual-onboarding.png
rename to static/img/integrations/manual-onboarding.png
diff --git a/docs/integrations/images/self-hosted-gitlab-host-url.png b/static/img/integrations/self-hosted-gitlab-host-url.png
similarity index 100%
rename from docs/integrations/images/self-hosted-gitlab-host-url.png
rename to static/img/integrations/self-hosted-gitlab-host-url.png
diff --git a/docs/integrations/images/self-hosted-page.png b/static/img/integrations/self-hosted-page.png
similarity index 100%
rename from docs/integrations/images/self-hosted-page.png
rename to static/img/integrations/self-hosted-page.png