diff --git a/pyproject.toml b/pyproject.toml
index 32d09df..f5ab924 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -31,26 +31,35 @@ indent-width = 4
 
 [tool.ruff.lint]
 select = [
-    "RUF", # Ruff specific rules
-    "N",   # pep8-naming
-    "I",   # isort
-    "F",   # pyflakes
-    "UP",  # pyupgrade
-    "E",   # pycodestyle errors
-    "W",   # pycodestyle warnings
-    "ANN", # flake8-annotations
-    "S",   # flake8-bandit
-    "B",   # flake8-bugbear
-    "A",   # flake8-builtins
-    "C4",  # flake8-comprehensions
-    "DTZ", # flake8-datetimez
+    "A",   # flake8-builtins ---------------> https://docs.astral.sh/ruff/rules/#flake8-builtins-a
+    "ANN", # flake8-annotations ------------> https://docs.astral.sh/ruff/rules/#flake8-annotations-ann
+    "B",   # flake8-bugbear ----------------> https://docs.astral.sh/ruff/rules/#flake8-bugbear-b
+    "C4",  # flake8-comprehensions ---------> https://docs.astral.sh/ruff/rules/#flake8-comprehensions-c4
+    "C90", # mccabe complexity -------------> https://docs.astral.sh/ruff/rules/#mccabe-c90
+    "DTZ", # flake8-datetimez --------------> https://docs.astral.sh/ruff/rules/#flake8-datetimez-dtz
+    "E",   # pycodestyle errors ------------> https://docs.astral.sh/ruff/rules/#error-e
+    "ERA", # eradicate ---------------------> https://docs.astral.sh/ruff/rules/#eradicate-era
+    "F",   # pyflakes ----------------------> https://docs.astral.sh/ruff/rules/#pyflakes-f
+    "I",   # isort -------------------------> https://docs.astral.sh/ruff/rules/#isort-i
+    "LOG",  # flake8-logging ---------------> https://docs.astral.sh/ruff/rules/#flake8-logging-log
+    "N",   # pep8-naming -------------------> https://docs.astral.sh/ruff/rules/#pep8-naming-n
+    "RUF", # Ruff specific rules -----------> https://docs.astral.sh/ruff/rules/#ruff-specific-rules-ruf
+    "S",   # flake8-bandit -----------------> https://docs.astral.sh/ruff/rules/#flake8-bandit-s
+    "TRY", # tryceratops -------------------> https://docs.astral.sh/ruff/rules/#tryceratops-try
+    "UP",  # pyupgrade ---------------------> https://docs.astral.sh/ruff/rules/#pyflakes-f
+    "W",   # pycodestyle warnings ----------> https://docs.astral.sh/ruff/rules/#warning-w
 ]
 
 ignore = [
-    "E501",   # line-too-long
-    "T201",   # print
-    "S101",   # use of assert
-    "ANN003", # missing type annotation for kwargs
+    "ANN002", # missing type annotation for *args ------> https://docs.astral.sh/ruff/rules/missing-type-args/
+    "ANN003", # missing type annotation for **kwargs----> https://docs.astral.sh/ruff/rules/missing-type-kwargs/
+    "E501",   # line-too-long --------------------------> https://docs.astral.sh/ruff/rules/line-too-long/
+]
+
+[lint.extend-per-file-ignores]
+"tests/**/test*.py" = [     # in tests files ignore:
+    "S101",                 # - use of `assert` ---------------> https://docs.astral.sh/ruff/rules/assert/
+    "TRY002",               # - rasing vanilla exceptions -----> https://docs.astral.sh/ruff/rules/raise-vanilla-class/
 ]
 
 [tool.ruff.lint.isort]