feat: Enhance Ruff per-file ignores with documentation links (#1779)

* Add Ruff rule links for per-file ignores

* Update backend/pyproject.toml

---------

Co-authored-by: Arkadii Yakovets <[email protected]>

Author: anujpundir999

backend/pyproject.toml

@@ -144,18 +144,60 @@ ignore = [
 select = ["ALL"]
 
 [tool.ruff.lint.per-file-ignores]
-"**/__init__.py" = ["D104", "F401"]
-"**/admin.py" = ["D100", "D101", "D104"]
-"**/rest/v1/*.py" = ["ARG001", "B008", "D106"]
-"**/apps.py" = ["D100", "D101", "D104"]
-"**/graphql/**/nodes.py" = ["D106"]
-"**/graphql/nodes/*.py" = ["D106"]
-"**/graphql/queries/*.py" = ["N805"]
-"**/management/commands/*.py" = ["D101", "D102", "T201"]
-"**/migrations/*.py" = ["D100", "D101", "D104", "E501"]
-"**/models.py" = ["D106"]
-"**/models/*.py" = ["D106"]
-"**/tests/**/*.py" = ["D100", "D101", "D102", "D103", "D107", "PLR2004", "S101"]
+"**/__init__.py" = [
+    "D104", # https://docs.astral.sh/ruff/rules/undocumented-public-package/
+    "F401"  # https://docs.astral.sh/ruff/rules/unused-import/
+]
+"**/admin.py" = [
+    "D100", # https://docs.astral.sh/ruff/rules/undocumented-public-module/
+    "D101", # https://docs.astral.sh/ruff/rules/undocumented-public-class/
+    "D104"  # https://docs.astral.sh/ruff/rules/undocumented-public-package/
+]
+"**/apps.py" = [
+    "D100", # https://docs.astral.sh/ruff/rules/undocumented-public-module/
+    "D101", # https://docs.astral.sh/ruff/rules/undocumented-public-class/
+    "D104"  # https://docs.astral.sh/ruff/rules/undocumented-public-package/
+]
+"**/graphql/**/nodes.py" = [
+    "D106" # https://docs.astral.sh/ruff/rules/undocumented-public-nested-class/
+]
+"**/graphql/nodes/*.py" = [
+    "D106" # https://docs.astral.sh/ruff/rules/undocumented-public-nested-class/
+]
+"**/graphql/queries/*.py" = [
+    "N805" # https://docs.astral.sh/ruff/rules/invalid-first-argument-name-for-method/
+]
+"**/management/commands/*.py" = [
+    "D101", # https://docs.astral.sh/ruff/rules/undocumented-public-class/
+    "D102", # https://docs.astral.sh/ruff/rules/undocumented-public-method/
+    "T201"  # https://docs.astral.sh/ruff/rules/print/
+]
+"**/migrations/*.py" = [
+    "D100", # https://docs.astral.sh/ruff/rules/undocumented-public-module/
+    "D101", # https://docs.astral.sh/ruff/rules/undocumented-public-class/
+    "D104", # https://docs.astral.sh/ruff/rules/undocumented-public-package/
+    "E501"  # https://docs.astral.sh/ruff/rules/line-too-long/
+]
+"**/models.py" = [
+    "D106" # https://docs.astral.sh/ruff/rules/undocumented-public-nested-class/
+]
+"**/models/*.py" = [
+    "D106" # https://docs.astral.sh/ruff/rules/undocumented-public-nested-class/
+]
+"**/rest/v1/*.py" = [
+    "ARG001", # https://docs.astral.sh/ruff/rules/unused-function-argument/
+    "B008",   # https://docs.astral.sh/ruff/rules/function-call-in-default-argument/
+    "D106"    # https://docs.astral.sh/ruff/rules/undocumented-public-nested-class/
+]
+"**/tests/**/*.py" = [
+    "D100",    # https://docs.astral.sh/ruff/rules/undocumented-public-module/
+    "D101",    # https://docs.astral.sh/ruff/rules/undocumented-public-class/
+    "D102",    # https://docs.astral.sh/ruff/rules/undocumented-public-method/
+    "D103",    # https://docs.astral.sh/ruff/rules/undocumented-public-function/
+    "D107",    # https://docs.astral.sh/ruff/rules/undocumented-public-init/
+    "PLR2004", # https://docs.astral.sh/ruff/rules/magic-value-comparison/
+    "S101"     # https://docs.astral.sh/ruff/rules/assert/
+]
 
 [build-system]
 build-backend = "poetry.core.masonry.api"