Skip to content

Commit 010a385

Browse files
committed
gettings-started/ reviewed + support languages revamp
1 parent 46bae36 commit 010a385

14 files changed

+468
-1013
lines changed

docusaurus/docs/codacy-guardrails/codacy-guardrails-how-to-configure-rules.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
title: How to customize the analysis rules for Codacy Guardrails
3+
sidebar_label: Customizing analysis rules
34
---
45

56
By default, if no API token is provided in the [MCP Server setup](codacy-guardrails-getting-started#3-install-mcp-server), Codacy uses a predefined configuration that includes all recommended rules (or [code patterns](../repositories-configure/configuring-code-patterns) that you can find on many parts of our product) from the supported built-in scanners.

docusaurus/docs/enterprise-cloud/github-enterprise-cloud.md renamed to docusaurus/docs/enterprise-cloud/github-enterprise-cloud.mdx

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,5 +67,3 @@ Currently, the integration between Codacy and GitHub Enterprise has the followin
6767
- [How does Codacy support GitLab Enterprise?](../faq/general/how-does-codacy-support-gitlab-enterprise.md)
6868
- [How does Codacy support Bitbucket Cloud?](../faq/general/how-does-codacy-support-bitbucket-cloud.md)
6969
- [How does Codacy support Bitbucket Server?](../faq/general/how-does-codacy-support-bitbucket-server.md)
70-
71-
<br /><br />

docusaurus/docs/getting-started/_order.ts

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,11 @@ export const gettingStartedOrder = [
66
type: 'category' as const,
77
label: 'Integrating Codacy with your IDE',
88
items: [
9-
'getting-started/configure-ide/integrating-codacy-with-intellij-ides',
10-
'getting-started/configure-ide/integrating-codacy-with-visual-studio-code',
9+
'getting-started/integrating-codacy-with-intellij-ides',
10+
'getting-started/integrating-codacy-with-visual-studio-code',
1111
],
1212
},
1313
'getting-started/supported-languages-and-tools',
1414
'getting-started/which-permissions-does-codacy-need-from-my-account',
1515
'getting-started/adding-a-codacy-badge',
1616
];
17-

docusaurus/docs/getting-started/adding-a-codacy-badge.md renamed to docusaurus/docs/getting-started/adding-a-codacy-badge.mdx

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,18 @@
22
title: Adding a Codacy badge
33
---
44

