diff --git a/README.md b/README.md
index efb8f2f8..b46add26 100644
--- a/README.md
+++ b/README.md
@@ -72,6 +72,9 @@ To upgrade docusaurus to a more recent version:
    - `package.json`
    - `yarn.lock`
 
+> **Warning**
+> Giscus comments are implemented using a unsafe [swizzle](https://docusaurus.io/docs/swizzling#ejecting) of `DocItem/Layout` that could break in minor upgrades of Docusaurus. See [comments here](https://github.com/pester/docs/blob/main/src/theme/DocItem/Layout/index.js) for update instructions.
+
 ## Code of Conduct
 
 In the interest of fostering an open and welcoming environment, we as