📝 Update documentation to include warning regarding draft documents

crcorbett · crcorbett · commit e3e92e9ac3c8 · 2025-05-16T16:47:32.000+10:00
diff --git a/docs/plugins/nested-docs.mdx b/docs/plugins/nested-docs.mdx
@@ -43,6 +43,13 @@ but different parents.
 - Dynamically generate labels and URLs for each breadcrumb
 - Supports localization
 
+<Banner type="warning">
+  **Note:**
+
+When versions are enabled for a collection, only published documents will recursively update their descendants. If a parent document is in a draft state, its children will not be updated until the parent is published.
+
+</Banner>
+
 ## Installation
 
 Install the plugin using any JavaScript package manager like [pnpm](https://pnpm.io), [npm](https://npmjs.com), or [Yarn](https://yarnpkg.com):
