docs(errors): update suppressHydrationWarning section (#76521)

## Why?

We should clarify that React will **not** attempt to patch mismatched text content when using `suppressHydrationWarning`.

- Related: reactjs/react.dev#7651
- x-ref: #75890

Author: samcx

errors/react-hydration-error.mdx

@@ -75,6 +75,11 @@ Sometimes content will inevitably differ between the server and client, such as
 <time datetime="2016-10-25" suppressHydrationWarning />
 ```
 
+> **Good to know:**
+>
+> - This only works one level deep, and is intended to be an escape hatch. Don’t overuse it.
+> - React will **not** attempt to patch mismatched text content when `suppressHydrationWarning={true}` is set.
+
 ## Common iOS issues
 
 iOS attempts to detect phone numbers, email addresses, and other data in text content and convert them into links, leading to hydration mismatches.