diff --git a/docs/en/ExpectAPI.md b/docs/en/ExpectAPI.md
index ce66f38983d8..c7b194912db4 100644
--- a/docs/en/ExpectAPI.md
+++ b/docs/en/ExpectAPI.md
@@ -666,6 +666,8 @@ describe('the La Croix cans on my desk', () => {
 });
 ```
 
+> Note: `.toEqual` won't perform a *deep equality* check for two errors. Only the `message` property of an Error is considered for equality. It is recommended to use the `.toThrow` matcher for testing against errors.
+
 ### `.toHaveLength(number)`
 
 Use `.toHaveLength` to check that an object has a `.length` property and it is set to a certain numeric value.