improved documentation

Author: adcoelho

docs/resources/kibana_maintenance_window.md

@@ -1,16 +1,46 @@
 ---
-# generated by https://github.com/hashicorp/terraform-plugin-docs
-page_title: "elasticstack_kibana_maintenance_window Resource - terraform-provider-elasticstack"
-subcategory: ""
+subcategory: "Kibana"
+layout: ""
+page_title: "Elasticstack: elasticstack_kibana_maintenance_window Resource"
 description: |-
-  Manages Kibana data views
+  Manages Kibana maintenance windows.
 ---
 
-# elasticstack_kibana_maintenance_window (Resource)
+# Resource: elasticstack_kibana_maintenance_window
 
-Manages Kibana data views
+Creates and manages Kibana [maintenance windows](https://www.elastic.co/docs/api/doc/kibana/group/endpoint-maintenance-window)
 
+## Example Usage
 
+```terraform
+provider "elasticstack" {
+  elasticsearch {}
+  kibana {}
+}
+
+resource "elasticstack_kibana_maintenance_window" "my_maintenance_window" {
+  title   = "UPDATE TEST"
+  enabled = true
+
+  custom_schedule {
+    start    = "1993-01-01T05:00:00.200Z"
+    duration = "12d"
+
+    recurring {
+      every        = "21d"
+      on_week_day  = ["MO", "+3TU", "-2FR"]
+      on_month_day = [1, 2, 4, 6, 7]
+      on_month     = [12]
+    }
+  }
+
+  scope {
+    alerting {
+      kql = "_id: '1234'"
+    }
+  }
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
@@ -28,7 +58,7 @@ Manages Kibana data views
 
 ### Read-Only
 
-- `id` (String) Generated ID for the data view.
+- `id` (String) Generated ID for the maintenance window.
 
 <a id="nestedatt--custom_schedule"></a>
 ### Nested Schema for `custom_schedule`
@@ -70,3 +100,11 @@ Required:
 Required:
 
 - `kql` (String) A filter written in Kibana Query Language (KQL).
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+terraform import elasticstack_kibana_maintenance_window.my_maintenance_window <space id>/<maintenance window id>
+```

examples/resources/elasticstack_kibana_maintenance_window/import.sh

@@ -0,0 +1 @@
+terraform import elasticstack_kibana_maintenance_window.my_maintenance_window <space id>/<maintenance window id>

examples/resources/elasticstack_kibana_maintenance_window/resource.tf

@@ -0,0 +1,27 @@
+provider "elasticstack" {
+  elasticsearch {}
+  kibana {}
+}
+
+resource "elasticstack_kibana_maintenance_window" "my_maintenance_window" {
+  title   = "UPDATE TEST"
+  enabled = true
+
+  custom_schedule {
+    start    = "1993-01-01T05:00:00.200Z"
+    duration = "12d"
+
+    recurring {
+      every        = "21d"
+      on_week_day  = ["MO", "+3TU", "-2FR"]
+      on_month_day = [1, 2, 4, 6, 7]
+      on_month     = [12]
+    }
+  }
+
+  scope {
+    alerting {
+      kql = "_id: '1234'"
+    }
+  }
+}

templates/resources/kibana_maintenance_window.md.tmpl

@@ -0,0 +1,23 @@
+---
+subcategory: "Kibana"
+layout: ""
+page_title: "Elasticstack: elasticstack_kibana_maintenance_window Resource"
+description: |-
+  Manages Kibana maintenance windows.
+---
+
+# Resource: elasticstack_kibana_maintenance_window
+
+Creates and manages Kibana [maintenance windows](https://www.elastic.co/docs/api/doc/kibana/group/endpoint-maintenance-window)
+
+## Example Usage
+
+{{ tffile "examples/resources/elasticstack_kibana_maintenance_window/resource.tf" }}
+
+{{ .SchemaMarkdown | trimspace }}
+
+## Import
+
+Import is supported using the following syntax:
+
+{{ codefile "shell" "examples/resources/elasticstack_kibana_maintenance_window/import.sh" }}