docs: update dragonfly and add example (#1671)

docs/data-sources/dragonfly.md

@@ -3,14 +3,21 @@
 page_title: "aiven_dragonfly Data Source - terraform-provider-aiven"
 subcategory: ""
 description: |-
-  The Dragonfly data source provides information about the existing Aiven Dragonfly service.
+  Gets information about an Aiven for Dragonfly® service.
 ---
 
 # aiven_dragonfly (Data Source)
 
-The Dragonfly data source provides information about the existing Aiven Dragonfly service.
+Gets information about an Aiven for Dragonfly® service.
 
+## Example Usage
 
+```terraform
+data "aiven_dragonfly" "example_dragonfly" {
+  project      = data.aiven_project.example_project.project
+  service_name = "example-dragonfly-service"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/dragonfly.md

@@ -3,14 +3,27 @@
 page_title: "aiven_dragonfly Resource - terraform-provider-aiven"
 subcategory: ""
 description: |-
-  The Dragonfly resource allows the creation and management of Aiven Dragonfly services.
+  Creates and manages an Aiven for Dragonfly® https://aiven.io/docs/products/dragonfly/concepts/overview service.
 ---
 
 # aiven_dragonfly (Resource)
 
-The Dragonfly resource allows the creation and management of Aiven Dragonfly services.
+Creates and manages an [Aiven for Dragonfly®](https://aiven.io/docs/products/dragonfly/concepts/overview) service.
 
+## Example Usage
 
+```terraform
+resource "aiven_dragonfly" "example_dragonfly" {
+    project      = data.aiven_project.example_project.project
+    plan         = "startup-4"
+    cloud_name   = "google-europe-west1"
+    service_name = "example-dragonfly-service"
+
+    dragonfly_user_config {
+        cache_mode = true
+    }
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
@@ -189,3 +202,11 @@ Read-Only:
 ### Nested Schema for `dragonfly`
 
 Read-Only:
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+terraform import aiven_dragonfly.example_dragonfly PROJECT/SERVICE_NAME
+```

examples/data-sources/aiven_dragonfly/data-source.tf

@@ -0,0 +1,4 @@
+data "aiven_dragonfly" "example_dragonfly" {
+  project      = data.aiven_project.example_project.project
+  service_name = "example-dragonfly-service"
+}

examples/dragonfly/provider.tf

@@ -0,0 +1,12 @@
+terraform {
+  required_providers {
+    aiven = {
+      source  = "aiven/aiven"
+      version = ">=4.0.0, <5.0.0"
+    }
+  }
+}
+
+provider "aiven" {
+  api_token = var.aiven_token
+}

examples/dragonfly/service.tf

@@ -0,0 +1,10 @@
+resource "aiven_dragonfly" "example_dragonfly" {
+    project      = var.aiven_project_name
+    plan         = "startup-4"
+    cloud_name   = "google-europe-west1"
+    service_name = "example-dragonfly-service" 
+
+    dragonfly_user_config {
+        cache_mode = true
+    }
+}

examples/dragonfly/variables.tf

@@ -0,0 +1,9 @@
+variable "aiven_token" {
+  description = "Aiven token"
+  type        = string
+}
+
+variable "aiven_project_name" {
+  description = "Aiven project name"
+  type        = string
+}

examples/resources/aiven_dragonfly/import.sh

@@ -0,0 +1 @@
+terraform import aiven_dragonfly.example_dragonfly PROJECT/SERVICE_NAME

examples/resources/aiven_dragonfly/resource.tf

@@ -0,0 +1,10 @@
+resource "aiven_dragonfly" "example_dragonfly" {
+    project      = data.aiven_project.example_project.project
+    plan         = "startup-4"
+    cloud_name   = "google-europe-west1"
+    service_name = "example-dragonfly-service"
+
+    dragonfly_user_config {
+        cache_mode = true
+    }
+}

internal/sdkprovider/service/dragonfly/dragonfly.go

@@ -22,7 +22,7 @@ func dragonflySchema() map[string]*schema.Schema {
 
 func ResourceDragonfly() *schema.Resource {
 	return &schema.Resource{
-		Description:   "The Dragonfly resource allows the creation and management of Aiven Dragonfly services.",
+		Description:   "Creates and manages an [Aiven for Dragonfly®](https://aiven.io/docs/products/dragonfly/concepts/overview) service.",
 		CreateContext: schemautil.ResourceServiceCreateWrapper(schemautil.ServiceTypeDragonfly),
 		ReadContext:   schemautil.ResourceServiceRead,
 		UpdateContext: schemautil.ResourceServiceUpdate,

internal/sdkprovider/service/dragonfly/dragonfly_data_source.go

@@ -9,7 +9,7 @@ import (
 func DatasourceDragonfly() *schema.Resource {
 	return &schema.Resource{
 		ReadContext: schemautil.DatasourceServiceRead,
-		Description: "The Dragonfly data source provides information about the existing Aiven Dragonfly service.",
+		Description: "Gets information about an Aiven for Dragonfly® service.",
 		Schema:      schemautil.ResourceSchemaAsDatasourceSchema(dragonflySchema(), "project", "service_name"),
 	}
 }