diff --git a/.flake8 b/.flake8
index 3fab97f87881d8f08d49d4094048ad673dfff540..711138f30d7afdfd58e85a9d65b18c1b7210fac8 100644
--- a/.flake8
+++ b/.flake8
@@ -1,2 +1,7 @@
 [flake8]
-ignore=E128,E501,E731,W503,W504,W505
+# https://pycodestyle.readthedocs.io/en/latest/intro.html#error-codes
+# Ignored errors:
+# - E501: line too long
+# - W503: line break before binary operator (deprecated rule)
+# - W505: doc line too long
+ignore=E501,W503,W505