fix vale issues

Author: DMarinhoCodacy

docs/codacy-guardrails/codacy-guardrails-faq.md

@@ -4,16 +4,16 @@
 Please have a look at our [documentation](codacy-guardrails-getting-started.md)
 
 ## Does Guardrails only work with AI-generated code?
-No — while Guardrails does scan and auto-fix AI code as part of the agent flow, it scans any code shown in your IDE in real-time, regardless of how it was written.
+No. While Guardrails does scan and autofix AI code as part of the agent flow, it scans any code shown in your IDE in real-time, regardless of how it was written.
 
-## How is Guardrails different from Codacy’s traditional analysis?
+## How's Guardrails different from Codacy’s traditional analysis?
 Guardrails is IDE-first and real-time. It complements Codacy’s platform analysis by catching issues earlier in the development cycle.
 
 ## Does Guardrails work offline?
 Yes, local scanning via Codacy CLI works offline. API-based features (like querying metrics) require connectivity.
 
 ## Which AI security and quality standards can I enforce with Guardrails?
-Codacy Guardrails detects and auto-remediates security risks and quality issues in JavaScript, TypeScript, Python, and Java, including:
+Codacy Guardrails detects and autoremediates security risks and quality issues in JavaScript, TypeScript, Python, and Java, including:
 
 
 -  SAST vulnerabilities
@@ -29,7 +29,7 @@ Codacy Guardrails detects and auto-remediates security risks and quality issues
 Configuring and enforcing coding standards at scale across all IDEs in your organization requires a Codacy Team or Business subscription.
 
 ## Is my data secure?
-Codacy Guardrails is not a large language model, but an IDE extension that uses an MCP Server to communicate with existing AI coding agents owned by the user.
+Codacy Guardrails isn't a large language model, but an IDE extension that uses an MCP Server to communicate with existing AI coding agents owned by the user.
 
 ## When I change some analysis configuration in the UI, is it automatically applied to Guardrails?
 We're still working on this feature but in order to update the new tool configuration. you should run the command in your repository:
