chore: Restructures existing guides into an organizational tree structure (#3630)

maastha · web-flow · commit c4602ac0586c · 2025-09-02T14:01:37.000+02:00
diff --git a/RELEASING.md b/RELEASING.md
@@ -23,7 +23,7 @@ While QA acceptance tests are run in the release process automatically, we check
 
 - The expectation is that this file is created during relevant pull requests (breaking changes, significant features), and not before the release process.
 
-- We keep [Guides](https://github.com/mongodb/terraform-provider-mongodbatlas/tree/master/docs/guides) only for 12 months. Add header `subcategory: "Older Guides"` to previous versions.
+- We keep [Guides](https://github.com/mongodb/terraform-provider-mongodbatlas/tree/master/docs/guides) only for 12 months. Add header `subcategory: "Older Guides - Version X"` to previous versions.
 
 ### Trigger release workflow
 
diff --git a/docs/guides/0.6.0-upgrade-guide.md b/docs/guides/0.6.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 0.6.0"
-subcategory: "Older Guides"    
+subcategory: "Older Guides - Version 0"    
 ---
 
 # MongoDB Atlas Provider 0.6.0: Upgrade Guide
diff --git a/docs/guides/0.8.0-upgrade-guide.md b/docs/guides/0.8.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 0.8.0"
-subcategory: "Older Guides"    
+subcategory: "Older Guides - Version 0"
 ---
 
 # MongoDB Atlas Provider v0.8.0: Upgrade and Information Guide
diff --git a/docs/guides/0.8.2-upgrade-guide.md b/docs/guides/0.8.2-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 0.8.2"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 0"    
 ---
 
 # MongoDB Atlas Provider v0.8.2: Upgrade and Information Guide
@@ -64,4 +64,3 @@ configuration and real physical resources that exist. As a result, no
 actions need to be performed.
 
 ```
-
diff --git a/docs/guides/0.9.0-upgrade-guide.md b/docs/guides/0.9.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 0.9.0"
-subcategory: "Older Guides"    
+subcategory: "Older Guides - Version 0"    
 ---
 
 # MongoDB Atlas Provider v0.9.0: Upgrade and Information Guide
diff --git a/docs/guides/0.9.1-upgrade-guide.md b/docs/guides/0.9.1-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 0.9.1"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 0"
 ---
 
 # MongoDB Atlas Provider v0.9.1: Upgrade and Information Guide
diff --git a/docs/guides/1.0.0-upgrade-guide.md b/docs/guides/1.0.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.0.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"
 ---
 
 # MongoDB Atlas Provider 1.0.0: Upgrade and Information Guide
@@ -378,4 +378,4 @@ so no changes are needed.
 
 * [Request Features](https://feedback.mongodb.com/forums/924145-atlas?category_id=370723)
 
-* [Contact Support](https://docs.atlas.mongodb.com/support/) covered by MongoDB Atlas support plans, Developer and above.
+* [Contact Support](https://docs.atlas.mongodb.com/support/) covered by MongoDB Atlas support plans, Developer and above.
diff --git a/docs/guides/1.0.1-upgrade-guide.md b/docs/guides/1.0.1-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.0.1"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider v1.0.1: Upgrade and Information Guide
@@ -86,4 +86,4 @@ resource "mongodbatlas_search_index" "test" {
 
 * [Request Features](https://feedback.mongodb.com/forums/924145-atlas?category_id=370723)
 
-* [Contact Support](https://docs.atlas.mongodb.com/support/) covered by MongoDB Atlas support plans, Developer and above.
+* [Contact Support](https://docs.atlas.mongodb.com/support/) covered by MongoDB Atlas support plans, Developer and above.
diff --git a/docs/guides/1.1.0-upgrade-guide.md b/docs/guides/1.1.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.1.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"
 ---
 
 # MongoDB Atlas Provider 1.1.0/1.1.1: Upgrade and Information Guide
@@ -95,4 +95,4 @@ so no changes are needed.
 
 * [Request Features](https://feedback.mongodb.com/forums/924145-atlas?category_id=370723)
 
-* [Contact Support](https://docs.atlas.mongodb.com/support/) covered by MongoDB Atlas support plans, Developer and above.
+* [Contact Support](https://docs.atlas.mongodb.com/support/) covered by MongoDB Atlas support plans, Developer and above.
diff --git a/docs/guides/1.10.0-upgrade-guide.md b/docs/guides/1.10.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.10.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.10.0: Upgrade and Information Guide
diff --git a/docs/guides/1.11.0-upgrade-guide.md b/docs/guides/1.11.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.11.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.11.0: Upgrade and Information Guide
diff --git a/docs/guides/1.12.0-upgrade-guide.md b/docs/guides/1.12.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.12.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.12.0: Upgrade and Information Guide
diff --git a/docs/guides/1.13.0-upgrade-guide.md b/docs/guides/1.13.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.13.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.13.0: Upgrade and Information Guide
diff --git a/docs/guides/1.14.0-upgrade-guide.md b/docs/guides/1.14.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.14.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.14.0: Upgrade and Information Guide
diff --git a/docs/guides/1.15.0-upgrade-guide.md b/docs/guides/1.15.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.15.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.15.0: Upgrade and Information Guide
diff --git a/docs/guides/1.16.0-upgrade-guide.md b/docs/guides/1.16.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.16.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.16.0: Upgrade and Information Guide
diff --git a/docs/guides/1.17.0-upgrade-guide.md b/docs/guides/1.17.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.17.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.17.0: Upgrade and Information Guide
diff --git a/docs/guides/1.18.0-upgrade-guide.md b/docs/guides/1.18.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.18.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.18.0: Upgrade and Information Guide
diff --git a/docs/guides/1.19.0-upgrade-guide.md b/docs/guides/1.19.0-upgrade-guide.md
@@ -1,5 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.19.0"
+subcategory: "Older Guides - Version 1" 
 ---
 
 # MongoDB Atlas Provider 1.19.0: Upgrade and Information Guide
diff --git a/docs/guides/1.2.0-upgrade-guide.md b/docs/guides/1.2.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.2.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"
 ---
 
 # MongoDB Atlas Provider 1.2.0: Upgrade and Information Guide
@@ -24,4 +24,4 @@ Changes:
 
 * [Request Features](https://feedback.mongodb.com/forums/924145-atlas?category_id=370723)
 
-* [Contact Support](https://docs.atlas.mongodb.com/support/) covered by MongoDB Atlas support plans, Developer and above.
+* [Contact Support](https://docs.atlas.mongodb.com/support/) covered by MongoDB Atlas support plans, Developer and above.
diff --git a/docs/guides/1.20.0-upgrade-guide.md b/docs/guides/1.20.0-upgrade-guide.md
@@ -1,5 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.20.0"
+subcategory: "Older Guides - Version 1"
 ---
 
 # MongoDB Atlas Provider 1.20.0: Upgrade and Information Guide
diff --git a/docs/guides/1.3.0-upgrade-guide.md b/docs/guides/1.3.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.3.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.3.0: Upgrade and Information Guide
diff --git a/docs/guides/1.4.0-upgrade-guide.md b/docs/guides/1.4.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.4.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.4.0: Upgrade and Information Guide
diff --git a/docs/guides/1.5.0-upgrade-guide.md b/docs/guides/1.5.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.5.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.5.0: Upgrade and Information Guide
diff --git a/docs/guides/1.6.0-upgrade-guide.md b/docs/guides/1.6.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.6.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.6.0: Upgrade and Information Guide
diff --git a/docs/guides/1.7.0-upgrade-guide.md b/docs/guides/1.7.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.7.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.7.0: Upgrade and Information Guide
diff --git a/docs/guides/1.8.0-upgrade-guide.md b/docs/guides/1.8.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.8.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.8.0: Upgrade and Information Guide
diff --git a/docs/guides/1.9.0-upgrade-guide.md b/docs/guides/1.9.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Upgrade Guide 1.9.0"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # MongoDB Atlas Provider 1.9.0: Upgrade and Information Guide
diff --git a/docs/guides/2.0.0-upgrade-guide.md b/docs/guides/2.0.0-upgrade-guide.md
@@ -1,6 +1,6 @@
 ---
 layout: "mongodbatlas"
-page_title: "MongoDB Atlas Provider 2.0.0: Upgrade and Information Guide"
+page_title: "Upgrade Guide 2.0.0"
 sidebar_current: "docs-mongodbatlas-guides-200-upgrade-guide"
 description: |-
 MongoDB Atlas Provider 2.0.0: Upgrade and Information Guide
diff --git a/docs/guides/Programmatic-API-Key-upgrade-guide-1.10.0.md b/docs/guides/Programmatic-API-Key-upgrade-guide-1.10.0.md
@@ -1,6 +1,6 @@
 ---
 page_title: "Migration Guide: Programmatic API Key (v1.10.0)"
-subcategory: "Older Guides"
+subcategory: "Older Guides - Version 1"  
 ---
 
 # Migration Guide: Programmatic API Key (v1.10.0)
diff --git a/docs/guides/team-project-assignment-migration-guide.md b/docs/guides/team-project-assignment-migration-guide.md
@@ -1,6 +1,7 @@
----  
+---
 page_title: "Migration Guide: Project Teams Attribute to Team Project Assignment Resource"
----  
+---
+
   
 # Migration Guide: Project Teams Attribute to Team Project Assignment Resource
   
@@ -157,4 +158,4 @@ A: No — using `ignore_changes` ensures they remain in Atlas until the provider
 ---  
   
 ## Further resources  
-- [`mongodbatlas_team_project_assignment` docs](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/team_project_assignment)
+- [`mongodbatlas_team_project_assignment` docs](https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/resources/team_project_assignment)
