Add linter documentation

docs/guides/commands.md

@@ -4,7 +4,7 @@ sidebar_label: CodeRabbit Commands
 description:
   CodeRabbit offers various commands that can be invoked as PR comments to
   control the review process.
-sidebar_position: 3
+sidebar_position: 4
 ---
 
 The following commands are available (invoked as PR comments):

docs/guides/delete-account.md

@@ -2,7 +2,7 @@
 title: Delete CodeRabbit Account
 sidebar_label: Delete CodeRabbit Account
 # description:
-sidebar_position: 3
+sidebar_position: 5
 ---
 
 The guide explains how to delete your CodeRabbit account and all the data

docs/guides/ondemand-reports.md

@@ -3,7 +3,7 @@ title: On-demand Reports
 sidebar_label: On-demand Reports (Beta)
 description:
   CodeRabbit offers a way to generate on-demand reports using a simple API request
-sidebar_position: 5
+sidebar_position: 6
 ---
 
 ```mdx-code-block
@@ -54,7 +54,6 @@ Sample output:
 ]
 ```
 
-
 :::info
 
 If you get a 401 UNAUTHORIZED error, check if you're passing the right API key in the `x-coderabbitai-api-key` header

docs/guides/review-instructions.md

@@ -5,7 +5,7 @@ description:
   CodeRabbit offers various customization options to tailor the reviews to your
   specific requirements. Customizations can be made using one of the below
   options.
-sidebar_position: 2
+sidebar_position: 3
 ---
 
 The guide explains how to add custom review instructions for the entire project.

docs/guides/tools/_category_.yml

@@ -0,0 +1,4 @@
+label: Linters
+position: 2
+collapsible: true
+collapsed: true

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/tools/ruff.md

@@ -0,0 +1,122 @@
+---
+title: Ruff
+sidebar_label: Ruff
+description: CodeRabbit's guide to Ruff.
+sidebar_position: 1
+---
+
+Ruff is a linter and code formatter for Python.
+
+## Settings
+
+Ruff supports the following config files:
+
+- `pyproject.toml`
+- `ruff.toml`
+- `.ruff.toml`
+
+CodeRabbit will use the following settings if no config file is found:
+
+### Chill
+
+```toml
+[lint]
+select = [
+    # pycodestyle subset rules
+    "E7",
+    "E9",
+    # Pyflakes
+    "F",
+    # flake8-bugbear
+    "B",
+    # flake8-simplify
+    "SIM",
+    # isort subset rules
+    "I002",
+]
+[lint.per-file-ignores]
+"**/__init__.py" = ["E402"]
+"**/conftest.py" = ["E402"]
+```
+
+### Assertive
+
+```toml
+[lint]
+select = [
+    # pycodestyle subset rules
+    "E7",
+    "E9",
+    # Pyflakes
+    "F",
+    # flake8-bugbear
+    "B",
+    # flake8-simplify
+    "SIM",
+    # isort subset rules
+    "I002",
+    # pycodestyle subset rules
+    "E4",
+    "E101",
+    # mccabe
+    "C90",
+    # flake8-annotations
+    "ANN",
+    # flake8-async
+    "ASYNC",
+    # flake8-trio
+    "TRIO",
+    # flake8-bandit
+    "S",
+    # flake8-blind-except
+    "BLE",
+    # flake8-boolean-trap
+    "FBT",
+    # flake8-commas
+    "COM",
+    # flake8-comprehensions
+    "C4",
+    # flake8-datetimez
+    "DTZ",
+    # flake8-debugger
+    "T10",
+    # flake8-django
+    "DJ",
+    # flake8-executable
+    "EXE",
+    # flake8-implicit-str-concat
+    "ISC",
+    # flake8-logging
+    "LOG",
+    # flake8-logging-format
+    "G",
+    # flake8-pie
+    "PIE",
+    # flake8-pytest-style
+    "PT",
+    # flake8-raise
+    "RSE",
+    # flake8-return
+    "RET",
+    # flake8-unused-arguments
+    "ARG",
+    # tryceratops
+    "TRY",
+    # flynt
+    "FLY",
+    # Ruff-specific rules
+    "RUF",
+    # pyupgrade
+    "UP",
+]
+[lint.per-file-ignores]
+"**/__init__.py" = ["E402"]
+"**/conftest.py" = ["E402"]
+"**/*_test.py" = ["S101"]
+"**/test_*.py" = ["S101"]
+"**/{test,tests}/**/*.py" = ["S101"]
+```
+
+Links:
+
+- [Ruff](https://docs.astral.sh/ruff/configuration/)