docs: Move linter documentation to tools folder

docs/guides/tools/linters.md

@@ -0,0 +1,39 @@
+---
+title: Tools
+sidebar_label: Tools
+description: Overview of CodeRabbit's supported linters and security analysis tools.
+sidebar_position: 1
+---
+
+CodeRabbit supports various linters and security analysis tools to improve the code review process. The output of these tools is used to enhance the feedback provided by CodeRabbit, making it possible to provide 1-click fixes for common issues.
+
+## Enabling/Disabling Tools
+
+You can enable or disable tools by setting `reviews.tools.<linter>.enabled` in your project's `.coderabbit.yaml` file or setting the "Review → Tools → Linter → Enabled" field in CodeRabbit's settings page.
+
+## Customizing Tools
+
+CodeRabbit supports customizing the strictness of tools by setting `reviews.profile` in your project's `.coderabbit.yaml` file or setting the "Review → Profile" field in CodeRabbit's settings page. The following profiles are available:
+
+- `Chill` - Yields less feedback, that may be considered lenient.
+- `Assertive` - Yields more feedback, that may be considered nit-picky.
+
+Apart from the overall profile, you can also configure each tool by providing a configuration file (specific to the tool) in your project. This would allow you to further customize the tool's behavior, by enabling/disabling specific rules, setting rule severity, etc.
+
+## Checking Tool Output
+
+When a tool is enabled, CodeRabbit will run it on your change request and attach the output under "Review details" comment in the change request. The output will be displayed in a structured format, with information on the file, line number, and the issue detected. For example:
+
+```text
+Ruff
+fib.py
+21-21: f-string without any placeholders
+
+Remove extraneous f prefix
+
+(F541)
+```
+
+## Supported Tools
+
+- [Ruff](./ruff.md)

docs/guides/linters/ruff.md → docs/guides/tools/ruff.md

@@ -1,7 +1,7 @@
 ---
 title: Ruff
 sidebar_label: Ruff
-description: Overview of CodeRabbit's supported linters and security analysis tools.
+description: CodeRabbit's guide to Ruff.
 sidebar_position: 1
 ---