docs: folders beta (#12500)

Author: DanRibbens

docs/folders/overview.mdx

@@ -10,6 +10,11 @@ Folders allow you to group documents across collections, and are a great way to
 
 The configuration for folders is done in two places, the collection config and the Payload config. The collection config is where you enable folders, and the Payload config is where you configure the global folder settings.
 
+<Banner type="warning">
+  **Note:** The Folders feature is currently in beta and may be subject to
+  change in minor versions updates prior to being stable.
+</Banner>
+
 ## Folder Configuration
 
 On the payload config, you can configure the following settings under the `folders` property:

packages/payload/src/collections/config/types.ts

@@ -347,6 +347,7 @@ export type CollectionAdminOptions = {
   enableRichTextRelationship?: boolean
   /**
    * Enables folders for this collection
+   * @deprecated this property will move out of `admin` in the next patch
    */
   folders?: CollectionFoldersConfiguration
   /**

packages/payload/src/config/types.ts

@@ -985,6 +985,7 @@ export type Config = {
   endpoints?: Endpoint[]
   /**
    * Options for folder view within the admin panel
+   * @experimental this feature may change in minor versions until it is fully stable
    */
   folders?: RootFoldersConfiguration
   /**