feat(resourcemanager): extend folder example

Signed-off-by: Mauritz Uphoff <[email protected]>

Author: h3adex

docs/resources/resourcemanager_folder.md

@@ -17,10 +17,21 @@ Resource Manager folder resource schema.
 
 ```terraform
 resource "stackit_resourcemanager_folder" "example" {
-  name                = "foo"
+  name                = "example-folder"
   owner_email         = "[email protected]"
   parent_container_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
 }
+
+# Note:
+# You can add projects under folders.
+# However, when deleting a project, be aware:
+#   - Projects may remain "invisible" for up to 7 days after deletion
+#   - During this time, deleting the parent folder may fail because the project is still technically linked
+resource "stackit_resourcemanager_project" "example_project" {
+  name                = "example-project"
+  owner_email         = "[email protected]"
+  parent_container_id = stackit_resourcemanager_folder.example.container_id
+}
 ```
 
 <!-- schema generated by tfplugindocs -->

examples/resources/stackit_resourcemanager_folder/resource.tf

@@ -1,5 +1,16 @@
 resource "stackit_resourcemanager_folder" "example" {
-  name                = "foo"
+  name                = "example-folder"
   owner_email         = "[email protected]"
   parent_container_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+}
+
+# Note:
+# You can add projects under folders.
+# However, when deleting a project, be aware:
+#   - Projects may remain "invisible" for up to 7 days after deletion
+#   - During this time, deleting the parent folder may fail because the project is still technically linked
+resource "stackit_resourcemanager_project" "example_project" {
+  name                = "example-project"
+  owner_email         = "[email protected]"
+  parent_container_id = stackit_resourcemanager_folder.example.container_id
 }