diff --git a/.git-blame-ignore-revs b/.git-blame-ignore-revs
new file mode 100644
index 00000000..eb74a0da
--- /dev/null
+++ b/.git-blame-ignore-revs
@@ -0,0 +1,2 @@
+# Use cargo-derivefmt to sort derives alphabetically
+f900dbea468e822c5a510a72ecc6367549443927
diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
index 80a839bc..41c7866e 100644
--- a/DEVELOPMENT.md
+++ b/DEVELOPMENT.md
@@ -1,5 +1,14 @@
 # Development
 
+## use `.git-blame-ignore-revs` file _optional_
+
+Use this file to ignore formatting commits from `git-blame`.
+It needs to be set up per project because `git-blame` will fail if it's missing.
+
+```sh
+git config blame.ignoreRevsFile .git-blame-ignore-revs
+```
+
 ## Testing
 
 How to run specific tests: