chore: Updates documentation structure to have data sources and resources in subcategories by feature

docs/data-sources/access_list_api_key.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Programmatic API Keys"
+---
+
 # Data Source: mongodbatlas_access_list_api_key
 
 `mongodbatlas_access_list_api_key` describes an Access List API Key entry resource. The access list grants access from IPs, CIDRs) to clusters within the Project.

docs/data-sources/access_list_api_keys.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Programmatic API Keys"
+---
+
 # Data Source: mongodbatlas_access_list_api_key
 
 `mongodbatlas_access_list_api_keys` describes an Access List API Key entry resource. The access list grants access from IPs, CIDRs) to clusters within the Project.

docs/data-sources/advanced_cluster.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Clusters"
+---
+
 # Data Source: mongodbatlas_advanced_cluster
 
 `mongodbatlas_advanced_cluster` describes an Advanced Cluster. The data source requires your Project ID.

docs/data-sources/advanced_clusters.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Clusters"
+---
+
 # Data Source: mongodbatlas_advanced_clusters
 
 `mongodbatlas_advanced_clusters` returns all Advanced Clusters for a project_id.

docs/data-sources/alert_configuration.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Alert Configurations"
+---
+
 # Data Source: mongodbatlas_alert_configuration
 
 `mongodbatlas_alert_configuration` describes an Alert Configuration.

docs/data-sources/alert_configurations.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Alert Configurations"
+---
+
 # Data Source: mongodbatlas_alert_configurations
 
 `mongodbatlas_alert_configurations` describes all Alert Configurations by the provided project_id. The data source requires your Project ID.

docs/data-sources/api_key.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Programmatic API Keys"
+---
+
 # Data Source: mongodbatlas_api_key
 
 `mongodbatlas_api_key` describes a MongoDB Atlas API Key. This represents a API Key that has been created.

docs/data-sources/api_key_project_assignment.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Programmatic API Keys"
+---
+
 # Data Source: mongodbatlas_api_key_project_assignment
 
 `mongodbatlas_api_key_project_assignment` describes an API Key Project Assignment.

docs/data-sources/api_key_project_assignments.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Programmatic API Keys"
+---
+
 # Data Source: mongodbatlas_api_key_project_assignments
 
 `mongodbatlas_api_key_project_assignments` provides an API Key Project Assignments data source. The data source lets you list all API key project assignments for an organization.

docs/data-sources/api_keys.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Programmatic API Keys"
+---
+
 # Data Source: mongodbatlas_api_keys
 
 `mongodbatlas_api_keys` describe all API Keys. This represents API Keys that have been created.

docs/data-sources/atlas_user.md

@@ -1,5 +1,5 @@
 ---
-subcategory: "Deprecated"    
+subcategory: "MongoDB Cloud Users"
 ---
 
 # Data Source: mongodbatlas_atlas_user

docs/data-sources/atlas_users.md

@@ -1,5 +1,5 @@
 ---
-subcategory: "Deprecated"    
+subcategory: "MongoDB Cloud Users"
 ---
 
 # Data Source: atlas_users

docs/data-sources/auditing.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Auditing"
+---
+
 # Data Source: mongodbatlas_auditing
 
 `mongodbatlas_auditing` describes a Auditing.

docs/data-sources/backup_compliance_policy.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Cloud Backups"
+---
+
 # Data Source: mongodbatlas_backup_compliance_policy
 
 `mongodbatlas_backup_compliance_policy` provides an Atlas Backup Compliance Policy. An Atlas Backup Compliance Policy contains the current protection policy settings for a project. A compliance policy prevents any user, regardless of role, from modifying or deleting specific cluster configurations and backups. To disable a Backup Compliance Policy, you must contact MongoDB support. Backup Compliance Policies are only supported for clusters M10 and higher and are applied as the minimum policy for all clusters.

docs/data-sources/cloud_backup_schedule.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Cloud Backups"
+---
+
 # Data Source: mongodbatlas_cloud_backup_schedule
 
 `mongodbatlas_cloud_backup_schedule` provides a Cloud Backup Schedule datasource. An Atlas Cloud Backup Schedule provides the current cloud backup schedule for the cluster. 

docs/data-sources/cloud_backup_snapshot.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Cloud Backups"
+---
+
 # Data Source: mongodbatlas_cloud_backup_snapshot
 
 `mongodbatlas_cloud_backup_snapshot` provides an Cloud Backup Snapshot datasource. Atlas Cloud Backup Snapshots provide localized backup storage using the native snapshot functionality of the cluster’s cloud service.

docs/data-sources/cloud_backup_snapshot_export_bucket.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Cloud Backups"
+---
+
 # Data Source: mongodbatlas_cloud_backup_snapshot_export_bucket
 
 `mongodbatlas_cloud_backup_snapshot_export_bucket` datasource allows you to retrieve all the buckets for the specified project.

docs/data-sources/cloud_backup_snapshot_export_buckets.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Cloud Backups"
+---
+
 # Data Source: mongodbatlas_cloud_backup_snapshot_export_buckets
 
 `mongodbatlas_cloud_backup_snapshot_export_buckets` datasource allows you to retrieve all the buckets for the specified project.

docs/data-sources/cloud_backup_snapshot_export_job.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Cloud Backups"
+---
+
 # Data Source: mongodbatlas_cloud_backup_snapshot_export_Job
 
 `mongodbatlas_cloud_backup_snapshot_export_job` datasource allows you to retrieve a snapshot export job for the specified project and cluster.

docs/data-sources/cloud_backup_snapshot_export_jobs.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Cloud Backups"
+---
+
 # Data Source: mongodbatlas_cloud_backup_snapshot_export_jobs
 
 `mongodbatlas_cloud_backup_snapshot_export_jobs` datasource allows you to retrieve all the buckets for the specified project.

docs/data-sources/cloud_backup_snapshot_restore_job.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Cloud Backups"
+---
+
 # Data Source: mongodbatlas_cloud_backup_snapshot_restore_job
 
 `mongodbatlas_cloud_backup_snapshot_restore_job` provides a Cloud Backup Snapshot Restore Job datasource. Gets all the cloud backup snapshot restore jobs for the specified cluster.

docs/data-sources/cloud_backup_snapshot_restore_jobs.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Cloud Backups"
+---
+
 # Data Source: mongodbatlas_cloud_backup_snapshot_restore_jobs
 
 `mongodbatlas_cloud_backup_snapshot_restore_jobs` provides a Cloud Backup Snapshot Restore Jobs datasource. Gets all the cloud backup snapshot restore jobs for the specified cluster.

docs/data-sources/cloud_backup_snapshots.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Cloud Backups"
+---
+
 # Data Source: mongodbatlas_cloud_backup_snapshots
 
 `mongodbatlas_cloud_backup_snapshots` provides an Cloud Backup Snapshot datasource. Atlas Cloud Backup Snapshots provide localized backup storage using the native snapshot functionality of the cluster’s cloud service.

docs/data-sources/cloud_provider_access_setup.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Cloud Provider Access"
+---
+
 # Data Source: mongodbatlas_cloud_provider_access_setup
 
 `mongodbatlas_cloud_provider_access_setup` allows you to get a single role for a provider access role setup, currently only AWS and Azure are supported.

docs/data-sources/cloud_provider_shared_tier_restore_job.md

@@ -1,8 +1,8 @@
 ---
-subcategory: "Deprecated"    
+subcategory: "Shared-Tier Restore Jobs"
 ---
 
-**WARNING:** This data source is deprecated and will be removed in January 2026. For more details, see [Migration Guide: Transition out of Serverless Instances and Shared-tier clusters](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/serverless-shared-migration-guide).
+~> **DEPRECATION:** This data source is deprecated and will be removed in January 2026. For more details, see [Migration Guide: Transition out of Serverless Instances and Shared-tier clusters](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/serverless-shared-migration-guide).
 
 # Data Source: mongodbatlas_shared_tier_restore_job
 
@@ -41,4 +41,4 @@ In addition to all arguments above, the following attributes are exported:
 * `delivery_type` -	Means by which this resource returns the snapshot to the requesting MongoDB Cloud user. Values: `RESTORE`, `DOWNLOAD`.
 * `expiration_date` -	Date and time when the download link no longer works. This parameter expresses its value in the ISO 8601 timestamp format in UTC.
 
-For more information see: [MongoDB Atlas API Reference.](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Shared-Tier-Restore-Jobs/operation/getSharedClusterBackupRestoreJob)
+For more information see: [MongoDB Atlas API Reference.](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Shared-Tier-Restore-Jobs/operation/getSharedClusterBackupRestoreJob)

docs/data-sources/cloud_provider_shared_tier_restore_jobs.md

@@ -1,8 +1,8 @@
 ---
-subcategory: "Deprecated"    
+subcategory: "Shared-Tier Restore Jobs"
 ---
 
-**WARNING:** This data source is deprecated and will be removed in January 2026. For more details, see [Migration Guide: Transition out of Serverless Instances and Shared-tier clusters](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/serverless-shared-migration-guide).
+~> **DEPRECATION:** This data source is deprecated and will be removed in January 2026. For more details, see [Migration Guide: Transition out of Serverless Instances and Shared-tier clusters](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/serverless-shared-migration-guide).
 
 # Data Source: mongodbatlas_shared_tier_restore_jobs
 
@@ -48,4 +48,4 @@ In addition to all arguments above, the following attributes are exported:
 * `delivery_type` -	Means by which this resource returns the snapshot to the requesting MongoDB Cloud user. Values: `RESTORE`, `DOWNLOAD`.
 * `expiration_date` -	Date and time when the download link no longer works. This parameter expresses its value in the ISO 8601 timestamp format in UTC.
 
-For more information see: [MongoDB Atlas API Reference.](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Shared-Tier-Restore-Jobs/operation/getSharedClusterBackupRestoreJob)
+For more information see: [MongoDB Atlas API Reference.](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Shared-Tier-Restore-Jobs/operation/getSharedClusterBackupRestoreJob)

docs/data-sources/cloud_provider_shared_tier_snapshot.md

@@ -1,8 +1,8 @@
 ---
-subcategory: "Deprecated"    
+subcategory: "Shared-Tier Snapshots"
 ---
 
-**WARNING:** This data source is deprecated and will be removed in January 2026. For more details, see [Migration Guide: Transition out of Serverless Instances and Shared-tier clusters](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/serverless-shared-migration-guide).
+~> **DEPRECATION:** This data source is deprecated and will be removed in January 2026. For more details, see [Migration Guide: Transition out of Serverless Instances and Shared-tier clusters](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/serverless-shared-migration-guide).
 
 # Data Source: mongodbatlas_shared_tier_snapshot
 
@@ -39,4 +39,4 @@ In addition to all arguments above, the following attributes are exported:
 * `finish_time` - Date and time when MongoDB Cloud completed writing this snapshot. This parameter expresses its value in the ISO 8601 timestamp format in UTC.
 * `scheduled_time` - 	Date and time when MongoDB Cloud will take the snapshot. This parameter expresses its value in the ISO 8601 timestamp format in UTC.
 
-For more information see: [MongoDB Atlas API Reference.](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Shared-Tier-Snapshots/operation/getSharedClusterBackup)
+For more information see: [MongoDB Atlas API Reference.](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Shared-Tier-Snapshots/operation/getSharedClusterBackup)

docs/data-sources/cloud_provider_shared_tier_snapshots.md

@@ -1,8 +1,8 @@
 ---
-subcategory: "Deprecated"    
+subcategory: "Shared-Tier Snapshots"
 ---
 
-**WARNING:** This data source is deprecated and will be removed in January 2026. For more details, see [Migration Guide: Transition out of Serverless Instances and Shared-tier clusters](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/serverless-shared-migration-guide).
+~> **DEPRECATION:** This data source is deprecated and will be removed in January 2026. For more details, see [Migration Guide: Transition out of Serverless Instances and Shared-tier clusters](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/serverless-shared-migration-guide).
 
 # Data Source: mongodbatlas_shared_tier_snapshots
 
@@ -43,4 +43,4 @@ In addition to all arguments above, the following attributes are exported:
 * `finish_time` - Date and time when MongoDB Cloud completed writing this snapshot. This parameter expresses its value in the ISO 8601 timestamp format in UTC.
 * `scheduled_time` - 	Date and time when MongoDB Cloud will take the snapshot. This parameter expresses its value in the ISO 8601 timestamp format in UTC.
 
-For more information see: [MongoDB Atlas API Reference.](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Cloud-Backups/operation/listShardedClusterBackups)
+For more information see: [MongoDB Atlas API Reference.](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Cloud-Backups/operation/listShardedClusterBackups)

docs/data-sources/cloud_user_org_assignment.md

@@ -1,3 +1,7 @@
+---
+subcategory: "MongoDB Cloud Users"
+---
+
 # Data Source: mongodbatlas_cloud_user_org_assignment
 
 `mongodbatlas_cloud_user_org_assignment` provides a Cloud User Organization Assignment data source. The data source lets you retrieve a user assigned to an organization.

docs/data-sources/cloud_user_project_assignment.md

@@ -1,3 +1,7 @@
+---
+subcategory: "MongoDB Cloud Users"
+---
+
 # Data Source: mongodbatlas_cloud_user_project_assignment
 
 `mongodbatlas_cloud_user_project_assignment` provides a Cloud User Project Assignment data source. The data source lets you retrieve a user assigned to a project.

docs/data-sources/cloud_user_team_assignment.md

@@ -1,3 +1,7 @@
+---
+subcategory: "MongoDB Cloud Users"
+---
+
 # Data Source: mongodbatlas_cloud_user_team_assignment
 
 `mongodbatlas_cloud_user_team_assignment` provides a Cloud User Team Assignment data source. The data source lets you retrieve a user assigned to a team.

docs/data-sources/cluster.md

@@ -1,8 +1,12 @@
+---
+subcategory: "Clusters"
+---
+
 # Data Source: mongodbatlas_cluster
 
 `mongodbatlas_cluster` describes a Cluster. The data source requires your Project ID.
 
-**WARNING:** This datasource is deprecated and will be removed in the next major release. Please use `mongodbatlas_advanced_cluster`. For more details, see [our migration guide](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/cluster-to-advanced-cluster-migration-guide).
+~> **DEPRECATION:** This datasource is deprecated and will be removed in the next major release. Please use `mongodbatlas_advanced_cluster`. For more details, see [our migration guide](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/cluster-to-advanced-cluster-migration-guide).
 
 ~> **IMPORTANT:**
 <br> &#8226; Multi Region Cluster: The `mongodbatlas_cluster` data source doesn't return the `container_id` for each region utilized by the cluster. For retrieving the `container_id`, we recommend the [`mongodbatlas_advanced_cluster`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/data-sources/advanced_cluster) data source instead.

docs/data-sources/cluster_outage_simulation.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Cluster Outage Simulation"
+---
+
 # Data Source: mongodbatlas_cluster_outage_simulation
 
 `mongodbatlas_cluster_outage_simulation` provides a Cluster Outage Simulation resource. For more details see https://www.mongodb.com/docs/atlas/tutorial/test-resilience/simulate-regional-outage/

docs/data-sources/clusters.md

@@ -1,8 +1,12 @@
+---
+subcategory: "Clusters"
+---
+
 # Data Source: mongodbatlas_clusters
 
 `mongodbatlas_cluster` describes all Clusters by the provided project_id. The data source requires your Project ID.
 