5-
65
Add a Codacy badge to the README of your repository to display the current [code quality grade](../faq/code-analysis/which-metrics-does-codacy-calculate.md#grade) or [code coverage](../faq/code-analysis/which-metrics-does-codacy-calculate.md#code-coverage) of your repository.
76

8-
<!-- vale off -->
7+
8+
{/*<!-- vale off -->*/}
99
![Codacy badge on the codacy/docs README](images/codacy-badge-example.png)
10-
<!-- vale on -->
10+
{/*<!-- vale on -->*/}
1111

12-
To obtain your Codacy badge, open your repository **Settings**, tab **General**, select the markup language, and copy the generated code to your README file. You can also add a badge for your coverage if you have [set up code coverage](../coverage-reporter/index.md) for your repository.
12+
To obtain your Codacy badge, open your repository **Settings**, tab **General**, select the markup language, and copy the generated code to your README file. You can also add a badge for your coverage if you have [set up code coverage](../coverage-reporter/index.mdx) for your repository.
1313

1414
![Codacy badge](images/codacy-badge.png)
1515

16-
To display the grade or code coverage information of a [different branch](../repositories-configure/managing-branches.mdx) analyzed by Codacy, append `?branch=<branch_name>` to the URL of the badge. For example:
16+
To display the grade or code coverage information of a [different branch](../repositories-configure/managing-branches) analyzed by Codacy, append `?branch=<branch_name>` to the URL of the badge. For example:
1717

1818
```text
1919
https://app.codacy.com/project/badge/Grade/cba8fd0874ac4f569f4f880e473cbac9?branch=dev
@@ -27,7 +27,7 @@ The Codacy badges for your repository may become unavailable or grayed out if th
2727

2828
To fix each badge:
2929

30-
- [Reanalyze the branch](../faq/repositories/how-do-i-reanalyze-my-repository.md#reanalyzing-a-branch) associated with the **code quality badge**
30+
- [Reanalyze the branch](../faq/repositories/how-do-i-reanalyze-my-repository#reanalyzing-a-branch) associated with the **code quality badge**
3131
- Make sure that you're [generating and uploading code coverage reports](../../coverage-reporter/) for all the commits in the branch associated with the **coverage badge**
3232

33-
If these steps don't fix your Codacy badges it can mean that the badges are no longer valid. In this case, [repeat the steps above](#adding-a-codacy-badge) to replace the existing badges with new ones.
33+
If these steps don't fix your Codacy badges it can mean that the badges are no longer valid. In this case, repeat the steps above to replace the existing badges with new ones.

docusaurus/docs/getting-started/codacy-quickstart.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,13 +37,13 @@ To get started, head to [<span class="skip-vale">codacy.com</span>](https://www.
3737
1. [Choosing an organization](#choosing-organization)
3838
1. [Adding repositories](#adding-repositories)
3939

40-
## 1. Signing-up ||signing-up||
40+
## 1. Signing-up \{#signing-up\}
4141

4242
Sign up with a Git provider such as GitHub, GitLab, or Bitbucket. This links your Codacy user with your Git provider user, making it easier to add repositories to Codacy and invite your teammates.
4343

4444
Codacy will request access to your Git provider during the authorization flow. [Check the permissions that Codacy requires and why](which-permissions-does-codacy-need-from-my-account).
4545

46-
## 2. Choosing an organization ||choosing-organization||
46+
## 2. Choosing an organization \{#choosing-organization\}
4747

4848
Now, you'll need to add or join the organizations that contain your repositories. The organization with the same name as your Git provider username contains your personal repositories. Read more about [organizations on Codacy](../../organizations/what-are-organizations).
4949

@@ -55,7 +55,7 @@ If you can't see the organization you're looking for, [follow these troubleshoot
5555

5656
![Choosing an organization](../organizations/images/organization-add.png)
5757

58-
## 3. Adding repositories ||adding-repositories||
58+
## 3. Adding repositories \{#adding-repositories\}
5959

6060
Next, add the repositories that you wish to analyze. Codacy begins an initial analysis as soon as you add a repository and sets everything up to ensure your next commits on that repository are analyzed.
6161

@@ -73,4 +73,4 @@ Click the repository name to navigate to the repository dashboard and see the [c
7373

7474
## Next steps
7575

76-
The first analysis is based on default tool and pattern configurations. It's now important that you configure your repository to integrate code analysis seamlessly into your existing pipeline. See how to [configure your repository to match the use cases of your team](configuring-your-repository.md).
76+
The first analysis is based on default tool and pattern configurations. It's now important that you configure your repository to integrate code analysis seamlessly into your existing pipeline. See how to [configure your repository to match the use cases of your team](configuring-your-repository).

docusaurus/docs/getting-started/configure-ide/_category_.json

Lines changed: 0 additions & 3 deletions
This file was deleted.

docusaurus/docs/getting-started/configuring-your-repository.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,15 +19,15 @@ To configure your repository, follow these steps:
1919

2020
## 1. Ignoring files \{#ignoring-files\}
2121

22-
[Ignore any files and directories](../repositories-configure/ignoring-files.md) that aren't relevant for the Codacy analysis, such as generated code or any third-party libraries included in your repositories.
22+
[Ignore any files and directories](../repositories-configure/ignoring-files) that aren't relevant for the Codacy analysis, such as generated code or any third-party libraries included in your repositories.
2323

2424
![Ignoring files](../repositories-configure/images/ignored-files.png)
2525

2626
## 2. Configuring code patterns \{#configuring-code-patterns\}
27-
[Configure the tools and code patterns](../repositories-configure/configuring-code-patterns.md) that Codacy uses to analyze your repository. If security is important for your team, review the [Security and risk management dashboard](../organizations/managing-security-and-risk.md) to ensure that your configuration detects potential security issues.
27+
[Configure the tools and code patterns](../repositories-configure/configuring-code-patterns) that Codacy uses to analyze your repository. If security is important for your team, review the [Security and risk management dashboard](../organizations/managing-security-and-risk) to ensure that your configuration detects potential security issues.
2828

2929
:::tip
30-
To ensure that multiple repositories consistently follow the same global tool and code pattern configurations, [use an organization coding standard](../organizations/using-coding-standards.md).
30+
To ensure that multiple repositories consistently follow the same global tool and code pattern configurations, [use an organization coding standard](../organizations/using-coding-standards).
3131
:::
3232

3333
![Configuring the tools and code patterns](../repositories-configure/images/code-patterns.png)
@@ -40,8 +40,8 @@ It's important that you set up coverage beforehand because Codacy can only repor
4040
![Adding coverage to your repository](../coverage-reporter/images/coverage-codacy-ui.png)
4141

4242
## Next steps \{#next-steps\}
43-
Once you’re satisfied with your setup, [integrate Codacy with your Git workflow](integrating-codacy-with-your-git-workflow.md) to flag potential issues, block problematic pull requests, and display other useful suggestions directly on your Git provider.
43+
Once you’re satisfied with your setup, [integrate Codacy with your Git workflow](./integrating-codacy-with-your-git-workflow) to flag potential issues, block problematic pull requests, and display other useful suggestions directly on your Git provider.
4444

4545
:::tip
46-
To showcase the current code quality grade and coverage, [add a Codacy badge to your repository](adding-a-codacy-badge.md).
46+
To showcase the current code quality grade and coverage, [add a Codacy badge to your repository](./adding-a-codacy-badge).
4747
:::

docusaurus/docs/getting-started/configure-ide/integrating-codacy-with-intellij-ides.md renamed to docusaurus/docs/getting-started/integrating-codacy-with-intellij-ides.mdx

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -12,19 +12,19 @@ The [Codacy IntelliJ plugin](https://github.com/codacy/codacy-intellij-extension
1212

1313
The main view of the Codacy IntelliJ plugin provides a summary of the code quality and coverage changes introduced by the pull request of the currently checked-out branch.
1414

15-
![Main view](./../images/codacy-intellij-plugin-main-view.png)
15+
![Main view](./images/codacy-intellij-plugin-main-view.png)
1616

1717
In the main view, you can find the following information:
1818

19-
- The **Status** of the pull request, either up to standards or not up to standards, based on the [Gates](../repositories-configure/adjusting-quality-gates.md) set for the repository.
19+
- The **Status** of the pull request, either up to standards or not up to standards, based on the [Gates](../repositories-configure/adjusting-quality-gates) set for the repository.
2020

21-
- Any **issues** introduced or fixed by the pull request. These are the same issues you find in the [Issues tabs](../repositories/pull-requests.mdx#issues-tabs) in the Codacy app and are also visible in IntelliJ's Problems tab.
21+
- Any **issues** introduced or fixed by the pull request. These are the same issues you find in the [Issues tabs](../repositories/pull-requests#issues-tabs) in the Codacy app and are also visible in IntelliJ's Problems tab.
2222

2323
When this item is expanded, the number next to each file name is the total number of issues that the pull request adds to that file.
2424

2525
- The **diff coverage** introduced by the pull request. The percentage next to each file name is the coverage variation for that file.
2626

27-
- Sequences of **duplicate code** (clones) introduced by the pull request. These are the same ones you find in the [Duplication tabs](../repositories/pull-requests.mdx#duplication-tabs) in the Codacy app.
27+
- Sequences of **duplicate code** (clones) introduced by the pull request. These are the same ones you find in the [Duplication tabs](../repositories/pull-requests#duplication-tabs) in the Codacy app.
2828

2929
- Variations in **code complexity** introduced by the pull request.
3030

@@ -33,10 +33,10 @@ In the main view, you can find the following information:
3333
:::note[The Codacy IntelliJ plugin is compatible with IntelliJ IDEA (Ultimate, Community), Android Studio, and Aqua.]
3434
:::
3535

36-
1. Make sure that the repository you’re working on is analyzed by Codacy and that you have a [repository read](../organizations/roles-and-permissions-for-organizations.md) role or higher.
36+
1. Make sure that the repository you’re working on is analyzed by Codacy and that you have a [repository read](../organizations/roles-and-permissions-for-organizations) role or higher.
3737

3838
:::tip
39-
If this is your first time using Codacy, see [how to add and analyze your first repository](./codacy-quickstart.md#adding-your-first-repository).
39+
If this is your first time using Codacy, see [how to add and analyze your first repository](./codacy-quickstart#adding-your-first-repository).
4040
:::
4141

4242
1. Install the plugin from the [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/23924-codacy) or through the [plugin settings panel](https://www.jetbrains.com/help/idea/managing-plugins.html) in your IntelliJ IDE.
@@ -48,12 +48,12 @@ To see Codacy quality and coverage data for an open pull request, follow these s
4848
1. Open the repository directory in your IntelliJ IDE.
4949

5050
:::note
51-
If the repository isn't on Codacy yet, [add it to Codacy](../organizations/managing-repositories.md#adding-a-repository) first.
51+
If the repository isn't on Codacy yet, [add it to Codacy](../organizations/managing-repositories#adding-a-repository) first.
5252
:::
5353

5454
1. Open the main view by clicking the **Codacy logo** in the left tool window bar.
5555

56-
![Codacy main view](./../images/codacy-intellij-plugin-sign-in.png)
56+
![Codacy main view](./images/codacy-intellij-plugin-sign-in.png)
5757

5858
1. If you’re not signed in, click the **Sign in** button to authorize IntelliJ on Codacy.
5959

@@ -77,20 +77,20 @@ To review issues:
7777

7878
1. Open the **Problems tool window** (use `Ctrl+6` on Windows/Linux or `Cmd+6` on macOS) and select the **File** tab.
7979

80-
![Navigate to a specific issue from the Problems tab](./../images/codacy-intellij-plugin-problems-tab.png)
80+
![Navigate to a specific issue from the Problems tab](./images/codacy-intellij-plugin-problems-tab.png)
8181

8282
1. Click the name of the issue you want to review.
8383

8484
1. Hover over a highlighted issue in the code editor to view available actions and suggested quick fixes, if available.
8585

86-
For a list of tools that support suggested fixes, see [Supported languages and tools](./supported-languages-and-tools.md#supported-languages-and-tools).
86+
For a list of tools that support suggested fixes, see [Supported languages and tools](./supported-languages-and-tools).
8787

8888
1. Once you've addressed the problems in your code, push your changes to the Git provider so that Codacy analyzes the updated code.
8989

9090
When the analysis is complete, the Codacy plugin automatically refreshes the pull request analysis result. You can also refresh the pull request data manually by clicking the Refresh Pull Request button in the main view.
9191

9292
## Running Codacy Guardrails
93-
As of version [0.0.8](https://plugins.jetbrains.com/plugin/23924-codacy/versions/stable/840439), the IntelliJ plugin now supports Codacy Guardrails. To see how to get it quickly setup refer to our quickstart guide [here](../codacy-guardrails/codacy-guardrails-getting-started.md#how-to-install-quick-guide-jetbrains).
93+
As of version [0.0.8](https://plugins.jetbrains.com/plugin/23924-codacy/versions/stable/840439), the IntelliJ plugin now supports Codacy Guardrails. To see how to get it quickly setup refer to our quickstart guide [here](../codacy-guardrails/codacy-guardrails-getting-started#how-to-install-quick-guide-jetbrains).
9494

9595
## See also
9696

0 commit comments

Comments
 (0)