diff --git a/.prospector.yml b/.prospector.yml
index 8c141202d3..51508847c2 100644
--- a/.prospector.yml
+++ b/.prospector.yml
@@ -15,6 +15,9 @@ pyroma:
 pep8:
   full: true
   # ignore rules that conflict with ruff formatter
+  # E203: https://black.readthedocs.io/en/stable/the_black_code_style/current_style.html#slices
+  # E501: https://docs.astral.sh/ruff/formatter/#conflicting-lint-rules
+  # W503: https://pycodestyle.pycqa.org/en/latest/intro.html#error-codes
   disable: ['E203', 'E501', 'W503']
 
 mypy:
diff --git a/setup.cfg b/setup.cfg
index 10e8d8d09c..15d02392d7 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -23,6 +23,9 @@ exclude_lines =
 
 [pycodestyle]
 # ignore rules that conflict with ruff formatter
+# E203: https://black.readthedocs.io/en/stable/the_black_code_style/current_style.html#slices
+# E501: https://docs.astral.sh/ruff/formatter/#conflicting-lint-rules
+# W503: https://pycodestyle.pycqa.org/en/latest/intro.html#error-codes
 ignore = E203,E501,W503
 
 [pydocstyle]