feat: add descriptions to docs

docs/data-sources/registry_image.md

@@ -3,12 +3,12 @@
 page_title: "docker_registry_image Data Source - terraform-provider-docker"
 subcategory: ""
 description: |-
-  
+  Reads the image metadata from a Docker Registry. Used in conjunction with the docker_image resource to keep an image up to date on the latest available version of the tag.
 ---
 
 # docker_registry_image (Data Source)
 
-
+Reads the image metadata from a Docker Registry. Used in conjunction with the [docker_image](/docs/providers/docker/r/image.html) resource to keep an image up to date on the latest available version of the tag.
 
 
 

docs/resources/config.md

@@ -3,12 +3,12 @@
 page_title: "docker_config Resource - terraform-provider-docker"
 subcategory: ""
 description: |-
-  
+  Manages the configs of a Docker service in a swarm.
 ---
 
 # docker_config (Resource)
 
-
+Manages the configs of a Docker service in a swarm.
 
 ## Example Usage
 

docs/resources/container.md

@@ -3,12 +3,12 @@
 page_title: "docker_container Resource - terraform-provider-docker"
 subcategory: ""
 description: |-
-  
+  Manages the lifecycle of a Docker container.
 ---
 
 # docker_container (Resource)
 
-
+Manages the lifecycle of a Docker container.
 
 ## Example Usage
 

docs/resources/image.md

@@ -3,12 +3,14 @@
 page_title: "docker_image Resource - terraform-provider-docker"
 subcategory: ""
 description: |-
