diff --git a/pyproject.toml b/pyproject.toml
index 6a107899..06a35bc5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -56,12 +56,17 @@ ignore = [
     "EM101", # https://docs.astral.sh/ruff/rules/raw-string-in-exception/
     "EM102", # https://docs.astral.sh/ruff/rules/f-string-in-exception/
     "S101", # https://docs.astral.sh/ruff/rules/assert/
-    "TRY003",
-    "PD", # false positives; not using Pandas
+    "TRY003", # https://docs.astral.sh/ruff/rules/raise-vanilla-args/
+    "PD", # https://docs.astral.sh/ruff/rules/#pandas-vet-pd (false positives)
 ]
 [tool.ruff.per-file-ignores]
 "**/__init__.py" = ["F401"]
-"tests/**/*.py" = ["S106", "S108", "ANN", "PT009"]
+"tests/**/*.py" = [
+    "S106", # https://docs.astral.sh/ruff/rules/hardcoded-password-func-arg/
+    "S108", # https://docs.astral.sh/ruff/rules/hardcoded-temp-file/
+    "ANN", # https://docs.astral.sh/ruff/rules/#flake8-annotations-ann
+    "PT009" # https://docs.astral.sh/ruff/rules/pytest-unittest-assertion/
+]
 # the following exclusions have been introduced to prevent huge changes
 # feel free to remove them and fix the code
 "gitopscli/appconfig_api/app_tenant_config.py" = ["PTH110", "PTH112", "PTH118"]