-**WARNING:** This datasource is deprecated and will be removed in the next major release. Please use `mongodbatlas_advanced_clusters`. For more details, see [our migration guide](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/cluster-to-advanced-cluster-migration-guide).
+~> **DEPRECATION:** This datasource is deprecated and will be removed in the next major release. Please use `mongodbatlas_advanced_clusters`. For more details, see [our migration guide](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/cluster-to-advanced-cluster-migration-guide).
 
 ~> **IMPORTANT:**
 <br> &#8226; Multi Region Cluster: The `mongodbatlas_cluster` data source doesn't return the `container_id` for each region utilized by the cluster. For retrieving the `container_id`, we recommend the [`mongodbatlas_advanced_cluster`](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/data-sources/advanced_clusters) data source instead.

docs/data-sources/control_plane_ip_addresses.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Root"
+---
+
 # Data Source: mongodbatlas_control_plane_ip_addresses
 
 `mongodbatlas_control_plane_ip_addresses` returns all control plane IP addresses.

docs/data-sources/custom_db_role.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Custom Database Roles"
+---
+
 # Data Source: mongodbatlas_custom_db_role
 
 `mongodbatlas_custom_db_role` describes a Custom DB Role. This represents a custom db role.

docs/data-sources/custom_db_roles.md

@@ -1,3 +1,7 @@
+---
+subcategory: "Custom Database Roles"
+---
+
 # Data Source: mongodbatlas_custom_db_roles
 
 `mongodbatlas_custom_db_roles` describes all Custom DB Roles. This represents a custom db roles.

docs/data-sources/custom_dns_configuration_cluster_aws.md

@@ -1,3 +1,7 @@
+---
+subcategory: "AWS Clusters DNS"
+---
+
 # Data Source: mongodbatlas_custom_dns_configuration_cluster_aws
 
 `mongodbatlas_custom_dns_configuration_cluster_aws` describes a Custom DNS Configuration for Atlas Clusters on AWS.

docs/data-sources/data_lake_pipeline.md

@@ -1,8 +1,8 @@
 ---
-subcategory: "Deprecated"    
+subcategory: "Data Lake Pipelines"
 ---
 
-**WARNING:** Data Lake is deprecated. To learn more, see <https://dochub.mongodb.org/core/data-lake-deprecation>
+~> **DEPRECATION:** Data Lake is deprecated. To learn more, see <https://dochub.mongodb.org/core/data-lake-deprecation>
 
 # Data Source: mongodbatlas_data_lake_pipeline
 

docs/data-sources/data_lake_pipeline_run.md

@@ -1,8 +1,8 @@
 ---
-subcategory: "Deprecated"    
+subcategory: "Data Lake Pipelines"
 ---
 
-**WARNING:** Data Lake is deprecated. To learn more, see <https://dochub.mongodb.org/core/data-lake-deprecation>
+~> **DEPRECATION:** Data Lake is deprecated. To learn more, see <https://dochub.mongodb.org/core/data-lake-deprecation>
 
 # Data Source: mongodbatlas_data_lake_pipeline_run
 

docs/data-sources/data_lake_pipeline_runs.md

@@ -1,8 +1,8 @@
 ---
-subcategory: "Deprecated"    
+subcategory: "Data Lake Pipelines"
 ---
 
-**WARNING:** Data Lake is deprecated. To learn more, see <https://dochub.mongodb.org/core/data-lake-deprecation>
+~> **DEPRECATION:** Data Lake is deprecated. To learn more, see <https://dochub.mongodb.org/core/data-lake-deprecation>
 
 # Data Source: mongodbatlas_data_lake_pipeline_runs
 

docs/data-sources/data_lake_pipelines.md

@@ -1,8 +1,8 @@
 ---
-subcategory: "Deprecated"    
+subcategory: "Data Lake Pipelines"
 ---
 
-**WARNING:** Data Lake is deprecated. To learn more, see <https://dochub.mongodb.org/core/data-lake-deprecation>
+~> **DEPRECATION:** Data Lake is deprecated. To learn more, see <https://dochub.mongodb.org/core/data-lake-deprecation>
 
 # Data Source: mongodbatlas_data_lake_pipelines