Add documentation and examples for write-only attributes

Co-authored-by: tobio <[email protected]>

Author: Copilot

docs/resources/kibana_import_saved_objects.md

@@ -12,6 +12,8 @@ Create sets of Kibana saved objects from a file created by the export API. See h
 
 ## Example Usage
 
+### Basic usage
+
 ```terraform
 provider "elasticstack" {
   kibana {}
@@ -26,15 +28,44 @@ EOT
 }
 ```
 
-<!-- schema generated by tfplugindocs -->
-## Schema
+### Using write-only attributes
 
-### Required
+The `file_contents_wo` and `file_contents_wo_version` attributes provide write-only alternatives to `file_contents`. 
+These attributes are not stored in the Terraform state, making them useful for sensitive content management.
 
-- `file_contents` (String) The contents of the exported saved objects file.
+```terraform
+provider "elasticstack" {
+  kibana {}
+}
+
+# Example using write-only file_contents_wo attribute
+resource "elasticstack_kibana_import_saved_objects" "settings_write_only" {
+  overwrite        = true
+  file_contents_wo = <<-EOT
+{"attributes":{"buildNum":42747,"defaultIndex":"metricbeat-*","theme:darkMode":true},"coreMigrationVersion":"7.0.0","id":"7.14.0","managed":false,"references":[],"type":"config","typeMigrationVersion":"7.0.0","updated_at":"2021-08-04T02:04:43.306Z","version":"WzY1MiwyXQ=="}
+{"excludedObjects":[],"excludedObjectsCount":0,"exportedCount":1,"missingRefCount":0,"missingReferences":[]}
+EOT
+}
+
+# Example using write-only file_contents_wo with version tracking
+resource "elasticstack_kibana_import_saved_objects" "settings_with_version" {
+  overwrite                = true
+  file_contents_wo         = <<-EOT
+{"attributes":{"buildNum":42747,"defaultIndex":"metricbeat-*","theme:darkMode":true},"coreMigrationVersion":"7.0.0","id":"7.14.0","managed":false,"references":[],"type":"config","typeMigrationVersion":"7.0.0","updated_at":"2021-08-04T02:04:43.306Z","version":"WzY1MiwyXQ=="}
+{"excludedObjects":[],"excludedObjectsCount":0,"exportedCount":1,"missingRefCount":0,"missingReferences":[]}
+EOT
+  file_contents_wo_version = "v1.0.0"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
 
 ### Optional
 
+- `file_contents` (String) The contents of the exported saved objects file.
+- `file_contents_wo` (String, Sensitive) The contents of the exported saved objects file (write-only, not stored in state).
+- `file_contents_wo_version` (String, Sensitive) Version or identifier for the file contents (write-only, not stored in state).
 - `ignore_import_errors` (Boolean) If set to true, errors during the import process will not fail the configuration application
 - `overwrite` (Boolean) Overwrites saved objects when they already exist. When used, potential conflict errors are automatically resolved by overwriting the destination object.
 - `space_id` (String) An identifier for the space. If space_id is not provided, the default space is used.

examples/resources/elasticstack_kibana_import_saved_objects/resource-write-only.tf

@@ -0,0 +1,22 @@
+provider "elasticstack" {
+  kibana {}
+}
+
+# Example using write-only file_contents_wo attribute
+resource "elasticstack_kibana_import_saved_objects" "settings_write_only" {
+  overwrite        = true
+  file_contents_wo = <<-EOT
+{"attributes":{"buildNum":42747,"defaultIndex":"metricbeat-*","theme:darkMode":true},"coreMigrationVersion":"7.0.0","id":"7.14.0","managed":false,"references":[],"type":"config","typeMigrationVersion":"7.0.0","updated_at":"2021-08-04T02:04:43.306Z","version":"WzY1MiwyXQ=="}
+{"excludedObjects":[],"excludedObjectsCount":0,"exportedCount":1,"missingRefCount":0,"missingReferences":[]}
+EOT
+}
+
+# Example using write-only file_contents_wo with version tracking
+resource "elasticstack_kibana_import_saved_objects" "settings_with_version" {
+  overwrite                = true
+  file_contents_wo         = <<-EOT
+{"attributes":{"buildNum":42747,"defaultIndex":"metricbeat-*","theme:darkMode":true},"coreMigrationVersion":"7.0.0","id":"7.14.0","managed":false,"references":[],"type":"config","typeMigrationVersion":"7.0.0","updated_at":"2021-08-04T02:04:43.306Z","version":"WzY1MiwyXQ=="}
+{"excludedObjects":[],"excludedObjectsCount":0,"exportedCount":1,"missingRefCount":0,"missingReferences":[]}
+EOT
+  file_contents_wo_version = "v1.0.0"
+}

templates/resources/kibana_import_saved_objects.md.tmpl

@@ -0,0 +1,26 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "{{.Name}} {{.Type}} - {{.RenderedProviderName}}"
+subcategory: "Kibana"
+description: |-
+{{ .Description | plainmarkdown | trimspace | prefixlines "  " }}
+---
+
+# {{.Name}} ({{.Type}})
+
+{{ .Description | trimspace }}
+
+## Example Usage
+
+### Basic usage
+
+{{ tffile "examples/resources/elasticstack_kibana_import_saved_objects/resource.tf" }}
+
+### Using write-only attributes
+
+The `file_contents_wo` and `file_contents_wo_version` attributes provide write-only alternatives to `file_contents`. 
+These attributes are not stored in the Terraform state, making them useful for sensitive content management.
+
+{{ tffile "examples/resources/elasticstack_kibana_import_saved_objects/resource-write-only.tf" }}
+
+{{ .SchemaMarkdown | trimspace }}