-  
+  Pulls a Docker image to a given Docker host from a Docker Registry.
+   This resource will not pull new layers of the image automatically unless used i conjunction with [docker_registry_image](/docs/providers/docker/d/registry_image.html data source to update the pull_triggers field.
 ---
 
 # docker_image (Resource)
 
-
+Pulls a Docker image to a given Docker host from a Docker Registry.
+ This resource will *not* pull new layers of the image automatically unless used i conjunction with [`docker_registry_image`](/docs/providers/docker/d/registry_image.html data source to update the `pull_triggers` field.
 
 ## Example Usage
 

docs/resources/registry_image.md

@@ -3,12 +3,12 @@
 page_title: "docker_registry_image Resource - terraform-provider-docker"
 subcategory: ""
 description: |-
-  
+  Manages the lifecycle of docker image/tag in a registry.
 ---
 
 # docker_registry_image (Resource)
 
-
+Manages the lifecycle of docker image/tag in a registry.
 
 ## Example Usage
 

docs/resources/secret.md

@@ -3,12 +3,12 @@
 page_title: "docker_secret Resource - terraform-provider-docker"
 subcategory: ""
 description: |-
-  
+  Manages the secrets of a Docker service in a swarm.
 ---
 
 # docker_secret (Resource)
 
-
+Manages the secrets of a Docker service in a swarm.
 
 ## Example Usage
 

docs/resources/service.md

@@ -3,12 +3,14 @@
 page_title: "docker_service Resource - terraform-provider-docker"
 subcategory: ""
 description: |-
-  
+  This resource manages the lifecycle of a Docker service. By default, the creation, update and delete of services are detached.
+   With the Converge Config the behavior of the docker cli is imitated to guarantee tha for example, all tasks of a service are running or successfully updated or to inform terraform that a service could no be updated and was successfully rolled back.
 ---
 
 # docker_service (Resource)
 
-
+This resource manages the lifecycle of a Docker service. By default, the creation, update and delete of services are detached.
+ With the [Converge Config](#convergeconfig) the behavior of the `docker cli` is imitated to guarantee tha for example, all tasks of a service are running or successfully updated or to inform `terraform` that a service could no be updated and was successfully rolled back.
 
 ## Example Usage
 

docs/resources/volume.md

@@ -3,12 +3,12 @@
 page_title: "docker_volume Resource - terraform-provider-docker"
 subcategory: ""
 description: |-
-  
+  Creates and destroys a volume in Docker. This can be used alongside docker_container to prepare volumes that can be shared across containers.
 ---
 
 # docker_volume (Resource)
 
-
+Creates and destroys a volume in Docker. This can be used alongside [docker_container](/docs/providers/docker/r/container.html) to prepare volumes that can be shared across containers.
 
 ## Example Usage
 

internal/provider/data_source_docker_registry_image.go

@@ -19,6 +19,8 @@ import (
 
 func dataSourceDockerRegistryImage() *schema.Resource {
 	return &schema.Resource{
+		Description: "Reads the image metadata from a Docker Registry. Used in conjunction with the [docker_image](/docs/providers/docker/r/image.html) resource to keep an image up to date on the latest available version of the tag.",
+
 		ReadContext: dataSourceDockerRegistryImageRead,
 
 		Schema: map[string]*schema.Schema{

internal/provider/resource_docker_config.go

@@ -12,6 +12,8 @@ import (
 
 func resourceDockerConfig() *schema.Resource {
 	return &schema.Resource{
+		Description: "Manages the configs of a Docker service in a swarm.",
+
 		CreateContext: resourceDockerConfigCreate,
 		ReadContext:   resourceDockerConfigRead,
 		DeleteContext: resourceDockerConfigDelete,

internal/provider/resource_docker_container.go

@@ -9,6 +9,8 @@ import (
 
 func resourceDockerContainer() *schema.Resource {
 	return &schema.Resource{
+		Description: "Manages the lifecycle of a Docker container.",
+
 		CreateContext: resourceDockerContainerCreate,
 		ReadContext:   resourceDockerContainerRead,
 		UpdateContext: resourceDockerContainerUpdate,

internal/provider/resource_docker_image.go

@@ -6,6 +6,8 @@ import (
 
 func resourceDockerImage() *schema.Resource {
 	return &schema.Resource{
+		Description: "Pulls a Docker image to a given Docker host from a Docker Registry.\n This resource will *not* pull new layers of the image automatically unless used i conjunction with [`docker_registry_image`](/docs/providers/docker/d/registry_image.html data source to update the `pull_triggers` field.",
+
 		CreateContext: resourceDockerImageCreate,
 		ReadContext:   resourceDockerImageRead,
 		UpdateContext: resourceDockerImageUpdate,

internal/provider/resource_docker_registry_image.go

@@ -8,6 +8,8 @@ import (
 
 func resourceDockerRegistryImage() *schema.Resource {
 	return &schema.Resource{
+		Description: "Manages the lifecycle of docker image/tag in a registry.",
+
 		CreateContext: resourceDockerRegistryImageCreate,
 		ReadContext:   resourceDockerRegistryImageRead,
 		DeleteContext: resourceDockerRegistryImageDelete,

internal/provider/resource_docker_secret.go

@@ -12,6 +12,8 @@ import (
 
 func resourceDockerSecret() *schema.Resource {
 	return &schema.Resource{
+		Description: "Manages the secrets of a Docker service in a swarm.",
+
 		CreateContext: resourceDockerSecretCreate,
 		ReadContext:   resourceDockerSecretRead,
 		DeleteContext: resourceDockerSecretDelete,

internal/provider/resource_docker_service.go

@@ -12,6 +12,8 @@ import (
 // https://docs.docker.com/engine/api/v1.32/#operation/ServiceCreate
 func resourceDockerService() *schema.Resource {
 	return &schema.Resource{
+		Description: "This resource manages the lifecycle of a Docker service. By default, the creation, update and delete of services are detached.\n With the [Converge Config](#convergeconfig) the behavior of the `docker cli` is imitated to guarantee tha for example, all tasks of a service are running or successfully updated or to inform `terraform` that a service could no be updated and was successfully rolled back.",
+
 		CreateContext: resourceDockerServiceCreate,
 		ReadContext:   resourceDockerServiceRead,
 		UpdateContext: resourceDockerServiceUpdate,

internal/provider/resource_docker_volume.go

@@ -21,6 +21,8 @@ const (
 
 func resourceDockerVolume() *schema.Resource {
 	return &schema.Resource{
+		Description: "Creates and destroys a volume in Docker. This can be used alongside [docker_container](/docs/providers/docker/r/container.html) to prepare volumes that can be shared across containers.",
+
 		CreateContext: resourceDockerVolumeCreate,
 		ReadContext:   resourceDockerVolumeRead,
 		DeleteContext: resourceDockerVolumeDelete,