@@ -50,7 +50,7 @@ Check our [Team and Organization plans](https://www.codacy.com/pricing) to unloc
 
 
 -  Central configuration and enforcement of AI coding standards across teams and projects
--  Query and auto-fix existing problems across your codebase from the AI chat panel
+-  Query and autofix existing problems across your codebase from the AI chat panel
 -  Generate custom security and code quality reports using AI prompts
 -  Full access to the Codacy Cloud platform including:
 
@@ -65,6 +65,6 @@ Check our [Team and Organization plans](https://www.codacy.com/pricing) to unloc
 Guardrails is supported on MacOS, Linux, and Windows (via [WSL](https://learn.microsoft.com/en-us/windows/wsl/install))
 
 ## Can I use Guardrails without an AI copilot?
-Codacy Guardrails is designed to be installed from our IDE extension for VS Code, Cursor and Windsurf. but as long as you have an AI code generator that is compatible with the MCP protocol you can also add Guardrails into your MCP configuration manually.
+Codacy Guardrails is designed to be installed from our IDE extension for VS Code, Cursor and Windsurf. but as long as you have an AI code generator that's compatible with the MCP protocol you can also add Guardrails into your MCP configuration manually.
 
 Without an AI coding agent, you instead need to use the Codacy IDE extension without the MCP Server.

docs/codacy-guardrails/codacy-guardrails-getting-started.md

@@ -40,7 +40,7 @@ Besides real-time AI code scanning, Guardrails users can now prompt all their Co
 - ESLint
 - Pylint
 - PMD
-- DartAnalyzer
+- dartanalyzer
 - [Lizard](https://docs.codacy.com/release-notes/cloud/cloud-2025-02-adding-ruff-lizard/#lizard)
 
 ## How to install - Quick Guide
@@ -81,7 +81,7 @@ In the Codacy Extension tab, click **Add Codacy MCP Server**
 
 #### b. Check if the Codacy MCP Server is enabled
 
-On the left side menu of the Codacy extension, please make sure that mcp server is set up and ready.
+On the left side menu of the Codacy extension, please make sure that MCP server is set up and ready.
 
 ![Codacy MCP Server is enabled](images/mcp-server-enabled.png)
 
@@ -104,7 +104,7 @@ brew install codacy/codacy-cli-v2/codacy-cli-v2
 
 ##### Linux
 
-For Linux, we rely on the codacy-cli.sh script in the root. To download the CLI, run:
+For Linux, we rely on the **codacy-cli.sh** script in the root. To download the CLI, run:
 
 ```bash
 bash <(curl -Ls https://raw.githubusercontent.com/codacy/codacy-cli-v2/main/codacy-cli.sh)
@@ -191,12 +191,12 @@ Or open the general settings.json file directly, which according to your OS shou
 
 Make sure you update the value of `CODACY_ACCOUNT_TOKEN` with your [API token](../codacy-api/api-tokens.md).
 
-a.  Above the MCP Server configuration in **Settings.json** file, you can Click in the command **Start**
+a. Above the MCP Server configuration in **Settings.json** file, you can Click in the command **Start**
 
 ![Start MCP Server in VSCode](images/start-mcp-server-vscode.png)
 
-b.  Make sure you have Agent mode enabled: [vscode://settings/chat.agent.enabled](vscode://settings/chat.agent.enabled)
+b. Make sure you have Agent mode enabled: [vscode://settings/chat.agent.enabled](vscode://settings/chat.agent.enabled)
 
-c.  Open the Copilot chat and switch the mode to `Agent`. You can check that the MCP server was enabled correctly by clicking on the `Select tools` icon, which should list all the available Codacy tools.
+c. Open the Copilot chat and switch the mode to `Agent`. You can check that the MCP server was enabled correctly by clicking on the `Select tools` icon, which should list all the available Codacy tools.
 
 ![Copilot Agent with Codacy tools](images/copilot_agent.png)

docs/codacy-guardrails/codacy-guardrails-how-to-configure-rules.md

@@ -7,9 +7,9 @@ However, when an API token is used, Codacy automatically retrieves the current r
 You can configure your rules in one of two ways:
 
 
--  Using [built-in scanner configuration files](#using-configuration-files) – for version-controlled setups.
+-  Using [built-in scanner configuration files](#using-configuration-files)–for version-controlled setups.
 
--  Using the [Codacy UI](#using-the-codacy-ui) – for quick, manual adjustments.
+-  Using the [Codacy UI](#using-the-codacy-ui)–for quick, manual adjustments.
 
 !!! note
     If you're already using a configuration file, please we recommend you can follow the first way. Otherwise, the second way is the best for you, so you can configure directly in the Codacy platform.
@@ -132,5 +132,5 @@ Select the coding standards that you want to follow or stop following and click
 ![Customize applied coding standards](images/code-patterns-cs-customize-modal.png)
 
 !!! note
-    -  Scanners and rules enabled by a coding standard are enforced and cannot be disabled.
-    -  You can add extra scanners and rules, if these are not enabled by any applied coding standard.
+    -  Scanners and rules enabled by a coding standard are enforced and can't be disabled.
+    -  You can add extra scanners and rules, if these aren't enabled by any applied coding standard.

docs/codacy-guardrails/codacy-guardrails-how-to-use.md

@@ -2,7 +2,7 @@
 
 ## Write secure, compliant AI code
 
-a.  Let's run an prompt to create a webserver in Java
+a. Let's run an prompt to create a webserver in Java
 
 ```text
 Create a lightweight webserver in Java.
@@ -14,15 +14,15 @@ In response, it generated a compact, readable Java class using ServerSocket and
 
 ![response to the webserver creation using AI](images/response-webserver.png)
 
-b.  There's a call from MCP tool to analyse the code that was generated. Click in **Run tool**
+b. There's a call from MCP tool to analyse the code that was generated. Click in **Run tool**
 
-Codacy Guardrails starts analyzing it automatically using the Codacy CLI embedded in the agent’s flow. No configs, no extra steps – it just works.
+Codacy Guardrails starts analyzing it automatically using the Codacy CLI embedded in the agent’s flow. No configurations, no extra steps–it just works.
 
-It found an issue with PMD - the package name is not correctly declared - and it will try to fix that with the right declaration.
+It found an issue with PMD - the package name isn't correctly declared - and it will try to fix that with the right declaration.
 
 ![analysis to the webserver implementation](images/analysis-webserver-implementation.png)
 
-c.  After a new analysis, It shows us that it has 0 issues in the code
+c. After a new analysis, It shows us that it has 0 issues in the code
 
 ![zero issues in the webserver implementation](images/no-issues-webserver.png)
 
@@ -31,7 +31,7 @@ c.  After a new analysis, It shows us that it has 0 issues in the code
 Once your repository is connected to Codacy, you can go beyond traditional static analysis and start interacting with your codebase using simple natural language prompts.
 
 
-a.  Let's run a quick example with the prompt:
+a. Let's run a quick example with the prompt:
 
 ```text
 Can you list all security issues in my repository?
@@ -40,12 +40,12 @@ Can you list all security issues in my repository?
 ![Prompt list the security issues in my repository](images/prompt-list-security-issues-repository.png)
 
 
-b.  Right after running this prompt, there is a MCP tool call to search all security issues in my repository. Click in **Run tool**
+b. Right after running this prompt, there is a MCP tool call to search all security issues in my repository. Click in **Run tool**
 
 ![List the security issues in my repository](images/run-mcp-tool-list-security-issues.png)
 
 It will search for all open security issues in my repository. And it will list all of them, showing the **title**, **priority**, **status** and the **link to the issue**, 
 
 ![List the security issues in my repository](images/list-security-issues.png)
 
-It turned security from a checklist into a dialogue — and that changes everything.
+It turned security from a checklist into a dialogue—and that changes everything.