diff --git a/.flake8 b/.flake8
index 452c42549..fbc73fdc2 100644
--- a/.flake8
+++ b/.flake8
@@ -1,3 +1,5 @@
 [flake8]
+# The flake8 config should work well with black,
+# see https://black.readthedocs.io/en/stable/guides/using_black_with_other_tools.html#flake8
 ignore = E203,E501,E741,W503,W604
 exclude = build,sample-files